@ingeniomaps/cauce 0.77.0 → 0.78.0

package/CHANGELOG.md

@@ -14,6 +14,44 @@ 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.78.0] - 2026-09-10
+
+### Corregido
+
+- **Las puertas que revisan un recorrido leen los literales de regex.** Tres pruebas analizan cada
+  workflow como texto —que su `meta` sea un literal puro, que no llame a nada inexistente y que no use un
+  nombre que no declaró— y ninguna sabía qué es un regex. La barra escapada que cierra uno deja un `//`
+  literal, que se leía como el arranque de un comentario: a partir de ahí se perdía el resto de la línea,
+  en silencio. Dos recorridos del catálogo tenían cuatro líneas así.
+
+  **Qué cambia para vos**: nada en lo que recibís, y sí en lo que se puede confiar. Un recorrido propio
+  con un regex adentro ahora se revisa entero en vez de a medias, y un `meta` con un regex o con una
+  interpolación —que hasta acá pasaba siempre, porque esa regla no podía dispararse— se rechaza.
+- **El nombre de un banco de pruebas no trae nada que la prueba no haya pedido.** La suite aísla lo que
+  cada prueba mide filtrando la salida de `check`, y esa salida empieza con la ruta del banco: cuando el
+  sufijo aleatorio del directorio terminó en `adr`, un error ajeno entró a una prueba de plantillas de
+  ADR y la puso en rojo. Falla una vez cada muchas corridas y se lee como un hipo del entorno.
+
+  **Qué cambia para vos**: nada — es la suite del toolkit, no algo que recibas. Va acá porque una puerta
+  que falla al azar enseña a relanzar en vez de a mirar, y eso sí llega a quien la usa.
+
+- **`autobuild` lee `blocked` por su valor y no por su verdad.** El campo del contexto es un vocabulario
+  de tres valores —vacío, `awaiting-review` y `blocked-on-human`—, y el recorrido lo probaba con un `if`
+  a secas. Dos consecuencias, y la que más costaba no era intermitente: una cola trabada por acciones
+  humanas frenaba con el motivo del checkpoint de hito y mandaba a mirar `AWAITING_REVIEW.md`, un archivo
+  que en ese escenario no existe. Ahora cada bloqueo para con su motivo y nombra su archivo:
+  `AWAITING_REVIEW.md` para el checkpoint, `HUMAN_ACTIONS.md` —con las tareas trabadas— para la cola.
+
+  La otra es la que se ve al azar: el agente que transcribe el contexto a veces entrega el vacío como la
+  cadena de dos comillas, y eso frenaba la corrida en la fase 1 sin que hubiera nada que resolver. Medido
+  sobre siete corridas de una instancia real: 3 de 24 lecturas llegaron así, y una de cada siete cayó en
+  la única lectura que consulta el campo. Las formas equivocadas del vacío se desenvuelven antes de leer.
+
+  Y lo que no está en el vocabulario ya no se adivina en ninguna de las dos direcciones: no se sigue como
+  si no hubiera bloqueo ni se inventa cuál es — para diciendo que el contexto llegó fuera del
+  vocabulario. El esquema declara los tres valores, igual que `lane`; eso documenta el contrato, y lo que
+  sostiene el arreglo es la lectura.
+
 ## [0.77.0] - 2026-09-10
 
 ### Corregido

package/automatization/workflows/autobuild.js

@@ -38,6 +38,11 @@ const GATE = `${P}/AWAITING_REVIEW.md`
 const ROADMAP = `${P}/roadmap`
 
 // Estado de planning tal como lo emite `ops context --json`; ningún modelo parsea BACKLOG ni WIP.
