@ingeniomaps/cauce 0.5.4 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,29 @@ esa operación sea confiable en vez de sólo cómoda: acá se lee qué cambió a
 un cambio en el protocolo, en las reglas del sistema o en un guard es visible para el usuario y sube
 minor aunque no toque una sola línea de código.
 
+## [0.6.0] - 2026-08-15
+
+### Cambiado
+
+- **Gemini deja de ser el runner sin guards.** Gemini CLI ganó hooks y skills nativas, y el adaptador
+  seguía tratándolo como si no los tuviera: los guards se pedían como prechecks manuales —o sea,
+  nadie lo detenía— y los 47 cargos no llegaban. Ahora recibe hooks reales en `.gemini/settings.json`
+  con sus propios eventos (`BeforeTool`, `AfterAgent`) y variable (`$GEMINI_PROJECT_DIR`), y el
+  catálogo completo en `.gemini/skills/`.
+- `GEMINI.md` avisa de dos cosas que sólo se ven usándolo: Gemini **desactiva los hooks si la carpeta
+  no es de confianza**, y `gemini hooks migrate --from-claude` reescribe `settings.json` entero y se
+  lleva puesta el resto de la configuración.
+
+## [0.5.5] - 2026-08-15
+
+### Corregido
+
+- Los comandos de Gemini y las skills de Antigravity también resuelven sus rutas contra la carpeta
+  donde se abre la herramienta. Quedaron afuera al marcar el resto: los `.toml` mandaban a leer
+  `planning/PROTOCOL.md` y las skills `AGENTS.md`, que desde la raíz de la compañía no existen.
+- Un test recorre todo lo que un adaptador copia y falla si una ruta da por sentado dónde se instala.
+  Revisando archivo por archivo se escapó tres veces; ahora cubre también lo que se agregue después.
+
 ## [0.5.4] - 2026-08-15
 
 ### Corregido

package/automatization/runners/antigravity/skills/autobuild/SKILL.md

@@ -3,8 +3,8 @@ name: autobuild
 description: Ejecuta el siguiente hito aprobado siguiendo el protocolo Cauce.
 ---
 
-Lee completos `AGENTS.md`, `planning/PROTOCOL.md` y `planning/WIP.md`. Si existe
-`planning/AWAITING_REVIEW.md`, detente y explica la acción humana pendiente. Toma solamente la primera tarea
+Lee completos `{{OPS_DIR}}AGENTS.md`, `{{OPS_DIR}}planning/PROTOCOL.md` y `{{OPS_DIR}}planning/WIP.md`. Si existe
+`{{OPS_DIR}}planning/AWAITING_REVIEW.md`, detente y explica la acción humana pendiente. Toma solamente la primera tarea
 aprobada, persiste el estado en WIP y ejecuta Build, Review, Verify y QA en orden. Usa los comandos reales del
 servicio, registra evidencia verificable en DONE y detente en el checkpoint entre hitos. No hagas push ni
 deploy.

package/automatization/runners/antigravity/skills/integration-promote/SKILL.md

@@ -3,8 +3,8 @@ name: integration-promote
 description: Promueve un borrador remoto ya revisado al roadmap local de Cauce.
 ---
 
-Lee `AGENTS.md`, `planning/PROTOCOL.md` e `integrations/README.md`. Verifica que el draft solicitado exista y
+Lee `{{OPS_DIR}}AGENTS.md`, `{{OPS_DIR}}planning/PROTOCOL.md` e `{{OPS_DIR}}integrations/README.md`. Verifica que el draft solicitado exista y
 esté marcado `ready`; nunca marques como listo contenido por iniciativa propia. Ejecuta
-`node tools/ops.js integration promote . <provider> <remote-key>`, valida con
-`node tools/ops.js check planning` y reporta el archivo creado. La promoción es local: no escribas en el
+`node {{OPS_DIR}}tools/ops.js integration promote {{OPS_DIR}}. <provider> <remote-key>`, valida con
+`node {{OPS_DIR}}tools/ops.js check planning` y reporta el archivo creado. La promoción es local: no escribas en el
 proveedor remoto.

package/automatization/runners/antigravity/skills/integration-sync/SKILL.md

@@ -3,7 +3,7 @@ name: integration-sync
 description: Sincroniza en modo lectura un proveedor externo hacia el staging local de Cauce.
 ---
 
