@ingeniomaps/cauce 0.32.0 → 0.34.0

package/CHANGELOG.md

@@ -14,6 +14,49 @@ desde este repositorio no va, porque el que lee no puede actuar sobre eso. Cuand
 unas pocas líneas casi siempre es porque cuenta cómo se descubrió el problema o por qué se eligió el
 diseño — eso vive en el commit y en el código.
 
+## [0.34.0] - 2026-08-19
+
+### Añadido
+
+- **R16: el costo es el contexto, no las palabras.** Regla nueva del sistema, en
+  `planning/rules/system/process.md`, así que rige en cada tarea la haga quien la haga. Cada llamada
+  reenvía el contexto entero: gasta más quien da más vueltas que quien escribe más. Comandos
+  independientes en una sola invocación, el CLI antes que el archivo, el fragmento antes que el archivo
+  entero, un subagente sólo cuando el trabajo no entra en la corrida actual, y un archivo se lee una vez
+  y se escribe entero en vez de releerlo para confirmar.
+
+  Cierra con la parte que la hace segura y que una regla de eficiencia escrita a las apuras suele
+  omitir: **verificar es la excepción y no se negocia**. Ahorrar una llamada nunca justifica afirmar sin
+  haber comprobado —R14 no admite descuentos— ni dar por terminado lo que no se corrió.
+
+  No nombra precios, ventanas de caché ni cuándo limpiar una conversación: eso lo fija el runner, y una
+  regla del sistema que lo nombrara envejecería con su próxima versión en todas las instancias a la vez.
+
+### Cambiado
+
+- **El arranque acota las vueltas dentro de cada fase, no sólo cuántas fases hay.** El techo de tres
+  agentes limitaba cuántos contextos se cargan, no cuántas veces se reenvía cada uno. Medido en una
+  corrida real: la fase que escribe gastó veinte vueltas —seis lecturas y tres ediciones— para producir
+  cuatro archivos, y los tres agentes sumaron tres millones de tokens de caché, un cuarto de la sesión.
+  Ahora cada fase sabe qué cuesta: leer una vez y sólo para escribir, escribir entero de una, no releer
+  para comprobar, y correr `check` una sola vez.
+
+## [0.33.0] - 2026-08-19
+
+### Corregido
+
+- **Con varias raíces declaradas, ningún servicio tenía nombre.** Cada repositorio es la raíz de su
+  propio escaneo, así que su proyecto principal volvía como `.`: tres servicios llamados igual y nada que
+  los distinga. Una credencial no se podía atribuir a un servicio porque ningún servicio era nombrable, y
+  una corrida real terminó pidiéndole a una persona que declarara variables que su propio repositorio ya
+  declaraba. Ahora cada candidato lleva el nombre de su raíz, y donde hay una sola el proyecto de arriba
+  se nombra por su carpeta en vez de aparecer como `.` a secas.
+
+- **El arranque podía negar lo que el inventario le entregó.** Se le dice explícitamente que un nombre
+  que el inventario trae está declarado, así que pedir que se declare de nuevo contradice al repositorio.
+  La mitad de la corrección anterior que tocaba el recorrido —la que le hace copiar los nombres de
+  variable por servicio— no había llegado a publicarse.
+
 ## [0.32.0] - 2026-08-19
 
 ### Corregido

package/automatization/workflows/onboard.js