+// De a pares, y sin regex: una comilla dentro de un literal de regex desincroniza a las dos puertas que
+// leen este archivo sin parsearlo —caso 084—, y de a pares es además lo correcto, porque una comilla
+// suelta no es un envoltorio. Por eso también la escapada en vez de alternar el estilo de comillas.
+const QUOTES = ['\'', '"']
+
 const CONTEXT = {
   type: 'object', additionalProperties: false,
   required: ['blocked', 'hasTask', 'wipActive', 'queued', 'cast', 'readOk'],
@@ -46,7 +51,13 @@ const CONTEXT = {
     // exactamente lo que un modelo completa cuando no tiene qué poner. Sin este campo esa invención se
     // lee igual que una cola terminada, y Pick la toma como permiso para promover.
     readOk: { type: 'boolean' },
-    blocked: { type: 'string' }, hasTask: { type: 'boolean' }, wipActive: { type: 'boolean' },
+    // Vocabulario cerrado, igual que `lane` acá abajo, y por la misma razón: el motor emite tres valores
+    // y nada más —`ops context` los decide con un `existsSync` y un conteo—, así que dejarlo como texto
+    // libre le pedía a quien lo transcribe que acertara una convención invisible. Un modelo que rellena
+    // «el valor vacío» puede escribir la cadena vacía o **escribir las comillas**, y las dos satisfacían
+    // el esquema: medido en una instancia real, 3 de 24 lecturas llegaron como `"\"\""` (caso 083).
+    blocked: { type: 'string', enum: ['', 'awaiting-review', 'blocked-on-human'] },
+    hasTask: { type: 'boolean' }, wipActive: { type: 'boolean' },
     queued: { type: 'integer' }, slug: { type: 'string' }, hito: { type: 'string' },
     service: { type: 'string' }, acceptance: { type: 'string' }, epic: { type: 'string' },
     // Sin declararlo acá no llega: `additionalProperties: false` lo descartaría, y el aplanado de la
@@ -364,7 +375,28 @@ if (!planning) return stop('context-unavailable', `no se pudo leer el estado de
 // Que el agente conteste no significa que haya leído: el schema se completa igual con ceros. Parar acá
 // cuesta una corrida; seguir sobre una lectura fallida escribe en el BACKLOG, y eso no se revierte solo.
 if (!planning.readOk) return stop('context-unavailable', `${P} no se pudo leer; revisá la ruta y el cwd`)
-if (planning.blocked) return stop('awaiting-human-review', `${GATE} tiene un checkpoint humano sin resolver`)
+// `blocked` se lee por su valor y no por su verdad. Como verdad, **cualquier** cadena no vacía frenaba la
+// corrida con el mismo motivo, y eso mentía dos veces: con `blocked-on-human` —la cola trabada por
+// acciones humanas, que es otra cosa— mandaba a mirar un gate que no existe, y eso no era intermitente;
+// y con la cadena `""` que a veces llega del transcriptor, frenaba sin que hubiera nada que resolver.
+//
+// El vacío se normaliza antes porque sus formas equivocadas no son ambiguas: dos comillas o unos espacios
+// no son ningún bloqueo legítimo. Lo que no se reconoce **no se adivina**: para diciendo que el contexto
+// llegó fuera del vocabulario, que es lo que esta familia de casos —056, 074, 075— pide para lo que no se
+// pudo determinar.
+let blocker = String(planning.blocked || '').trim()
+while (blocker.length > 1 && QUOTES.includes(blocker[0]) && blocker[blocker.length - 1] === blocker[0]) {
+  blocker = blocker.slice(1, -1).trim()
+}
+if (blocker === 'awaiting-review') {
+  return stop('awaiting-human-review', `${GATE} tiene un checkpoint humano sin resolver`)
+}
+if (blocker === 'blocked-on-human') {
+  return stop('blocked-on-human', `toda la cola espera una acción humana. Está en ${HUMAN}`
+    + `${(planning.blockedTasks || []).length ? `, sobre ${planning.blockedTasks.join(', ')}` : ''}`)
+}
+if (blocker) return stop('context-unavailable', `${P} contestó blocked=${JSON.stringify(planning.blocked)}, `
+  + 'que no es del vocabulario. No se sabe si hay bloqueo, así que no se sigue como si no lo hubiera.')
 
 let currentMilestone = planning.wipActive ? planning.hito : ''
 const completed = []

package/package.json

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