@ingeniomaps/cauce 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -14,6 +14,38 @@ 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.31.0] - 2026-08-18
+
+### Añadido
+
+- **`ops automation uninstall <ops-root> <runner>`: sacar el wiring sin llevarse lo tuyo.** Hasta ahora
+  desinstalar era borrar la carpeta ops y descubrir después que cada llamada de herramienta ejecuta un
+  guard que ya no existe; la otra salida —borrar `.claude/` entero— se lleva puesto lo que hayas puesto
+  vos. El comando quita lo que Cauce entregó **y sigue igual que como lo entregó**: sus guards de la
+  configuración del runner, sus workflows, sus punteros a cargos. Tus hooks, tus workflows y tus skills
+  quedan donde están, y un archivo del toolkit que hayas editado se conserva y aparece nombrado en la
+  salida, porque decidir sobre él es tuyo. La instancia no se toca: borrarla es una decisión aparte.
+  También como `make uninstall-claude` y sus equivalentes.
+
+### Corregido
+
+- **Una instancia dejaba de enterarse de que había versiones nuevas.** `init` fija la versión exacta del
+  motor, así que `npm update` no la mueve y `upgrade` compara contra el que está instalado: quien
+  actualizaba con `make upgrade` recibía «la instancia está al día» en todas las versiones siguientes, sin
+  nada que le dijera que la comparación era local. Ahora la salida nombra contra qué comparó y da el
+  comando que trae un motor nuevo, y `make upgrade` lo corre antes de aplicar.
+
+  Actualizar son tres pasos y el tercero sigue siendo aparte: `npm install --save-dev
+  @ingeniomaps/cauce@latest`, `ops upgrade .` y `ops automation install . <runner>`. Los workflows y las
+  skills viven en el runner, no en la instancia, y `upgrade` lo recuerda al terminar.
+
+### Cambiado
+
+- **`init` termina en un solo cierre, y sus opciones se leen como una selección.** Las tres líneas finales
+  —cada una con tono de última— pasaron a ser una con la acción concreta, y las opciones de runner e
+  integración van una por línea con el default marcado donde se mira: `5) ninguno   ← Enter`, en vez de un
+  `[ninguno]` pegado al prompt.
+
 ## [0.30.0] - 2026-08-18
 
 ### Añadido

package/README.md

@@ -31,12 +31,21 @@ instala la dependencia, deja el wiring del runner puesto y valida la instancia a
 
 ```text
 ¿Con qué runner vas a trabajar?
-1) claude   2) codex   3) gemini   4) antigravity   5) ninguno
-[ninguno] > 1
+
+  1) claude
+  2) codex
+  3) gemini
+  4) antigravity
+  5) ninguno   ← Enter
+
+> 1
 
 ¿Habilitar alguna integración?
-1) jira   2) ninguna
-[ninguna] >
+
+  1) jira
+  2) ninguna   ← Enter
+
+>
 
 · npm install (el motor viene de la dependencia)
 ✓ claude: adaptador operativo (0 advertencia(s))
@@ -57,7 +66,8 @@ este proyecto, hasta cubrir lo que haga falta de esto:
 
 Mientras tanto, esto es lo que hay: apps/api, apps/web
 
-Abrí claude en este directorio para que las escriba por vos.
+→ Abrí claude acá y contestale esa pregunta.
+  Con tus respuestas escribe organization/, el mapa real de AGENTS.md y la primera épica.
 El ciclo empieza en ops/planning/FLOW.md.
 ```
 
@@ -190,6 +200,7 @@ Lee [template/planning/PROTOCOL.md](template/planning/PROTOCOL.md) para el contr
 | `ops automation list-hooks <ops-root>` | Describe los guards portables disponibles. |
 | `ops automation check <ops-root>` | Valida guards, permisos y configuraciones. |
 | `ops automation install <ops-root> <runner>` | Instala el wiring de Claude, Codex, Antigravity o Gemini. |
+| `ops automation uninstall <ops-root> <runner>` | Quita ese wiring y conserva lo que no escribió Cauce. |
 | `ops automation doctor <ops-root> <runner>` | Diagnostica una instalación materializada. |
 
 `ops --help` lista las banderas de cada uno. En un proyecto generado, `make help` muestra los atajos
