@ingeniomaps/cauce 0.97.0 → 0.99.0

package/agents/roles/system/sales-representative/learning/AUTOMATION.md

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en ventas responsables y procesos comerciales para
@@ -15,4 +15,4 @@ no compres listas, envíes outreach, publiques, hagas commit ni push. Termina co
 `make agent-evaluate AGENT=sales-representative`.
 ```
 
-Programar semanalmente en cada instalación.
+Programar mensualmente en cada instalación.

package/agents/roles/system/security-engineer/learning/AUTOMATION.md

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en Security Engineering para mantener
@@ -16,4 +16,4 @@ hagas commit ni push. Termina con
 `make agent-evaluate AGENT=security-engineer`.
 ```
 
-Programar semanalmente en cada instalación.
+Programar mensualmente en cada instalación.

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

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en Site Reliability Engineering para mantener
@@ -15,4 +15,4 @@ no ejecutes carga, caos, failover, publiques, hagas commit ni push. Termina con
 `make agent-evaluate AGENT=site-reliability-engineer`.
 ```
 
-Programar semanalmente en cada instalación.
+Programar mensualmente en cada instalación.

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

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en Software Architecture para mantener
@@ -15,4 +15,4 @@ no generes migraciones, publiques, hagas commit ni push. Termina con
 `make agent-evaluate AGENT=software-architect`.
 ```
 
-Programar semanalmente en cada instalación.
+Programar mensualmente en cada instalación.

package/agents/roles/system/solutions-engineer/learning/AUTOMATION.md

@@ -1,6 +1,6 @@
 # Automatización de aprendizaje
 
-## Semanal con Codex
+## Mensual con Codex
 
 Ejecutar `make agent-learn AGENT=solutions-engineer`. Completar el informe generado con novedades relevantes, versiones, aplicabilidad, evidencia primaria, impacto y recomendación. Investigar no autoriza cambiar `SKILL.md`, materiales, producto ni sistemas.
 

package/agents/roles/system/tech-lead/learning/AUTOMATION.md

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en la práctica de liderazgo técnico —revisión y aprobación
@@ -22,4 +22,4 @@ apruebes, despliegues, hagas commit ni push, y no autorices gasto. Termina con
 `make agent-evaluate AGENT=tech-lead`.
 ```
 
-Programar semanalmente en cada instalación.
+Programar mensualmente en cada instalación.

package/agents/roles/system/technical-program-manager/learning/AUTOMATION.md

@@ -1,6 +1,6 @@
 # Automatización de aprendizaje
 
-## Semanal con Codex
+## Mensual con Codex
 
 Ejecutar `make agent-learn AGENT=technical-program-manager`. Registrar fuentes primarias, estándar/versión/estado, fit organizacional, evidencia de outcome y validación de owners. Investigar no autoriza cambiar planes, compromisos o sistemas.
 

package/agents/roles/system/technical-writer/learning/AUTOMATION.md

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en Technical Writing y documentación de software

package/agents/roles/system/treasury-analyst/learning/AUTOMATION.md

@@ -1,4 +1,4 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
 ```text
 Investiga cambios recientes en tesorería corporativa, liquidez y pagos salientes para mantener
@@ -17,4 +17,4 @@ no actualices SKILL.md, código ni planificación; no publiques, hagas commit ni
 con `make agent-evaluate AGENT=treasury-analyst`.
 ```
 
-Programar semanalmente en cada instalación.
+Programar mensualmente en cada instalación.

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

@@ -1,6 +1,6 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
-Configurar una automatización semanal con este prompt:
+Configurar una automatización mensual con este prompt:
 
 ```text
 Investiga cambios recientes en UI Design para mantener agents/roles/system/ui-designer.
