00 · Plan maestro — Luna Chat
La asistente se llama Ada desde 2026-09-10; “Luna” en nombres de código (carpetas, módulos, tablas, rutas del API, este documento) es el nombre interno.Documento vivo. Se actualiza ola por ola sin reescribirse: los estados cambian, la Bitácora crece, el resto se toca solo por decisión del founder. Ver §9.
1. Norte
Un chat top, totalmente especializado en Brein — no un asistente genérico con acceso a Brein. El humano sigue en el loop: Luna busca, arma y propone; la persona decide y el servidor ejecuta. El MCP es la fuente de la verdad que Claude, ChatGPT y Luna consumen por igual — un solo catálogo, no tres integraciones distintas.2. Decisiones tomadas
Append-only: una decisión aquí no se borra, se supera con una nueva fechada.3. Estado actual
Commit base:f19865d4 — “el motor de turno de Luna, headless, con su bench” (apps/api/src/luna/).
4. Carriles y olas de la primera noche
Tres carriles en paralelo: MCP (limpia y estandariza el catálogo que todos consumen), Memoria (persiste la sesión), Pantalla (construye contra un stream simulado mientras Memoria no esté lista). Se integran al final.
Reglas de la noche: el contrato de eventos (§6 de
01-interfaz-luna.md) y el contrato de turno (TurnInput/TurnIntent) quedan congelados — un carril que necesite cambiarlos para en seco y avisa, no improvisa. Commit + push por ola, nunca al final. caffeinate corriendo y despertador cada 20 min para no perder una ola dormida. Presupuesto de bench de la noche: ~$3, autorizado de antemano.
5. Después de la noche
- Resolutores de decisión con dinero de por medio: guardar en CRM, revelar contactos, autorizar secuencia.
- Modo automático con presupuesto (planes de pago).
- Diseño visual de la pantalla con el founder — lo de esta noche es funcional, no final.
- Evals L1/L2 en CI, con juez con modelo.
- Mercado estandarizado sobre el mismo formato de herramienta que el core.
- Beta con el Founder.
6. Puertas globales
Ninguna ola se da por verde sin esto, además de su puerta propia:7. Mapa de documentos
8. Bitácora
Append-only. Una entrada por hito relevante, nunca se edita una entrada pasada. 2026-09-10 — Día de arranque. Se construyó y commiteó S1 (f19865d4): motor de turno headless completo (contratos, compilador, manual, validador, candados, bench), sin memoria, sin endpoints, sin pantalla. Seis benches corridos; bench 6 en 13/20 medido (15/20 real — la reparación del validador puede degradar un turno bueno a uno vacío, hallazgo pendiente de arreglar). Pivote de diseño: el MCP pasa a ser la fuente de la verdad que Claude, ChatGPT y Luna consumen por igual, en vez de que Luna tenga su propio backing paralelo. Investigación de referencia completada: Apollo, Clay, HubSpot, plataformas de outreach, patrones de UX de chat. Se cerraron las 18 decisiones de §2.
2026-09-10 02:30 CST — Arranca la noche con el sí del founder. Sin .env.local en esta sesión: el bench y todo lo que pega a staging quedan para su máquina; se avanza solo lo que no gasta. Ola 0: caffeinate corriendo, despertador de ola cada 20 min y uno de reinicio de límites a las 04:03. Se lanzan en paralelo: MCP · 1, Memoria · sesión, Memoria · resumen, Pantalla · ruta + hilo (stream simulado), Pantalla · filas + tarjetas, y la reescritura de los 20 briefs al flujo core. Decisiones del founder aún abiertas y respetadas: tope de 12 herramientas sin cambio, con_secuencia detrás de bandera apagada, borrador de secuencia en nivel 0 como constante marcada.
2026-09-10 04:03 CST — Los seis agentes de la 02:30 murieron por límite de uso de la sesión antes de tocar un archivo; el árbol quedó limpio. Reinicio del límite a las 04:00; se relanzan los seis paquetes idénticos.
2026-09-10 04:17 CST — Memoria · resumen verde: el hilo entra como resumen rodante (≤1 200 chars, escalera 3/10/30) más los últimos 4 turnos crudos cuando pasa de 12; con 30 turnos las instrucciones completas miden 13 446 de 14 000 chars. Determinista, sin modelo, con punto de extensión para que el modelo lo escriba después. Salvedad: si otra sección de las instrucciones se disparara, el recorte de luna-manual (congelado) tira primero el resumen; anotado en el código.
2026-09-10 04:22 CST — Briefs del bench reescritos al flujo core (20: empresas 4, guardar en CRM 3, contactos 3, secuencias 3, Cerebro 3, saldo 2, fuera de alcance 2); los de Mercado quedan en briefs.mercado.json. Spec de validación verde (18 pruebas). Sin ejecutar el bench. Cinco graders faltantes anotados para MCP · 3 / MCP · 4: conteo fuera de Mercado, “nunca llama a X” leyendo eventos, orden cotizar→proponer, herramienta esperada usada, y decision.kind esperado.
2026-09-10 04:35 CST — Memoria · sesión verde: tablas nuevas luna_sessions y luna_session_events (no se reutilizan work_sessions, que pertenecen al Workbench A4 y tienen otro snapshot; corrección a la fila de §4). Seq monotónico asignado por la base, idempotencia por Idempotency-Key, ocultar un turno es hidden_at y nunca DELETE, regenerar es un turno nuevo con parent_turn_id/variant_index en columnas propias, compactar solo persiste el resumen. runTurn no cambió: el sink de eventos existente es la costura. Migración escrita y probada con mocks; no se corrió contra Postgres (pendiente en la máquina del founder). Se lanzan Memoria · endpoints y · stream juntas.
2026-09-10 05:05 CST — Pantalla · filas y · tarjetas verdes: la fila de herramienta con sus 7 estados a altura fija y sin animación de entrada; las 9 tarjetas de decisión (una por kind) que previsualizan y no ejecutan nada hasta el toque, con cuenta regresiva, recibo sellado, recotización en su lugar y confirmación escrita cuando el gasto pasa de la mitad del saldo; más la tarjeta de límite y la franja de deshacer de 8 s. Todo cuelga de los contratos de slots.ts del carril del hilo. 23 pruebas nuevas verdes. Hueco anotado: el reductor del runtime aún no conserva hora ni política de la resolución, así que el recibo sale sin esa línea.
2026-09-10 05:20 CST — Pantalla · ruta y · hilo verdes: /w/:slug/luna con riel de sesiones (archivar, nunca eliminar), hilo assistant-ui sobre un External Store con reductor exhaustivo de los 10 eventos, panel derecho con modo activo, compositor con Preguntar/Automático (automático deshabilitado: “en planes de pago”) y contador de presupuesto, píldora “Luna sigue trabajando”. Stream simulado que reproduce la escena de referencia; reconectar con since no duplica. react-resizable-panels no estaba instalado (el plan lo daba por instalado): se agregó. Rojo pendiente: el guard de diseño marca 4 controles crudos en Luna.tsx; lo corrige la ola de acciones de turno, que ya toca ese archivo.
2026-09-10 05:45 CST — Memoria · endpoints verde y · stream amarillo. Rutas bajo workspaces/:slug/luna/sessions (el prefijo que la auth de workspace exige): crear, listar, leer, turno con Idempotency-Key obligatoria (misma clave → mismo resultado sin volver a correr), ocultar, regenerar (variante con parent_turn_id), archivar, y SSE con replay desde since o Last-Event-ID, heartbeat de 15 s. 354 archivos / 5 119 pruebas verdes. Rojo a resolver en Integración: el sink guarda los eventos en un solo lote al cerrar el turno, así que el stream no narra en vivo mientras Luna trabaja; la causa es que appendEvents estampa la clave de idempotencia solo en la primera fila del lote. Arreglo previsto: la idempotencia vive en el turno (una fila por clave) y los eventos se anexan uno a uno según llegan. También anotado: regenerar corre sobre el snapshot actual, no el previo al turno original; listEventsSince no pagina más de 500 filas.
2026-09-10 06:10 CST — MCP · 1 verde: 22 herramientas fuera del catálogo (18 retiradas + context_share, contact_prepare, members, context_delete; borrar un topic cae bajo la misma regla que borrar un registro), el registro partido en cinco familias (Cerebro, CRM, Empresas y contactos, Cuenta, Mercado sin tocar por dentro), tool-registry.ts de 2 928 a 832 líneas, desaparece el mecanismo de “ocultas pero resolubles”: lo eliminado responde Unknown tool. tools/list expone 31 (18 core + 13 Mercado). MCP 174/174, CLI 215/215. Docs, skill del CLI, sumisión a ChatGPT, contrato de evals y harness e2e actualizados. Fuera: espejo docs/es (quedará STALE), y un mensaje de error en members/member-lookup.service.ts que aún sugiere driftless_members; lo toma MCP · 2.
2026-09-10 06:35 CST — Memoria · stream en vivo verde: tabla nueva luna_session_turns con la Idempotency-Key única por sesión registrada antes de correr el turno; cada evento se persiste y se publica al hub según llega (5 eventos → 5 publicaciones antes del cierre, probado). Repetir la clave reproduce el mismo resultado sin volver a correr; un turno interrumpido por excepción queda failed y se reintenta reusando la fila; un proceso muerto deja running y la misma clave responde 409. Nada se borra. Sin correr contra Postgres. Un spec de mapeo MCP en cognitive está rojo por el trabajo en curso de MCP · 2, no por esta ola.
2026-09-10 07:05 CST — Pantalla · acciones y · panel dividido verdes, guard de diseño en cero. Las seis acciones funcionan sobre el stream simulado: regenerar con selector de variantes ‹ i/n ›, eliminar con confirmación en línea y sin borrar nada, compactar pliega el hilo tras un bloque de resumen expandible, recordar reutiliza la tarjeta dejar_nota, detener con Esc, dirigir mientras corre con píldora “dirigido”. El panel muestra la selección como tabla del CRM y “vino de este turno ▸” resalta el turno. El recibo ya muestra hora y política. 451 pruebas verdes. Para Integración: el reductor usa tres eventos solo de cliente (turn.variant, turn.retracted, thread.compacted) que no están en el contrato congelado de 10; el servidor modela lo mismo como turno variante, hidden_at y resumen, así que el cliente real debe traducir esas formas del servidor a los eventos del reductor, no ampliar el contrato. SelectionItem no trae nombre de empresa en el contrato: el panel muestra monograma; abrir esa decisión con el founder.
2026-09-10 07:20 CST — Pantalla · cliente real (paquete añadido, archivos nuevos): cliente tipado de las rutas de sesión con Idempotency-Key y un reintento con la misma clave ante fallo de red; fuente de eventos sobre EventSource con reconexión desde el último seq entregado, heartbeats ignorados; hook useLunaSession. 478 pruebas verdes. Para Integración: (1) EventSource nativo no puede mandar el Bearer de Clerk, así que hoy depende de la cookie; el repo ya resuelve SSE autenticado con fetch en subscribeWorkspaceEvents de api.ts: cambiar a ese patrón. (2) Faltan rutas en el API para resolver una decisión, detener un turno, dirigir, compactar y proponer nota; el cliente las marca not_supported. (3) El turno regenerado llega como turno normal: el cliente debe leer parent_turn_id/variant_index de la respuesta de sesión, no del evento.
2026-09-10 07:50 CST — MCP · 2 verde: catálogo core de 21 (Cerebro 4, CRM 2, Empresas y contactos 7, Cuenta 2, Secuencias 6) + Mercado 13 = 34, exactamente el de 05. Cada herramienta lleva sideEffect / policyClass / costClass / idempotent y sus ejemplos van dentro de la descripción (antes el modelo nunca los veía). DriftlessTool extendido aditivamente; el MCP mantiene un espejo local porque no puede importar del API. context_search/context_list/context_get_for_files y collection_record quedan como alias de llamada ocultos por 60 días para skills externas. Ninguna Secuencia activa ni envía; sequence_check es la comprobación previa. Backends que faltan y no se inventaron: audiencia por registros sin correos literales, límite diario y dedup en campañas, SPF/DKIM, undo_token, guardado en lote con política de conflicto, search_id reutilizable. MCP 181/181, API 5 129, CLI 215/215.
2026-09-10 08:25 CST — Memoria · decisiones y control de turno (paquete añadido) verde: resolver una tarjeta (decisions/:id/resolve, con 404/409/410/501), detener (aborta el turno vía la señal que runTurn ya aceptaba; la fila queda failed: detenido), dirigir, compactar y recordar. Resolutores reales solo sin dinero: guardar en CRM (crea o reutiliza la Colección y hace upsert por record_ref, “3 ya estaban” sale del conteo real), cambios masivos (cambio de etapa por id, deshacer es otro cambio a Descartado), dejar nota (escribe el topic directo). Los seis kinds con dinero o externos responden 501. El resolutor vive en su propio módulo luna-decisions/ por exigencia del candado. 355 archivos / 5 158 pruebas verdes antes de que MCP · 3 empezara a reescribir el árbol. Pendiente de plomería: hoy ninguna herramienta llena preview ni board.selection, así que solo guardar en CRM resuelve de punta a punta cuando la selección exista; lo cierra la Integración.
2026-09-10 08:55 CST — Integración · pantalla verde: /w/:slug/luna habla con el API real por defecto (riel, nueva sesión con id del servidor, archivar, abrir sesión siembra el reductor con snapshot + resumen + últimos turnos y suscribe desde last_seq); el simulado queda con ?simulado=1. SSE sobre fetch con el Bearer de Clerk, como el resto del repo; reconexión con backoff desde el último seq. Cada acción se traduce a su ruta y a un evento del reductor sin ampliar el contrato: ocultar → turn.retracted, compactar → thread.compacted, regenerar → turno nuevo cuyas narraciones se pliegan en turn.variant al terminar; resolver, detener, dirigir y recordar solo disparan el POST y el efecto llega por el stream. 409 al enviar encola el texto como dirección. 483 pruebas verdes, guard de diseño en cero. Falta en el API: renombrar sesión (queda solo en cliente).
2026-09-10 09:30 CST — MCP · 3 amarillo. Luna toma su catálogo del registro del MCP en proceso (un solo ToolRegistry para todo el proceso), luna-tools.ts y su servicio se borraron, los estados mexicanos viven en libs/market-data-contracts, etapas renombradas a las herramientas del MCP (Mercado: 6 visibles en buscando, 6 fuera; el tope de 12 intacto; contact_unlock nunca visible), routing de las instrucciones actualizado, presupuesto de instrucciones subido a 14 600 chars para no perder el resumen. Cuatro graders nuevos en el bench. 5 161 pruebas verdes. Rojo estructural: la ejecución no pasa por registry.call() porque los handlers del MCP exigen un bearer y el contexto de Luna solo trae workspace y principal ya autenticados; Cerebro, Mercado, saldo y workspaces ejecutan directo contra los servicios, pero las 9 herramientas de Empresas, CRM y Secuencias responden not_wired. Se abre el paquete “MCP · 5: costura de auth en proceso” para que Luna ejecute por el mismo camino que Claude y ChatGPT.
2026-09-10 10:20 CST — Selección viva y renombrar sesión verdes. Buscar empresas o proveedores llena la selección del tablero por cada llamada (evento board.patched, que ya estaba en el contrato y nadie usaba) y la persiste en el snapshot; guardar_en_crm llega con vista previa (nombre de Colección desde el criterio, conteo, refs) y el resolutor real la acepta: probado de punta a punta con el resolutor y colaboradores simulados. Corrección a la nota de las 07:05: SelectionItem sí trae name. Hueco real: cambios_masivos no se puede armar con el contrato congelado (proposal_id opaco sin registro de propuestas; sin ids reales del CRM hasta que collection_query ejecute). Renombrar sesión en API y riel; el título automático nace en el servidor al cerrar el primer turno. 5 190 pruebas verdes.
2026-09-10 11:10 CST — MCP · 5 verde: Luna ejecuta TODAS sus herramientas por registry.call() del MCP, el mismo camino que Claude y ChatGPT, con un token interno firmado de 60 s (audiencia luna, secreto en LUNA_INTERNAL_TOKEN_SECRET, falla en claro en producción si falta); un token que llegue por HTTP sin firma válida cae a la validación normal y falla, probado. Cero not_wired. Verificación final: db build, API 5 212 pruebas, MCP 181, CLI 215, dashboard 485, guard de diseño y el harness de léxico nuevo (scripts/harness/luna-lexico.mjs, que encontró y corrigió dos “universo” en las instrucciones) todos verdes. mcp-e2e.mjs no ejecutable sin servidor y base.
Cierre de la noche, en términos de producto. Un vendedor que abra /w/:slug/luna hoy ve el riel de sesiones, escribe, y Luna narra en vivo lo que hace: cada herramienta aparece como una fila con su estado, la búsqueda llena la selección en el panel derecho como tabla del CRM, y guardar en el CRM es una tarjeta con nombre de Colección, cuántas entran y cuántas ya estaban; al tocar, la Colección se crea de verdad y queda un recibo con hora y política. Puede regenerar con variantes, quitar un turno sin que nada se borre, compactar un hilo largo tras un resumen, recordar algo como topic del Cerebro con aprobación, detener con Esc y dirigir mientras corre. Al día siguiente la sesión reabre con su resumen. Lo que cobra o sale del workspace (revelar contactos, autorizar una secuencia, acciones externas) muestra la tarjeta pero responde “todavía no se puede resolver desde el chat”. Claude y ChatGPT ven el mismo catálogo de 34 herramientas, con la familia Secuencias y su comprobación previa, y ninguna borra, cobra sin cotización ni envía.
Lo que necesita el founder: (1) correr las tres migraciones (luna_sessions, luna_session_events, luna_session_turns) y LUNA_INTERNAL_TOKEN_SECRET en staging; (2) el bench en local (.env.local, workspace golden, ~$3) y cinco corridas para MCP · 4; (3) abrir la ruta con assistant habilitado y pedir algo real; (4) cuatro decisiones: tope de 12 con Mercado, nivel del borrador de secuencia, etapa con_secuencia (requiere ampliar el contrato), y la vista previa de cambios_masivos (proposal_id opaco sin registro de propuestas). Backends que faltan para Secuencias: audiencia por registros, límite diario y dedup en campañas, SPF/DKIM. Comentarios obsoletos con not_wired en luna-board.ts por limpiar.
2026-09-10 tarde, en la máquina del founder. Migraciones aplicadas en staging (tres tablas). Pila hermética con Postgres nativo en el worktree Driftless-luna: HTTP e2e 24/24 y MCP e2e 101/101 (harness alineado al catálogo de 34). Benches 7→9 contra staging: 3/20 → 3/20 → 6/20, cada uno con una causa de plomería distinta y ya cerrada: sin principal en el bench, la política negaba la búsqueda gratuita, el bench no escuchaba en el puerto del loopback, el pooler de staging se saturaba (cierre explícito de DataSources; bug real de Nest con dos DataSources). El workspace golden quedó sembrado (Colección Oportunidades, 10 registros, 3 contactos adquiridos, remitente sin verificar, borrador de secuencia). Empresas → selección → guardar funciona: company_search llena la selección y el resolutor consume claim tokens vía company_save. Dos correcciones del founder: Hunter Discover es gratis (la puerta es de evaluación, no de costo) y el tope de 12 herramientas era mío (S1), no suyo: subió a 20 y las Secuencias entran en con_lista. Diagnóstico del bench 9 por clase: 4 entorno, 3 contrato de herramienta, 3 etapa, 1 validador, 5 instrucciones (incluida mi línea de routing “guardar → company_save”, que debe ser tarjeta). Bench 10 en curso con esos arreglos. Decisiones que siguen abiertas: nivel del borrador de secuencia; con_secuencia como etapa (contrato); vista previa de cambios_masivos; el lote de company_save con política de conflicto que 05 describe y el API no tiene.
2026-09-10 13:00 CST. Bench 10: 7/20 (manual v2.4.0, 2.9 herramientas por turno). Desaparecieron los dos errores de contrato del bench 9 (select+projection, entity_id como campo) y el refusal espurio por la fecha “1 de octubre” (el validador acepta fechas que vienen de la herramienta; la causa real era que un datetime ISO nunca entraba en las cifras conocidas). Nuevos muros: Hunter sin configurar en el entorno local (503), cursor_invalid de paginación en cuatro briefs, y proposal_id sin fuente en guardar_en_crm una vez que guardar dejó de ser llamada directa. Los resolutores con dinero ya existen: revelar contactos (cotización vigente, saldo, confirmación escrita, reembolso) y revisar secuencia (comprobación previa vigente, un toque por paso, huella). Demo: API del worktree contra staging en :3777 con Empresas y secuencias en evaluación, dashboard en :5173; el founder es owner de golden. Pendiente de plomería: la vista previa de las tarjetas de contactos y secuencia (cotización y comprobación) desde el turno.
2026-09-10 15:10 CST — la primera sesión real del founder. Abrió /w/golden/luna y vio: layout encajonado en el centro, filas de herramienta con el JSON crudo como título, la narración terminando en 】【。, el panel “Vacío” pese a 47 observaciones, y en “muéstralas” Luna se fue de pesca (tres búsquedas no pedidas). Nada de eso lo vio ningún agente ni yo: se verificó con pruebas, guard de diseño y un stream simulado; el founder fue el primer humano en verla con datos reales. Regla nueva (memoria): ninguna ola de Pantalla cierra sin captura contra el API real. Causas y arreglos: (1) el recorte por presupuesto vaciaba results[] y dejaba la procedencia duplicada, así que no había filas ni tablero → se quita la procedencia y las filas llevan nombre y estado; summary humano por herramienta; (2) la pantalla mostraba summary como título → título = etiqueta, JSON solo al expandir; citas rotas limpiadas o convertidas en chip; layout con el patrón de sangrado completo del rediseño; (3) el modelo escribe corchetes de ancho completo → normalización en el turno y ejemplo exacto del formato en las instrucciones (en curso); (4) seguimientos (“muéstralas”) se contestan desde el tablero, nunca con búsquedas nuevas (en curso). Decisión: no se corren más benches hoy; la señal es el founder con el navegador. Bench 11 quedó commiteado sin correr (pooler saturado).
2026-09-10 17:00 CST — el Chat del founder. Tras “suspende ya toda tu mierda”: todo detenido, y dos órdenes: (a) un agente diseña bien el chat y lo mete en el sidebar como “Chat” en lugar de Prioridades, borrando todo lo de Prioridades (Inbox, su endpoint exclusivo, redirects, i18n); (b) Luna ve las 34 herramientas siempre (decisión 19). Luego mandó una referencia visual (decisión 21) y el rediseño la siguió: Chats en el sidebar, cabecera delgada, una línea de actividad por turno, resultados como tarjeta en línea con acciones por fila y en lote, tarjetas de decisión con la misma piel, compositor ancho; sin panel derecho ni riel interno. Verificado con captura real a 1440 y 1024 antes de entregar. En paralelo, “¿cómo va mi pipeline?” destapó que no existía forma de listar Colecciones: collection_query sin id ahora las lista con conteos por etapa, el routing va lista → consulta, y un freno corta llamadas repetidas. Resultado en su pantalla: “Tu pipeline tiene 40 oportunidades: 36 nuevas, 3 por revisar y 1 prioritaria”, con cita a la Colección. Su veredicto del rediseño: “nice, mejoró muchísimo”. Pendientes chicos: chip “colección”, sección Chats visible arriba, título sin capitalizar.
2026-09-11 — Contact Path retirado (PR #698) + Ada persona-primero (#697). La familia de Empresas pasó a persona-primero: contact_discover/contact_select/contacts_acquired/contact_quote/contact_unlock salen del catálogo MCP, las rutas /radar/collections/:id/contact-paths/* y el flujo en RadarEnrichmentService se borran, y su lugar lo ocupan people_search/people_quote/people_acquired/people_reveal/people_file/people_status sobre /radar/people/*. El resolver del chat llama ContactsService.revealSelection; people_reveal (spend, policyClass 2) queda oculto del cinturón y people_quote sella el quote_token en el snapshot (el modelo solo ve quote_id). Scopes OAuth: search/save→commercial:discover, quote/acquired→commercial:read, reveal/file/status→commercial:activate (default-deny; sin ellos Ada era rechazada). El catálogo público queda en 22 core (Cerebro 4, CRM 2, Empresas y personas 8, Cuenta 2, Secuencias 6) + 13 Mercado = 35. Docs públicas y de arquitectura repuntadas.