@ingeniomaps/cauce 0.21.0 → 0.23.0

package/engine/config/validate.js

@@ -5,13 +5,8 @@ const MODES = ['embedded', 'sidecar', 'toolkit']
 // Campos que existieron y se retiraron. Se nombran en vez de caer en «propiedad desconocida» porque
 // quien actualiza merece saber qué hacer con la línea, no sólo que sobra.
 //
-// `planningDir` era obligatorio y nadie lo honraba: el renderizador de la plantilla lo resolvía
-// siempre a `planning`, y `findOpsRoot` y el registro de integraciones lo tienen escrito a mano. Un
-// campo así no configura, promete. En el propio toolkit decía `template/planning` —el molde que se
-// distribuye—, y un cargo que lo leyó concluyó que ahí vivía la planificación del proyecto.
-//
-// Se retira en vez de honrarse porque la ubicación no es opinable: `findOpsRoot` reconoce un
-// repositorio de operaciones justamente por tener `planning/` en la raíz.
+// `planningDir` no configuraba, prometía: nadie lo honraba y la ubicación no es opinable —`findOpsRoot`
+// reconoce una raíz ops justamente por tener `planning/` en la raíz—.
 const RETIRED = {
   planningDir: 'el motor siempre busca planning/ en la raíz del repositorio. Borrá la línea',
 }

package/engine/core/changelog.js

@@ -8,7 +8,7 @@ const path = require('node:path')
 
 const HEADING = /^##\s*\[([^\]]+)\]/
 