@@ -16,4 +16,4 @@ permiso, publiques, hagas commit ni push. Termina ejecutando
 `make agent-evaluate AGENT=ui-designer`.
 ```
 
-La frecuencia recomendada es semanal; cada instalación define el horario.
+La frecuencia recomendada es mensual; cada instalación define el horario.

package/agents/roles/system/user-researcher/learning/AUTOMATION.md

@@ -1,6 +1,6 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
-Configurar una automatización semanal en la raíz del repositorio con este prompt:
+Configurar una automatización mensual en la raíz del repositorio con este prompt:
 
 ```text
 Investiga cambios recientes en User Research para mantener el agente
@@ -19,4 +19,4 @@ contactes participantes, accedas a datos personales, publiques, hagas commit ni
 push. Termina ejecutando `make agent-evaluate AGENT=user-researcher`.
 ```
 
-La frecuencia recomendada es semanal; cada instalación elige día y hora.
+La frecuencia recomendada es mensual; cada instalación elige día y hora.

package/agents/roles/system/ux-designer/learning/AUTOMATION.md

@@ -1,6 +1,6 @@
-# Automatización semanal del aprendizaje
+# Automatización mensual del aprendizaje
 
-Configurar una automatización semanal con este prompt:
+Configurar una automatización mensual con este prompt:
 
 ```text
 Investiga cambios recientes en UX Design para mantener agents/roles/system/ux-designer.
@@ -15,4 +15,4 @@ referencias, evaluaciones, fuentes ni planificación; no publiques, hagas commit
 ni push. Termina con `make agent-evaluate AGENT=ux-designer`.
 ```
 
-La frecuencia recomendada es semanal; cada instalación define el horario.
+La frecuencia recomendada es mensual; cada instalación define el horario.

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
@@ -74,16 +75,20 @@ guards lo leen:
 
 - lo que la persona **pidió nombrándolo** pasa: «leé el `.env`» autoriza leer el `.env`; «no toques el
   `.env`» no, y tampoco una pregunta o un comentario que sólo lo nombra —«¿qué tiene el `.env`?»—;
-- lo que se frenó sin que lo nombrara queda anotado, y un «dale» en el mensaje siguiente aprueba
-  exactamente eso;
+- lo que se frenó sin que lo nombrara queda anotado, y su confirmación en el mensaje siguiente —con las
+  palabras que sea— aprueba exactamente eso. Si ese mensaje niega, frena o pregunta, no aprueba nada; y lo
+  que se frenó mientras ella decía que no, no queda esperando;
 - lo que un guard dejó pasar porque ella lo pidió sigue valiendo mientras dure la sesión, **salvo en los
   gates de un commit** —`governance`, `verify` y `dependencies`—, que preguntan cada vez: ahí vale lo que
-  pidió el mensaje en curso o un «dale», igual que para publicar;
+  pidió el mensaje en curso o su confirmación al bloqueo, igual que para publicar;
 - `plan-first` no aplica: el plan es del trabajo que va por tareas.
 
 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-propose.js

@@ -1,6 +1,6 @@
 // Convierte la recomendación de los informes en el cambio concreto que una persona puede aprobar.
 //
-// `learn --proposal` consolida qué recomendaron los informes de la semana, pero deja «Cambio
+// `learn --proposal` consolida qué recomendaron los informes de investigación, pero deja «Cambio
 // propuesto: por definir». Eso no es aprobable: nadie firma una intención. Este recorrido escribe el
 // texto exacto que habría que agregar, archivo por archivo, y lo contrasta contra los casos
 // adversariales vigentes antes de proponerlo.
@@ -70,7 +70,7 @@ phase('Proponer')
 
 const proposal = await agent(
   `Sos quien mantiene el cargo ${AGENT}. La propuesta ${context.proposal} consolidó lo que ` +
-  `recomendaron los informes semanales, pero le falta lo único que una persona puede aprobar: el ` +
+  `recomendaron los informes de investigación, pero le falta lo único que una persona puede aprobar: el ` +
   `cambio concreto.\n\n` +
   `Leé los informes citados en su sección «Hallazgos», el SKILL.md del cargo, ` +
   `${context.dir}/learning/sources.yaml, ${context.dir}/evaluations/expected-behaviors.yaml y sus ` +