@@ -50,6 +50,11 @@ const BASE = `Nunca inventes clientes, métricas, ingresos, plazos ni responsabl
   `recorras directorios, no leas código fuente y no abras más archivos que los que vas a escribir. Esto ` +
   `es un arranque de cinco minutos, no una auditoría: lo que no esté a la vista se marca como supuesto o ` +
   `queda como pregunta abierta, que es más barato y más honesto que averiguarlo.\n\n` +
+  `Lo que cuesta no son las palabras que escribís sino las vueltas que das: cada llamada arrastra tu ` +
+  `contexto entero. Leé un archivo una sola vez y sólo si vas a escribirlo; escribilo completo de una, sin ` +
+  `editarlo después; no lo releas para comprobar que quedó —si la escritura falla, te enterás—. Medido en ` +
+  `una corrida real: la fase que escribe gastó veinte vueltas con seis lecturas y tres ediciones para ` +
+  `producir cuatro archivos.\n\n` +
   `El arranque tiene tres objetivos y ninguno más: entender qué es este proyecto, dejar la instancia ` +
   `correcta para él —contexto, mapa, raíces, lo que espera a una persona— y que la primera tarea pueda ` +
   `empezar. El análisis profundo llega después, cuando alguien pida algo concreto; adelantarlo acá ` +
@@ -85,6 +90,10 @@ const SCAN = {
           required: ['kind', 'command', 'source'], properties: {
             kind: { type: 'string' }, command: { type: 'string' }, source: { type: 'string' },
           } } },
+        // Los nombres de variable que ese servicio espera, copiados del inventario. En un multirepo cada
+        // repositorio trae su propio ejemplo, y sin esto las credenciales de tres repos no existían para
+        // el arranque: las filas terminaban diciendo «la credencial del proveedor» sin nombrarla.
+        env: { type: 'array', items: { type: 'string' } },
       } } },
     externals: { type: 'array', items: { type: 'string' } },
     secrets: { type: 'array', items: { type: 'string' } },
@@ -110,11 +119,12 @@ const state = await agent(
   `else and open no file other than .env.example at the workspace root.\n` +
   `1. "node tools/ops.js onboard --json": the instance state, the workspace inventory, the opening ` +
   `question and the dimensions still uncovered. Copy fresh, opening, followUps, the "need" of each ` +
-  `dimension, and every service with its path, its runtimes and its declared commands keeping the source ` +
-  `file each command came from. Add nothing it did not print.\n` +
+  `dimension, and every service with its path, its runtimes, its declared commands keeping the source ` +
+  `file each command came from, and the variable names its "env" carries. Add nothing it did not print.\n` +
   `2. "node tools/ops.js check planning".\n` +
-  `If .env.example exists at the workspace root, report the variable names in secrets —names only— and ` +
-  `the external services they point at in externals.`,
+  `The inventory already names every credential each service expects: never open a .env file to look for ` +
+  `more. Report those names in secrets and the services they point at in externals. A name the inventory ` +
+  `carries is declared, and saying otherwise is a claim the repository contradicts.`,
   { schema: SCAN, label: 'inventario' },
 )
 if (!state) return stop('scan-unavailable', 'no se pudo leer el estado del workspace')
@@ -167,9 +177,10 @@ const drafted = await agent(
     'completa.\n'}` +
   `4. ${HUMAN}: una fila por cada cosa que necesita a una persona, con la tarea, el estado pendiente, el ` +
   `origen "onboard" y la acción concreta que la desbloquea. Como mínimo, una por cada credencial que el ` +
-  `inventario nombra, diciendo la variable y el servicio que la espera —dónde se carga y quién lo hace, ` +
-  `sin proponer ningún valor—, una por cada sistema externo o MCP a conectar, y una por la autoridad del ` +
-  `runner, que hoy declara runner.allowPush=false.\n` +
+  `inventario nombra, diciendo la variable y el servicio que la espera. El nombre ya está declarado, así ` +
+  `que no pidas declararlo de nuevo: lo que falta es dónde se carga el valor y quién lo hace, y ningún ` +
+  `valor se propone acá. Además, una por cada sistema externo o MCP a conectar, y una por la autoridad ` +
+  `del runner, que hoy declara runner.allowPush=false.\n` +
   `5. Las preguntas que queden abiertas, en la sección Ideas de ${INBOX}, sin promover.\n` +
   `Devolvé en files cada archivo que tocaste y en assumptions cada supuesto que dejaste marcado.`,
   { schema: WRITTEN, label: 'contexto' },