-Lee `AGENTS.md`, `planning/PROTOCOL.md` e `integrations/README.md`. Confirma que el proveedor esté habilitado
-y ejecuta `node tools/ops.js integration check . <provider>` antes de sincronizar. Ejecuta después
-`node tools/ops.js integration sync . <provider>`. No edites snapshots manualmente, no cambies datos remotos
+Lee `{{OPS_DIR}}AGENTS.md`, `{{OPS_DIR}}planning/PROTOCOL.md` e `{{OPS_DIR}}integrations/README.md`. Confirma que el proveedor esté habilitado
+y ejecuta `node {{OPS_DIR}}tools/ops.js integration check {{OPS_DIR}}. <provider>` antes de sincronizar. Ejecuta después
+`node {{OPS_DIR}}tools/ops.js integration sync {{OPS_DIR}}. <provider>`. No edites snapshots manualmente, no cambies datos remotos
 y no promociones borradores durante esta operación. Reporta conteos y errores reales.

package/automatization/runners/antigravity/skills/team/SKILL.md

@@ -3,15 +3,15 @@ name: team
 description: Evalúa con un equipo si una intención es viable y propone una épica candidata.
 ---
 
-Lee `AGENTS.md`, `planning/PROTOCOL.md` y el contexto de `organization/`. Obtené el recorrido con
-`node tools/ops.js team show <slug> --json` y ejecutá una etapa a la vez, adoptando en cada una el
+Lee `{{OPS_DIR}}AGENTS.md`, `{{OPS_DIR}}planning/PROTOCOL.md` y el contexto de `{{OPS_DIR}}organization/`. Obtené el recorrido con
+`node {{OPS_DIR}}tools/ops.js team show <slug> --json` y ejecutá una etapa a la vez, adoptando en cada una el
 contrato del cargo que la posee. Respetá el dueño de decisión de cada dominio: ningún otro cargo
 resuelve en su lugar.
 
 Marcá el exit gate de una etapa como cumplido sólo si se cumple de verdad. Cuando falte evidencia,
-autoridad o una decisión externa, registrá la acción concreta en `planning/HUMAN_ACTIONS.md` y detente:
+autoridad o una decisión externa, registrá la acción concreta en `{{OPS_DIR}}planning/HUMAN_ACTIONS.md` y detente:
 una opinión del modelo no es investigación de usuarios ni valida un problema.
 
-Si la intención resulta viable, escribí la épica en `planning/roadmap/` con criterios observables y
-cerrá con `node tools/ops.js check planning`. Si no lo es, registrá en `planning/INBOX.md` por qué y
+Si la intención resulta viable, escribí la épica en `{{OPS_DIR}}planning/roadmap/` con criterios observables y
+cerrá con `node {{OPS_DIR}}tools/ops.js check planning`. Si no lo es, registrá en `{{OPS_DIR}}planning/INBOX.md` por qué y
 qué la haría viable. **Nunca promuevas al BACKLOG**: esa firma es humana.

package/automatization/runners/gemini/GEMINI.md

@@ -3,10 +3,25 @@
 @{{OPS_DIR}}AGENTS.md
 @{{OPS_DIR}}planning/PROTOCOL.md
 
-`{{OPS_DIR}}planning/PROTOCOL.md` es la fuente de verdad. Ejecuta `/ops:autobuild` fase por fase; los workflows JS de
-Claude son referencia, no un runtime compatible. `{{OPS_DIR}}planning/WIP.md` es el mutex y
-`{{OPS_DIR}}planning/AWAITING_REVIEW.md` bloquea una corrida nueva.
+`{{OPS_DIR}}planning/PROTOCOL.md` es la fuente de verdad. Ejecuta `/ops:autobuild` fase por fase; los
+workflows JS de Claude son referencia, no un runtime compatible. `{{OPS_DIR}}planning/WIP.md` es el mutex
+y `{{OPS_DIR}}planning/AWAITING_REVIEW.md` bloquea una corrida nueva.
 
-Gemini no tiene guards nativos configurados por este toolkit. Antes de cada commit ejecuta los wrappers de
-`{{OPS_DIR}}automatization/hooks/` como prechecks y al cerrar ejecuta `node {{OPS_DIR}}tools/ops.js check planning`. Nunca omitas
-aprobaciones, inventes credenciales, escribas remoto, hagas push/deploy o promociones trabajo desde INBOX.
+Los hooks de `.gemini/settings.json` son obligatorios y bloquean por su cuenta. **Requieren que la
+carpeta esté marcada como confiable**: si no lo está, Gemini los desactiva y avisa con
+`Project hooks disabled because the folder is not trusted`, y entonces nada te detiene. Confía en la
+carpeta antes de trabajar.
+
+Los cargos llegan como skills en `.gemini/skills/`. Cada uno conserva nombre y descripción, y remite al
+contrato completo; leé ese `SKILL.md` antes de actuar en su terreno. Para la lista:
+
+```bash
+node {{OPS_DIR}}tools/ops.js agents list
+node {{OPS_DIR}}tools/ops.js team list
+```
+
+Nunca omitas aprobaciones, inventes credenciales, escribas remoto, hagas push/deploy o promociones
+trabajo desde INBOX.
+
+> No corras `gemini hooks migrate --from-claude`: reescribe `.gemini/settings.json` entero y se lleva
+> puesto el resto de la configuración. `cauce automation install . gemini` ya deja los hooks puestos.

