@ingeniomaps/cauce 0.5.5 → 0.6.1

package/CHANGELOG.md

@@ -8,6 +8,32 @@ 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.1] - 2026-08-15
+
+### Corregido
+
+- **El bridge de Antigravity negaba cada llamada a herramienta.** Resolvía la raíz ops subiendo por el
+  árbol, y en sidecar es un *hermano* de los repos de producto: no la encontraba y, como falla cerrado,
+  bloqueaba todo. Ahora `automation install` le deja escrito dónde quedó, con el recorrido hacia arriba
+  como respaldo.
+- **`automation install antigravity` copiaba el plugin y lo dejaba inerte.** Antigravity exige un
+  registro explícito —`agy plugin install`—, así que los archivos quedaban en su lugar, `doctor` daba
+  verde y no se ejecutaba nada. `install` ahora dice el comando exacto y `doctor` avisa si falta, sin
+  tocar por su cuenta la configuración global del usuario.
+
+## [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

package/automatization/runners/antigravity/hook.js

@@ -11,7 +11,22 @@ function readInput() {
   } 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
+// no hallaba `ops.config.json` y, como falla cerrado, negaba cada llamada a herramienta.
+const OPS_DIR = '{{OPS_DIR}}'
+
+function declaredRoot() {
+  // El plugin vive en <raíz-de-instalación>/.agents/plugins/cauce/.
+  const installed = path.resolve(__dirname, '..', '..', '..')
+  const root = OPS_DIR.startsWith('{{') ? installed : path.join(installed, OPS_DIR)
+  return fs.existsSync(path.join(root, 'ops.config.json')) ? root : ''
+}
+
 function findRoot(input) {
+  const declared = declaredRoot()
+  if (declared) return declared
   const args = input.toolCall && input.toolCall.args || {}
   const starts = [args.Cwd, process.cwd(), ...(input.workspacePaths || [])].filter(Boolean)
   for (const start of starts) {

package/automatization/runners/antigravity/manifest.json

@@ -48,5 +48,13 @@
     "checkpointing": false,
     "nativeSkills": true
   },
-  "roleSkills": ".agents/plugins/cauce/skills"
+  "roleSkills": ".agents/plugins/cauce/skills",
+  "activation": {
+    "hint": "agy plugin install .agents/plugins/cauce",
+    "verify": [
+      "plugin",
+      "list"
+    ],
+    "expect": "cauce"
+  }
 }

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/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/engine/automation/index.js

@@ -182,6 +182,15 @@ function installRoleSkills(root, runner, output) {
   return roles.length
 }
 
+// Runners que además de los archivos necesitan un registro propio para que el wiring cuente. Copiar
+// y quedarse ahí deja un plugin inerte: los archivos están, `doctor` da verde y nada se ejecuta.
+function activated(runner) {
+  if (!runner.activation) return true
+  const result = spawnSync(runner.command, runner.activation.verify, { encoding: 'utf8' })
+  if (result.status !== 0) return null
+  return `${result.stdout || ''}`.includes(runner.activation.expect)
+}
+
 function hasHooks(config) {
   if (config.hooks && Object.keys(config.hooks).length) return true
   const events = [
@@ -423,6 +432,10 @@ function doctor(root, name, output = console) {
     ['-c', 'command -v "$1" >/dev/null 2>&1', 'runner-doctor', runner.command],
   )
   if (executable.status !== 0) warnings.push(`${runner.command}: CLI no encontrado en PATH`)
+  else if (activated(runner) === false) {
+    warnings.push(`el plugin está copiado pero no registrado, así que no se ejecuta. `
+      + `Corré desde ${paths.install}: ${runner.activation.hint}`)
+  }
   for (const warning of warnings) output.warn(`⚠ ${name}: ${warning}`)
   for (const error of errors) output.error(`✗ ${name}: ${error}`)
   return { runner, errors, warnings }
@@ -516,6 +529,10 @@ function install(root, name, output = console, options = {}) {
     }
   }
   installRoleSkills(root, runner, output)
+  if (runner.activation && activated(runner) !== true) {
+    output.log(`  ${name}: falta registrarlo para que corra. Desde ${paths.install}:`)
+    output.log(`    ${runner.activation.hint}`)
+  }
   M.write(root, undefined, entregado)
   return runner
 }

package/package.json

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