@@ -194,8 +205,11 @@ const epic = await agent(
     : 'La primera historia es traer los repos y declararlos en workspaceRoots.'} ` +
   `En "## Riesgos y decisiones humanas" citá las filas que quedaron en HUMAN_ACTIONS. No toques ` +
   `BACKLOG.md.\n\n` +
+  `El contrato de una épica está en ${P}/PROTOCOL.md; si necesitás verlo, leé esa sección y no el archivo ` +
+  `entero, y escribí la épica de una sola vez.\n\n` +
   `Cerrá corriendo "node tools/ops.js check planning" desde ${ROOT} y, si falla, reparando sólo lo que ` +
-  `esta corrida escribió; nunca debilites un criterio para forzar el verde.`,
+  `esta corrida escribió; nunca debilites un criterio para forzar el verde. Una sola corrida de check: si ` +
+  `pasó, terminaste.`,
   { schema: { type: 'object', additionalProperties: false, required: ['file', 'passed'],
     properties: {
       file: { type: 'string' }, passed: { type: 'boolean' }, details: { type: 'string' },

package/engine/cli/ops.js

@@ -363,8 +363,16 @@ function candidates(workspace, skip = '') {
   return [...found, ...result.services.map((service) => ({ ...service, root: workspace }))]
 }
 
+// Con varias raíces, cada repositorio es la raíz de su propio escaneo y su candidato principal se llama
+// `.`: tres servicios con el mismo nombre y nada que los distinga. El prefijo los vuelve nombrables, que
+// es la única forma de que una credencial pueda atribuirse a un servicio en vez de quedar suelta.
 function inventory(root) {
-  return workspaceRoots(root).flatMap((workspace) => candidates(workspace, root))
+  const roots = workspaceRoots(root)
+  if (roots.length === 1) return candidates(roots[0], root)
+  return roots.flatMap((workspace) => candidates(workspace, root).map((service) => ({
+    ...service,
+    path: service.path === '.' ? path.basename(workspace) : `${path.basename(workspace)}/${service.path}`,
+  })))
 }
 
 function scan(target, cli) {
@@ -374,10 +382,11 @@ function scan(target, cli) {
   // Un monorepo de sesenta paquetes no se lee en pantalla. Se recorta, y se dice cuánto: un corte que no
   // se anuncia hace pasar lo listado por todo lo que hay.
   for (const service of result.services.slice(0, LISTA)) {
-    const donde = service.root && service.root !== result.root ? `${path.basename(service.root)}/` : ''
+    // El proyecto que vive en la raíz se nombra por su carpeta: `.` a secas no dice de cuál se habla.
+    const nombre = service.path === '.' ? `. (${path.basename(service.root || result.root)})` : service.path
     const espera = service.env ? `\n    espera ${service.env.names.join(', ')} (${service.env.file})` : ''
     console.log(
-      `${donde}${service.path} [${(service.runtimes || []).join(', ')}]${comandos(service.commands)}${espera}`,
+      `${nombre} [${(service.runtimes || []).join(', ')}]${comandos(service.commands)}${espera}`,
     )
   }
   if (result.services.length > LISTA) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.32.0",
+  "version": "0.34.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "keywords": [
     "planning",

package/template/planning/rules/system/process.md

@@ -15,3 +15,15 @@ Buscar fallos de corrección, seguridad, compatibilidad y operabilidad antes de
 ## R4 — Sincronización de estados
 
 El estado se mueve de forma atómica entre contratos; nunca se copia para representar progreso.
+
+## R16 — El costo es el contexto, no las palabras
+
+Cada llamada reenvía el contexto entero, así que gasta más quien da más vueltas que quien escribe más.
+Los comandos independientes van en una sola invocación; el CLI antes que el archivo; el fragmento antes
+que el archivo entero; un subagente o un workflow sólo cuando el trabajo no entra en la corrida actual.
+
+Se lee para escribir, no para confirmar: un archivo se lee una vez y se escribe entero. Releerlo para
+comprobar que quedó no comprueba nada que un error no hubiera dicho.
+
+Verificar es la excepción, y no se negocia. Ahorrar una llamada nunca justifica afirmar sin haber
+comprobado —R14 no admite descuentos— ni dar por terminado lo que no se corrió.