@ingeniomaps/cauce 0.98.0 → 0.99.1

package/CHANGELOG.md

@@ -14,6 +14,119 @@ 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.99.1] - 2026-09-25
+
+### Cambiado
+
+- **Una lectura de credencial que necesitás siempre se aprueba una vez.** Cuando el agente se frena leyendo
+  una credencial, te pregunta además si querés dejarla aprobada para siempre. Si esa es tu intención —con
+  tus palabras, sin frase fija—, él mismo escribe la ruta en `planning/.ops-approval` con quién lo aprobó y
+  para qué, y ninguna sesión vuelve a preguntarlo. Tu confirmación le deja escribir esa línea y ninguna otra.
+- **Confirmar el bloqueo de `.ops-approval` ahora aprueba.** Si el agente intenta escribir la aprobación sin
+  que se la hayas pedido, el bloqueo te muestra qué iba a agregar y tu «sí» lo deja pasar. Antes el bloqueo
+  ofrecía confirmar y la confirmación no hacía nada: sólo pasaba pidiéndolo con el nombre del archivo.
+- **El bloqueo dice cuánto dura una línea pegada**: hasta que alguien la borre. Decía que dejaba de valer
+  «en cuanto cambie», y una lectura siempre frena la misma ruta, así que nunca cambiaba.
+- **`check` nombra aparte las credenciales aprobadas** —«N credencial(es) aprobadas hasta que se borre su
+  línea»—, en vez de contarlas como una aprobación olvidada. Sigue mostrándolas en cada corrida.
+
+## [0.99.0] - 2026-09-24
+
+### Agregado
+
+- **`migrations.paths` en `ops.config.json`**: las carpetas donde viven tus migraciones, por ejemplo
+  `["migrations", "alembic/versions"]`. Si la declarás, reemplaza el default (`migrations`, `migration`,
+  `migrate`), que no alcanzaba a Alembic. `check` avisa la extensión o la carpeta declarada que no alcanza
+  a ningún archivo: una cobertura que declaraste y no cubre nada.
+
+### Cambiado
+
+- **`check` falla si una entrada de DONE tiene `tests:` todo `n/a` y su commit toca algo que no sea un
+  documento (`.md`, `.txt`, `.adoc`) o una imagen (`.png`, `.jpg`, `.jpeg`, `.gif`, `.svg`, `.webp`).** Es lo que vuelve creíble el `n/a` de arriba: lo demás se ejecuta y se prueba. Rige
+  para lo cerrado desde el 2026-09-24, así que tu historia anterior no se pone en rojo al actualizar.
+
+### Corregido
+
+- **Un aviso de una tarea de fondo ya no le borra a la persona lo que dijo.** Si un guard frenaba algo en el
+  turno de un aviso de un subagente, eso no quedaba esperando tu confirmación, y tu «dale» siguiente no
+  aprobaba nada. Ahora lo frenado espera tu respuesta aunque el aviso llegue antes que ella, y tu negativa
+  —«no toques el `.env`»— sigue valiendo después de un aviso sin depender del texto que el aviso traiga.
+
+- **Una negación sobre otra cosa ya no te hace perder un bloqueo.** «dale, fijate si esto no es un
+  defecto» dejaba lo frenado sin anotar, y tu «confirmo» siguiente no aprobaba nada. Ahora la respuesta se
+  lee en la primera parte del mensaje, y lo que negás nombrándolo —«dale, pero no el .env»— sigue sin
+  pasar, igual que un push si en cualquier parte decís que no se publique —«no hagas push todavía»—. Cuando algo no queda esperando tu confirmación, el bloqueo lo dice y te indica que lo pidas
+  nombrándolo, en vez de ofrecerte un «dale» que no iba a servir.
+
+- **Si lo que se frenó lo hacía un subagente, tu confirmación le llega.** Dentro de trabajo delegado —Build en
+  cada `autobuild`— el bloqueo no ofrecía el chat: decías que sí y el reintento volvía a frenar con el mismo
+  mensaje, y la única salida era pegar la línea en `planning/.ops-approval`. Ahora el subagente devuelve el
+  bloqueo para que te lo pregunten, y lo que confirmes pasa aunque lo reintente otro subagente. Sólo eso: un
+  pedido tuyo que nombraba algo sigue valiendo para el agente con el que hablás, no para un subagente.
+
+- **Sin nadie en el chat, el bloqueo ya no le ordena al agente que se escriba la aprobación.** Decía «Aprobalo
+  pegando tal cual en…», y el agente lo leía como una orden que su contrato le prohíbe. Ahora dice que las
+  líneas las pega una persona, y al agente qué hacer mientras tanto.
+
+- **El gate de commit reconoce el código de sqlc donde lo pongas.** Sólo aceptaba el generado bajo una
+  carpeta `sqlc/` o `generated/`, así que un `out` como `internal/platform/pgdb/` pedía aprobación en cada
+  commit que tocaba una consulta aunque hubieras regenerado. Ahora reconoce `*.sql.go` en cualquier carpeta.
+  Y ve una consulta en cualquier carpeta `queries/` —`api/db/queries/` en un monorepo—, que antes se
+  commiteaba sin su generado sin que nada avisara; eso sólo si el repositorio tiene `sqlc.yaml`, `sqlc.yml`
+  o `sqlc.json`. Si frena, dice qué buscó. Límite: con `output_files_suffix` el generado no se reconoce.
+
+- **Un guard invocado a mano ya no se queda colgado.** Lanzado fuera del runner —a mano, desde un script o
+  en segundo plano— con stdin abierto y sin datos, esperaba hasta que el otro extremo cerrara: horas, sin
+  llegar a correr. Ahora, si en 2 s no llega nada, bloquea y explica cómo invocarlo: con el JSON del hook
+  por stdin, o sin entrada con `</dev/null`. Lo que manda el runner se lee entero, así que una escritura
+  grande no se corta, y un JSON completo se juzga aunque quien lo mandó no cierre stdin.
+
+- **Una tarea cuyo entregable es un documento o una decisión escrita ya puede cerrarse en `autobuild`.**
+  Paraba en `verify-hollow` pidiendo pruebas imposibles. Ahora Verify declara esos criterios sin superficie
+  ejecutable, llegan a Done como `tests: n/a — <razón>`, y QA comprueba que el documento exista y cubra lo
+  que la aceptación enumera. Con causas mezcladas, el rebote pide sólo las pruebas que de verdad faltan, y
+  Done recibe de Verify qué prueba cubre cada criterio en vez de componerlo de memoria.
+
+- **Una condición marcada `(fuera de verify: <razón>)` ya no llega a Verify ni a QA.** Era la salida que
+  `check` recomienda, y la corrida paraba igual; ahora viaja a Done para quedar cumplida en `tests:`, `qa:`
+  o `commit:`.
+
+- **El guard de migraciones ya no frena la reversión honesta.** Buscaba en todo el archivo, así que el
+  `DROP TABLE` del `-- +goose Down` frenaba cada tabla nueva y una migración sin `Down` pasaba. Ahora, en
+  goose y dbmate, juzga sólo el bloque que aplica; un `*.down.sql` es reversión entera; corregir el `Down`
+  con una edición también pasa; y el mensaje dice en qué bloque está lo que frena.
+
+- **Si declarás `migrations.extensions`, el guard ve también el borrado escrito con la API del ORM**, no
+  sólo el SQL crudo: `op.drop_table`/`drop_column` (Alembic), `drop_table`, `remove_column(s)` y
+  `drop_join_table` (Rails), `dropTable`/`dropColumn(s)` (TypeORM), `dropTable(IfExists)`/`dropColumn`
+  (Knex) y `DeleteModel`/`RemoveField` (Django). La reversión —`downgrade()`, `down`— no se juzga.
+
+- **El puente de Antigravity ya no deja pasar lo que no puede leer.** Ante un JSON ilegible respondía
+  `allow`: un `git push --force` al que le faltaba una llave pasaba. Y con stdin abierto se colgaba. Ahora
+  lee con el mismo lector que los guards: lo ilegible se niega en `pre-shell` y `pre-files`, si en 2 s no
+  llega nada niega y dice cómo invocarlo a mano, y en `stop` deja cerrar con el motivo a la vista. Sin
+  entrada (`</dev/null`) sigue permitiendo, como antes.
+
+- **El puente de Antigravity niega una llamada que no sabe describir.** Leía cada campo por un nombre fijo,
+  así que una llamada con otra forma —un campo renombrado en una actualización del runner— llegaba vacía a
+  los guards y pasaba: todos apagados sin avisar. Ahora un `pre-shell` sin comando o un `pre-files` sin
+  archivo se niegan, y el motivo nombra los campos que sí llegaron.
+
+- **El gate de commit reconoce una especificación OpenAPI por lo que declara, no por la carpeta.** Cualquier
+  `.yaml` bajo `api/`, `openapi/` o `spec/` pedía regenerar el cliente: una config de sqlc, un compose o un
+  fixture ahí frenaban cada commit. Ahora cuenta el que declara `openapi:` o `swagger:`, o un fragmento de una
+  carpeta que tiene uno.
+
+- **En Codex, el guard de migraciones juzga cada archivo del parche por separado.** Un `apply_patch` llegaba
+  como un solo sobre: los marcadores de goose y dbmate venían con el `+` del parche y no partían, así que la
+  reversión honesta volvía a frenar, y un `DROP TABLE` citado en otro archivo del mismo parche frenaba la
+  migración. Ahora cada archivo se juzga por su sección, y en una modificación sólo lo agregado.
+
+- **`automation doctor` de Antigravity mira la copia que `agy` ejecuta de verdad.** `agy` corre la que registrás
+  con `agy plugin install`, una por usuario, y `doctor` miraba la del workspace: decía «operativo» mientras `agy`
+  ejecutaba el plugin de otro proyecto o uno roto, y frenaba cada comando. Ahora compara las dos, lanza la
+  registrada como la lanza `agy`, y si difiere te dice qué comando corre para registrar esta instalación.
+
 ## [0.98.0] - 2026-09-17
 
 ### Cambiado

