@ingeniomaps/cauce 0.37.0 → 0.39.0

package/CHANGELOG.md

@@ -14,6 +14,40 @@ 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.39.0] - 2026-08-19
+
+### Corregido
+
+- **`check` nombra las credenciales que nadie se llevó.** El arranque tiene que dejar una fila por cada
+  variable que el proyecto declara, y en cuatro corridas reales se cumplió en proporción a lo que se
+  habló: las que sólo estaban en el inventario quedaron afuera —entre ellas el broker por donde entran
+  los datos y el servicio al que se le mandan errores—. Ahora `check` nombra las que no aparecen ni en el
+  mapa ni en `HUMAN_ACTIONS.md`. Mira sólo cuando la instancia ya tiene contexto escrito, porque antes no
+  hay dónde tendrían que estar, y avisa en vez de fallar: una variable sin dueño no rompe nada hoy, rompe
+  el día que alguien tiene que desplegar.
+
+## [0.38.0] - 2026-08-19
+
+### Añadido
+
+- **Gemini recibe `onboard` y `team`, que sólo tenía como prosa.** Estaban descritos en `GEMINI.md` y no
+  existía ningún comando detrás, así que quien venía de otro runner los buscaba en la lista y no
+  aparecían.
+
+- **`automation install` termina diciendo cómo se invoca lo que acaba de instalar.** Una línea con los
+  nombres exactos para ese runner, que es lo que evita buscar en una lista de cincuenta skills el nombre
+  que se usó en otro lado.
+
+### Cambiado
+
+- **Una convención para el nombre de cada recorrido.** El nombre es el mismo en todos los runners
+  —`onboard`, `team`, `autobuild`, `integration-sync`, `integration-promote`—; el prefijo lo pone cada
+  uno según su espacio de nombres: `/onboard` en Claude, `/cauce:onboard` en Gemini, `cauce:onboard` en
+  Antigravity. Codex no tiene comandos y opera el protocolo desde sus instrucciones.
+
+  Los comandos de Gemini se mudaron de `/ops:` a `/cauce:`. Si actualizás una instalación anterior,
+  `.gemini/commands/ops/` queda huérfano: se borra a mano, `install` no toca lo que ya no declara.
+
 ## [0.37.0] - 2026-08-19
 
 ### Cambiado

package/README.md

@@ -139,8 +139,20 @@ no puede hacer, así que ese recorrido vive en el runner:
 /autobuild  ejecuta una tarea ya promovida, fase por fase.
 ```
 
-Claude y Antigravity lo traen como recorrido ejecutable; Codex y Gemini lo operan siguiendo las
-instrucciones que `automation install` les deja. Sin runner, la [tabla de comandos](#comandos) y
+### Cómo se lo llama en cada runner
+
+El nombre del recorrido es el mismo en todos —`onboard`, `team`, `autobuild`, `integration-sync`,
+`integration-promote`—; el prefijo lo pone cada runner según su espacio de nombres:
+
+| Runner | Se invoca | |
+|---|---|---|
+| Claude | `/onboard` | workflow ejecutable |
+| Gemini | `/cauce:onboard` | comando |
+| Antigravity | `cauce:onboard` | skill |
+| Codex | — | opera el protocolo desde sus instrucciones |
+
+`automation install` termina diciendo la lista exacta para el runner que instalaste, que es lo que
+evita buscar en Gemini el nombre que se usó en Claude. Sin runner, la [tabla de comandos](#comandos) y
 [FLOW.md](template/planning/FLOW.md) hacen el mismo camino a mano.
 
 Dentro del proyecto el CLI se invoca con `node tools/ops.js` —o `npx cauce`, que la dependencia deja

package/automatization/runners/antigravity/manifest.json

@@ -60,5 +60,15 @@
       "list"
     ],
     "expect": "cauce"
+  },
+  "commands": {
+    "invocation": "cauce:{name}",
+    "names": [
+      "onboard",
+      "team",
+      "autobuild",
+      "integration-sync",
+      "integration-promote"
+    ]
   }
 }

package/automatization/runners/claude/manifest.json

@@ -53,5 +53,15 @@
     "checkpointing": false,
     "nativeSkills": true
   },
-  "roleSkills": ".claude/skills"
+  "roleSkills": ".claude/skills",
+  "commands": {
+    "invocation": "/{name}",
+    "names": [
+      "onboard",
+      "team",
+      "autobuild",
+      "integration-sync",
+      "integration-promote"
+    ]
+  }
 }

package/automatization/runners/codex/manifest.json

@@ -19,5 +19,9 @@
     "projectInstructions": true,
     "checkpointing": false,
     "nativeSkills": false
+  },
+  "commands": {
+    "invocation": "",
+    "names": []
   }
 }

package/automatization/runners/gemini/README.md

@@ -9,8 +9,12 @@ Adaptador mediante configuración de proyecto, `GEMINI.md`, checkpointing y coma
 node tools/ops.js automation install . gemini
 ```
 