-// Compara versiones semver sin dependencias. Lo no numérico ordena antes que la release.
+// Lo no numérico ordena antes que la release.
 function compare(left, right) {
   const parse = (value) => String(value).split('-')[0].split('.').map((part) => Number(part) || 0)
   const [a, b] = [parse(left), parse(right)]

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

@@ -32,7 +32,7 @@ const SYSTEM_FILES = [
   'organization/README.md',
   // Las reglas que un agente obedece y los atajos que envuelven al CLI. Ninguno tiene una línea de la
   // empresa, y envejecidos mienten: el `AGENTS.md` de una instancia seguía describiendo carpetas que
-  // `upgrade` había retirado, y el Makefile llama 16 veces a comandos que cambian.
+  // `upgrade` había retirado, y el Makefile envuelve comandos que cambian.
   'AGENTS.md',
   'Makefile',
   // El shim no tiene una línea de la empresa —dice él mismo que no se edita— y es por donde entra
@@ -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,24 @@ function packagePath(root, relative) {
   return candidates.find((candidate) => fs.existsSync(candidate)) || ''
 }
 
+// El modo declarado, o '' si no hay configuración. `toolkit` es este repositorio: acá se fabrica
+// Cauce, así que los comandos que actualizan o instalan una instancia sólo pueden romper. Ausente e
+// ilegible no son lo mismo —devolver '' ante un archivo roto dejaba correr contra el toolkit justo
+// lo que reconocerlo impide—, así que lo segundo se levanta como error.
+function mode(root) {
+  const file = path.join(root, 'ops.config.json')
+  if (!fs.existsSync(file)) return ''
+  try { return JSON.parse(fs.readFileSync(file, 'utf8')).mode || '' } catch (error) {
+    throw new Error(`ops.config.json no se puede leer (${error.message}).`)
+  }
+}
+
+// Dónde quedó el motor. El bridge de Antigravity repite esta cascada a mano porque corre antes de
+// poder cargar este módulo: si cambia acá, cambia allá.
+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.
@@ -140,7 +143,6 @@ function entries(dir) {
   } catch { return [] }
 }
 
-// Entradas del proyecto que reemplazan a una del sistema con la misma identidad.
 function overrides(root) {
   const found = []
   for (const collection of SYSTEM_COLLECTIONS) {
@@ -165,6 +167,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í
@@ -195,7 +201,6 @@ function systemPaths(root) {
   return paths
 }
 
-// Archivos de un árbol, relativos a él, para comparar instancia contra paquete.
 function treeFiles(dir, prefix = '') {
   const found = []
   let list = []
@@ -208,7 +213,6 @@ function treeFiles(dir, prefix = '') {
   return found.sort()
 }
 
-// Rutas que Cauce mantiene y que por eso conviene registrar y vigilar.
 function trackedPaths() {
   return [...RUNTIME_PATHS, ...SYSTEM_COLLECTIONS.map((collection) => `${collection}/system`)]
 }
@@ -234,12 +238,11 @@ module.exports = {
   RUNTIME_PATHS,
   retiredWithLearning,
   engineAt,
-  engineCandidates,
   packagePath,
   SYSTEM_COLLECTIONS,
   SYSTEM_FILES,
-  identity,
   localChanges,
+  mode,
   overrides,
   sourceOf,
   systemPaths,

package/engine/hooks/run.js

@@ -1,15 +1,21 @@
 #!/usr/bin/env node
 'use strict'
 
-const fs = require('fs')
-const os = require('os')
-const path = require('path')
-const { spawnSync } = require('child_process')
-
+const fs = require('node:fs')
+const os = require('node:os')
+const path = require('node:path')
+const { spawnSync } = require('node:child_process')
+
+// Sin stdin no hay nada que leer y los guards caen a las variables de entorno; con stdin ilegible sí
+// hay algo y no se entiende, que es otra cosa. Devolver `{}` ahí dejaba a cada guard sin comando ni
+// archivos, o sea permitiendo todo, y en silencio.
 function readInput() {
   let raw = ''
-  try { raw = fs.readFileSync(0, 'utf8') } catch { /* no stdin */ }
-  try { return raw.trim() ? JSON.parse(raw) : {} } catch { return {} }
+  try { raw = fs.readFileSync(0, 'utf8') } catch { /* sin stdin */ }
+  if (!raw.trim()) return {}
+  try { return JSON.parse(raw) } catch (error) {
+    block(`la entrada del hook no es JSON válido (${error.message}).`)
+  }
 }
 
 function commandOf(input) {
@@ -55,6 +61,15 @@ function block(message) {
   throw error
 }
 
+// La configuración de la raíz ops. Un guard que no puede leerla bloquea: `findOpsRoot` sólo devuelve
+// una raíz si `ops.config.json` existe, así que llegar acá significa roto o ilegible, no ausente.
+// Dejarlo pasar convertía una coma de más en «sin límite de escritura».
+function configOf(root) {
+  try { return JSON.parse(fs.readFileSync(path.join(root, 'ops.config.json'), 'utf8')) } catch (error) {
+    block(`ops.config.json no se puede leer (${error.message}). Un guard no decide sin él.`)
+  }
+}
+
 function gitDirectory(command, cwd) {
   const flag = command.match(/(?:^|\s)git\s+-C\s+(['"]?)([^\s'";&|]+)\1/)
   const cd = command.match(/(?:^|[;&|]\s*)cd\s+(['"]?)([^\s'";&|]+)\1/)
@@ -146,8 +161,7 @@ function generated(input) {
 function workspaceBoundary(input) {
   const root = findOpsRoot(process.env.OPS_ROOT || process.env.CLAUDE_PROJECT_DIR || cwdOf(input))
   if (!root) return
-  let config
-  try { config = JSON.parse(fs.readFileSync(path.join(root, 'ops.config.json'), 'utf8')) } catch { return }
+  const config = configOf(root)
   const allowed = [root, ...(config.workspaceRoots || []).map((entry) => path.resolve(root, entry.path))]
   for (const raw of filesOf(input)) {
     const file = path.resolve(cwdOf(input), raw)
@@ -228,22 +242,14 @@ function governance(input) {
   const command = commandOf(input)
   if (!isCommit(command)) return
   const dir = gitDirectory(command, cwdOf(input))
-  // El contrato de un cargo y lo que lo mide son gobernanza, igual que un ADR o una regla.
-  //
-  // Lo puntual es la firma: `agent-promote` se niega si «Aprobación humana» no está firmada, pero lo
-  // único que impedía que la escribiera un agente era una frase en un prompt. Una instrucción, no un
-  // candado — y el archivo no estaba protegido por nada.
+  // El contrato de un cargo y lo que lo mide son gobernanza, igual que un ADR o una regla. La firma de
+  // «Aprobación humana» sólo estaba protegida por una frase en un prompt; `SKILL.md` y `references/`
+  // son lo que la propuesta cambia, y editarlos directo saltea el ciclo entero; y `evaluations/` es el
+  // denominador con que se juzga, así que moverlo ablanda toda medición pasada sin tocar una regla.
   //
-  // Alrededor de la firma van las otras tres piezas del mismo acto. `SKILL.md` y `references/` son lo
-  // que la propuesta cambia: sin ellos, editar el contrato directo saltea el ciclo entero. Y
-  // `evaluations/` es el denominador con que se juzga —el propio recorrido de propuesta dice que
-  // cambiarlo «es parte de lo que se aprueba»—, así que moverlo en silencio ablanda toda medición
-  // pasada sin tocar una sola regla.
-  //
-  // Quedan afuera las dos clases de evidencia, y por la misma razón: registran lo que pasó un día en
-  // vez de decidir algo. `learning/reports/` es lo investigado esa semana, y `evaluations/results/` la
-  // transcripción de una corrida —que se escribe en cada evaluación, así que gobernarla pediría un
-  // override por corrida—. Por eso `evaluations/` se nombra por partes en vez de entero.
+  // Quedan afuera las dos clases de evidencia, que registran lo que pasó un día en vez de decidir algo:
+  // `learning/reports/` y `evaluations/results/` —esta última se escribe en cada corrida, así que
+  // gobernarla pediría un override por evaluación—. Por eso `evaluations/` se nombra por partes.
   const governedPattern = new RegExp(
     String.raw`^(?:(?:template\/)?planning\/(?:rules\/|adr\/|PROTOCOL\.md|` +
       String.raw`METHODOLOGY\.md|FLOW\.md)|automatization\/|engine\/` +
@@ -351,21 +357,16 @@ function planningDrift(input) {
   block(`Planning o integraciones quedaron desalineados:\n${result.output}`)
 }
 
-// El motor llega por npm y se actualiza por npm. `workspace-boundary` no lo cubre: en una instalación
-// `node_modules/` cae dentro de la raíz declarada, así que editar el motor le parece legítimo.
-//
-// Editarlo desde la empresa rompe dos veces. El próximo `npm install` borra el cambio sin avisar, así
-// que el arreglo se pierde justo cuando alguien creyó haberlo hecho; y hasta entonces la empresa corre
-// un motor que no coincide con la versión que declara, que es la clase de diferencia que aparece como
-// un bug irreproducible. Un problema del motor se reporta y se arregla arriba, no acá.
+// Hace falta un guard aparte porque `workspace-boundary` no lo cubre: `node_modules/` cae dentro de
+// la raíz declarada, así que editar el motor le parece legítimo.
 //
-// El toolkit se exceptúa, y esa distinción ya estaba escrita: en su `ops.config.json` el modo es
-// `toolkit`. Ahí el motor es el producto y editarlo es exactamente el trabajo.
+// Editarlo rompe dos veces: el próximo `npm install` borra el cambio sin avisar, y hasta entonces la
+// empresa corre un motor que no coincide con la versión que declara —la clase de diferencia que
+// aparece como un bug irreproducible—. En modo `toolkit` no aplica: ahí el motor es el producto.
 function engineWrites(input) {
   const root = findOpsRoot(process.env.OPS_ROOT || process.env.CLAUDE_PROJECT_DIR || cwdOf(input))
   if (!root) return
-  let config
-  try { config = JSON.parse(fs.readFileSync(path.join(root, 'ops.config.json'), 'utf8')) } catch { return }
+  const config = configOf(root)
   if (config.mode === 'toolkit') return
   const pkg = path.join(root, 'node_modules', '@ingeniomaps', 'cauce')
   for (const raw of filesOf(input)) {
@@ -459,5 +460,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/proposals.js

@@ -17,7 +17,9 @@ function read(root, provider) {
     const content = fs.readFileSync(path.join(dir, file), 'utf8')
     const fields = S.frontmatter(content)
     const body = content.replace(/^---[\s\S]*?---\s*/, '')
-    const summary = ((body.match(/^#\s+(.+)$/m) || [])[1] || '').trim()
+    // `[ \t]` y no `\s`: `\s` casa el salto de línea, así que un `#` vacío se comía la siguiente
+    // línea no vacía y devolvía «## Descripción» como título. Con eso, «falta título» no saltaba nunca.
+    const summary = ((body.match(/^#[ \t]+(.+)$/m) || [])[1] || '').trim()
     const description = ((body.match(
       /^##\s+Descripción\s*\n([\s\S]*?)(?=^##\s+|(?![\s\S]))/im,
     ) || [])[1] || '').trim()

package/engine/integrations/registry.js

@@ -2,8 +2,8 @@
 
 // Registro y ciclo común de proveedores externos.
 
-const fs = require('fs')
-const path = require('path')
+const fs = require('node:fs')
+const path = require('node:path')
 const F = require('../core/files')
 const S = require('./state')
 const P = require('./proposals')
@@ -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,14 +250,17 @@ 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'), {
+  // Siempre se limpia: ningún adaptador puede devolver una lectura parcial. El de Jira lanza al
+  // exceder páginas, al repetir un token y ante cualquier HTTP que no sea 200, así que o trajo todo o
+  // no trajo nada. Había una bandera `complete` para saltearlo, sin forma de activarla desde el CLI y
+  // sin nadie que leyera el campo que escribía. Vuelve el día que un adaptador sepa decir «traje una
+  // parte», que es cuando protegería algo.
+  cleanupMissing(root, name, seen, result)
+  F.atomicWriteJson(path.join(staging, 'sync-state.json'), {
     schemaVersion: 2,
     provider: name,
-    complete,
     pulledAt: new Date().toISOString(),
     keys: [...seen].sort(),
   })
@@ -284,7 +283,7 @@ function cleanupMissing(root, name, seen, result) {
       continue
     }
     snapshot.sync.missingFromRemote = true
-    writeJson(snapshotFile, snapshot)
+    F.atomicWriteJson(snapshotFile, snapshot)
     result.missing++
   }
 }
@@ -364,7 +363,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 +384,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

@@ -45,7 +45,7 @@ function replaceField(text, name, value) {
 
 function sections(text) {
   const body = String(text).replace(/^---[\s\S]*?---\s*/, '')
-  const title = ((body.match(/^#\s+(.+)$/m) || [])[1] || '').trim()
+  const title = ((body.match(/^#[ \t]+(.+)$/m) || [])[1] || '').trim()
   const result = { title }
   const names = ['Descripción', 'Aceptación', 'Comentarios', 'Decisiones', 'Problemas de preparación']
   for (const [index, name] of names.entries()) {
@@ -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

@@ -2,11 +2,10 @@
 
 // Contratos deterministas de planning; no contiene estado de proyecto.
 
-const fs = require('fs')
-const path = require('path')
+const fs = require('node:fs')
+const path = require('node: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/engine/teams/registry.js

@@ -1,7 +1,7 @@
 'use strict'
 
-const fs = require('fs')
-const path = require('path')
+const fs = require('node:fs')
+const path = require('node:path')
 const catalog = require('../agents/catalog')
 
 const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/
@@ -51,8 +51,12 @@ function validate(root, slug) {
   }
   if (!OUTCOMES.includes(manifest.outcome)) errors.push(`outcome debe ser ${OUTCOMES.join(' o ')}`)
   if (!Array.isArray(manifest.stages) || !manifest.stages.length) errors.push('stages debe contener etapas')
-  if (!Array.isArray(manifest.guardrails) || !manifest.guardrails.length) errors.push('guardrails debe contener controles')
-  if (!Array.isArray(manifest.completion) || !manifest.completion.length) errors.push('completion debe contener criterios')
+  if (!Array.isArray(manifest.guardrails) || !manifest.guardrails.length) {
+    errors.push('guardrails debe contener controles')
+  }
+  if (!Array.isArray(manifest.completion) || !manifest.completion.length) {
+    errors.push('completion debe contener criterios')
+  }
 
   const agents = new Set([manifest.entryAgent, manifest.facilitator])
   for (const agent of Object.values(manifest.decisionOwners || {})) agents.add(agent)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "type": "commonjs",
   "bin": {
@@ -24,6 +24,7 @@
     "integration:check": "node engine/cli/ops.js integration check template jira",
     "test": "bash test/hooks-smoke.sh && node --test test/*.test.js",
     "coverage": "bash test/coverage.sh",
+    "coverage:update": "bash test/coverage.sh --update",
     "ci": "npm run check && npm run automation:check && npm run integration:check && npm run coverage"
   },
   "engines": {

package/template/AGENTS.md

@@ -1,7 +1,9 @@
 # Reglas de construcción
 
 Este archivo gobierna el qué y el cuándo. `planning/PROTOCOL.md` gobierna el flujo y
-`planning/rules/` el cómo.
+`planning/rules/` el cómo: sus reglas rigen cada tarea y se leen antes de empezar, no cuando algo sale
+mal. Ahí está la conducta que no depende de este proyecto —trato con sistemas externos, qué se debe
+entregar aun al negarse—; acá, lo que sí depende.
 
 ## Mapa real
 
@@ -16,14 +18,8 @@ El mapa no debe duplicar documentación técnica: enlaza a la fuente de verdad d
 
 ## Integraciones y ambientes
 
-Por defecto, todo sistema externo se considera real y de solo lectura. Sin aprobación humana explícita:
-
-- no desplegar, publicar, enviar mensajes ni escribir en producción;
-- no cobrar, reembolsar, gastar créditos ni llamar APIs con costo de forma repetida;
-- no editar secretos, credenciales, DNS, permisos o cuentas;
-- no borrar datos ni ejecutar migraciones irreversibles.
-
-Documentar excepciones concretas aquí. Un entorno de desarrollo o sandbox debe nombrarse explícitamente.
+R12 fija el trato con todo sistema externo: real y de sólo lectura mientras no se lo nombre como
+sandbox. Las excepciones de este proyecto —y sólo ellas— van acá, con el entorno concreto.
 
 ## Cargos disponibles
 
@@ -32,7 +28,19 @@ decide, qué no le corresponde y cuál es su entrega mínima; sus métodos viven
 
 Antes de resolver algo que cae claramente en un cargo —una decisión de producto, un diseño de
 arquitectura, una estrategia de pruebas—, adoptá ese contrato en vez de improvisar el criterio. Los
-límites del cargo no son sugerencias: un cargo que no puede decidir solo, no decide solo.
+límites del cargo no son sugerencias: un cargo que no puede decidir solo, no decide solo. Su
+contraparte es R13: el que se niega bien y no deja nada tampoco cumplió.
+
+Para saber cuál es, una línea por cargo:
+
+```bash
+node tools/ops.js agents list                # quién hace qué y qué NO le corresponde
+```
+
+Se elige leyendo esa lista, no abriendo carpetas. Si ninguna línea encaja, el cargo no existe y el
+camino es escribir el propio en `agents/roles/<slug>/`; forzar el más parecido es peor que no usar
+ninguno. Si encaja pero lo querés más enfocado en esta empresa, el contexto va en
+`organization/roles/<slug>.md` y el contrato sigue siendo el de Cauce.
 
 En Claude y Antigravity los cargos aparecen como skills invocables por nombre. En Codex y Gemini no hay
 mecanismo nativo: leé directamente el `SKILL.md` del cargo. Los que trae
@@ -52,7 +60,7 @@ Los cargos **propios** son otra cosa: nadie más los va a investigar. Su ciclo e
 comando, sin cron —activarlo en tu repositorio es decisión tuya—:
 
 ```bash
-node tools/ops.js agents list --own          # sólo los tuyos, sin los 47 del catálogo
+node tools/ops.js agents list --own          # sólo los tuyos, sin los del catálogo
 node tools/ops.js learn <slug>               # arma el informe de la semana
 /agent-propose <slug>                        # escribe el cambio concreto sobre esos informes
 #   ↑ firmá «Aprobación humana» en la propuesta antes de seguir
@@ -64,26 +72,6 @@ Un cargo propio puede declarar en `learning/AUTOMATION.md` qué debe investigar
 Si su profesión no existe fuera de tu empresa, sus fuentes son internas: lo que aprende sale de sus
 propias decisiones, no de un estándar de afuera.
 
-## Negarse no es entregar
-
-Cada límite de un cargo tiene una contraparte positiva, y respetar el límite no exime de ella. Un cargo
-que se niega bien y no deja nada dejó el pedido sin resolver: hizo la mitad barata del trabajo.
-
-- **Ante falta de contexto, producir el borrador reversible marcado como supuesto, no bloquear pidiendo
-  insumos.** Pedir una decisión humana sólo cuando las opciones cambien materialmente el rumbo, el
-  gasto, una obligación externa o el riesgo. Un borrador que se puede tirar no cambia ninguna de esas
-  cosas; no entregarlo, sí.
-- **Delimitar el espacio de decisión no es decidir.** Enumerar las opciones y pedir que alguien elija
-  es trabajo a medias cuando ninguna de ellas cambia materialmente el rumbo: en ese caso se propone una,
-  con su razón, marcada como propuesta.
-- **Todo rechazo se acompaña de lo que sí corresponde hacer**, dicho como acción concreta y no como
-  categoría. «Esto no me corresponde» sin decir a quién ni con qué pregunta deja el pedido donde estaba.
-- **Nombrar lo que falta no reemplaza a entregar lo que se puede.** Lo que sí se pudo establecer se
-  escribe igual, aunque el resultado quede parcial y marcado como tal.
-
-Esto no afloja ningún límite: no promover, no prometer fechas, no inventar evidencia y no exceder la
-autoridad del cargo siguen siendo absolutos. Lo que se cierra es la salida de cumplirlos sin entregar.
-
 ## Qué se puede editar y qué no
 
 Todo directorio `system/` pertenece a Cauce y se reemplaza completo al actualizar. **Nunca editar nada

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/planning/rules/README.md

@@ -5,6 +5,7 @@
 - `system/process.md`: planificación, alcance, review y sincronización de estado.
 - `system/code-shape.md`: simplicidad y forma del cambio.
 - `system/commits.md`: historia versionada y entrega.
+- `system/conduct.md`: trato con sistemas externos y obligación de entregar al negarse.
 
 Las reglas propias del proyecto van en este directorio, junto a `system/`, y nunca se tocan al
 actualizar. Para cambiar una regla del sistema, escribí la tuya con el mismo nombre: la del proyecto

package/template/planning/rules/system/code-shape.md

@@ -12,3 +12,8 @@ No reformatear, renombrar ni reparar elementos ajenos a la tarea.
 
 Extraer responsabilidades cuando una unidad deja de poder entenderse y probarse aisladamente; no usar
 límites numéricos como sustituto del juicio.
+
+## R11 — Comentarios que explican el porqué
+
+Un comentario dice por qué el código es así, no qué hace: si el código ya lo dice, sobra. Cada razón
+vive en un solo lugar, y un bloque de más de tres líneas tiene que justificar su largo.