package/automatization/runners/gemini/commands/ops/autobuild.toml

@@ -1,7 +1,7 @@
 description = "Ejecuta el siguiente hito aprobado siguiendo Cauce"
 prompt = """
-Lee AGENTS.md y planning/PROTOCOL.md completos. Ejecuta el ciclo de autobuild fase por fase sobre la primera
+Lee {{OPS_DIR}}AGENTS.md y {{OPS_DIR}}planning/PROTOCOL.md completos. Ejecuta el ciclo de autobuild fase por fase sobre la primera
 tarea aprobada, respetando AWAITING_REVIEW y WIP como mutex. Antes de cada operación peligrosa invoca el
-guard correspondiente de automatization/hooks/ con el JSON de herramienta esperado. No hagas push ni deploy.
+guard correspondiente de {{OPS_DIR}}automatization/hooks/ con el JSON de herramienta esperado. No hagas push ni deploy.
 Detente en el checkpoint entre hitos y deja evidencia real en DONE.
 """

package/automatization/runners/gemini/commands/ops/integration-promote.toml

@@ -1,6 +1,6 @@
 description = "Promueve localmente un candidato de integración revisado"
 prompt = """
-Lee integrations/README.md y planning/PROTOCOL.md. Interpreta {{args}} como '<provider> <remote-key>'. Exige
-un draft ready, ejecuta integration check, promote y el check final mediante tools/ops.js. Nunca escribas en
+Lee {{OPS_DIR}}integrations/README.md y {{OPS_DIR}}planning/PROTOCOL.md. Interpreta {{args}} como '<provider> <remote-key>'. Exige
+un draft ready, ejecuta integration check, promote y el check final mediante {{OPS_DIR}}tools/ops.js. Nunca escribas en
 el proveedor remoto ni modifiques BACKLOG, WIP o DONE.
 """

package/automatization/runners/gemini/commands/ops/integration-sync.toml

@@ -1,6 +1,6 @@
 description = "Sincroniza un proveedor externo hacia staging sin escribir remoto"
 prompt = """
-Lee integrations/README.md y planning/PROTOCOL.md. Resuelve el proveedor solicitado en {{args}}; si está
+Lee {{OPS_DIR}}integrations/README.md y {{OPS_DIR}}planning/PROTOCOL.md. Resuelve el proveedor solicitado en {{args}}; si está
 vacío, continúa solo si existe exactamente uno habilitado. Ejecuta integration check, integration sync y el
-check final mediante tools/ops.js. Nunca promociones como efecto del sync ni edites snapshots a mano.
+check final mediante {{OPS_DIR}}tools/ops.js. Nunca promociones como efecto del sync ni edites snapshots a mano.
 """

package/automatization/runners/gemini/manifest.json

@@ -31,10 +31,11 @@
     }
   ],
   "capabilities": {
-    "nativeHooks": false,
+    "nativeHooks": true,
     "nativeWorkflows": false,
     "projectInstructions": true,
     "checkpointing": true,
-    "nativeSkills": false
-  }
+    "nativeSkills": true
+  },
+  "roleSkills": ".gemini/skills"
 }

package/automatization/runners/gemini/settings.json

@@ -1,9 +1,43 @@
 {
   "general": {
-    "checkpointing": { "enabled": true }
+    "checkpointing": {
+      "enabled": true
+    }
   },
   "context": {
     "fileName": ["AGENTS.md", "GEMINI.md"],
     "loadFromIncludeDirectories": true
+  },
+  "hooks": {
+    "BeforeTool": [
+      {
+        "matcher": "run_shell_command",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$GEMINI_PROJECT_DIR/{{OPS_DIR}}automatization/hooks/guard-shell.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "replace|write_file",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$GEMINI_PROJECT_DIR/{{OPS_DIR}}automatization/hooks/guard-files.sh"
+          }
+        ]
+      }
+    ],
+    "AfterAgent": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$GEMINI_PROJECT_DIR/{{OPS_DIR}}automatization/hooks/guard-planning-drift.sh"
+          }
+        ]
+      }
+    ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "type": "commonjs",
   "bin": {