package/agents/roles/system/ai-product-manager/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/analytics-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/backend-engineer/learning/HISTORY.md

@@ -5,3 +5,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | Nada: el período se revisó y se decidió no cambiar ningún contrato. |
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/cloud-architect/learning/HISTORY.md

@@ -5,3 +5,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-30 | `agents/roles/system/cloud-architect/learning/proposals/2026-08.md` | Aprobada | @ingeniomaps | `agents/roles/system/cloud-architect/SKILL.md` |
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/customer-success-manager/learning/HISTORY.md

@@ -5,3 +5,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `SKILL.md` (párrafo nuevo al final de «Construir contexto»); `learning/proposals/2026-08.md`. Dos desviaciones, escritas al final de «Aprobación humana» de la propuesta: (1) los ejemplos del párrafo se adaptaron al vocabulario del cargo —la propuesta autoriza adaptar la redacción y la licencia se usó sólo en esa lista: donde decía «Delighted, una herramienta de analítica», el `SKILL.md` dice «la encuesta de NPS o CSAT, el producto de analítica», porque Delighted es el proveedor del caso `07-nps-que-subio` y nombrarlo metía un caso de evaluación dentro del contrato del cargo—; el resto entró literal, incluida «abstenerse cubre lo que no se puede consultar, no lo que cuesta abrir una página», y en la ubicación que la propuesta fija; (2) no se re-corrió `07-nps-que-subio`, que la sección «Evaluación» pide como confirmación: esta aplicación se limitó a «Cambio propuesto», y hasta que exista ese veredicto el efecto del párrafo en este cargo no está medido. Sin caso adversarial nuevo: la propuesta acota el cambio al párrafo y nada más. |
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/data-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/data-governance-steward/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/devops-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/engineering-manager/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/engineering-manager/learning/sources.yaml

