@ingeniomaps/cauce 0.49.0 → 0.52.0

package/CHANGELOG.md

@@ -14,7 +14,53 @@ 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.49.0] - 2026-08-26
+## [0.52.0] - 2026-08-27
+
+### Corregido
+
+- **Lanzar el aprendizaje a mano ya no arrastra el ensamblaje mensual.** El `workflow_dispatch` corría
+  las dos fases, así que probar la investigación de un cargo abría además su propuesta — y una
+  propuesta cuesta una firma humana. Peor: consolidar **sella** los informes que consume, o sea que un
+  lanzamiento de prueba movía estado real del ciclo. Ahora el dispatch acepta `phase`, con `research`
+  por defecto, que es para lo que se lanza a mano; `propose` y `both` siguen disponibles cuando de
+  verdad haga falta, y los crones deciden por su cuenta como siempre.
+- **Los permisos de la investigación llegaban partidos, y `Bash` nunca se concedía.** Iban en una
+  cadena sin comillas, así que el shell partía `Bash(make agent-learn *)` en tres palabras y el CLI
+  descartaba la última —«Ignoring --allowedTools rule "*)"»—. La investigación salía bien igual porque
+  con web y lectura alcanzaba, así que el defecto vivía en dos líneas del log y en ningún resultado.
+- **La investigación late mientras corre y deja dicho lo que costó.** El log quedaba mudo los diez
+  minutos que dura y no se distinguía de una corrida colgada: la única salida era esperar el timeout
+  para saber cuál era. Ahora avisa cada minuto —el latido lo emite el shell y comprueba el proceso, así
+  que no puede mentir que sigue vivo— y al cerrar deja en el resumen del job **cuánto costó en dólares,
+  cuántos tokens y qué permisos se le negaron**. Eso último es lo que vuelve visible un permiso mal
+  escrito, que es como se descubrió el de arriba.
+
+## [0.51.0] - 2026-08-27
+
+### Agregado
+
+- **El guard `destructive` bloquea la forma ancha de `git checkout` y `git restore`.** `git checkout
+  -- .` destruye lo mismo que `git reset --hard` —que ya se bloqueaba— y sin recuperación, pero se
+  escribe como una limpieza. Se bloquea sólo cuando la ruta es `.`, `*`, `:/` o no hay ninguna:
+  revertir un archivo nombrado es trabajo corriente y sigue pasando. Lo que engaña es que el alcance no
+  se ve en el comando — `.` es el directorio actual, y ahí suele haber más de lo que uno está mirando.
+
+## [0.50.0] - 2026-08-27
+
+### Corregido
+
+- **La investigación semanal recibe las herramientas que su instrucción nombra.** Corría sin permisos
+  declarados, así que no podía correr un comando ni salir a la web —que es todo lo que una
+  investigación hace— y devolvía el informe vacío en tres minutos. El cargo se portaba bien y lo decía:
+  «no voy a fabricar fuentes, fechas ni salidas de comando para llenar el informe». Ahora se le declaran
+  las que su `AUTOMATION.md` nombra —buscar, leer, escribir su informe, `make agent-learn` y
+  `make agent-evaluate`— y sólo ésas: saltear permisos le daría justo lo que su instrucción le prohíbe.
+- **Un informe sin contenido ya no abre PR.** Que el archivo exista no alcanza: `learn` lo crea vacío y
+  el modelo puede devolverlo tal cual, y así se publicaba. Un lunes eso son veintinueve PRs en blanco
+  sin que nada lo diga. Ahora se miran las secciones que la propuesta mensual consolida, y si están
+  vacías el job falla nombrando cuáles y dónde mirar la causa.
+
+## [0.49.0] - 2026-08-27
 
 ### Agregado
 
@@ -28,12 +74,6 @@ diseño — eso vive en el commit y en el código.
 
 ### Corregido
 
