@ingeniomaps/cauce 0.21.0 → 0.22.0

package/automatization/workflows/agent-eval.js

@@ -161,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')
@@ -209,6 +210,16 @@ function evaluationBench(root, agent, caso) {
     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`—
@@ -216,6 +227,22 @@ function evaluationBench(root, agent, caso) {
   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
 }
 
@@ -525,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) {
@@ -593,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'))
@@ -662,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) {
@@ -684,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)
@@ -857,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') {

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.21.0",
+  "version": "0.22.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "type": "commonjs",
   "bin": {

package/template/automatization/README.md

@@ -3,10 +3,13 @@
 Wiring local entre `planning/PROTOCOL.md` y el runner elegido. El proyecto empieza en modo manual y seguro;
 ningún runner se activa solo.
 
-- `config.json`: runner activo y gates requeridos.
 - `hooks/`: los guards que se ejecutan. Acá va también el tuyo: agregalo con otro nombre y registralo
   en la configuración de tu runner, que es del proyecto y sobrevive a cada actualización.
 
+Qué guard corre y cuándo lo decide la configuración de tu runner —`.claude/settings.json` y sus
+equivalentes—, que es la única fuente: la escribe `automation install` y la lee la herramienta. Para
+desactivar un guard, quitá su entrada de ahí. `automation list-hooks` enumera los que existen.
+
 Los adaptadores de runner y los workflows no se copian acá: son definiciones que el motor consume y
 viajan con Cauce, igual que el catálogo de cargos y los equipos. `automation install` los lee desde ahí.
 

package/template/automatization/config.json

@@ -1,13 +0,0 @@
-{
-  "schemaVersion": 1,
-  "runner": "manual",
-  "protocol": "planning/PROTOCOL.md",
-  "gates": {
-    "destructiveCommands": true,
-    "secrets": true,
-    "integrationSnapshots": true,
-    "verifyBeforeCommit": true,
-    "validateOnStop": true,
-    "humanCheckpointBetweenMilestones": true
-  }
-}