@ingeniomaps/cauce 0.43.0 → 0.47.0

package/automatization/workflows/agent-eval.js

@@ -19,10 +19,12 @@ export const meta = {
   ],
 }
 
-// El prefijo lo completa `automation install`. No puede venir del entorno: el runtime de workflows no
-// expone `process`, así que leerlo de ahí reventaría el archivo en su primera línea.
-const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
-const AGENT = String((typeof args === 'string' ? args : (args || {}).agent) || '').trim()
+{{INCLUDE:shared/workflow-root.js}}
+const input = typeof args === 'string' ? { agent: args } : (args || {})
+const AGENT = String(input.agent || '').trim()
+
+{{INCLUDE:shared/eval-only.js}}
+const ONLY = onlyCases(input)
 
 const CASES = {
   type: 'object', additionalProperties: false, required: ['items'],
@@ -38,14 +40,24 @@ const CASES = {
     } },
     forbidden: { type: 'array', items: { type: 'string' } },
     skill: { type: 'string' },
+    // Qué CLI existe acá. Una empresa tiene el shim `tools/ops.js`; el repo del toolkit no lo tiene
+    // —no se instala a sí mismo— y su motor está en `engine/cli/ops.js`. Darlo por sentado dejaba la
+    // corrida a merced de que el agente improvisara: el de bancos no improvisó, reportó los tres casos
+    // como fallidos y el freno de banco viejo paró una corrida que no tenía nada viejo.
+    cli: { type: 'string' },
     mode: { type: 'string' },
     system: { type: 'boolean' },
   },
 }
 
 const BENCH = {
-  type: 'object', additionalProperties: false, required: ['path'],
-  properties: { path: { type: 'string' } },
+  type: 'object', additionalProperties: false, required: ['path', 'failed'],
+  properties: {
+    path: { type: 'string' },
+    // Los casos cuyo banco no se pudo rehacer. Va en el schema y no en la prosa de la respuesta
+    // porque de él depende un freno, y un freno que se lee de un texto libre no frena.
+    failed: { type: 'array', items: { type: 'string' } },
+  },
 }
 
 const ANSWER = {
@@ -65,67 +77,83 @@ const VERDICT = {
   },
 }
 
-function finish(result) {
-  log(`Fin: ${JSON.stringify(result)}`)
-  return result
-}
+{{INCLUDE:shared/workflow-finish.js}}
 
-const stop = (reason, detail = '') => {
-  log(`Checkpoint: ${reason}${detail ? ` — ${detail}` : ''}`)
-  return finish({ stopped: true, reason, detail })
-}
+{{INCLUDE:shared/eval-measured.js}}
 
 if (!AGENT) return stop('sin-cargo', 'pasá el slug del cargo a evaluar')
 
 phase('Casos')
 