@@ -230,7 +241,20 @@ y actualizar no exige resolver conflictos: se reemplaza `system/` entero y nada
 y sobrevive, desactivar uno del toolkit es quitarlo de la configuración del runner, y editar uno
 existente detiene el `upgrade` antes de pisarlo.
 
-### Versionado
+### Actualizar
+
+Son tres pasos y `make upgrade` hace los dos primeros:
+
+```bash
+npm install --save-dev @ingeniomaps/cauce@latest   # trae el motor nuevo
+node tools/ops.js upgrade .                        # aplica system/ y el runtime
+node tools/ops.js automation install . claude      # el wiring del runner
+```
+
+El primero no se puede saltear: `init` fija la versión exacta, así que `npm update` no la mueve y
+`upgrade` compara contra el motor instalado —lo dice en su salida—. El tercero tampoco: los workflows y
+las skills viven en el runner, no en la instancia, y `upgrade` no los toca. `upgrade` lo recuerda al
+terminar.
 
 Como `upgrade` reemplaza `system/` sin pedir confirmación, un cambio en el protocolo, en una regla del
 sistema o en un guard es visible para el usuario y sube minor aunque no toque código. `upgrade` y
@@ -277,6 +301,12 @@ La instalación fusiona la configuración propia del runner y conserva las entra
 reemplaza los guards que el propio toolkit había registrado sueltos por el grupo que ahora los cubre, y
 lista cuáles quitó. Nada que no haya escrito el toolkit se toca.
 
+Para sacarlo, `automation uninstall` quita exactamente lo que Cauce entregó y sigue igual que como lo
+entregó: los guards de la configuración del runner, los workflows, los punteros a cargos. Lo que no
+escribió —tus hooks, tus workflows, tus skills— queda donde está, y un archivo suyo que hayas editado se
+conserva y se nombra en la salida. Borrar la carpeta ops sin esto deja al runner ejecutando guards que ya
+no existen.
+
 Qué comprueba cada guard, qué no puede comprobar y cómo se agrupan por evento está en
 [automatization/hooks/README.md](automatization/hooks/README.md).
 

package/engine/automation/index.js

@@ -478,6 +478,108 @@ function deliveryState(recorded, name, resolved, prefix = '') {
   return delivered && delivered === current ? 'desactualizado' : 'ajeno'
 }
 
