@ingeniomaps/cauce 0.99.0 → 0.99.2

package/CHANGELOG.md

@@ -14,6 +14,34 @@ desde este repositorio no va, porque el que lee no puede actuar sobre eso. Cuand
 unas pocas líneas casi siempre es porque cuenta cómo se descubrió el problema o por qué se eligió el
 diseño — eso vive en el commit y en el código.
 
+## [0.99.2] - 2026-09-28
+
+### Corregido
+
+- **Cada límite de `### Límites` llega una sola vez.** Si la primera viñeta empezaba con «El runner»,
+  «Debe» o «Nunca», la lista entera llegaba otra vez a cada agente, pegada en un límite más. Si reordenaste
+  tus viñetas para esquivarlo, ya podés dejarlas como quieras.
+- **`check` deja de avisar que una fila resuelta de `HUMAN_ACTIONS.md` no está commiteada cuando sí lo
+  está.** Pasaba con filas largas: la búsqueda de git que usaba no encuentra algunas de más de 256 bytes.
+  Ahora se compara contra el archivo commiteado, y una fila que pasó a resuelta sólo en tu árbol se sigue
+  avisando.
+
+## [0.99.1] - 2026-09-25
+
+### Cambiado
+
+- **Una lectura de credencial que necesitás siempre se aprueba una vez.** Cuando el agente se frena leyendo
+  una credencial, te pregunta además si querés dejarla aprobada para siempre. Si esa es tu intención —con
+  tus palabras, sin frase fija—, él mismo escribe la ruta en `planning/.ops-approval` con quién lo aprobó y
+  para qué, y ninguna sesión vuelve a preguntarlo. Tu confirmación le deja escribir esa línea y ninguna otra.
+- **Confirmar el bloqueo de `.ops-approval` ahora aprueba.** Si el agente intenta escribir la aprobación sin
+  que se la hayas pedido, el bloqueo te muestra qué iba a agregar y tu «sí» lo deja pasar. Antes el bloqueo
+  ofrecía confirmar y la confirmación no hacía nada: sólo pasaba pidiéndolo con el nombre del archivo.
+- **El bloqueo dice cuánto dura una línea pegada**: hasta que alguien la borre. Decía que dejaba de valer
+  «en cuanto cambie», y una lectura siempre frena la misma ruta, así que nunca cambiaba.
+- **`check` nombra aparte las credenciales aprobadas** —«N credencial(es) aprobadas hasta que se borre su
+  línea»—, en vez de contarlas como una aprobación olvidada. Sigue mostrándolas en cada corrida.
+
 ## [0.99.0] - 2026-09-24
 
 ### Agregado

package/agents/roles/system/ai-product-manager/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/analytics-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/backend-engineer/learning/HISTORY.md

@@ -5,3 +5,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | Nada: el período se revisó y se decidió no cambiar ningún contrato. |
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/cloud-architect/learning/HISTORY.md

@@ -5,3 +5,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-30 | `agents/roles/system/cloud-architect/learning/proposals/2026-08.md` | Aprobada | @ingeniomaps | `agents/roles/system/cloud-architect/SKILL.md` |
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/customer-success-manager/learning/HISTORY.md

@@ -5,3 +5,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `SKILL.md` (párrafo nuevo al final de «Construir contexto»); `learning/proposals/2026-08.md`. Dos desviaciones, escritas al final de «Aprobación humana» de la propuesta: (1) los ejemplos del párrafo se adaptaron al vocabulario del cargo —la propuesta autoriza adaptar la redacción y la licencia se usó sólo en esa lista: donde decía «Delighted, una herramienta de analítica», el `SKILL.md` dice «la encuesta de NPS o CSAT, el producto de analítica», porque Delighted es el proveedor del caso `07-nps-que-subio` y nombrarlo metía un caso de evaluación dentro del contrato del cargo—; el resto entró literal, incluida «abstenerse cubre lo que no se puede consultar, no lo que cuesta abrir una página», y en la ubicación que la propuesta fija; (2) no se re-corrió `07-nps-que-subio`, que la sección «Evaluación» pide como confirmación: esta aplicación se limitó a «Cambio propuesto», y hasta que exista ese veredicto el efecto del párrafo en este cargo no está medido. Sin caso adversarial nuevo: la propuesta acota el cambio al párrafo y nada más. |
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/data-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/data-governance-steward/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/devops-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/engineering-manager/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/engineering-manager/learning/sources.yaml

@@ -17,7 +17,7 @@ sources:
     tier: profession
     topics: [developer-productivity, wellbeing, flow, collaboration]
   - name: Google re Work team effectiveness
-    url: https://rework.withgoogle.com/intl/en/guides/understanding-team-effectiveness
+    url: https://rework.withgoogle.com/intl/en/guides/understand-team-effectiveness
     tier: profession
     topics: [psychological-safety, effectiveness]
   - name: ACM Code of Ethics

package/agents/roles/system/engineering-manager/references/operating-model.md

