@ingeniomaps/cauce 0.97.0 → 0.98.0

package/engine/hooks/self-approval.js

@@ -24,7 +24,7 @@ const CHAT_RECORD = (file) => `${file} es el registro de lo que la persona dijo
   + 'runner, nunca una herramienta.'
 
 const SELF = (file) => `${file} es la aprobación de una persona, y escribírsela es aprobarse solo. Si la `
-  + 'persona quiere autorizar algo, que lo diga en el chat —nombrándolo, o contestando «dale» al bloqueo— o '
+  + 'persona quiere autorizar algo, que lo diga en el chat —nombrándolo, o confirmando el bloqueo— o '
   + 'que edite el archivo ella.'
 
 // Las líneas van en el mensaje porque son lo que el «dale» va a aprobar: una confirmación que no muestra
@@ -32,7 +32,7 @@ const SELF = (file) => `${file} es la aprobación de una persona, y escribírsel
 const UNASKED = (file, missing) => `${file} es la aprobación de una persona y estas líneas no las pidió:\n`
   + missing.map((line) => `  ${line}\n`).join('')
   + 'Escribí sólo lo que ella nombró en su mensaje. Si hacen falta las otras, decile cuáles y por qué, y '
-  + 'esperá: si contesta «dale», reintentá la misma escritura y pasa.'
+  + 'pedile que lo confirme con sus palabras: si lo que contesta es un sí, reintentá la misma escritura y pasa.'
 
 // **Por shell se frena toda escritura.** Es la misma decisión que toma `ops-config`, y por qué un comando
 // no se puede comparar está escrito allá. Lo que la trae hasta acá es que el contenido es lo único que

package/engine/hooks/shell.js

@@ -193,6 +193,39 @@ function gitAdd(input) {
   }
 }
 
