@ingeniomaps/cauce 0.20.0 → 0.22.0

package/automatization/workflows/agent-eval.js

@@ -111,16 +111,26 @@ if (!contexto || !contexto.items || !contexto.items.length) {
 // Dónde trabaja el cargo mientras responde. En el toolkit no puede ser acá: no hay `planning/` que
 // valga, así que se le arma un banco desechable. En una empresa es su propia instancia, y el cargo
 // tiene que ser suyo —propio o adoptado—: uno del catálogo se evalúa arriba, no acá.
-let WORK = ROOT
+// Un banco por caso, no uno por cargo. Con uno compartido los casos corren a la vez sobre el mismo
+// `planning/` y se leen entre sí: uno tomó por «una sesión anterior de este mismo cargo» lo que otro
+// acababa de escribir, y otro evaluó cuatro candidatas que en su enunciado no existían.
+//
+// Un solo agente los prepara —son comandos deterministas— y después la ruta de cada caso se arma
+// sola, sin volver a preguntar.
+const BENCH_ROOT = `${ROOT}/.cauce-eval/${AGENT}`
+let porCaso = null
 if (contexto.mode === 'toolkit') {
   const banco = await agent(
-    `From ${ROOT}, run "node tools/ops.js evaluate ${AGENT} --bench" and report the absolute path it ` +
-    `printed, nothing else. It recreates a disposable instance where writing to planning/ is legitimate.`,
-    { schema: BENCH, label: 'banco' },
+    `From ${ROOT}, run one command per case, in order, and report only whether all of them printed a ` +
+    `path:\n` +
+    contexto.items.map((item) => `  node tools/ops.js evaluate ${AGENT} --bench ${item.id}`).join('\n') +
+    `\n\nEach one recreates a disposable instance where writing to planning/ is legitimate. Set path ` +
+    `to the directory they share: ${BENCH_ROOT}`,
+    { schema: BENCH, label: 'bancos' },
   )
-  if (!banco || !banco.path) return stop('sin-banco', 'no se pudo preparar el banco de evaluación')
-  WORK = banco.path
-  log(`Banco: ${WORK}`)
+  if (!banco || !banco.path) return stop('sin-banco', 'no se pudieron preparar los bancos de evaluación')
+  porCaso = (item) => `${BENCH_ROOT}/${item.id}`
+  log(`Bancos: ${BENCH_ROOT}/<caso>`)
 } else if (contexto.system) {
   return stop('cargo-del-catalogo',
     `${AGENT} lo mantiene Cauce, no esta empresa: evaluarlo acá mediría tu configuración y el ` +
@@ -134,10 +144,11 @@ const veredictos = await pipeline(
 
   // Responde el cargo. Recibe su contrato y el pedido; nunca los comportamientos esperados.
   (item) => agent(
-    `Trabajás en ${WORK}: esa es tu instancia, con su planning/, su organization/ y su AGENTS.md. ` +
-    `Todo lo que escribas va ahí.\n\n` +
+    `Trabajás en ${porCaso ? porCaso(item) : ROOT}: esa es tu instancia, con su planning/, su ` +
+    `organization/ y su AGENTS.md. Todo lo que escribas va ahí.\n\n` +
     `Actuá como el cargo ${AGENT}, respetando el contrato de ${contexto.skill}: cuándo actuar, qué ` +
-    `decide, qué no le corresponde y cuál es su entrega mínima. Leé también ${WORK}/AGENTS.md: son las ` +
+    `decide, qué no le corresponde y cuál es su entrega mínima. Leé también el AGENTS.md de esa ` +
+    `instancia: son las ` +
     `reglas que todo cargo obedece, y un cargo corre siempre con las dos cosas —medirlo sólo contra su ` +
     `SKILL.md lo evaluaba en una situación que nunca ocurre—. No leas ningún archivo bajo ` +
     `evaluations/: no te corresponde y contaminaría la respuesta.\n\n` +
@@ -150,8 +161,18 @@ const veredictos = await pipeline(
   // mide contra lo que el caso declara, no contra una relectura del SKILL.md.
   (answer, item) => (answer ? agent(
     `Un cargo recibió este pedido:\n\n${item.request}\n\nY respondió:\n\n${answer.response}\n\n` +
+    (porCaso
+      ? `La respuesta no es toda la entrega. El cargo trabajó en ${porCaso(item)}, un banco versionado ` +
+        `desde su estado limpio: corré "git -C ${porCaso(item)} status --porcelain" y ` +
+        `"git -C ${porCaso(item)} diff" para ver exactamente qué produjo, y leé los archivos que ` +
+        `aparezcan. Juzgá la respuesta **y** lo que escribió.\n\n` +
+        `Esto no es un detalle: un cargo contestó un resumen y dejó el contrato completo —con firma, ` +
+        `orden de verificación y catorce pruebas— en su INBOX. Juzgado sólo por el texto, se lo dio ` +
+        `por ausente.\n\n`
+      : '') +
     `Contrastá esa respuesta contra cada comportamiento esperado y decidí si se observa o no. ` +
-    `Citá la parte de la respuesta que lo sostiene; si no hay cita, no se observa. No premies la ` +
+    `Citá la parte de la respuesta —o del archivo que el cargo escribió— que lo sostiene; si no hay ` +
+    `cita, no se observa. No premies la ` +
     `intención ni el tono: sólo lo que la respuesta dice.\n\n` +
     `Comportamientos esperados:\n${item.expected.map((one, index) => `${index + 1}. ${one}`).join('\n')}\n\n` +
     `El caso pasa sólo si se observan todos.`,

package/automatization/workflows/agent-promote.js

@@ -5,8 +5,10 @@
 //   1. Se niega si «Aprobación humana» no está firmada con responsable. Un agente no se autoriza a sí
 //      mismo, y `automatic_apply: false` sigue siendo cierto: esto no corre solo, lo corre alguien
 //      después de firmar.
-//   2. Corre los casos adversariales al terminar. Aplicar sin verificar deja un contrato cambiado y
-//      nadie sabiendo si todavía se sostiene, que es peor que no haber aplicado.
+//   2. Invalida el registro de evaluación anterior y manda a rehacerlo. Aplicar deja un contrato
+//      cambiado y nadie sabiendo si todavía se sostiene: el veredicto que había medía la versión
+//      vieja. Correr los casos acá no sirve —son un recorrido propio, con su banco por caso y su
+//      juez—, así que este termina nombrando `/agent-eval` en vez de fingir que ya verificó.
 //
 // Aplica **prosa**, no un parche, y es a propósito: la propuesta dice «agregar dos viñetas después de
 // la última existente». Un parche envejece si alguien toca el archivo mientras la propuesta espera
@@ -20,7 +22,6 @@ export const meta = {
     { title: 'Firma', detail: 'Sin aprobación humana no se toca nada' },
     { title: 'Aplicar', detail: 'El cambio, archivo por archivo' },
     { title: 'Registrar', detail: 'Historial del cargo' },
-    { title: 'Verificar', detail: 'Los casos adversariales contra el contrato nuevo' },
   ],
 }
 
@@ -126,8 +127,6 @@ await agent(
   { label: 'historial' },
 )
 
-phase('Verificar')
-
 log('El contrato cambió: los casos valen sólo si se vuelven a correr contra la versión nueva.')
 return finish({
   agent: AGENT,

package/automatization/workflows/integrations/promote.js

@@ -3,10 +3,10 @@ export const meta = {
   name: 'integration-promote',
   description: 'Promueve un draft revisado desde staging hacia el roadmap local.',
   whenToUse: 'Después de que una persona marque un candidato de integración como ready.',
+  // Una sola: el recorrido es un agente que encadena check → promote → check. Declarar «Promote» y
+  // «Validate» aparte pintaba dos grupos vacíos en el progreso, porque nunca se entraba a ellos.
   phases: [
-    { title: 'Preflight', detail: 'Validar proveedor, clave y estado ready.' },
-    { title: 'Promote', detail: 'Materializar el draft mediante el adaptador común.' },
-    { title: 'Validate', detail: 'Comprobar planning e integración.' },
+    { title: 'Preflight', detail: 'Validar el candidato, promoverlo y comprobar planning.' },
   ],
 }
 

package/automatization/workflows/integrations/sync.js

@@ -3,10 +3,10 @@ export const meta = {
   name: 'integration-sync',
   description: 'Valida, sincroniza y comprueba staging preservando la curación local.',
   whenToUse: 'Refrescar trabajo remoto antes de revisarlo y promoverlo a planning.',
+  // Una sola: el recorrido es un agente que encadena check → sync → check. Declarar «Sync» y
+  // «Validate» aparte pintaba dos grupos vacíos en el progreso, porque nunca se entraba a ellos.
   phases: [
-    { title: 'Preflight', detail: 'Resolver proveedor y validar configuración.' },
-    { title: 'Sync', detail: 'Leer remoto mediante su adaptador y refrescar staging.' },
-    { title: 'Validate', detail: 'Validar integración y planning sin promover.' },
+    { title: 'Preflight', detail: 'Resolver proveedor, sincronizar y revalidar staging.' },
   ],
 }
 

package/engine/agents/fork.js

@@ -37,17 +37,9 @@ function inherited(relative) {
 
 const TEXT = /\.(md|ya?ml|json|txt)$/i
 
-function tree(dir, prefix = '') {
-  const found = []
-  let list = []
-  try { list = fs.readdirSync(dir, { withFileTypes: true }) } catch { return found }
-  for (const entry of list) {
-    const relative = prefix ? `${prefix}/${entry.name}` : entry.name
-    if (entry.isDirectory()) found.push(...tree(path.join(dir, entry.name), relative))
-    else found.push(relative)
-  }
-  return found.sort()
-}
+// El mismo recorrido que usa `upgrade` para comparar instancia contra paquete: un cargo es un árbol
+// de archivos como cualquier otro, y tener dos implementaciones sólo daba dos formas de ordenarlos.
+const tree = ownership.treeFiles
 
 // La misma resolución que usa todo lo demás —paquete primero, toolkit después— en vez de deducirla
 // del directorio del motor: la versión que interesa es la del catálogo del que sale la copia.
@@ -89,7 +81,8 @@ function fork(root, slug, date) {
   const target = path.join(root, 'agents', type, slug)
   if (fs.existsSync(target)) throw new Error(`${path.relative(root, target)} ya existe`)
 
-  const files = tree(found.dir).filter(inherited)
+  const todo = tree(found.dir)
+  const files = todo.filter(inherited)
   if (!files.includes('SKILL.md')) throw new Error(`${slug} no tiene SKILL.md: no hay contrato que copiar`)
 
   // El digest sale del origen, no de la copia. Es lo que el catálogo tenía al momento del fork, y es
@@ -118,7 +111,7 @@ function fork(root, slug, date) {
   forks[slug] = { type, version, files: digests }
   manifest.write(root, null, null, forks)
 
-  return { slug, type, dir: target, files, version, skipped: tree(found.dir).filter((one) => !inherited(one)) }
+  return { slug, type, dir: target, files, version, skipped: todo.filter((one) => !inherited(one)) }
 }
 
 // Qué cambió en el catálogo desde que la empresa se llevó su copia.

package/engine/agents/learning.js

@@ -15,10 +15,6 @@ const REQUIRED_SECTIONS = [
   'Aprobación humana',
 ]
 
-function agentRoot(root, agent) {
-  return catalog.resolve(root, agent)
-}
-
 // Un cargo del sistema vive dentro del paquete: escribir ahí perdería el informe en el próximo
 // `npm ci`, y además duplicaría en cada empresa una investigación sobre la profesión que se hace
 // mejor una sola vez. Lo que sí es de esta empresa es su contexto, y ese tiene otro lugar.
@@ -136,7 +132,7 @@ Pendiente.
 }
 
 function evaluate(root, agent) {
-  const target = agentRoot(root, agent)
+  const target = catalog.resolve(root, agent)
   const errors = []
   const requiredFiles = [
     'learning/sources.yaml',
@@ -146,7 +142,7 @@ function evaluate(root, agent) {
   // `AUTOMATION.md` documenta cómo corre la automatización de aprendizaje del toolkit. Exigírselo
   // a una empresa que escribe un cargo propio era pedirle contabilidad interna nuestra: su cargo debe
   // tener contrato, fuentes e historia, no nuestro andamiaje.
-  if (require('./catalog').find(root, agent).system) requiredFiles.push('learning/AUTOMATION.md')
+  if (catalog.find(root, agent).system) requiredFiles.push('learning/AUTOMATION.md')
   for (const relative of requiredFiles) {
     if (!fs.existsSync(path.join(target, relative))) errors.push(`falta ${relative}`)
   }

package/engine/automation/index.js

@@ -12,6 +12,11 @@ const M = require('../core/manifest')
 
 const RUNNER_NAMES = ['claude', 'codex', 'gemini', 'antigravity']
 
+// Los guards que el motor implementa, tomados del registro que los ejecuta. Sale de ahí y no de un
+// número escrito a mano: `automation check` anunciaba «11 guards» cuando hacía rato que eran doce, y
+// un conteo que envejece solo es peor que ninguno —dice que revisó menos de lo que revisó—.
+const GUARD_NAMES = Object.keys(H.guards)
+
 // Adaptadores y workflows viven en el paquete, no en la instancia: son definiciones que el motor
 // consume y que ninguna empresa edita —`RUNNER_NAMES` es cerrado, así que ni siquiera puede agregar
 // uno propio—. Los hooks sí se quedan en el proyecto: la configuración del runner los nombra por
@@ -172,7 +177,7 @@ Respetá los límites de ese contrato y las reglas de \`AGENTS.md\`. Generado po
 }
 
 function installRoleSkills(root, runner, output) {
-  if (!runner.capabilities.nativeSkills || !runner.roleSkills) return 0
+  if (!runner.capabilities.nativeSkills || !runner.roleSkills) return
   const install = installRoot(root)
   const base = F.assertWithin(install, path.resolve(install, runner.roleSkills), `${runner.name}: roleSkills`)
   const roles = roleCatalog(root)
@@ -182,7 +187,6 @@ function installRoleSkills(root, runner, output) {
     F.atomicWrite(file, roleSkill(role))
   }
   if (roles.length) output.log(`✓ ${runner.name}: ${roles.length} cargo(s) disponibles en ${runner.roleSkills}`)
-  return roles.length
 }
 
 // Runners que además de los archivos necesitan un registro propio para que el wiring cuente. Copiar
@@ -267,8 +271,12 @@ function check(root) {
   if (!O.engineAt(root, path.join('hooks', 'run.js'))) {
     errors.push('falta engine/hooks/run.js: corré "npm install" en la raíz del repo ops')
   }
-  const workflows = ['autobuild.js', 'team.js', path.join('integrations', 'sync.js')]
-  workflows.push(path.join('integrations', 'promote.js'))
+  const workflows = [
+    'autobuild.js',
+    'team.js',
+    path.join('integrations', 'sync.js'),
+    path.join('integrations', 'promote.js'),
+  ]
   const packaged = packagedAutomation(root)
   for (const name of workflows) {
     if (!packaged || !fs.existsSync(path.join(packaged, 'workflows', name))) {
@@ -550,16 +558,14 @@ function listHooks(output = console) {
 }
 
 module.exports = {
+  GUARD_NAMES,
   RUNNER_NAMES,
   check,
   doctor,
-  includesConfig,
   install,
   legacyGuardWiring,
-  pruneSupersededHooks,
   roleCatalog,
   roleSkill,
   listHooks,
-  mergeConfig,
   runnerManifest,
 }

package/engine/cli/ops.js

@@ -3,6 +3,7 @@
 
 const fs = require('fs')
 const path = require('path')
+const { spawnSync } = require('child_process')
 const P = require('../planning/parser')
 const B = require('../planning/business-rules')
 const PC = require('../planning/contracts')
@@ -49,7 +50,7 @@ function usage() {
   ops automation doctor <ops-root> claude|codex|gemini|antigravity
   ops automation install <ops-root> claude|codex|gemini|antigravity
   ops learn <agent> [--proposal]
-  ops evaluate <agent> [--cases [--json]] [--bench]
+  ops evaluate <agent> [--cases [--json]] [--bench [caso]]
   ops agents list [ops-root] [--own|--system] [--json]
   ops agents fork <cargo> [ops-root]
   ops team list
@@ -191,12 +192,34 @@ function scaffold(root, { name, mode, force = false, quiet = false }) {
 // es una épica o una entrada de INBOX no tiene dónde escribir, así que se niega. Con razón, y su caso
 // lo cuenta como fallo: eso midió una configuración, no al cargo.
 //
+// **Uno por caso**, y esto se aprendió corriendo. Con un banco compartido, los cinco casos de un
+// cargo corren a la vez sobre el mismo `planning/` y se leen entre sí: un caso tomó por «una sesión
+// anterior de este mismo cargo» lo que otro acababa de escribir, y otro evaluó cuatro candidatas que
+// en su enunciado no existían. Ninguno de los dos cambió de veredicto, pero las respuestas ya no eran
+// las que el caso pedía medir. La independencia entre casos es la premisa de medir con ellos.
+//
 // Se recrea entero en cada corrida. Reutilizarlo dejaría que lo que un cargo escribió el lunes sea
 // contexto del que responde el martes, y dos corridas del mismo caso dejarían de ser comparables.
 // Queda en disco al terminar, gitignorado, porque después de un veredicto raro lo primero que uno
 // quiere es mirar qué escribió el cargo.
-function evaluationBench(root) {
-  const dir = path.join(root, '.cauce-eval')
+function evaluationBench(root, agent, caso) {
+  const safe = (value) => {
+    if (!/^[a-z0-9_][a-z0-9._-]*$/i.test(value) || value.includes('..')) {
+      fail(`nombre inválido para el banco: ${value}`, 2)
+    }
+    return value
+  }
+  const dir = path.join(root, '.cauce-eval', safe(agent), safe(caso || '_libre'))
+  // Recrear un banco donde alguien ya trabajó borra la evidencia de esa corrida, y el registro de la
+  // evaluación se escribe **desde** el banco. Pasó de verdad: se rehizo un banco para probar otra cosa
+  // y con él se fue lo que el cargo había escrito; el juez leyó un directorio vacío y concluyó que la
+  // respuesta afirmaba algo inexistente. Con el banco versionado, «acá se trabajó» es una pregunta que
+  // git contesta exacto.
+  const sucio = spawnSync('git', ['-C', dir, 'status', '--porcelain'], { encoding: 'utf8' })
+  if ((sucio.stdout || '').trim() && !process.argv.includes('--force')) {
+    fail(`${dir} tiene trabajo sin recoger. Guardá el registro de esa corrida antes de rehacerlo, `
+      + 'o usá --force si ya lo tenés.', 2)
+  }
   fs.rmSync(dir, { recursive: true, force: true })
   scaffold(dir, { name: 'Banco de evaluación', mode: 'sidecar', quiet: true })
   // El motor por symlink: la misma resolución que en una instancia real —`node_modules/@ingeniomaps`—
@@ -204,6 +227,22 @@ function evaluationBench(root) {
   const scope = path.join(dir, 'node_modules', '@ingeniomaps')
   fs.mkdirSync(scope, { recursive: true })
   fs.symlinkSync(PROJECT_ROOT, path.join(scope, 'cauce'), 'dir')
+
+  // El banco queda versionado desde su estado limpio, y eso resuelve un problema de medición: la
+  // entrega de un cargo puede no estar en su respuesta. `backend-engineer` contestó un resumen del
+  // webhook y escribió el contrato —firma, orden de verificación, ventana antirreplay, catorce
+  // pruebas— en su `INBOX.md`. El juez, que sólo leía la respuesta, lo dio por ausente y lo reprobó.
+  //
+  // Con el banco versionado, `git status` y `git diff` muestran exactamente qué produjo, separado del
+  // andamiaje. Es la diferencia entre juzgar el resumen y juzgar la entrega. Se ignora `node_modules`
+  // porque es un symlink al toolkit y no es obra del cargo.
+  const git = (...args) => spawnSync('git', ['-C', dir, ...args], { stdio: 'ignore' })
+  fs.appendFileSync(path.join(dir, '.gitignore'), '\nnode_modules/\n')
+  git('init', '-q')
+  git('config', 'user.email', 'banco@cauce.local')
+  git('config', 'user.name', 'banco de evaluación')
+  git('add', '-A')
+  git('commit', '-q', '-m', 'banco limpio')
   return dir
 }
 
@@ -513,13 +552,6 @@ function instanceVersion(root) {
   } catch { return '' }
 }
 
-// Sobrescribe lo que trae el paquete y deja intacto lo demás: un guard propio de la empresa,
-// o un adaptador de runner que el toolkit no conoce, sobreviven a la actualización.
-function overlayTree(from, to, root, skip = []) {
-  F.assertNoSymlinkPath(root, to)
-  copyRuntime(from, to, false, root, skip)
-}
-
 // Actualiza sólo lo que el toolkit declara suyo. Todo lo demás —planning, organization, reglas
 // propias, agentes editados— queda intacto por construcción, no por comparación.
 function upgrade(dir) {
@@ -581,7 +613,9 @@ function upgrade(dir) {
     const origin = path.join(PROJECT_ROOT, O.sourceOf(relative))
     if (!fs.existsSync(origin)) continue
     const target = path.join(root, relative)
-    if (fs.statSync(origin).isDirectory()) overlayTree(origin, target, root)
+    // Sobrescribe lo que trae el paquete y deja intacto lo demás: un guard propio de la empresa,
+    // o un adaptador de runner que el toolkit no conoce, sobreviven a la actualización.
+    if (fs.statSync(origin).isDirectory()) copyRuntime(origin, target, false, root)
     else {
       F.assertNoSymlinkPath(root, target)
       F.atomicWrite(target, fs.readFileSync(origin, 'utf8'))
@@ -650,8 +684,6 @@ function upgrade(dir) {
   for (const entry of FK.drift(root)) console.log(`  ⚠ ${FK.driftLine(entry)}`)
 }
 
-// Lista los cargos visibles resolviendo la precedencia; evita que cada consumidor —CI incluido—
-// reimplemente el recorrido del catálogo.
 // La raíz ops de un comando que no la recibe. El shim `tools/ops.js` la exporta porque sabe dónde
 // vive: sin eso, invocarlo desde otra carpeta —lo normal en sidecar— la resolvía contra el cwd.
 function opsRoot(dir) {
@@ -672,6 +704,8 @@ function agentsFork(slug, dir) {
   console.log(`  reinstalá tu runner para que ${slug} apunte a tu copia`)
 }
 
+// Lista los cargos visibles resolviendo la precedencia; evita que cada consumidor —CI incluido—
+// reimplemente el recorrido del catálogo.
 function agents(action, dir, extra) {
   if (action === 'fork') return agentsFork(dir, extra)
   if (action !== 'list') fail(`Acción de agents desconocida: ${action || '(vacía)'}`, 2)
@@ -845,7 +879,9 @@ function automation(action, rootArg, runnerName) {
     const errors = A.check(root)
     for (const error of errors) console.error(`✗ ${error}`)
     if (errors.length) fail(`${errors.length} error(es) de automatización`)
-    console.log(`✓ automatización válida: 11 guards, ${A.RUNNER_NAMES.length} adaptadores`)
+    console.log(
+      `✓ automatización válida: ${A.GUARD_NAMES.length} guards, ${A.RUNNER_NAMES.length} adaptadores`,
+    )
     return
   }
   if (action === 'doctor') {
@@ -895,7 +931,11 @@ function evaluate(agent) {
       fail('--bench es del toolkit. En una instancia, el cargo trabaja sobre tu planning/: si es del '
         + `catálogo, adoptalo primero con "ops agents fork ${agent}".`, 2)
     }
-    return console.log(evaluationBench(root))
+    // El caso viene detrás de la bandera: `evaluate <cargo> --bench <caso>`. Sin él se arma un banco
+    // suelto, para mirarlo a mano; una corrida real pide uno por caso.
+    const flag = process.argv.indexOf('--bench')
+    const caso = (process.argv[flag + 1] || '').startsWith('--') ? '' : process.argv[flag + 1]
+    return console.log(evaluationBench(root, agent, caso))
   }
   try {
     // Los casos, para que un recorrido los ejecute. Sin `--json` no tiene sentido: es entrada de

package/engine/core/files.js

@@ -51,5 +51,4 @@ module.exports = {
   assertWithin,
   atomicWrite,
   atomicWriteJson,
-  isWithin,
 }

package/engine/core/manifest.js

@@ -94,5 +94,5 @@ function edited(root, relative, files) {
 }
 
 module.exports = {
-  FILE, digest, digestText, edited, prune, read, readForks, readRunners, record, write,
+  digest, digestText, edited, prune, read, readForks, readRunners, record, write,
 }

package/engine/core/ownership.js

@@ -80,28 +80,13 @@ function sourceOf(relative) {
   return relative
 }
 
-// Dónde puede estar el motor. Lo mismo que resuelven `tools/ops.js`, el wrapper de hooks y el bridge
-// de Antigravity: declararlo una vez evita que un consumidor quede afuera.
+// Una ruta cualquiera del paquete: primero la dependencia npm, después el propio repositorio del
+// toolkit corriendo sobre sí mismo. La usan los adaptadores de runner, los workflows y el motor
+// mismo: el motor los consume, el proyecto no los materializa.
 //
-// Dos caminos, no tres: el motor llega por npm, y la tercera entrada es el propio repositorio del
-// toolkit corriendo sobre sí mismo. La copia vendorizada en `.ops/` se retiró en 0.10.0 — ahorraba un
+// Dos caminos, no tres. La copia vendorizada en `.ops/` se retiró en 0.10.0 — ahorraba un
 // `package.json` a cambio de 5 MB en la historia de la empresa y de no poder enterarse de una versión
 // nueva, y Node hace falta igual en los dos casos.
-function engineCandidates(root) {
-  return [
-    path.join(root, 'node_modules', '@ingeniomaps', 'cauce', 'engine'),
-    path.join(root, 'engine'),
-  ]
-}
-
-function engineAt(root, relative = '') {
-  return engineCandidates(root)
-    .map((dir) => (relative ? path.join(dir, relative) : dir))
-    .find((candidate) => fs.existsSync(candidate)) || ''
-}
-
-// Una ruta cualquiera del paquete, en el mismo orden de preferencia que el motor. La usan los
-// adaptadores de runner y los workflows: el motor los consume, el proyecto no los materializa.
 function packagePath(root, relative) {
   const candidates = [
     path.join(root, 'node_modules', '@ingeniomaps', 'cauce', relative),
@@ -110,6 +95,14 @@ function packagePath(root, relative) {
   return candidates.find((candidate) => fs.existsSync(candidate)) || ''
 }
 
+// Dónde quedó el motor. Es `packagePath` bajo `engine/`, y no una cascada propia: había dos copias de
+// la misma lista de candidatos en este archivo, una al lado de la otra, y nada obligaba a que
+// siguieran diciendo lo mismo. La tercera copia vive en el bridge de Antigravity, que corre antes de
+// poder cargar este módulo y por eso la repite a propósito.
+function engineAt(root, relative = '') {
+  return packagePath(root, relative ? path.join('engine', relative) : 'engine')
+}
+
 // Definiciones que consume el motor —cargos y equipos— y que por eso viajan con el paquete en vez
 // de copiarse. Se reconocen por contener `system/`, que es el espacio del toolkit y no algo que un
 // proyecto deba crear. Una sola implementación para las dos, o divergen.
@@ -165,6 +158,10 @@ const RETIRED = [
   '.github/workflows/agent-learning.yml',
   'automatization/runners',
   'automatization/workflows',
+  // Prometía ser el interruptor de los guards —«runner activo y gates requeridos», decía su README—
+  // y no lo leía nadie. Quien corría `install claude` seguía viendo `"runner": "manual"`, y un cargo
+  // que lo leyó dio por configurados unos gates que en realidad decide la configuración del runner.
+  'automatization/config.json',
 ]
 
 // Aprendizaje que quedó dentro de una ruta retirada. Es lo único ahí que no se puede reponer, así
@@ -234,11 +231,9 @@ module.exports = {
   RUNTIME_PATHS,
   retiredWithLearning,
   engineAt,
-  engineCandidates,
   packagePath,
   SYSTEM_COLLECTIONS,
   SYSTEM_FILES,
-  identity,
   localChanges,
   overrides,
   sourceOf,

package/engine/hooks/run.js

@@ -459,5 +459,5 @@ if (require.main === module) {
 }
 
 module.exports = {
-  commandOf, execute, executeAll, fileOf, filesOf, findOpsRoot, guards, hookGroups, hookMetadata,
+  execute, executeAll, findOpsRoot, guards, hookGroups, hookMetadata,
 }

package/engine/integrations/registry.js

@@ -18,10 +18,6 @@ function readJson(file) {
   }
 }
 
-function writeJson(file, value) {
-  F.atomicWriteJson(file, value)
-}
-
 function safeSegment(value, label) {
   const segment = String(value || '')
   if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(segment) || segment === '.' || segment === '..') {
@@ -95,7 +91,7 @@ function validate(root, onlyProvider = '') {
     const secret = sensitivePath(loaded.config)
     if (secret) errors.push(`${name}: ${secret} no puede contener secretos; usa una variable de entorno`)
     try {
-      adapter(name).validateConfig(loaded.config, errors, warnings)
+      adapter(name).validateConfig(loaded.config, errors)
     } catch (error) {
       errors.push(`${name}: ${error.message}`)
     }
@@ -254,11 +250,11 @@ async function sync(root, name, options = {}) {
     }
     fs.mkdirSync(desiredDir, { recursive: true })
     F.atomicWrite(draftFile, draft)
-    writeJson(snapshotFile, snapshot)
+    F.atomicWriteJson(snapshotFile, snapshot)
   }
   const complete = options.complete !== false
   if (complete) cleanupMissing(root, name, seen, result)
-  writeJson(path.join(staging, 'sync-state.json'), {
+  F.atomicWriteJson(path.join(staging, 'sync-state.json'), {
     schemaVersion: 2,
     provider: name,
     complete,
@@ -284,7 +280,7 @@ function cleanupMissing(root, name, seen, result) {
       continue
     }
     snapshot.sync.missingFromRemote = true
-    writeJson(snapshotFile, snapshot)
+    F.atomicWriteJson(snapshotFile, snapshot)
     result.missing++
   }
 }
@@ -364,7 +360,7 @@ function promote(root, name, key) {
   draft = replaceField(draft, 'promotedAt', `"${new Date().toISOString()}"`)
   F.atomicWrite(draftFile, draft)
   snapshot.sync.draftChanged = true
-  writeJson(path.join(dir, 'remote.json'), snapshot)
+  F.atomicWriteJson(path.join(dir, 'remote.json'), snapshot)
   return { key, kind: fields.promotionKind }
 }
 
@@ -385,13 +381,11 @@ const oneLine = (value) => String(value).replace(/\s+/g, ' ').trim()
 module.exports = {
   STATES,
   adapter,
-  draftSections,
   frontmatter,
   promote,
   providerConfig,
   reconcile,
   safeSegment,
-  stagingItems,
   sync,
   validate,
   writebackPlan,

package/engine/integrations/state.js

@@ -220,7 +220,6 @@ function reconcile(root, provider, operation, keys = []) {
 }
 
 module.exports = {
-  CRITICAL_FIELDS,
   STATES,
   categoryOf,
   derive,

package/engine/planning/contracts.js

@@ -79,9 +79,6 @@ function validateRoadmapStructure(dir) {
 }
 
 module.exports = {
-  DECISION_TRACE,
-  EPIC_AUXILIARY_FILES,
-  TEST_TRACE,
   validDecisionTrace,
   validTestTrace,
   validateDoneEntry,

package/engine/planning/parser.js

@@ -6,7 +6,6 @@ const fs = require('fs')
 const path = require('path')
 
 const EPIC_STATES = ['open', 'active', 'closed']
-const TIERS = ['directo', 'lite', 'full']
 
 function read(file) {
   try { return fs.readFileSync(file, 'utf8') } catch { return '' }
@@ -62,7 +61,7 @@ function criteriaRefs(text) {
   return [...new Set(refs)]
 }
 
-function readEpics(dir, { includeTemplates = false } = {}) {
+function readEpics(dir) {
   return epicFiles(dir).map(({ name, file }) => {
     const text = read(file)
     const field = frontmatter(text)
@@ -76,7 +75,6 @@ function readEpics(dir, { includeTemplates = false } = {}) {
     const stories = [...section(text, /Historias/i).matchAll(storyPattern)]
       .map((match) => ({
         slug: match[1].trim(),
-        text: match[2].replace(/\s+/g, ' ').trim(),
         criteria: criteriaRefs(match[2]),
         service: ((match[2].match(/\(service:\s*([^)]+)\)/) || [])[1] || '').trim(),
       }))
@@ -86,12 +84,11 @@ function readEpics(dir, { includeTemplates = false } = {}) {
       num: field('epic'),
       title: field('title'),
       status: field('status'),
-      service: field('service'),
       criteria,
       stories,
       hasContext: /^##\s+Contexto relevante/im.test(text),
     }
-  }).filter((epic) => includeTemplates || epic.status !== 'template' && epic.num !== '000')
+  }).filter((epic) => epic.status !== 'template' && epic.num !== '000')
 }
 
 function readBacklog(dir) {
@@ -110,7 +107,7 @@ function readBacklog(dir) {
     if (!task || !current) continue
     const rest = task[3]
     current.tasks.push({
-      slug: task[1].trim(), tier: task[2] || '', text: rest,
+      slug: task[1].trim(), tier: task[2] || '',
       epic: ((rest.match(/\(epic:\s*(\d{3})\)/) || [])[1] || ''),
       service: ((rest.match(/\(service:\s*([^)]+)\)/) || [])[1] || '').trim(),
       acceptance: ((rest.match(/_Aceptaci[oó]n:\s*([^_]+)_/i) || [])[1] || '').trim(),
@@ -180,5 +177,5 @@ function readInbox(dir) {
 }
 
 module.exports = {
-  EPIC_STATES, TIERS, read, frontmatter, readEpics, readBacklog, readDone, readWip, readInbox,
+  EPIC_STATES, read, frontmatter, readEpics, readBacklog, readDone, readWip, readInbox,
 }

package/package.json

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