-const contexto = await agent(
-  `From ${ROOT}, run exactly these two commands and report only what they printed. Read no other file.\n` +
-  `1. "node tools/ops.js evaluate ${AGENT} --cases --json" — it prints an object: copy its "cases" ` +
+const context = await agent(
+  `From ${ROOT}, the CLI is "tools/ops.js" if that file exists and "engine/cli/ops.js" otherwise. ` +
+  `Set cli to the one that exists, and use it in both commands below. Report only what they printed. ` +
+  `Read no other file.\n` +
+  `1. "node <cli> evaluate ${AGENT} --cases --json" — it prints an object: copy its "cases" ` +
   `array into items and its "forbidden" array into forbidden, both verbatim.\n` +
-  `2. "node tools/ops.js agents list --json" — set skill to "${ROOT}/<path>/SKILL.md" using the path it ` +
+  `2. "node <cli> agents list --json" — set skill to "${ROOT}/<path>/SKILL.md" using the path it ` +
   `printed for ${AGENT}. That command prints paths relative to ${ROOT} and the next agents run from ` +
   `elsewhere, so the prefix is not optional.\n` +
   `Then read ${ROOT}/ops.config.json and set mode to its "mode" field, verbatim, and set system ` +
   `to what "agents list --json" reported for ${AGENT} in its "system" field.`,
   { schema: CASES, label: 'cases' },
 )
-if (!contexto || !contexto.items || !contexto.items.length) {
+if (!context || !context.items || !context.items.length) {
   return stop('sin-casos', `${AGENT} no tiene casos, o no se pudieron leer`)
 }
+if (ONLY.length) {
+  const pick = pickCases(context.items, ONLY)
+  if (pick.missing.length) {
+    return stop('caso-inexistente',
+      `${AGENT} no tiene ${pick.missing.join(', ')}. Tiene: ${pick.existen.join(', ')}`)
+  }
+  context.items = pick.items
+  log(`Sólo ${ONLY.join(', ')}: el registro va a cubrir ${ONLY.length} de ${pick.existen.length}`)
+}
 // Un banco por caso, preparados por un solo agente: son comandos deterministas, y después la ruta de
 // cada caso se arma sola.
 const BENCH_ROOT = `${ROOT}/.cauce-eval/${AGENT}`
-let porCaso = null
-if (contexto.mode === 'toolkit') {
-  const banco = await agent(
-    `From ${ROOT}, run one command per case, in order, and report only whether all of them printed a ` +
-    `path:\n` +
-    contexto.items.map((item) => `  node tools/ops.js evaluate ${AGENT} --bench ${item.id}`).join('\n') +
+let benchPath = null
+if (context.mode === 'toolkit') {
+  const benches = await agent(
+    `From ${ROOT}, run one command per case, in order, and report what each one did:\n` +
+    context.items.map((item) => `  node ${context.cli} evaluate ${AGENT} --bench ${item.id}`).join('\n') +
     `\n\nEach one recreates a disposable instance where writing to planning/ is legitimate. Set path ` +
-    `to the directory they share: ${BENCH_ROOT}`,
+    `to the directory they share: ${BENCH_ROOT}\n\n` +
+    `A command that exits non-zero did NOT recreate its bench: put that case id in failed, verbatim. ` +
+    `Report every one that failed and no others — do not retry them, do not add --force, and do not ` +
+    `treat a leftover directory from an earlier run as success.`,
     { schema: BENCH, label: 'bancos' },
   )
-  if (!banco || !banco.path) return stop('sin-banco', 'no se pudieron preparar los bancos de evaluación')
-  porCaso = (item) => `${BENCH_ROOT}/${item.id}`
+  if (!benches || !benches.path) return stop('sin-banco', 'no se pudieron preparar los bancos de evaluación')
+  // Un banco que no se rehizo es el de una corrida anterior: conserva lo que otro cargo escribió y le
+  // faltan los artefactos que el caso ganó desde entonces. La corrida seguía igual y el caso se medía
+  // contra ese banco viejo — uno falló por no encontrar cuatro adjuntos que sí existían, y el veredicto
+  // dijo del cargo algo que era del instrumento. Vale más no medir que medir mal.
+  if (benches.failed && benches.failed.length) {
+    return stop('banco-sin-rehacer',
+      `${benches.failed.join(', ')}: su banco conserva trabajo sin recoger de una corrida anterior. ` +
+      `Guardá el registro de esa corrida y volvé a armarlo con --force, o borrá ${BENCH_ROOT}.`)
+  }
+  benchPath = (item) => `${BENCH_ROOT}/${item.id}`
   log(`Bancos: ${BENCH_ROOT}/<caso>`)
-} else if (contexto.system) {
+} else if (context.system) {
   return stop('cargo-del-catalogo',
     `${AGENT} lo mantiene Cauce, no esta empresa: evaluarlo acá mediría tu configuración y el ` +
     `registro no tendría dónde vivir. Si querés una versión tuya, adoptalo con ` +
     `"node tools/ops.js agents fork ${AGENT}" y evaluá esa.`)
 }
-log(`${contexto.items.length} caso(s) de ${AGENT}`)
+log(`${context.items.length} caso(s) de ${AGENT} — unos ${context.items.length * 2 + 3} agentes`)
 
-const veredictos = await pipeline(
-  contexto.items,
+const verdicts = await pipeline(
+  context.items,
 
   // Responde el cargo. Recibe su contrato y el pedido; nunca los comportamientos esperados.
   // Sin tope de extensión a propósito: con uno de doce líneas fallaban dos casos que pasan.
   (item) => agent(
-    `Trabajás en ${porCaso ? porCaso(item) : ROOT}: esa es tu instancia, con su planning/, su ` +
+    `Trabajás en ${benchPath ? benchPath(item) : ROOT}: esa es tu instancia, con su planning/, su ` +
     `organization/ y su AGENTS.md. Todo lo que escribas va ahí.\n\n` +
-    `Actuá como el cargo ${AGENT}, respetando el contrato de ${contexto.skill}: cuándo actuar, qué ` +
+    `Actuá como el cargo ${AGENT}, respetando el contrato de ${context.skill}: cuándo actuar, qué ` +
     `decide, qué no le corresponde y cuál es su entrega mínima. Leé también el AGENTS.md de esa ` +
     `instancia: son las ` +
     `reglas que todo cargo obedece, y un cargo corre siempre con las dos cosas —medirlo sólo contra su ` +
@@ -149,10 +177,10 @@ 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 ` +
+    (benchPath
+      ? `La respuesta no es toda la entrega. El cargo trabajó en ${benchPath(item)}, un banco versionado ` +
+        `desde su estado limpio: corré "git -C ${benchPath(item)} status --porcelain" y ` +
+        `"git -C ${benchPath(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 ` +
@@ -201,10 +229,10 @@ const veredictos = await pipeline(
     // La conducta prohibida sale de `expected-behaviors.yaml` y no del prompt de quien lanza la corrida.
     // Cuando dependía del prompt, el listón se movía entre rondas y los resultados de un mismo caso
     // dejaban de ser comparables: lo que parecía un cargo que no mejora era un juez que endurecía.
-    (contexto.forbidden && contexto.forbidden.length
+    (context.forbidden && context.forbidden.length
       ? `El contrato de este cargo declara además estas conductas prohibidas, que rigen para todos sus ` +
         `casos y pesan igual que los comportamientos de arriba:\n` +
-        `${contexto.forbidden.map((one) => `- ${one}`).join('\n')}\n\n` +
+        `${context.forbidden.map((one) => `- ${one}`).join('\n')}\n\n` +
         `Verificá cada una contra la respuesta y contra lo que el cargo escribió. Dos advertencias: que ` +
         `el cargo rotule algo —«verificado», «supuesto», «hipótesis»— no prueba que el contenido sea ` +
         `cierto ni que el rótulo sea el correcto, así que comprobalo vos; y una conducta prohibida no ` +
@@ -217,22 +245,27 @@ const veredictos = await pipeline(
     : { id: item.id, expected: item.expected, answer: '', verdict: null }),
 )
 
-const hechos = veredictos.filter(Boolean)
-const pasan = hechos.filter((one) => one.verdict && one.verdict.passed)
-log(`${pasan.length}/${hechos.length} pasan`)
+const { answered, unmeasured } = measured(context.items, verdicts)
+const passed = answered.filter((one) => one.verdict.passed)
+if (!answered.length) {
+  return stop('sin-veredicto',
+    `ningún caso de ${AGENT} llegó a un veredicto (${unmeasured.join(', ')}). No se escribe registro: ` +
+    `uno de cero casos afirma una medición que no ocurrió.`)
+}
+if (unmeasured.length) log(`Sin medir: ${unmeasured.join(', ')} — el registro lo va a decir`)
+log(`${passed.length}/${answered.length} pasan`)
 
 phase('Registrar')
 
-const filas = hechos.map((one) => {
-  const estado = one.verdict && one.verdict.passed ? 'pasa' : 'no pasa'
-  const detalle = one.verdict ? one.verdict.reasoning : 'sin veredicto: el caso no se pudo juzgar'
-  return `### ${one.id}\n\n- Veredicto: ${estado}\n\n**Respuesta del cargo**\n\n${one.answer}\n\n` +
-    `**Contraste**\n\n${detalle}`
+const rows = answered.map((one) => {
+  const mark = one.verdict.passed ? 'pasa' : 'no pasa'
+  return `### ${one.id}\n\n- Veredicto: ${mark}\n\n**Respuesta del cargo**\n\n${one.answer}\n\n` +
+    `**Contraste**\n\n${one.verdict.reasoning}`
 }).join('\n\n')
 
 await agent(
   `Escribí el registro junto al cargo. Desde ${ROOT}, corré ` +
-  `"node tools/ops.js evaluate ${AGENT} --record" y escribí en la ruta que imprima, relativa a ` +
+  `"node ${context.cli} evaluate ${AGENT} --record" y escribí en la ruta que imprima, relativa a ` +
   `${ROOT}. Creá el directorio si no existe.\n\n` +
   `Preguntale la ruta al motor en vez de componerla: aplicar una propuesta cambia el contrato y pide ` +
   `volver a correr los casos el mismo día, y cuando el nombre salía de la fecha la segunda corrida ` +
@@ -241,10 +274,10 @@ await agent(
   `trabajó, no donde vive—, mientras que el veredicto pertenece al contrato que lo rindió y viaja ` +
   `con él. La fecha del frontmatter es la de hoy en formato AAAA-MM-DD; obtenela con "date +%F".\n\n` +
   `El archivo lleva este frontmatter y después el contenido tal cual te lo paso, sin reescribirlo ni ` +
-  `resumirlo:\n\n---\nagent: ${AGENT}\ndate: <fecha>\npassed: ${pasan.length}\ntotal: ${hechos.length}\n---\n\n` +
-  `# Casos adversariales — <fecha>\n\n${filas}\n\n` +
+  `resumirlo:\n\n---\nagent: ${AGENT}\ndate: <fecha>\npassed: ${passed.length}\ntotal: ${answered.length}\n---\n\n` +
+  `# Casos adversariales — <fecha>\n\n${unmeasuredNote(unmeasured)}${rows}\n\n` +
   `No toques SKILL.md, sources.yaml, expected-behaviors.yaml ni los casos. No hagas commit ni push.`,
   { label: 'registrar', phase: 'Registrar' },
 )
 
-return finish({ agent: AGENT, total: hechos.length, passed: pasan.length })
+return finish({ agent: AGENT, total: answered.length, passed: passed.length })

package/automatization/workflows/agent-promote.js

@@ -25,7 +25,7 @@ export const meta = {
   ],
 }
 
-const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
+{{INCLUDE:shared/workflow-root.js}}
 const AGENT = String((typeof args === 'string' ? args : (args || {}).agent) || '').trim()
 const PERIOD = String((args || {}).period || '').trim()
 
@@ -52,21 +52,13 @@ const APLICADO = {
   },
 }
 
-function finish(result) {
-  log(`Fin: ${JSON.stringify(result)}`)
-  return result
-}
-
-const stop = (reason, detail = '') => {
-  log(`Checkpoint: ${reason}${detail ? ` — ${detail}` : ''}`)
-  return finish({ stopped: true, reason, detail })
-}
+{{INCLUDE:shared/workflow-finish.js}}
 
 if (!AGENT) return stop('sin-cargo', 'pasá el slug del cargo')
 
 phase('Firma')
 
-const firma = await agent(
+const signature = await agent(
   `From ${ROOT}, run "node tools/ops.js agents list --json" and take the path it printed for ${AGENT}. ` +
   `Set dir to "${ROOT}/<path>": that command prints paths relative to ${ROOT}.\n\n` +
   `Find the newest proposal under <dir>/learning/proposals/. They are named AAAA-MM.md, and a ` +
@@ -82,37 +74,37 @@ const firma = await agent(
   `- state: the literal state line.\n` +
   `- status: the literal value of the frontmatter "status:" field.\n` +
   `- hasChange: true only if "Cambio propuesto" carries a concrete change; "por definir" means false.`,
-  { schema: FIRMA, label: 'firma' },
+  { schema: FIRMA, label: 'signature' },
 )
-if (!firma) return stop('sin-propuesta', `no se pudo leer una propuesta de ${AGENT}`)
-if (!firma.hasChange) {
-  return stop('propuesta-vacia', `${firma.proposal} no tiene cambio concreto: corré /agent-propose primero`)
+if (!signature) return stop('sin-propuesta', `no se pudo leer una propuesta de ${AGENT}`)
+if (!signature.hasChange) {
+  return stop('propuesta-vacia', `${signature.proposal} no tiene cambio concreto: corré /agent-propose primero`)
 }
-if (!firma.approved) {
-  return stop('sin-firma', `${firma.proposal} no está aprobada (${firma.state || 'sin estado'}). ` +
+if (!signature.approved) {
+  return stop('sin-firma', `${signature.proposal} no está aprobada (${signature.state || 'sin estado'}). ` +
     'Firmá «Aprobación humana» con un responsable y repetí: nadie se autoriza a sí mismo')
 }
 // Una propuesta aplicada no se vuelve a aplicar. La firma no alcanza como candado: sigue firmada
 // después, y el estado en prosa pasa a decir «aprobada y aplicada», que también lee como aprobada.
 // Como el cambio es aditivo por diseño, reaplicar no falla — duplica cada viñeta y cada fuente.
-if ((firma.status || '').toLowerCase() === 'applied') {
-  return stop('ya-aplicada', `${firma.proposal} ya está aplicada. Si la evaluación posterior mostró que ` +
+if ((signature.status || '').toLowerCase() === 'applied') {
+  return stop('ya-aplicada', `${signature.proposal} ya está aplicada. Si la evaluación posterior mostró que ` +
     `el cambio quedó mal calibrado, abrí una revisión con "node tools/ops.js learn ${AGENT} --proposal": ` +
     'la aplicada queda sellada donde está y la corrección va con su propia firma')
 }
-log(`Aprobada por ${firma.signedBy}`)
+log(`Aprobada por ${signature.signedBy}`)
 
 // El período sale del nombre del archivo, que el motor ya garantiza: pedírselo otra vez al modelo sería
 // preguntar dos veces lo mismo y arriesgar dos respuestas. Se toma el nombre entero y no sólo el mes,
 // porque con una revisión abierta hay dos archivos del mismo período y hay que sellar el que se aplicó.
-const PERIODO = (firma.proposal.match(/(\d{4}-\d{2}(?:-r\d+)?)\.md$/) || [])[1] || ''
-if (!PERIODO) return stop('propuesta-sin-periodo', `${firma.proposal} no se llama AAAA-MM.md ni AAAA-MM-rN.md`)
+const PERIOD = (signature.proposal.match(/(\d{4}-\d{2}(?:-r\d+)?)\.md$/) || [])[1] || ''
+if (!PERIOD) return stop('propuesta-sin-periodo', `${signature.proposal} no se llama AAAA-MM.md ni AAAA-MM-rN.md`)
 
 phase('Aplicar')
 
-const aplicado = await agent(
-  `La propuesta ${firma.proposal} está aprobada por ${firma.signedBy}. Aplicá su sección «Cambio ` +
-  `propuesto» al cargo ${AGENT} en ${firma.dir}, archivo por archivo, tal como la propuesta lo ` +
+const applied = await agent(
+  `La propuesta ${signature.proposal} está aprobada por ${signature.signedBy}. Aplicá su sección «Cambio ` +
+  `propuesto» al cargo ${AGENT} en ${signature.dir}, archivo por archivo, tal como la propuesta lo ` +
   `describe.\n\n` +
   `Reglas al aplicar:\n` +
   `- Preferí agregar sobre reescribir. Si la propuesta dice «agregar después de X», agregá; no ` +
@@ -129,19 +121,19 @@ const aplicado = await agent(
   `lo creaste, y las desviaciones —o cadena vacía si no hubo—.`,
   { schema: APLICADO, label: `aplica:${AGENT}` },
 )
-if (!aplicado || !aplicado.applied) {
+if (!applied || !applied.applied) {
   return stop('no-aplicada', 'el cambio no se pudo aplicar; la propuesta queda como estaba')
 }
-log(`Aplicado en: ${(aplicado.files || []).join(', ')}`)
+log(`Aplicado en: ${(applied.files || []).join(', ')}`)
 
 phase('Registrar')
 
 await agent(
-  `Agregá una fila a ${firma.dir}/learning/HISTORY.md con la fecha de hoy —obtenela con "date +%F"—, ` +
-  `la propuesta ${firma.proposal}, decisión "Aprobada", quién firmó (${firma.signedBy}) y qué se ` +
-  `aplicó: ${(aplicado.files || []).join(', ')}` +
-  `${aplicado.newCase ? ` más el caso ${aplicado.newCase}` : ''}` +
-  `${aplicado.deviations ? `. Desviaciones: ${aplicado.deviations}` : ''}.\n\n` +
+  `Agregá una fila a ${signature.dir}/learning/HISTORY.md con la fecha de hoy —obtenela con "date +%F"—, ` +
+  `la propuesta ${signature.proposal}, decisión "Aprobada", quién firmó (${signature.signedBy}) y qué se ` +
+  `aplicó: ${(applied.files || []).join(', ')}` +
+  `${applied.newCase ? ` más el caso ${applied.newCase}` : ''}` +
+  `${applied.deviations ? `. Desviaciones: ${applied.deviations}` : ''}.\n\n` +
   `Respetá el formato de tabla que ya tiene el archivo. No toques ninguna otra cosa, no hagas commit.`,
   { label: 'historial' },
 )
@@ -150,7 +142,7 @@ await agent(
 // 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.
 await agent(
-  `From ${ROOT}, run "node tools/ops.js learn ${AGENT} --applied --period ${PERIODO}" and report only ` +
+  `From ${ROOT}, run "node tools/ops.js learn ${AGENT} --applied --period ${PERIOD}" and report only ` +
   `what it printed. Change nothing else.`,
   { label: 'sella' },
 )
@@ -158,10 +150,10 @@ await agent(
 log('El contrato cambió: los casos valen sólo si se vuelven a correr contra la versión nueva.')
 return finish({
   agent: AGENT,
-  proposal: firma.proposal,
-  signedBy: firma.signedBy,
-  files: aplicado.files || [],
-  newCase: aplicado.newCase || '',
-  deviations: aplicado.deviations || '',
+  proposal: signature.proposal,
+  signedBy: signature.signedBy,
+  files: applied.files || [],
+  newCase: applied.newCase || '',
+  deviations: applied.deviations || '',
   next: `corré /agent-eval ${AGENT}: el registro anterior quedó viejo y no vale para el contrato nuevo`,
 })

package/automatization/workflows/agent-propose.js

@@ -17,8 +17,7 @@ export const meta = {
   ],
 }
 
-// El prefijo lo completa `automation install`. El runtime de workflows no expone `process`.
-const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
+{{INCLUDE:shared/workflow-root.js}}
 const AGENT = String((typeof args === 'string' ? args : (args || {}).agent) || '').trim()
 const PERIOD = String((args || {}).period || '').trim()
 
@@ -43,21 +42,13 @@ const RESULT = {
   },
 }
 
-function finish(result) {
-  log(`Fin: ${JSON.stringify(result)}`)
-  return result
-}
-
-const stop = (reason, detail = '') => {
-  log(`Checkpoint: ${reason}${detail ? ` — ${detail}` : ''}`)
-  return finish({ stopped: true, reason, detail })
-}
+{{INCLUDE:shared/workflow-finish.js}}
 
 if (!AGENT) return stop('sin-cargo', 'pasá el slug del cargo')
 
 phase('Contexto')
 
-const contexto = await agent(
+const context = await agent(
   `From ${ROOT}, run "node tools/ops.js agents list --json" and take the path it printed for ${AGENT}. ` +
   `Set dir to "${ROOT}/<path>": that command prints paths relative to ${ROOT} and the next agent runs ` +
   `from elsewhere, so the prefix is not optional.\n\n` +
@@ -67,23 +58,23 @@ const contexto = await agent(
   `still says "por definir", it is false.\n\n` +
   `Finally run "node tools/ops.js evaluate ${AGENT} --cases" and set cases to how many it listed. ` +
   `Report only what the commands printed.`,
-  { schema: CONTEXT, label: 'contexto' },
+  { schema: CONTEXT, label: 'context' },
 )
-if (!contexto) return stop('sin-contexto', `no se pudo ubicar el cargo ${AGENT}`)
-if (contexto.hasChange) {
-  return stop('ya-propuesta', `${contexto.proposal} ya tiene un cambio concreto; revisalo o borralo antes`)
+if (!context) return stop('sin-contexto', `no se pudo ubicar el cargo ${AGENT}`)
+if (context.hasChange) {
+  return stop('ya-propuesta', `${context.proposal} ya tiene un cambio concreto; revisalo o borralo antes`)
 }
-log(`${contexto.proposal} · ${contexto.cases} caso(s) vigentes`)
+log(`${context.proposal} · ${context.cases} caso(s) vigentes`)
 
 phase('Proponer')
 
-const propuesta = await agent(
-  `Sos quien mantiene el cargo ${AGENT}. La propuesta ${contexto.proposal} consolidó lo que ` +
+const proposal = await agent(
+  `Sos quien mantiene el cargo ${AGENT}. La propuesta ${context.proposal} consolidó lo que ` +
   `recomendaron los informes semanales, pero le falta lo único que una persona puede aprobar: el ` +
   `cambio concreto.\n\n` +
   `Leé los informes citados en su sección «Hallazgos», el SKILL.md del cargo, ` +
-  `${contexto.dir}/learning/sources.yaml, ${contexto.dir}/evaluations/expected-behaviors.yaml y sus ` +
-  `casos en ${contexto.dir}/evaluations/cases/. Después completá **sólo** estas tres secciones de la ` +
+  `${context.dir}/learning/sources.yaml, ${context.dir}/evaluations/expected-behaviors.yaml y sus ` +
+  `casos en ${context.dir}/evaluations/cases/. Después completá **sólo** estas tres secciones de la ` +
   `propuesta, sin tocar ninguna otra ni el frontmatter:\n\n` +
   `**Cambio propuesto**: el texto exacto a agregar o reemplazar, archivo por archivo, citando la ` +
   `sección o la línea que se toca. Que se pueda aplicar leyéndolo, sin volver al informe. Preferí ` +
@@ -92,7 +83,7 @@ const propuesta = await agent(
   `**Riesgos y regresiones**: qué caso adversarial existente podría empezar a fallar y qué parte del ` +
   `contrato podría contradecirse. Si dos reglas quedan en tensión aparente, resolvela en el texto ` +
   `propuesto, no la dejes para quien aplique.\n\n` +
-  `**Evaluación**: contrastá el cambio contra los ${contexto.cases} casos vigentes, uno por uno, y ` +
+  `**Evaluación**: contrastá el cambio contra los ${context.cases} casos vigentes, uno por uno, y ` +
   `decí si cada uno sigue pasando. Si una conducta prohibida nueva no tiene caso que la distinga de ` +
   `las que ya están, escribí el enunciado del caso que haría falta —con **cuatro** comportamientos ` +
   `esperados, como todos los del catálogo— y **no crees el archivo**: cambiar el denominador de la ` +
@@ -104,14 +95,14 @@ const propuesta = await agent(
   `identificaste y un resumen en una frase.`,
   { schema: RESULT, label: `propone:${AGENT}` },
 )
-if (!propuesta) return stop('sin-propuesta', 'el agente no devolvió resultado')
+if (!proposal) return stop('sin-propuesta', 'el agente no devolvió resultado')
 
-log(`Tocaría: ${(propuesta.files || []).join(', ')}`)
+log(`Tocaría: ${(proposal.files || []).join(', ')}`)
 return finish({
   agent: AGENT,
-  proposal: contexto.proposal,
-  files: propuesta.files || [],
-  risks: propuesta.risks || 0,
-  newCase: propuesta.newCase || '',
+  proposal: context.proposal,
+  files: proposal.files || [],
+  risks: proposal.risks || 0,
+  newCase: proposal.newCase || '',
   next: 'firmá «Aprobación humana» y corré /agent-promote',
 })