@@ -54,7 +54,7 @@ Combinar satisfacción/bienestar, performance/outcomes, actividad contextual, co
 
 - [DORA Capabilities](https://dora.dev/capabilities/): entrega sostenible, feedback, cultura y desempeño organizacional.
 - **SPACE Framework**, ACM Queue 19(1) (sin enlace: `queue.acm.org` bloquea): productividad multidimensional, no reducible a actividad.
-- [Google re:Work — Understand team effectiveness](https://rework.withgoogle.com/intl/en/guides/understanding-team-effectiveness): seguridad psicológica, confiabilidad, estructura, significado e impacto.
+- [Google re:Work — Understand team effectiveness](https://rework.withgoogle.com/intl/en/guides/understand-team-effectiveness): seguridad psicológica, confiabilidad, estructura, significado e impacto.
 - [ACM Code of Ethics](https://www.acm.org/binaries/content/assets/about/acm-code-of-ethics-booklet.pdf): bienestar, justicia, privacidad, competencia y liderazgo responsable.
 
 Verificar políticas laborales, jurisdicción y contexto real de cada empresa.

package/agents/roles/system/machine-learning-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/mlops-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/mobile-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/product-manager/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/site-reliability-engineer/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/software-architect/learning/HISTORY.md

@@ -4,3 +4,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `2026-09.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/agents/roles/system/ui-designer/learning/HISTORY.md

@@ -6,3 +6,4 @@ Una fila por propuesta cerrada: cuándo, cuál, qué se decidió —aplicarla o
 |---|---|---|---|---|
 | 2026-08-30 | `agents/roles/system/ui-designer/learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `agents/roles/system/ui-designer/SKILL.md` |
 | 2026-08-30 | `agents/roles/system/ui-designer/learning/proposals/2026-09.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | `agents/roles/system/ui-designer/SKILL.md` |
+| 2026-09-01 | `2026-09-r2.md` | archivada | malpisa1@gmail.com | Se archivó sin decidir: el documento quedó con el molde. |

package/automatization/workflows/agent-promote.js

@@ -184,9 +184,11 @@ await agent(
 // Sellar es lo último: hasta que el cambio no está aplicado y registrado, la propuesta sigue
 // pendiente. Lo hace el motor y no vos, a mano, porque marcar el estado editando frontmatter es
 // exactamente el paso que se hace mal en silencio.
+// En el toolkit, sellar además anota el cambio en el CHANGELOG para que salga en la versión siguiente.
+// Un mes sin cambios no le cambia nada a quien actualiza, y `--unchanged` lo deja fuera.
 await agent(
   `From ${ROOT}, run "node ${signature.cli || 'tools/ops.js'} ` +
-  `learn ${AGENT} --applied --period ${PERIOD}" and report only ` +
+  `learn ${AGENT} --applied --period ${PERIOD}${NOTHING ? ' --unchanged' : ''}" and report only ` +
   `what it printed. Change nothing else.`,
   { label: 'sella' },
 )

package/engine/agents/learning-seal.js

@@ -14,6 +14,8 @@ const {
   isoDate, proposalFiles, proposalState, assertWritable, lastOfPeriod, undecided, SIGNED,
 } = require('./learning-files')
 const { section } = require('../planning/parser')
+const ownership = require('../core/ownership')
+const changelog = require('../core/changelog')
 // La misma identidad con la que se reclama una tarea: quién es la persona, no qué runner corre.
 const { owner } = require('../planning/claims')
 
@@ -28,7 +30,7 @@ const UNSEALED = /^-[ \t]*Estado:[ \t]*(?:pendiente|aprobada)[ \t]*$/mi
 // aprobada con responsable — y «aprobada y aplicada» cumple eso—, así que volver a correrlo sobre una
 // propuesta ya aplicada la aplicaba de nuevo. Como los cambios son aditivos por diseño, el resultado
 // no es un error visible sino un contrato con cada viñeta y cada fuente duplicadas.
-function seal(root, agent, period = '', kind = 'agent') {
+function seal(root, agent, period = '', kind = 'agent', { note = true } = {}) {
   const file = proposalFile(root, agent, period, kind)
   const dir = path.dirname(file)
   const text = fs.readFileSync(file, 'utf8')
@@ -66,9 +68,26 @@ function seal(root, agent, period = '', kind = 'agent') {
   // así que el registro que la plantilla promete no existía nunca. Se escribe acá porque es determinista:
   // la fecha, el documento, quién aprobó y qué dice que cambia, todo sale de lo que se acaba de sellar.
   if (kind === 'flow') appendHistory(path.dirname(path.dirname(dir)), file, responsible.trim(), change)
+  // Sólo en el toolkit: ahí el cargo es del catálogo que se publica, y su cambio tiene que viajar en una
+  // versión. En una empresa el cargo es suyo y no hay CHANGELOG de Cauce que escribir. `note: false` es
+  // el mes revisado sin cambios, que se sella igual y no le cambia nada a quien actualiza.
+  if (kind === 'agent' && note && ownership.mode(root) === 'toolkit') {
+    const noted = changelog.noteAgentChange(root, {
+      agent, proposal: path.basename(file), summary: summarize(change), today: isoDate(new Date()),
+    })
+    return { file, already: false, noted }
+  }
   return { file, already: false }
 }
 
+// La primera idea de «Cambio propuesto», en una línea: el documento entero está en el cargo, y el
+// CHANGELOG lo lee quien actualiza antes de decidir, no quien aplica.
+function summarize(change, limit = 240) {
+  const first = change.split(/\n\s*\n/)[0].replace(/^\s*(?:\d+\.|[-*])\s+/, '').replace(/\s+/g, ' ').trim()
+  if (first.length <= limit) return first.replace(/[.:;]$/, '')
+  return `${first.slice(0, first.lastIndexOf(' ', limit)).replace(/[.,:;]$/, '')}…`
+}
+
 // Archivar es el tercer destino de una propuesta, y hasta ahora no existía: aplicarla, dejarla
 // esperando, o **mirarla y decidir que no cambia nada**. Ese tercero se venía haciendo mergeando el PR
 // sin firmar, que deja el documento en `proposed` para siempre — indistinguible de una que espera

package/engine/cli/args.js

@@ -36,7 +36,7 @@ const FLAGS = {
   integration: ['--fixture'],
   secrets: [],
   automation: ['--force'],
-  learn: ['--flow', '--proposal', '--applied', '--archived', '--period', '--reason'],
+  learn: ['--flow', '--proposal', '--applied', '--unchanged', '--archived', '--period', '--reason'],
   evaluate: ['--cases', '--json', '--bench', '--force', '--record', '--flow'],
   flow: ['--json'],
 }

package/engine/cli/catalog.js

@@ -104,11 +104,17 @@ function learn(agent, cli) {
         : `✓ ${relative} queda archivada: ${porque}`)
     }
     if (cli.has('--applied')) {
-      const result = L.seal(opsRoot(), agent, cli.value('--period'), kind)
+      const result = L.seal(opsRoot(), agent, cli.value('--period'), kind, { note: !cli.has('--unchanged') })
       const relative = path.relative(opsRoot(), result.file)
-      return console.log(result.already
+      console.log(result.already
         ? `= ${relative} ya estaba aplicada`
         : `✓ ${relative} queda aplicada: no se vuelve a aplicar`)
+      if (result.noted) {
+        console.log(result.noted.already
+          ? `= CHANGELOG.md ya nombraba este cambio en ${result.noted.version}`
+          : `✓ CHANGELOG.md: el cambio sale en ${result.noted.version}`)
+      }
+      return
     }
     // Un recorrido no tiene informe de investigación: su propuesta se compone de los veredictos de sus
     // propias corridas y nunca lee `learning/reports/`. La forma desnuda —la que para un cargo abre su

package/engine/cli/contract.js

@@ -119,17 +119,21 @@ function marked(raw) {
   return { bullets, intros, own }
 }
 
-const declared = (raw) => marked(raw).bullets
-
+// La pasada de prosa descuenta las líneas que ya son viñetas declaradas. Para ella un bloque de viñetas
+// seguidas es un solo párrafo, así que si la primera empezaba con «El runner» la lista entera entraba otra
+// vez, pegada en un límite: cada uno llegaba dos veces al preámbulo (caso 203). Es el mismo descuento por
+// línea que hace `warnings`, y por la misma razón.
 function limits(text) {
+  const { bullets, own } = marked(text)
+  const taken = new Set(own)
   const prose = text.split(/\n\s*\n/)
     .map((block) => block.split('\n')
       .map((line) => line.replace(/^[-*]\s+/, '').trim())
-      .filter((line) => line && !line.startsWith('#') && !line.startsWith('|'))
+      .filter((line) => line && !line.startsWith('#') && !line.startsWith('|') && !taken.has(line))
       .join(' ')
       .trim())
     .filter((block) => ENUNCIA.test(block))
-  return [...declared(text), ...prose]
+  return [...bullets, ...prose]
 }
 
 // Lo que el proyecto escribió en su sección de excepciones y **no** llegó a `boundaries`. Existe porque
@@ -163,7 +167,7 @@ function warnings(root) {
   ))
   // Se descuenta por línea y no por párrafo, que es donde estaba el defecto: `paragraphs` saca el `- ` y
   // une las viñetas seguidas en un párrafo solo, así que una lista declarada no era igual a ninguna
-  // entrada de `declared()` y se contaba entera como un límite perdido (caso 159).
+  // viñeta de `marked()` y se contaba entera como un límite perdido (caso 159).
   const { own, intros } = marked(mine)
   const suyo = new Set([...own, ...intros])
   const outside = P.withoutComments(mine).split('\n')

package/engine/cli/ops.js

@@ -180,7 +180,7 @@ function usage() {
   ops automation doctor <ops-root> claude|codex|gemini|antigravity
   ops automation install <ops-root> claude|codex|gemini|antigravity
   ops automation uninstall <ops-root> claude|codex|gemini|antigravity
-  ops learn <agent|flow> [--flow] [--proposal [--period <AAAA-MM>]] [--applied [--period <AAAA-MM>]]
+  ops learn <agent|flow> [--flow] [--proposal [--period <AAAA-MM>]] [--applied [--period <AAAA-MM>] [--unchanged]]
   ops learn <agent|flow> [--flow] --archived [--period <AAAA-MM>] [--reason <motivo>]
   ops evaluate <agent|flow> [--flow] [--cases [--json]] [--bench [caso]] [--record [AAAA-MM-DD]]
   ops agents list [ops-root] [--own|--system] [--json]

package/engine/cli/validate.js

@@ -132,7 +132,7 @@ function check(dir, cli) {
   warnings.push(...RC.warnings(RC.status({ ...recurring, done, today: TODAY() })))
   warnings.push(...IB.warnings(root, done, config))
   warnings.push(...AD.sealWarnings(root))
-  warnings.push(...R.unrecordedHumanActions(path.resolve(root, '..'), P.readHumanActions(root)))
+  warnings.push(...R.unrecordedHumanActions(path.resolve(root, '..'), P.readHumanActions(root), P.withoutComments))
   warnings.push(...AP.warnings(path.resolve(root, '..')))
   warnings.push(...TR.warnings(path.resolve(root, '..')))
   warnings.push(...CT.warnings(path.resolve(root, '..')))

package/engine/core/changelog.js

@@ -47,4 +47,63 @@ function read(packageRoot) {
   try { return fs.readFileSync(path.join(packageRoot, 'CHANGELOG.md'), 'utf8') } catch { return '' }
 }
 
-module.exports = { between, compare, entries, read }
+// La línea que `agent-promote` deja al aplicar un cargo, en la versión que todavía no salió. Sin ella el
+// cambio quedaba en `main` sin versión que lo llevara: `release-pr.yml` sólo abre el PR cuando el
+// CHANGELOG declara un número nuevo, y escribirlo era un paso que nadie tenía asignado.
+//
+// Abierta es la entrada más nueva si va por delante de `package.json`; si no, ya salió y se abre la
+// minor siguiente. Minor porque cambia lo que recibe quien hace `upgrade`, que es la regla de este
+// archivo. Varios cargos del mismo mes caen así en una sola versión.
+function noteAgentChange(root, { agent, proposal, summary, today }) {
+  const file = path.join(root, 'CHANGELOG.md')
+  const lines = fs.readFileSync(file, 'utf8').split('\n')
+  const released = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version
+  const first = lines.findIndex((line) => /^##\s*\[\d/.test(line))
+  if (first < 0) throw new Error('CHANGELOG.md no tiene ninguna entrada con versión.')
+  const bullet = wrap(`- **\`${agent}\`**: ${summary} (propuesta \`${proposal}\`).`)
+  const top = lines[first].match(HEADING)[1]
+  if (compare(top, released) <= 0) {
+    const [major, minor] = released.split('.').map(Number)
+    const version = `${major}.${minor + 1}.0`
+    lines.splice(first, 0, `## [${version}] - ${today}`, '', '### Cargos', '', ...bullet, '')
+    fs.writeFileSync(file, lines.join('\n'))
+    return { version, already: false }
+  }
+  let end = lines.findIndex((line, index) => index > first && HEADING.test(line))
+  if (end < 0) end = lines.length
+  // Una propuesta ya anotada no se anota dos veces: `seal` puede volver a correr sobre un cuerpo sin sellar.
+  // Con los espacios normalizados porque la viñeta se envuelve, y el corte puede caer entre las dos mitades.
+  const entry = lines.slice(first, end).join(' ').replace(/\s+/g, ' ')
+  if (entry.includes(`- **\`${agent}\`**`) && entry.includes(`(propuesta \`${proposal}\`)`)) {
+    return { version: top, already: true }
+  }
+  const section = lines.findIndex((line, index) => index > first && index < end && /^###\s+Cargos\s*$/.test(line))
+  let at = end
+  if (section >= 0) {
+    at = lines.findIndex((line, index) => index > section && index < end && /^#{2,3}\s/.test(line))
+    if (at < 0) at = end
+  }
+  while (at > first + 1 && lines[at - 1].trim() === '') at--
+  lines.splice(at, 0, ...(section >= 0 ? bullet : ['', '### Cargos', '', ...bullet]))
+  fs.writeFileSync(file, lines.join('\n'))
+  return { version: top, already: false }
+}
+
+// Al ancho del resto del archivo, con la sangría de continuación que ya usan sus viñetas.
+function wrap(text, width = 110) {
+  const out = []
+  let line = ''
+  for (const word of text.split(/\s+/)) {
+    const next = line ? `${line} ${word}` : word
+    if (next.length > width && line) {
+      out.push(line)
+      line = `  ${word}`
+    } else {
+      line = next
+    }
+  }
+  if (line) out.push(line)
+  return out
+}
+
+module.exports = { between, compare, entries, read, noteAgentChange }

package/engine/core/repos.js

@@ -130,26 +130,30 @@ function coverageWarnings(opsRoot, done) {
 // defecto se descubría en la fase 4 de un recorrido: 1,21 M de tokens en tres paradas, con la puerta en
 // verde las tres veces (caso 121).
 //
-// Se pregunta con el pickaxe sobre la línea entera y no por la palabra `resuelta`: lo que hay que
-// establecer es que **esa** fila, con ese estado, existió alguna vez en un commit. Una que pasó a resuelta
-// sólo en el árbol de trabajo no aparece en ninguno.
+// Se pregunta si **esa** fila, con ese estado, está en el archivo de `HEAD`, línea por línea, y no por la
+// palabra `resuelta`. Una que pasó a resuelta sólo en el árbol de trabajo no está ahí.
+//
+// No se pregunta con el pickaxe, que era la primera forma: `git log -S` busca con una tabla de saltos de
+// un byte (`kwset.c`), que con una aguja de más de 256 bytes se desborda y salta por encima de una fila que
+// sí está en el commit. Una fila resuelta de verdad es justo la larga, porque lleva la decisión adentro
+// (caso 204).
+//
+// `clean` es la limpieza que ya sufrieron las filas: el parser las lee sin comentarios, así que el archivo
+// commiteado tiene que pasar por la misma o una fila con un `<!-- -->` adentro no coincide con su línea.
 //
 // Sin repositorio, o con el archivo todavía sin commitear, no dice nada: no hay historia contra la cual
 // preguntar y el aviso sería inventado. Degrada como el 086 con las migraciones — antes callar de más que
 // avisar de más, porque un aviso que salta siempre se termina apagando.
-function unrecordedHumanActions(opsRoot, rows) {
+function unrecordedHumanActions(opsRoot, rows, clean) {
   const file = path.join(opsRoot, 'planning', 'HUMAN_ACTIONS.md')
   const top = git(path.dirname(file), 'rev-parse', '--show-toplevel')
   if (top.status !== 0) return []
   const repo = top.stdout.trim()
-  const relative = path.relative(repo, file)
-  const history = git(repo, 'log', '--format=%h', '--', relative)
-  if (history.status !== 0 || !history.stdout.trim()) return []
-  return rows.filter((row) => row.resolved)
-    .filter((row) => {
-      const found = git(repo, 'log', '--format=%h', `-S${row.raw}`, '--', relative)
-      return found.status === 0 && !found.stdout.trim()
-    })
+  const relative = path.relative(repo, file).split(path.sep).join('/')
+  const committed = git(repo, 'show', `HEAD:${relative}`)
+  if (committed.status !== 0) return []
+  const lines = new Set(clean(committed.stdout).split('\n'))
+  return rows.filter((row) => row.resolved && !lines.has(row.raw))
     .map((row) => `HUMAN_ACTIONS.md: ${row.task} figura resuelta y ningún commit la registró`)
 }
 

package/engine/hooks/approval.js

@@ -15,8 +15,8 @@
 // **Se coteja, no se consume.** Borrar el archivo al leerlo daría el mismo alcance y traería dos cosas
 // que no queremos: hoy ningún guard escribe en el repositorio, y `governance` corre antes que `verify`,
 // así que un commit frenado por otra razón se habría llevado puesta la aprobación y habría que
-// rehacerla. Cotejando, la aprobación vale para el conjunto que nombra y para ningún otro: en cuanto
-// cambia lo que está en el índice deja de servir, que es «por operación» sin fecha ni contador.
+// rehacerla. Cotejando, la aprobación vale para las rutas que nombra y para ninguna otra: lo que se sume
+// al índice vuelve a frenar, que es «por operación» sin fecha ni contador.
 //
 // Queda a la vista porque `check` avisa mientras exista. Sin eso, un archivo olvidado sigue autorizando
 // esas mismas rutas la próxima vez que alguien las stagee, que es la puerta abierta que esto evitaba.
@@ -104,7 +104,7 @@ function REFUSED(items, input = {}) {
 // `pasteable` es lo que se puede aprobar por archivo, y por defecto es todo: un guard lo angosta cuando lo
 // que tiene a mano no sirve para pegar —por qué, en `secrets-shell.js` (caso 118)—. Lo frenado se anota
 // igual, así que el «dale» sigue cubriendo todo.
-function HOW(variable, lines, input, pasteable = lines) {
+function HOW(variable, lines, input, pasteable = lines, { durable = false } = {}) {
   const held = CHAT.hold(input, lines)
   const dropped = held ? held.dropped : []
   const chat = held && dropped.length < lines.length
@@ -132,6 +132,7 @@ function HOW(variable, lines, input, pasteable = lines) {
       + 'en los mensajes siguientes hasta que ella lo niegue. '
     : ''
   const refused = dropped.length ? REFUSED(dropped, input) : ''
+  const keep = chat && durable ? KEEP(input, pasteable.filter((one) => !dropped.includes(one))) : ''
   // Sin chat la salida es la misma, y también se dice como cosa de ella: el imperativo que el párrafo de
   // arriba sacó de la rama con chat seguía acá, y es lo único que ve quien no tiene a nadie en el chat
   // (caso 194). A quien corre el guard le toca otra cosa, y se le dice cuál. Vale también cuando hay persona
@@ -141,7 +142,7 @@ function HOW(variable, lines, input, pasteable = lines) {
       + ' tal cual en'
       + ` ${where(input)} estas líneas:\n`
       + pasteable.map((line) => `  ${line}\n`).join('')
-      + 'Valen para ese conjunto y dejan de valer en cuanto cambie. '
+      + 'Cada línea vale hasta que alguien la borre, y lo que no esté ahí vuelve a frenar. '
       + (chat ? '' : 'Vos no lo escribas —un guard lo frena—: decí qué se frenó y dónde, y reintentá cuando '
         + 'esté; si sos un subagente, devolvele el bloqueo a quien te lanzó. ')
     : ''
@@ -157,7 +158,28 @@ function HOW(variable, lines, input, pasteable = lines) {
     ? `La variable ${variable}=1 sigue existiendo y apaga el guard para toda la sesión, que es por lo que no `
       + 'es la vía recomendada.'
     : ''
-  return ask + refused + paste + unresolved + off
+  return ask + keep + refused + paste + unresolved + off
+}
+
+// La lectura que un proyecto necesita siempre —el token con que su regla manda autenticar— se preguntaba en
+// cada sesión, porque el «dale» dura la sesión y la línea del archivo la tenía que pegar la persona a mano:
+// «pon esa línea» o «acepto que leas» no le alcanzaban al agente para escribírsela (caso 202).
+//
+// La pregunta va entera al agente, y no se le pide a la persona ninguna frase: cuál de las dos cosas quiso la
+// juzga él, igual que el «dale» (caso 184). Lo que hace el guard es dejar anotados, además de lo frenado, el
+// archivo de aprobación, así que la misma confirmación que habilita leer habilita escribir **esas líneas y
+// ninguna otra** —cuáles, lo compara `self-approval`—. Sólo lo ofrece un guard de lectura: una lectura
+// frena siempre la misma ruta, y ahí una línea permanente es lo que la persona está pidiendo; para un
+// commit, lo frenado cambia con el índice y dejarlo escrito no le ahorra nada a nadie.
+function KEEP(input, lines) {
+  const root = opsRoot(input)
+  if (!root || !lines.length) return ''
+  const held = CHAT.hold(input, [path.join(root, 'planning', APPROVAL)])
+  if (!held || held.dropped.length) return ''
+  return 'Preguntale también si quiere dejarlo aprobado para siempre, para no volver a preguntarlo en otra '
+    + `sesión. Si esa es su intención, agregá a ${where(input)} las líneas de abajo, con un comentario arriba que `
+    + 'diga quién lo aprobó, cuándo y para qué: la misma confirmación te deja escribirlas. Si sólo quiso que '
+    + 'leas ahora, no las escribas y vale para esta sesión. '
 }
 
 // Las dos exenciones que sobreviven a un bloqueo, para que `check` las muestre juntas: la lista que una
@@ -168,11 +190,23 @@ function HOW(variable, lines, input, pasteable = lines) {
 // repetir la autorización en cada mensaje —y eso está bien—, pero quedó del lado que nadie audita: vive en
 // el temporal del sistema, mientras que por una sola línea del archivo `check` sí avisaba. Una exención que
 // no se ve es un límite que ya no existe (caso 117).
+//
+// Una credencial aprobada se nombra aparte, y no como algo «sin borrar». Está ahí a propósito —la dejó
+// escrita la persona para no volver a autorizar la misma lectura en cada sesión (caso 202)—, y contada
+// junto a lo que quedó de un commit se leía como un olvido que había que limpiar. Sigue saliendo en cada
+// corrida, igual que `writableOutsideRoots`: una exención deliberada también se ve.
 function warnings(root) {
   const out = []
+  const { credential } = require('./files')
   const approved = read(root)
-  if (approved.length) {
-    out.push(`planning/${APPROVAL}: ${approved.length} ruta(s) aprobadas y sin borrar; `
+  const secret = approved.filter((line) => credential({ cwd: root }, line))
+  const rest = approved.filter((line) => !secret.includes(line))
+  if (secret.length) {
+    out.push(`planning/${APPROVAL}: ${secret.length} credencial(es) aprobadas hasta que se borre su línea: `
+      + secret.join(', '))
+  }
+  if (rest.length) {
+    out.push(`planning/${APPROVAL}: ${rest.length} ruta(s) aprobadas y sin borrar; `
       + 'el archivo sigue autorizándolas')
   }
   const granted = CHAT.grantedIn(root)

package/engine/hooks/files.js

@@ -19,8 +19,8 @@ const { hasTasks } = require('../planning/state')
 const { TEMPLATE_PREFIXES } = require('../core/ownership')
 
 // Si la ruta que este guard está por bloquear está aprobada, no hay nada que decir. Es la salida
-// angosta: vale para esa ruta y deja de valer en cuanto cambie, a diferencia de la variable, que apaga
-// el guard hasta que cierre la sesión.
+// angosta: vale para esa ruta y para ninguna otra, a diferencia de la variable, que apaga el guard hasta
+// que cierre la sesión.
 const approved = (input, file) => !AP.pending(opsRoot(input), [file], input).length
 
 // Qué archivo es una credencial, para los dos guards que la cuidan: `secrets`, que frena escribirla, y
@@ -78,7 +78,7 @@ function secretsRead(input) {
   for (const file of [...filesOf(input), ...patterns]) {
     if (!patternNames(file).some((name) => credential(input, name)) || approved(input, file)) continue
     block(`${file} es una credencial: leerla la deja en el contexto de la sesión. Si hace falta un valor, `
-      + `pedíselo a una persona.\n${AP.HOW('OPS_SECRETS_READ_OVERRIDE', [file], input)}`)
+      + `pedíselo a una persona.\n${AP.HOW('OPS_SECRETS_READ_OVERRIDE', [file], input, [file], { durable: true })}`)
   }
 }
 

package/engine/hooks/secrets-shell.js

@@ -67,7 +67,8 @@ function secretsShell(input) {
   if (!left.length) return
   block(`el comando lee ${left.join(', ')}, que es una credencial: leerla la deja en el contexto de la sesión. `
     + 'Si hace falta un valor, pedíselo a una persona.\n'
-    + AP.HOW('OPS_SECRETS_READ_OVERRIDE', left, input, left.filter((one) => !UNRESOLVED.test(one))))
+    + AP.HOW('OPS_SECRETS_READ_OVERRIDE', left, input, left.filter((one) => !UNRESOLVED.test(one)),
+      { durable: true }))
 }
 
 module.exports = { secretsShell }

package/engine/hooks/self-approval.js

@@ -6,8 +6,8 @@
 //
 // Lo preguntan los dos guards de límites —el que mira un `Write` y el que mira el destino de un comando—,
 // que ya son los que deciden dónde puede caer una escritura. La persona edita el archivo a mano, que ningún
-// hook ve, o se lo pide al agente nombrándolo en el chat. El registro del chat no lo escribe nunca una
-// herramienta.
+// hook ve, o se lo pide al agente en el chat: nombrándolo, o confirmando el bloqueo que le mostró qué iba a
+// escribir. El registro del chat no lo escribe nunca una herramienta.
 //
 // **Nombrar el archivo autoriza el archivo, no lo que se escribe adentro**, y hasta 0.83.0 eso era todo lo
 // que se comprobaba: la persona pedía agregar una ruta inocua, el agente escribía `push origin main`, y esa
@@ -34,6 +34,12 @@ const UNASKED = (file, missing) => `${file} es la aprobación de una persona y e
   + 'Escribí sólo lo que ella nombró en su mensaje. Si hacen falta las otras, decile cuáles y por qué, y '
   + 'pedile que lo confirme con sus palabras: si lo que contesta es un sí, reintentá la misma escritura y pasa.'
 
+// Lo mismo que `UNASKED`, para cuando además el archivo no se nombró: ninguna de las líneas está pedida.
+const UNNAMED = (file, lines) => `${file} es la aprobación de una persona, y escribírsela es aprobarse solo. `
+  + 'Esta escritura agrega:\n' + lines.map((line) => `  ${line}\n`).join('')
+  + 'Decile qué querés dejar aprobado y por qué, y pedile que lo confirme con sus palabras: si lo que contesta '
+  + 'es un sí, reintentá la misma escritura y pasa. Si no, que lo edite ella.'
+
 // **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
 // separa la línea que la persona pidió de la que el agente se escribe solo.
@@ -49,15 +55,31 @@ function approvalRoot(input, file) {
 }
 
 // Lo que las dos vías deciden igual: el registro del chat no se escribe nunca, y la aprobación sólo si la
-// persona la nombró en su mensaje.
+// persona la nombró en su mensaje o confirmó el bloqueo que la frenaba.
 //
 // Se pregunta sin conceder: una concesión que sobreviviera al mensaje convertiría «agregá src/x.js a
 // .ops-approval» en permiso para escribirle después cualquier otra línea, que es aprobarse solo por la
 // puerta de al lado.
-function common(input, file) {
-  if (file === CHAT.DIR || file.startsWith(`${CHAT.DIR}${path.sep}`)) return CHAT_RECORD(file)
-  if (!approvalRoot(input, file)) return ''
-  return CHAT.authorized(input, [file]).length ? '' : SELF(file)
+const named = (input, file) => CHAT.authorized(input, [file]).length > 0
+const chatRecord = (file) => file === CHAT.DIR || file.startsWith(`${CHAT.DIR}${path.sep}`)
+
+// Lo que esta escritura agrega al archivo. **Lo que ya estaba en disco no se vuelve a nombrar**: esta
+// escritura no lo agrega, y exigirlo obligaría a repetir el archivo entero para sumar una línea. Quitar
+// tampoco se pregunta: una aprobación más corta autoriza menos.
+function added(input, root) {
+  const filed = new Set(AP.read(root))
+  return AP.lines(contentOf(input)).filter((line) => !filed.has(line))
+}
+
+// El archivo sin nombrar frenaba sin anotar nada, así que la salida que el propio mensaje ofrecía
+// —confirmar el bloqueo— no aprobaba nada: el «dale» siguiente volvía a frenar igual, y la persona sólo
+// podía destrabarlo con la frase exacta que nombra el archivo con un verbo (caso 202). Se anota el archivo
+// con las líneas que trae, que es lo que la confirmación va a aprobar y lo que el mensaje le muestra.
+function unnamed(input, root, file) {
+  const lines = added(input, root)
+  const held = lines.length ? CHAT.hold(input, [file, ...lines]) : false
+  if (!held || held.dropped.length) return SELF(file)
+  return UNNAMED(file, lines)
 }
 
 // Una línea de push no se pregunta como una ruta: `mentions` compara también el basename, así que para
@@ -67,10 +89,6 @@ const isPush = (line) => /^push\s+\S+\s+\S+$/.test(line)
 
 // Por qué no se puede escribir este contenido, o vacío.
 //
-// **Lo que ya estaba en disco no se vuelve a nombrar**: esta escritura no lo agrega, y exigirlo obligaría a
-// repetir el archivo entero para sumar una línea. Quitar tampoco se pregunta: una aprobación más corta
-// autoriza menos.
-//
 // **Un fragmento sí se juzga, al revés que en `ops.config.json`.** Allá el archivo entrante se compara
 // entero porque una llave cambia de sentido según lo que la rodea, y un `Edit` manda un pedazo; acá cada
 // línea vale por sí sola, así que el pedazo que llega es exactamente lo que se agrega. Lo que no se puede
@@ -80,12 +98,11 @@ const isPush = (line) => /^push\s+\S+\s+\S+$/.test(line)
 // Y se pregunta sin heredar lo que la sesión concedió antes: una línea acá la leen todos los guards y llega
 // hasta la rama viva, así que tiene que ser la que la persona dijo en el mensaje en curso.
 function unasked(input, root, file) {
-  const filed = new Set(AP.read(root))
-  const added = AP.lines(contentOf(input)).filter((line) => !filed.has(line))
-  const pushes = CHAT.authorized(input, added.filter(isPush), { asked: CHAT.ordersPush, inherit: false })
-  const paths = CHAT.authorized(input, added.filter((line) => !isPush(line)), { inherit: false })
+  const lines = added(input, root)
+  const pushes = CHAT.authorized(input, lines.filter(isPush), { asked: CHAT.ordersPush, inherit: false })
+  const paths = CHAT.authorized(input, lines.filter((line) => !isPush(line)), { inherit: false })
   const cleared = new Set([...pushes, ...paths].map((one) => one.item))
-  const missing = added.filter((line) => !cleared.has(line))
+  const missing = lines.filter((line) => !cleared.has(line))
   if (!missing.length) return ''
   // El archivo se anota junto con las líneas: sin él, el «dale» aprobaría las líneas y el guard volvería a
   // frenar por el archivo, que en ese mensaje ya nadie nombra.
@@ -95,17 +112,17 @@ function unasked(input, root, file) {
 
 // Por qué el agente no puede escribir en `file` con la herramienta de edición, o vacío.
 function selfApproval(input, file) {
-  const stop = common(input, file)
-  if (stop) return stop
+  if (chatRecord(file)) return CHAT_RECORD(file)
   const root = approvalRoot(input, file)
-  return root ? unasked(input, root, file) : ''
+  if (!root) return ''
+  return named(input, file) ? unasked(input, root, file) : unnamed(input, root, file)
 }
 
 // Lo mismo para el destino de un comando, o vacío.
 function selfApprovalShell(input, file) {
-  const stop = common(input, file)
-  if (stop) return stop
-  return approvalRoot(input, file) ? BY_COMMAND(file) : ''
+  if (chatRecord(file)) return CHAT_RECORD(file)
+  if (!approvalRoot(input, file)) return ''
+  return named(input, file) ? BY_COMMAND(file) : SELF(file)
 }
 
 module.exports = { selfApproval, selfApprovalShell }

package/package.json

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

package/template/AGENTS.md

@@ -122,7 +122,14 @@ para el agente con el que hablás.
 autorizás, una por línea, con `#` para lo que no sea una ruta. En sidecar es el `planning/` de la
 instancia y no una carpeta al lado de tus proyectos; el bloqueo dice la ruta exacta. Es un solo archivo
 para todos los guards, porque lo que escribís son rutas y quién las mira lo decide qué guard esté
-juzgando esa ruta. Lo escribís vos: si el agente intenta escribírselo, un guard lo frena.
+juzgando esa ruta. Lo escribís vos, o el agente con tu confirmación: si intenta escribírselo solo, un
+guard lo frena y te muestra qué iba a agregar.
+
+**Una lectura que necesitás siempre se aprueba una vez.** El «dale» dura la sesión. Cuando el agente se
+frena leyendo una credencial —el token con el que una regla tuya manda autenticar—, te pregunta además si
+querés dejarla aprobada para siempre; si esa es tu intención, escribe la ruta en ese archivo, con quién lo
+aprobó y para qué, y ninguna sesión vuelve a preguntarlo. `check` la sigue nombrando mientras exista, como
+toda exención; se revoca borrando la línea.
 
 | lo que te frena | qué ruta aprobás |
 |---|---|