-- **Un recorrido que frena da igual la salida que su contrato reserva para no poder.** `change-review`
-  enumera tres veredictos y el tercero es «no poder aprobar»; bloqueado, su informe parcial escribía
-  «No hay veredicto», que no es ninguno de los tres. Con el diff, los importadores y las pruebas a la
-  vista, un revisor **sí** puede firmar que no aprueba: eso es un veredicto, no su ausencia. Vale para
-  cualquier recorrido cuyo contrato tenga esa salida — un destino de «nada que hacer», una
-  recomendación de investigar.
 - **`dependsOn` dejó de ser decorativo: un recorrido corre sus etapas como su contrato las declara.**
   Hasta ahora el motor las corría en fila y le pasaba a cada una los handoffs de **todas** las
   anteriores, sin mirar de qué decía depender. `technical-design` existe para tener tres lecturas
@@ -45,15 +85,17 @@ diseño — eso vive en el commit y en el código.
   **no** declara `dependsOn` sigue viendo todo lo anterior, igual que antes: independencia es una
   afirmación, y una afirmación se declara. Si una etapa no cumple su gate, el corte es por nivel — las
   que corrieron con ella entran igual al handoff, y lo que se abandona son los niveles siguientes.
+- **Un recorrido que frena da igual la salida que su contrato reserva para no poder.** `change-review`
+  enumera tres veredictos y el tercero es «no poder aprobar»; bloqueado, su informe parcial escribía
+  «No hay veredicto», que no es ninguno de los tres. Con el diff, los importadores y las pruebas a la
+  vista, un revisor **sí** puede firmar que no aprueba: eso es un veredicto, no su ausencia. Vale para
+  cualquier recorrido cuyo contrato tenga esa salida — un destino de «nada que hacer», una
+  recomendación de investigar.
 - **Cambiar el `flow.json` de un recorrido ahora envejece sus veredictos.** El aviso de «el contrato
   cambió y la última corrida es anterior» miraba sólo el `SKILL.md`, que un recorrido no tiene, así que
   no se disparaba nunca: se le podía agregar una dimensión a un gate y sus casos aprobados seguían
   leyéndose vigentes. Qué archivo **es** el contrato depende del sujeto — el de un cargo es su
   `SKILL.md`, el de un recorrido su `flow.json`— y ahora se mira el que corresponde.
-## [0.49.0] - 2026-08-27
-
-### Corregido
-
 - **`ops context` ya no se traga las acciones humanas cuando no hay tarea en cola.** Se imprimían
   después del `return` de «sin tarea disponible», así que una instancia recién arrancada —`onboard`
   deja filas pendientes y ninguna tarea todavía— preguntaba qué toca ahora y recibía «nada», cuando lo

package/engine/hooks/run.js

@@ -114,6 +114,19 @@ function destructive(input) {
   const rules = [
     [/\bgit\s+reset\s+--hard\b/, "'git reset --hard' destruye cambios locales."],
     [/\bgit\s+clean\s+-[^\s]*f/, "'git clean -f' borra archivos sin seguimiento."],
+    // `git checkout -- .` destruye lo mismo que `reset --hard` y sin recuperación, pero se escribe como
+    // una limpieza. Se bloquea sólo la forma ancha —`.`, `*`, `:/`, o sin ruta—: revertir un archivo
+    // nombrado es trabajo corriente y no se toca.
+    //
+    // Pasó dos veces en una sesión, las dos limpiando restos de una prueba: el comando revirtió también
+    // el trabajo de al lado, que no estaba commiteado. Lo que engaña es que el alcance no se ve en el
+    // comando — `.` es el cwd, y el cwd suele tener más de lo que uno está mirando.
+    [
+      // `git restore .` no lleva `--` y destruye igual: es la forma moderna del mismo comando.
+      /\bgit\s+(?:checkout|restore)\s+(?:[^;&|]*?\s)?(?:--\s*(?:$|[;&|])|(?:--\s+)?(?:\.|\*|:\/)\s*(?:$|[;&|]))/,
+      "'git checkout -- .' revierte todo lo no commiteado del directorio, no sólo lo que estás mirando. "
+      + 'Nombrá el archivo, o commiteá lo que quieras conservar antes.',
+    ],
     [
       /\bdocker(?:\s+\w+)*\s+(?:volume\s+(?:rm|prune)|system\s+prune|network\s+prune)\b/,
       'La limpieza global de Docker puede borrar datos compartidos.',

package/package.json

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