+// Un `package.json` cambia sin tocar nada de lo que su lockfile registra: un script, una descripción, la
+// configuración de una herramienta. Frenar eso por la sola presencia del archivo en el índice obligaba a
+// pedir permiso por un cambio sin riesgo (caso 181). Se deja pasar sólo lo medido, y lo demás frena como
+// antes, incluido lo que no se puede comparar.
+//
+// La lista salió de correr `npm install --package-lock-only` con npm 11.16.0 cambiando una clave por vez:
+// las claves name, version, license, engines, bin, funding, workspaces, os y cpu, y los scripts preinstall,
+// install y postinstall, sí mueven el lock. Sólo se midió el lock de npm, así que con otro gestor no se
+// afloja nada.
+const INERT_KEYS = new Set([
+  'scripts', 'description', 'keywords', 'author', 'repository', 'homepage', 'bugs', 'private', 'type',
+  'main', 'files', 'exports', 'config', 'jest', 'eslintConfig', 'prettier',
+])
+const INSTALL_SCRIPTS = ['preinstall', 'install', 'postinstall']
+
+function lockUnaffected(dir, file, lockfiles) {
+  if (path.basename(file) !== 'package.json' || lockfiles.join() !== 'package-lock.json') return false
+  const read = (ref) => {
+    const shown = run('git', ['-C', dir, 'show', `${ref}:${file}`], dir)
+    if (!shown.ok) return null
+    try { return JSON.parse(shown.output) } catch { return null }
+  }
+  const before = read('HEAD')
+  const after = read('')
+  if (!before || !after || typeof before !== 'object' || typeof after !== 'object') return false
+  const same = (one, other) => JSON.stringify(one) === JSON.stringify(other)
+  const changed = [...new Set([...Object.keys(before), ...Object.keys(after)])]
+    .filter((key) => !same(before[key], after[key]))
+  if (changed.some((key) => !INERT_KEYS.has(key))) return false
+  const scripts = (one) => (one && typeof one.scripts === 'object' ? one.scripts : {}) || {}
+  return INSTALL_SCRIPTS.every((name) => same(scripts(before)[name], scripts(after)[name]))
+}
+
 function dependencies(input) {
   if (process.env.OPS_DEPENDENCIES_OVERRIDE === '1') return
   const command = commandOf(input)
@@ -250,6 +283,7 @@ function dependencies(input) {
       block(`${parent}: hay varios lockfiles (${onDisk.join(', ')}). Conserva uno solo.`)
     }
     const manifests = sinAprobar(parent, state.manifests)
+      .filter((name) => !lockUnaffected(dir, name, existingLocks))
     if (state.manifests.length && existingLocks.length && !state.locks.length && manifests.length) {
       block(`${parent}: cambió ${state.manifests.join(', ')} sin actualizar su lockfile.\n`
         + AP.HOW('OPS_DEPENDENCIES_OVERRIDE', manifests, input))

package/package.json

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

package/template/AGENTS.md

@@ -57,7 +57,7 @@ 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 del catálogo
-node tools/ops.js learn <slug>               # arma el informe de la semana
+node tools/ops.js learn <slug>               # arma el informe de investigación
 /agent-propose <slug>                        # escribe el cambio concreto sobre esos informes
 #   ↑ firmá «Aprobación humana» en la propuesta antes de seguir
 /agent-promote <slug>                        # lo aplica, registra y manda a verificar
@@ -108,8 +108,9 @@ te frena es el peor para elegir bien.
 **Si lo pediste vos en el chat, no hace falta nada.** Los guards contienen al agente cuando decide solo o
 cuando trabaja dentro de un recorrido; lo que vos pedís directo no se frena. Nombrá lo que querés que
 toque —«borrá la prueba de altas», «reescribí la migración 004»— y pasa sin preguntarte de nuevo. Si tu
-pedido no lo nombraba y algo se frena, el agente te dice qué y por qué: contestá «dale» y pasa exactamente
-eso. **Con los gates de un commit se pregunta cada vez**, como con publicar: gobernanza, los gates del
+pedido no lo nombraba y algo se frena, el agente te dice qué y por qué: confirmalo con tus palabras —un
+«dale» alcanza, pero no hace falta esa palabra— y pasa exactamente eso. Si contestás negando, frenando o
+preguntando, no pasa. **Con los gates de un commit se pregunta cada vez**, como con publicar: gobernanza, los gates del
 stack y los lockfiles no heredan lo que autorizaste en un mensaje anterior, porque cada commit es otra
 operación. Y `plan-first` no te pide un plan cuando el cambio lo pediste vos: el plan es para el trabajo que va
 por tareas. Funciona en Claude Code, Codex y Gemini, que le avisan a Cauce cuando mandás un mensaje; en
@@ -258,7 +259,7 @@ Publicar es lo único de todo eso que este proyecto puede habilitar, y `runner.a
 `ops.config.json` es la autorización que R10 pide para las ramas de trabajo. La rama viva —`main`,
 `master` o la rama por defecto del remoto— no la alcanza si el proyecto no la nombra en
 `runner.pushToLiveBranches`, y un subagente no publica con ningún permiso. Sin la llave, pasa el push
-que la persona pide en el chat nombrando el remoto y la rama, o el que ella aprueba contestando «dale».
+que la persona pide en el chat nombrando el remoto y la rama, o el que ella confirma cuando se frena.
 Reescribir historia publicada no entra en el trato: un `push --force` se frena con la llave prendida o
 apagada.
 

package/template/Makefile

@@ -53,7 +53,7 @@ integration-promote: require-key ## Promueve el draft KEY=<clave> al roadmap
 require-agent:
 	@test -n "$(AGENT)" || (echo "Falta AGENT=<slug>" >&2; exit 2)
 
-agent-learn: require-agent ## Prepara el informe semanal de AGENT=<slug>
+agent-learn: require-agent ## Prepara el informe de investigación de AGENT=<slug>
 	@node tools/ops.js learn "$(AGENT)"
 
 agent-propose: require-agent ## Consolida una propuesta para AGENT=<slug>