-Instala `.gemini/settings.json`, el contexto raíz `GEMINI.md` y los comandos `/ops:autobuild`,
-`/ops:integration-sync` y `/ops:integration-promote`.
+Instala `.gemini/settings.json`, el contexto raíz `GEMINI.md` y los comandos `/cauce:onboard`,
+`/cauce:team`, `/cauce:autobuild`, `/cauce:integration-sync` y `/cauce:integration-promote`.
+
+Antes vivían bajo `/ops:` y eran tres: el arranque y el recorrido de equipo le llegaban sólo como prosa,
+así que alguien que venía de otro runner los buscaba en la lista y no estaban. Si actualizás una
+instalación vieja, `.gemini/commands/ops/` queda huérfano y se borra a mano.
 
 Gemini no anuncia hooks nativos en este adaptador: los guards se ejecutan como prechecks indicados por el
 protocolo y los comandos. Esta degradación está declarada en `manifest.json`, no se simula protección inexistente.

package/automatization/runners/gemini/commands/cauce/onboard.toml

@@ -0,0 +1,21 @@
+description = "Arranca una instancia recién creada: pregunta, escribe el contexto y la primera épica"
+prompt = """
+Seguí la sección «El arranque» de {{OPS_DIR}}AGENTS.md y de este contexto raíz.
+
+Empezá por `node {{OPS_DIR}}tools/ops.js onboard`: es instantáneo, y la primera línea que imprime es la
+pregunta con la que tenés que abrir. Hacésela tal cual y esperá la respuesta antes de mirar el
+inventario, sea el workspace vacío, un monolito o diez repos. Según lo que conteste, hasta tres
+preguntas más con las palabras de ese proyecto, una por vez. El inventario ya viene resuelto en esa
+salida —servicios, comandos declarados y las variables que cada uno espera—: no recorras el árbol ni
+corras comandos del proyecto para completarlo.
+
+Con eso escribí {{OPS_DIR}}organization/, la sección «Mapa real» de {{OPS_DIR}}AGENTS.md con cada
+comando tal como está declarado y de qué archivo salió, y las raíces reales en workspaceRoots. Las
+credenciales, los sistemas externos y el permiso de push van como filas de
+{{OPS_DIR}}planning/HUMAN_ACTIONS.md, sin proponer ningún valor. Una dimensión que no llegaste a
+preguntar queda «Por definir» con su pregunta en {{OPS_DIR}}planning/INBOX.md, y lo que deducís de otra
+respuesta va marcado «(supuesto)».
+
+Cerrá escribiendo la épica como epic-NNN-<slug>.md con status: open —sin slug no la lee nadie— y corré
+`node {{OPS_DIR}}tools/ops.js check planning`. Nunca promuevas al BACKLOG: esa firma es humana.
+"""

package/automatization/runners/gemini/commands/cauce/team.toml