@@ -17,7 +17,7 @@ sources:
     tier: profession
     topics: [developer-productivity, wellbeing, flow, collaboration]
   - name: Google re Work team effectiveness
-    url: https://rework.withgoogle.com/intl/en/guides/understanding-team-effectiveness
+    url: https://rework.withgoogle.com/intl/en/guides/understand-team-effectiveness
     tier: profession
     topics: [psychological-safety, effectiveness]
   - name: ACM Code of Ethics

package/agents/roles/system/engineering-manager/references/operating-model.md

@@ -54,7 +54,7 @@ Combinar satisfacción/bienestar, performance/outcomes, actividad contextual, co
 
 - [DORA Capabilities](https://dora.dev/capabilities/): entrega sostenible, feedback, cultura y desempeño organizacional.
 - **SPACE Framework**, ACM Queue 19(1) (sin enlace: `queue.acm.org` bloquea): productividad multidimensional, no reducible a actividad.
-- [Google re:Work — Understand team effectiveness](https://rework.withgoogle.com/intl/en/guides/understanding-team-effectiveness): seguridad psicológica, confiabilidad, estructura, significado e impacto.
+- [Google re:Work — Understand team effectiveness](https://rework.withgoogle.com/intl/en/guides/understand-team-effectiveness): seguridad psicológica, confiabilidad, estructura, significado e impacto.
 - [ACM Code of Ethics](https://www.acm.org/binaries/content/assets/about/acm-code-of-ethics-booklet.pdf): bienestar, justicia, privacidad, competencia y liderazgo responsable.
 
 Verificar políticas laborales, jurisdicción y contexto real de cada empresa.

package/agents/roles/system/machine-learning-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/mlops-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/mobile-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/product-manager/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/site-reliability-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/software-architect/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/ui-designer/learning/HISTORY.md

@@ -6,3 +6,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 |---|---|---|---|---|
 | 2026-08-30 | `agents/roles/system/ui-designer/learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `agents/roles/system/ui-designer/SKILL.md` |
 | 2026-08-30 | `agents/roles/system/ui-designer/learning/proposals/2026-09.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | `agents/roles/system/ui-designer/SKILL.md` |
+| 2026-09-01 | `2026-09-r2.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/automatization/hooks/README.md

@@ -12,7 +12,8 @@ Los hooks convierten invariantes comprobables en gates mecánicos. La base recom
 - cierre de sesión con planning o integraciones inválidas;
 - modificación del protocolo durante una tarea de producto.
 - escrituras fuera de las raíces declaradas del workspace;
-- reescritura de migraciones y SQL destructivo;
+- reescritura de migraciones y borrado destructivo —SQL o la API del ORM— en la parte que aplica, no en su
+  reversión; qué carpetas y extensiones son migraciones lo declara `migrations` en `ops.config.json`;
 - publicación, instalaciones globales y drift entre manifests y lockfiles.
 
 La lógica portable vive en `engine/hooks/run.js`; los `guard-*.sh` son entradas ejecutables comunes. Cada
@@ -84,7 +85,10 @@ guards lo leen:
 
 No cuenta cuando no hay persona —CI, o un aviso del runner como el de un subagente que terminó—, cuando lo
 que pidió es un recorrido de Cauce (`/autobuild`, `$flow`…), ni en la llamada de un subagente, que Claude
-marca con `agent_id`. En Claude y Codex cada llamada trae el identificador del mensaje que la originó;
+marca con `agent_id`: a un subagente no le llega lo que ella pidió ni lo que se le concedió antes. Sí le
+llega su confirmación a un bloqueo, que nombra exactamente lo frenado: el bloqueo de un subagente le pide
+devolverlo a quien lo lanzó para que se lo pregunte, y lo que ella confirme pasa aunque lo reintente otro
+subagente. En Claude y Codex cada llamada trae el identificador del mensaje que la originó;
 Gemini no lo manda, y ahí vale el último mensaje. El registro vive en el temporal del sistema, uno por
 sesión, y los guards de límites lo cuidan junto con `planning/.ops-approval`: el registro no lo escribe
 nunca una herramienta, y en la aprobación sólo entran las líneas que la persona nombró en ese mismo

package/automatization/runners/antigravity/README.md

@@ -19,7 +19,10 @@ usuario y no por workspace. De ahí salen tres consecuencias que conviene tener
 - Registrar desde otro proyecto reemplaza el plugin del anterior.
 
 Volvé a registrar cada vez que `automation install` cambie el wiring o el proyecto se mueva de lugar;
-`agy plugin validate .agents/plugins/cauce` comprueba la copia del repo antes de registrarla.
+`agy plugin validate .agents/plugins/cauce` comprueba la copia del repo antes de registrarla. Si te
+olvidás, `automation doctor` lo dice: compara la copia registrada con la del workspace y la lanza como
+la lanza `agy`, desde su carpeta, así que una copia de otro proyecto o de otra versión es un error con el
+comando que lo corrige. Al instalar es una advertencia, porque registrar es justo el paso que sigue.
 
 El plugin aporta hooks `PreToolUse` y `Stop`, reglas Cauce y los cinco recorridos —`/cauce:onboard`,
 `/cauce:flow`, `/cauce:autobuild`, `/cauce:integration-sync` y `/cauce:integration-promote`— más el

package/automatization/runners/antigravity/hook.js

@@ -4,13 +4,6 @@
 const fs = require('node:fs')
 const path = require('node:path')
 
-function readInput() {
-  try {
-    const raw = fs.readFileSync(0, 'utf8')
-    return raw.trim() ? JSON.parse(raw) : {}
-  } catch { return {} }
-}
-
 // Dónde quedó la raíz ops respecto de la carpeta que Antigravity abre. Lo completa
 // `automation install`, que es el único momento en que se sabe: en modo sidecar la raíz ops es un
 // hermano de los repos de producto, y ninguna búsqueda hacia arriba la encuentra. Sin esto el bridge
@@ -78,18 +71,39 @@ function findRoot(input, markers = MARKERS) {
   throw new Error('No se encontró una raíz Cauce desde el workspace de Antigravity.')
 }
 
-function runtimeAt(root) {
+function engineAt(root, file) {
   const candidates = [
-    path.join(root, 'node_modules', '@ingeniomaps', 'cauce', 'engine', 'hooks', 'run.js'),
-    path.join(root, 'engine', 'hooks', 'run.js'),
-    path.join(root, '..', 'node_modules', '@ingeniomaps', 'cauce', 'engine', 'hooks', 'run.js'),
+    path.join(root, 'node_modules', '@ingeniomaps', 'cauce', 'engine', 'hooks', file),
+    path.join(root, 'engine', 'hooks', file),
+    path.join(root, '..', 'node_modules', '@ingeniomaps', 'cauce', 'engine', 'hooks', file),
   ]
   // Copia de `packagePath`; su porqué vive allá. Son tres los que la repiten y el motor los nombra.
-  const runtime = candidates.find(fs.existsSync)
+  return candidates.find(fs.existsSync) || ''
+}
+
+function runtimeAt(root) {
+  const runtime = engineAt(root, 'run.js')
   if (!runtime) throw new Error('No se encontró el runtime engine/hooks/run.js.')
   return require(runtime)
 }
 
+// La entrada se lee con el lector del motor y no con uno propio: el puente tenía su copia, y la copia se
+// colgaba con stdin abierto y convertía un JSON ilegible en `allow` (caso 198). Lo que no se puede usar para
+// encontrarlo es la entrada misma, que todavía no se leyó: se busca como `findRoot` sin entrada —la raíz que
+// `install` dejó escrita y, si no resuelve, desde donde corre el puente—. Sólo la declarada dejaba sin
+// lector, negando cada llamada, a un proyecto movido que los guards sí encontraban. Sin ninguna, se niega.
+function inputReader(markers = MARKERS) {
+  let root = ''
+  try { root = findRoot({}, markers) } catch { /* sin raíz no hay motor: lo dice el error de abajo */ }
+  const reader = root && engineAt(root, 'input.js')
+  if (!reader) {
+    throw new Error('No se encontró engine/hooks/input.js, con el que se lee la entrada, ni en la raíz que '
+      + `automation install declaró (${declaredRoot(markers) || 'ninguna'}) ni desde ${process.cwd()}. `
+      + 'Reinstalá el runner.')
+  }
+  return require(reader)
+}
+
 // La carpeta que el runner abrió, deducida de la raíz: en sidecar la raíz ops es su hija, y en modo
 // embebido son la misma.
 function workspaceOf(root, markers) {
@@ -134,6 +148,47 @@ function respond(value) {
   process.stdout.write(`${JSON.stringify(value)}\n`)
 }
 
+function refusal(event, message, blocking) {
+  const reason = `Cauce: ${message}`
+  if (event !== 'stop') return { decision: 'deny', reason }
+  // Un guard que bloquea marca su error con `blocked` (engine/hooks/run.js); cualquier otro es que el
+  // puente no llegó a juzgar nada. En `stop` los dos devolvían `continue`, y eso ata al agente: la
+  // raíz que no resuelve no se arregla sola, así que cada intento de cerrar repite el mismo error.
+  // El bloqueo sigue dando `continue` —es el mecanismo funcionando—; la falla deja cerrar y avisa.
+  return blocking ? { decision: 'continue', reason } : { decision: 'stop', reason }
+}
+
+// Lo que cada evento tiene que traer para que sus guards juzguen algo. `normalize` lee campos por nombre y
+// convierte en `''` el que no encuentra, así que una llamada con otra forma —un campo renombrado en una
+// actualización de Antigravity— llegaba vacía a los guards, ninguno frenaba y el puente respondía `allow`:
+// todos los guards apagados sin rastro (caso 200). Cerrado por defecto: sin lo que el evento juzga, se niega
+// y se dice qué llegó, que es lo que hace falta para enseñarle la forma nueva a `normalize`.
+//
+// Una entrada vacía no es una llamada con otra forma: no describe ninguna, y es como se invoca a mano, con
+// `OPS_HOOK_COMMAND` u `OPS_HOOK_FILE` (caso 198).
+const DESCRIBED_BY = {
+  'pre-shell': { field: 'command', names: 'CommandLine' },
+  'pre-files': { field: 'file_path', names: 'TargetFile ni AbsolutePath' },
+}
+
+// Un archivo sin su contenido tampoco se puede juzgar: los guards que miran qué se escribe —secretos,
+// migraciones— verían un texto vacío. Basta que el campo esté; vacío es un archivo vacío.
+const CONTENT_FIELDS = ['CodeContent', 'ReplacementContent', 'ReplacementChunks']
+
+function undescribed(event, input, normalized) {
+  const need = DESCRIBED_BY[event]
+  if (!need || !Object.keys(input).length) return ''
+  const fields = (input.toolCall && input.toolCall.args) || {}
+  const args = Object.keys(fields)
+  const missing = !normalized.tool_input[need.field] ? need.names
+    : event === 'pre-files' && !CONTENT_FIELDS.some((field) => field in fields)
+      ? 'CodeContent, ReplacementContent ni ReplacementChunks' : ''
+  if (!missing) return ''
+  const received = args.length ? `toolCall.args trae ${args.join(', ')}` : `llegó ${Object.keys(input).join(', ')}`
+  return `la llamada no trae ${missing}, así que no hay nada que juzgar y no se autoriza (${received}). Si `
+    + 'Antigravity cambió el formato de sus llamadas, el puente tiene que aprenderlo en normalize().'
+}
+
 function evaluate(event, input) {
   try {
     const root = findRoot(input)
@@ -141,23 +196,30 @@ function evaluate(event, input) {
     const hooks = runtimeAt(root)
     const normalized = normalize(input, root)
     if (!hooks.hookGroups[event]) throw new Error(`Evento Antigravity desconocido: ${event || '(vacío)'}`)
+    const missing = undescribed(event, input, normalized)
+    if (missing) throw new Error(missing)
     hooks.executeAll([event], normalized)
     return event === 'stop' ? { decision: 'stop' } : { decision: 'allow' }
   } catch (error) {
-    const reason = `Cauce: ${error.message}`
-    if (event !== 'stop') return { decision: 'deny', reason }
-    // Un guard que bloquea marca su error con `blocked` (engine/hooks/run.js); cualquier otro es que el
-    // puente no llegó a juzgar nada. En `stop` los dos devolvían `continue`, y eso ata al agente: la
-    // raíz que no resuelve no se arregla sola, así que cada intento de cerrar repite el mismo error.
-    // El bloqueo sigue dando `continue` —es el mecanismo funcionando—; la falla deja cerrar y avisa.
-    return error.blocked ? { decision: 'continue', reason } : { decision: 'stop', reason }
+    return refusal(event, error.message, error.blocked)
   }
 }
 
-function main() {
-  respond(evaluate(process.argv[2], readInput()))
+async function main(event = process.argv[2]) {
+  let input
+  try {
+    const engine = inputReader()
+    const usage = 'pasale el JSON de Antigravity —printf \'%s\' '
+      + `'{"toolCall":{"args":{"CommandLine":"…"}}}' | node hook.js ${event || '<evento>'}—`
+    input = await engine.readInput(process.stdin, engine.FIRST_BYTE_MS, usage)
+  } catch (error) {
+    // El lector del motor marca `blocked` lo que no pudo leer, porque para un guard eso es bloquear. Acá
+    // es el puente sin nada que juzgar, y en `stop` eso deja cerrar: reintentar no arregla la entrada.
+    return respond(refusal(event, error.message, false))
+  }
+  respond(evaluate(event, input))
 }
 
 if (require.main === module) main()
 
-module.exports = { evaluate, findRoot, normalize }
+module.exports = { evaluate, findRoot, normalize, inputReader }

package/automatization/runners/antigravity/manifest.json

@@ -52,6 +52,7 @@
   "roleSkills": ".agents/plugins/cauce/skills",
   "activation": {
     "hint": "agy plugin install .agents/plugins/cauce",
+    "registered": "~/.gemini/config/plugins/cauce",
     "verify": [
       "plugin",
       "list"

package/automatization/shared/acceptance.js

@@ -0,0 +1,26 @@
+// Cómo se lee una aceptación, compartido por las dos puntas que la juzgan: `check`, que avisa sobre la
+// cola, y `autobuild`, que la manda a Verify. Vive acá y no en el motor porque el recorrido no puede hacer
+// `require` —se renderiza con `{{INCLUDE:}}`— y el motor sí puede leer este archivo: lo carga
+// `engine/planning/acceptance.js`. Escrito dos veces, una copia dejaba de reconocer lo que la otra pedía
+// escribir, que es exactamente el caso 195: `check` ofrecía una marca que el recorrido no conocía.
+
+// Una condición por tramo separado con `;`, el grano con el que Verify contrasta —su `uncovered` enumera
+// criterios— y con el que `check` avisa.
+const acceptanceConditions = (acceptance) => String(acceptance || '').split(';')
+  .map((one) => one.trim()).filter(Boolean)
+
+// La salida explícita, con la forma que el repositorio ya usa dos veces: `(sin partir: …)` para el umbral
+// de R17 y `n/a — razón` para `tests:` y `commit:`. Acá vale lo mismo que allá —«como lleva su razón
+// escrita se lee en el propio artefacto sin que nadie la cruce»— y por eso no se intenta adivinar si la
+// prosa excluye a Verify. Adivinarlo es lo que no se puede: la única aceptación real que nombra el commit
+// lo hace justamente para decir que no es condición de Verify, y cualquier lista de frases que la
+// reconociera enseñaría a escribir esa frase exacta para silenciar el aviso.
+const OUT_OF_VERIFY = /\(fuera de verify:\s*[^)]+\)/i
+
+// Lo que no se ejecuta, y por eso lo único que un criterio `no-surface` puede haber producido (caso 189).
+// Es la lista a favor y no la de lo ejecutable a propósito (R27): un `.sql` de migración, un workflow en
+// YAML, un `Dockerfile`, un `Makefile` o un `.json` de configuración se ejecutan sin parecer código, y una
+// lista de lo ejecutable dejaría afuera lo que venga después. Ampliarla es un cambio con su razón al lado.
+// Las imágenes entraron porque un ADR suele traer su diagrama, y sin ellas ese commit contaba como código.
+// Lo que no tiene extensión sigue contando como ejecutable: `Makefile` y `Dockerfile` no la tienen.
+const NON_EXECUTABLE = ['.md', '.txt', '.adoc', '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp']

package/automatization/workflows/agent-promote.js

@@ -184,9 +184,11 @@ await agent(
 // Sellar es lo último: hasta que el cambio no está aplicado y registrado, la propuesta sigue
 // pendiente. Lo hace el motor y no vos, a mano, porque marcar el estado editando frontmatter es
 // exactamente el paso que se hace mal en silencio.
+// En el toolkit, sellar además anota el cambio en el CHANGELOG para que salga en la versión siguiente.
+// Un mes sin cambios no le cambia nada a quien actualiza, y `--unchanged` lo deja fuera.
 await agent(
   `From ${ROOT}, run "node ${signature.cli || 'tools/ops.js'} ` +
-  `learn ${AGENT} --applied --period ${PERIOD}" and report only ` +
+  `learn ${AGENT} --applied --period ${PERIOD}${NOTHING ? ' --unchanged' : ''}" and report only ` +
   `what it printed. Change nothing else.`,
   { label: 'sella' },
 )