+// Quita de una estructura de configuración exactamente lo que este adaptador habría puesto, y nada más.
+// Es el inverso de `mergeConfig`: una entrada del usuario nunca coincide literalmente con la nuestra, así
+// que sobrevive; una que editó tampoco coincide, y por eso se conserva y se avisa en vez de borrarse.
+function unmergeConfig(current, incoming) {
+  if (Array.isArray(incoming)) {
+    if (!Array.isArray(current)) return current
+    const nuestras = new Set(incoming.map((value) => JSON.stringify(value)))
+    return current.filter((value) => !nuestras.has(JSON.stringify(value)))
+  }
+  if (incoming && typeof incoming === 'object') {
+    if (!current || typeof current !== 'object' || Array.isArray(current)) return current
+    const result = { ...current }
+    for (const [key, value] of Object.entries(incoming)) {
+      if (!(key in result)) continue
+      const limpio = unmergeConfig(result[key], value)
+      // Una clave que queda vacía por habernos ido no es del usuario: la creamos nosotros al instalar.
+      const vacia = limpio === undefined
+        || (Array.isArray(limpio) && !limpio.length)
+        || (limpio && typeof limpio === 'object' && !Array.isArray(limpio) && !Object.keys(limpio).length)
+      if (vacia) delete result[key]
+      else result[key] = limpio
+    }
+    return result
+  }
+  return JSON.stringify(current) === JSON.stringify(incoming) ? undefined : current
+}
+
+// Borra el archivo y, de paso, los directorios que quedaron vacíos por haberlo sacado. Nunca sube más
+// allá del límite: `.claude/` puede tener cosas del usuario aunque `.claude/workflows/` quede vacío.
+function removeFile(file, boundary) {
+  fs.rmSync(file, { force: true })
+  let dir = path.dirname(file)
+  while (dir.startsWith(boundary) && dir !== boundary) {
+    try { if (fs.readdirSync(dir).length) return } catch { return }
+    fs.rmdirSync(dir)
+    dir = path.dirname(dir)
+  }
+}
+
+// Saca el wiring de un runner dejando intacto lo que no escribimos nosotros.
+//
+// Existe porque desinstalar a mano es borrar `ops/` y descubrir después que cada llamada de herramienta
+// ejecuta un guard que ya no está. Y porque la alternativa —borrar `.claude/` entero— se lleva puesto lo
+// que el usuario haya puesto ahí, que es suyo y no tiene por qué desaparecer con el toolkit.
+//
+// La regla es una sola: se quita lo que Cauce entregó y sigue igual que como lo entregó. Un archivo con
+// cambios propios se conserva y se nombra; decidir sobre él es de la persona, no de este comando.
+function uninstall(root, name, output = console) {
+  if (O.mode(root) === 'toolkit') {
+    throw new Error('Acá se fabrica Cauce, no se lo consume.')
+  }
+  const runner = runnerManifest(root, name)
+  const paths = runnerPaths(root, name, runner)
+  const prefix = opsPrefix(root)
+  const recorded = M.readRunners(root)
+  const conservados = []
+  let quitados = 0
+
+  const items = [...(runner.instructions || []), ...(runner.artifacts || [])]
+  const entregado = { ...recorded }
+  for (const item of items) {
+    const resolved = { item, ...resolveItem(paths, root, name, item) }
+    const key = deliveryKey(name, item.target)
+    if (!fs.existsSync(resolved.target)) { delete entregado[key]; continue }
+    const situacion = deliveryState(recorded, name, resolved, prefix)
+    if (situacion === 'ajeno') { conservados.push(item.target); continue }
+    removeFile(resolved.target, paths.install)
+    delete entregado[key]
+    quitados += 1
+  }
+
+  // Los punteros a cargos no se registran uno por uno —son cuarenta y siete y se regeneran enteros—,
+  // así que se reconocen por contenido: sólo se va el que sigue siendo el que generamos.
+  if (runner.capabilities.nativeSkills && runner.roleSkills) {
+    const base = path.resolve(paths.install, runner.roleSkills)
+    for (const role of roleCatalog(root)) {
+      const file = path.join(base, role.slug, 'SKILL.md')
+      if (!fs.existsSync(file)) continue
+      if (M.digest(file) !== M.digestText(roleSkill(role))) {
+        conservados.push(path.relative(paths.install, file))
+        continue
+      }
+      removeFile(file, paths.install)
+      quitados += 1
+    }
+  }
+
+  if (fs.existsSync(paths.configTarget)) {
+    const current = JSON.parse(fs.readFileSync(paths.configTarget, 'utf8'))
+    const limpio = unmergeConfig(current, runnerConfig(paths, root))
+    if (limpio && Object.keys(limpio).length) F.atomicWriteJson(paths.configTarget, limpio)
+    else { removeFile(paths.configTarget, paths.install); quitados += 1 }
+    output.log(`✓ ${name}: ${runner.config.target} sin las entradas de Cauce`)
+  }
+
+  M.write(root, undefined, entregado)
+  output.log(`✓ ${name}: ${quitados} archivo(s) del toolkit quitados de ${paths.install}`)
+  for (const file of conservados) output.log(`= ${name}: conservado ${file} (tiene cambios tuyos)`)
+  if (runner.activation) output.log(`  ${name}: si lo habías registrado a mano, quitalo también.`)
+  return { removed: quitados, kept: conservados }
+}
+
 function install(root, name, output = console, options = {}) {
   // `install` arma la superficie de consumo de una empresa: punteros a cada cargo, una copia de los
   // workflows y los guards. Acá los cargos y los workflows son el producto —la copia divergiría— y
@@ -571,6 +673,7 @@ module.exports = {
   check,
   doctor,
   install,
+  uninstall,
   legacyGuardWiring,
   roleCatalog,
   roleSkill,

package/engine/cli/bootstrap.js

@@ -25,10 +25,14 @@ function terminal() {
 // dejar que ese rechazo suba terminaba la corrida con «Aborted with Ctrl+D» y la instancia recién creada
 // sin una línea que dijera cómo seguir. El default no hace nada, así que tomarlo no decide nada.
 async function elegir(deps, texto, opciones, fallback) {
-  const listado = opciones.map((opcion, indice) => `${indice + 1}) ${opcion}`).join('   ')
+  // Una opción por línea y el default señalado donde se mira: apretar Enter es la respuesta más común, y
+  // en una sola línea apretada el `[ninguno]` del final no se lee como «esto pasa si no elegís nada».
+  const listado = opciones
+    .map((opcion, indice) => `  ${indice + 1}) ${opcion}${opcion === fallback ? '   ← Enter' : ''}`)
+    .join('\n')
   for (let intento = 0; intento < INTENTOS; intento += 1) {
     let dicho
-    try { dicho = await deps.ask(`\n${texto}\n${listado}\n[${fallback}] > `) } catch {
+    try { dicho = await deps.ask(`\n${texto}\n\n${listado}\n\n> `) } catch {
       deps.log(`\n  sin respuesta: sigo con ${fallback}.`)
       return fallback
     }

package/engine/cli/ops.js

@@ -63,6 +63,7 @@ function usage() {
   ops automation check <ops-root>
   ops automation doctor <ops-root> claude|codex|gemini|antigravity
   ops automation install <ops-root> claude|codex|gemini|antigravity
+  ops automation uninstall <ops-root> claude|codex|gemini|antigravity
   ops learn <agent> [--proposal] [--applied [--period <AAAA-MM>]]
   ops evaluate <agent> [--cases [--json]] [--bench [caso]] [--record [AAAA-MM-DD]]
   ops agents list [ops-root] [--own|--system] [--json]
@@ -334,15 +335,8 @@ async function init(target, cli) {
   // corriendo `init`, no cuesta nada, y es lo único que le dice a alguien qué hacer con lo que acaba de
   // crear. Dejarlo adentro del camino feliz lo escondía justo de quien más lo necesita.
   console.log('')
-  onboard(root, SIN_BANDERAS)
-  if (resultado.instalado && resultado.runner !== BOOT.SIN_RUNNER) {
-    console.log(`\nAbrí ${resultado.runner} en este directorio para que las escriba por vos.`)
-  }
-  console.log('')
+  onboard(root, SIN_BANDERAS, resultado.instalado ? resultado.runner : '')
   for (const paso of initSteps(enter, resultado)) console.log(paso)
-  if (resultado.instalado) {
-    console.log(`El ciclo empieza en ${path.join(relative || '.', 'planning', 'FLOW.md')}.`)
-  }
   if (resultado.error) fail(`${resultado.error}: la instancia quedó creada pero todavía no funciona.`)
 }
 
@@ -399,7 +393,7 @@ function comandos(commands) {
 
 // La guía de arranque: qué hay, qué falta y qué preguntar. Determinista y en milisegundos, porque es lo
 // primero que ve alguien que acaba de instalar y todavía no sabe qué hace la herramienta.
-function onboard(rootArg, cli) {
+function onboard(rootArg, cli, runner = '') {
   const root = path.resolve(rootArg || '.')
   const services = inventory(root)
   const state = OB.guide(root, services)
@@ -426,8 +420,12 @@ function onboard(rootArg, cli) {
     console.log(`Esta instancia ya tiene ${escrito} escrito: el arranque no la va a pisar.`)
     return
   }
-  console.log('\nCon tus respuestas, el arranque escribe organization/, el mapa real de AGENTS.md y la')
-  console.log('primera épica. Con un runner instalado: /onboard, que te las hace una por una.')
+  // Un solo cierre: tres líneas que suenan a final se leen como tres finales, y quien recién instaló
+  // termina sin saber cuál era el paso.
+  console.log(runner
+    ? `\n→ Abrí ${runner} acá y contestale esa pregunta.`
+    : '\n→ Contestá esa pregunta cuando corras el arranque.')
+  console.log('  Con tus respuestas escribe organization/, el mapa real de AGENTS.md y la primera épica.')
 }
 
 function check(dir, cli) {
@@ -743,7 +741,13 @@ function upgrade(dir, cli) {
   const overrides = O.overrides(root)
 
   if (dry) {
-    if (from === to) return console.log(`= ${to}: la instancia está al día`)
+    if (from === to) {
+      // Contra el motor instalado, no contra lo publicado: la comparación es local y sin red. Decirlo
+      // importa porque `init` fija la versión exacta, así que el motor no se mueve solo y esta línea,
+      // a secas, se leía como «no hay nada nuevo» durante todas las versiones siguientes.
+      console.log(`= ${to}: la instancia está al día con el motor instalado`)
+      return console.log('  para traer una versión más nueva: npm install --save-dev @ingeniomaps/cauce@latest')
+    }
     console.log(`⚠ hay una versión más nueva: ${to} (la instancia tiene ${from || 'una previa'})`)
     printChangelog(from, to)
     for (const file of changed) console.log(`  editado localmente: ${file}`)
@@ -1112,6 +1116,11 @@ function automation(action, rootArg, runnerName, cli) {
     console.log(`✓ ${runnerName}: adaptador operativo (${result.warnings.length} advertencia(s))`)
     return
   }
+  if (action === 'uninstall') {
+    try { A.uninstall(root, runnerName, console) } catch (error) { fail(error.message, 2) }
+    console.log('  la instancia sigue en pie: borrar la carpeta ops es una decisión aparte.')
+    return
+  }
   if (action === 'install') {
     let runner
     const force = cli.has('--force')

package/package.json

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

package/template/Makefile

@@ -4,6 +4,7 @@
 .PHONY: integration-check integration-sync require-key integration-promote
 .PHONY: require-agent agent-learn agent-propose agent-evaluate require-team team-check team-show
 .PHONY: install-claude install-codex install-gemini install-antigravity
+.PHONY: uninstall-claude uninstall-codex uninstall-gemini uninstall-antigravity
 .PHONY: doctor-claude doctor-codex doctor-gemini doctor-antigravity
 
 # Jira es hoy el único proveedor; el día que haya otro se pasa PROVIDER=<slug>.
@@ -22,7 +23,10 @@ tree: ## Muestra roadmap, backlog, WIP y Done
 context: ## Muestra el contexto mínimo de la tarea vigente
 	@node tools/ops.js context planning
 
-upgrade: ## Actualiza Cauce sin tocar lo del proyecto
+# `init` fija la versión exacta del motor, así que `npm update` no la mueve: hay que pedir @latest.
+# Sin este primer paso `upgrade` compara contra el motor instalado y contesta «al día» para siempre.
+upgrade: ## Trae la última versión de Cauce y la aplica, sin tocar lo del proyecto
+	@npm install --save-dev @ingeniomaps/cauce@latest
 	@node tools/ops.js upgrade .
 
 automation-check: ## Comprueba hooks, workflows y adaptadores
@@ -73,6 +77,18 @@ install-gemini: ## Instala contexto, comandos y configuración para Gemini
 install-antigravity: ## Instala el plugin Cauce para Antigravity CLI
 	@node tools/ops.js automation install . antigravity
 
+uninstall-claude: ## Quita de Claude el wiring de Cauce, conservando lo tuyo
+	@node tools/ops.js automation uninstall . claude
+
+uninstall-codex: ## Quita de Codex el wiring de Cauce, conservando lo tuyo
+	@node tools/ops.js automation uninstall . codex
+
+uninstall-gemini: ## Quita de Gemini el wiring de Cauce, conservando lo tuyo
+	@node tools/ops.js automation uninstall . gemini
+
+uninstall-antigravity: ## Quita de Antigravity el wiring de Cauce, conservando lo tuyo
+	@node tools/ops.js automation uninstall . antigravity
+
 doctor-claude: ## Diagnostica la instalación de Claude
 	@node tools/ops.js automation doctor . claude