@@ -0,0 +1,15 @@
+description = "Recorre un equipo y propone una épica candidata, sin promoverla"
+prompt = """
+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 {{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 {{OPS_DIR}}planning/roadmap/ como
+epic-NNN-<slug>.md 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/manifest.json

@@ -18,16 +18,24 @@
   ],
   "artifacts": [
     {
-      "source": "commands/ops/autobuild.toml",
-      "target": ".gemini/commands/ops/autobuild.toml"
+      "source": "commands/cauce/autobuild.toml",
+      "target": ".gemini/commands/cauce/autobuild.toml"
     },
     {
-      "source": "commands/ops/integration-sync.toml",
-      "target": ".gemini/commands/ops/integration-sync.toml"
+      "source": "commands/cauce/integration-sync.toml",
+      "target": ".gemini/commands/cauce/integration-sync.toml"
     },
     {
-      "source": "commands/ops/integration-promote.toml",
-      "target": ".gemini/commands/ops/integration-promote.toml"
+      "source": "commands/cauce/integration-promote.toml",
+      "target": ".gemini/commands/cauce/integration-promote.toml"
+    },
+    {
+      "source": "commands/cauce/onboard.toml",
+      "target": ".gemini/commands/cauce/onboard.toml"
+    },
+    {
+      "source": "commands/cauce/team.toml",
+      "target": ".gemini/commands/cauce/team.toml"
     }
   ],
   "capabilities": {
@@ -37,5 +45,15 @@
     "checkpointing": true,
     "nativeSkills": true
   },
-  "roleSkills": ".gemini/skills"
+  "roleSkills": ".gemini/skills",
+  "commands": {
+    "invocation": "/cauce:{name}",
+    "names": [
+      "onboard",
+      "team",
+      "autobuild",
+      "integration-sync",
+      "integration-promote"
+    ]
+  }
 }

package/engine/automation/index.js

@@ -694,6 +694,15 @@ function install(root, name, output = console, options = {}) {
     }
   }
   installRoleSkills(root, runner, output)
+  // Cómo se lo llama acá. El nombre del recorrido es el mismo en todos los runners —`onboard`, `team`,
+  // `autobuild`—; el prefijo lo pone cada uno según su espacio de nombres, y esa diferencia es la que
+  // hace que alguien no encuentre en Gemini lo que usó en Claude. Decirlo al instalar cuesta una línea
+  // y ahorra buscarlo en una lista de cincuenta skills.
+  const invocacion = runner.commands && runner.commands.invocation
+  if (invocacion && (runner.commands.names || []).length) {
+    const lista = runner.commands.names.map((nombre) => invocacion.replace('{name}', nombre))
+    output.log(`  ${name}: se invocan como ${lista.join(', ')}`)
+  }
   if (runner.activation && activated(runner) !== true) {
     output.log(`  ${name}: falta registrarlo para que corra. Desde ${paths.install}:`)
     output.log(`    ${runner.activation.hint}`)

package/engine/cli/ops.js

@@ -465,6 +465,31 @@ function seccionesPerdidas(root) {
   return avisos
 }
 
+// Credenciales que el proyecto declara y que no aparecen en ningún contrato. El arranque tiene que
+// dejar una fila por cada una —quién la carga y dónde— y en la práctica cubre las que se hablaron en la
+// conversación: las que sólo estaban en el inventario se pierden, y con ellas el servicio externo que
+// hay detrás. Una variable sin dueño no rompe nada hoy; rompe el día que alguien tiene que desplegar.
+//
+// Sólo cuando la instancia ya tiene contexto escrito: antes del arranque no hay dónde estuvieran.
+function credencialesSinDueño(root) {
+  if (OB.guide(root).fresh) return []
+  const contratos = ['AGENTS.md', path.join('planning', 'HUMAN_ACTIONS.md')]
+    .map((file) => { try { return fs.readFileSync(path.join(root, file), 'utf8') } catch { return '' } })
+    .join('\n')
+  if (!contratos) return []
+  const huerfanas = []
+  for (const service of inventory(root)) {
+    for (const nombre of (service.env || {}).names || []) {
+      if (!contratos.includes(nombre)) huerfanas.push(`${nombre} (${service.path})`)
+    }
+  }
+  if (!huerfanas.length) return []
+  const lista = huerfanas.length > 4
+    ? `${huerfanas.slice(0, 4).join(', ')} y ${huerfanas.length - 4} más`
+    : huerfanas.join(', ')
+  return [`el proyecto declara ${lista} y no aparecen en el mapa ni en HUMAN_ACTIONS: nadie las carga`]
+}
+
 function check(dir, cli) {
   const root = path.resolve(dir || '.')
   const errors = []
@@ -578,6 +603,7 @@ function check(dir, cli) {
   for (const entry of FK.drift(path.resolve(root, '..'))) warnings.push(FK.driftLine(entry))
 
   warnings.push(...seccionesPerdidas(path.resolve(root, '..')))
+  warnings.push(...credencialesSinDueño(path.resolve(root, '..')))
 
   if (cli.has('--json')) {
     console.log(JSON.stringify({

package/package.json

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