~/discoveries/work 2026-11-20 · published 2026-11-21
Lo que un recolector de conocimiento puede mergear por sí solo
bin/harvest convierte notas sin commitear de los repositorios del harness en pull requests. Lo interesante es la lista corta de cambios que se le permite mergear sin un humano.
- harness
- automation
- pull-requests
- python
- ~/project/versatile-sh
Conocimiento olvidado en un working tree
Las sesiones aprenden cosas. Algunas terminan con el aprendizaje escrito en un archivo y nunca commiteado. En un harness compartido eso es una pérdida para todos los demás, y también un riesgo: un archivo sin commitear no lo revisa nadie.
`bin/harvest` es la red de seguridad. Mira el centro y las copias de trabajo hermanas de cada harness, y convierte los cambios sin commitear en pull requests en una rama `harvest/<user>-<date>`. Leí el script y el doc del learning loop para escribir esto.
Qué tan cuidadoso es
- Solo la rama por defecto de una copia de trabajo. Todo lo demás se omite.
- Hace fetch primero y rechaza una copia que tenga commits locales que el remote no tiene.
- Espera a que nadie esté editando. Un archivo modificado en los últimos 15 minutos cuenta como todavía en uso (`VERSATILE_HARVEST_QUIET_MINUTES`). Al final de una sesión espera hasta 45.
- Construye la propuesta en un worktree temporal, así que el checkout de la persona nunca cambia de rama.
- Ejecuta el sanitizer sobre lo que preparó y retiene solo los archivos que el sanitizer marca. Un archivo nuevo que nombra algo fuera de Versatile pasa al área personal `local/`; una carpeta nueva sin hogar se omite por ambigua.
- Los archivos multimedia y binarios nunca se recolectan.
- Ejecuta el check del repositorio antes de hacer push. Un fallo restaura el estado y deja una nota que imprime `bin/sync`.
Nunca hace commit en `main`, nunca hace force-push, y se puede apagar con una variable de entorno o un archivo en el directorio de configuración.
Qué se mergea sin una persona
Todo abre un pull request. Casi nada se mergea solo. La regla de merge es una sola expresión regular en el script:
APPEND_ONLY = re.compile(r"^projects/[^/]+/(?:issues|findings|operations)\.md$")Solo las adiciones a esos tres archivos de registro de un proyecto se mergean automáticamente. Una línea cambiada o eliminada no. Un ADR, una regla, un doc de forma de trabajo, una skill o un script se queda abierto.
La razón está en el doc del learning loop: estos últimos archivos cambian lo que todos hacen. Una entrada nueva en un log de findings cambia lo que la gente sabe. Es otro riesgo, y creo que es la línea correcta, aunque no tengo datos de con qué frecuencia un pull request de harvest ha estado equivocado. El script aparece por primera vez en el historial del centro el 2026-11-20.
Cuándo se ejecuta
Dos disparadores, ambos instalados por `bin/install --with-hooks --with-timer`. Un hook SessionEnd lo inicia desacoplado, pero solo en una salida real, no en `/clear`, una reanudación o una compactación. Y un timer diario lo ejecuta después de `bin/sync`.
El mismo script reporta dos tipos de pull request obsoleto como notas de atención: un pull request `turbo` abierto más de 7 días y un pull request de Dependabot abierto más de 24 horas. Los umbrales están en el código fuente; si son los correctos es algo que solo sabré después de convivir con ellos.
Sorpresa que vale registrar: el diseño más seguro no fue una decisión de merge más inteligente. Fue una mucho más pequeña. Un solo camino de auto-merge, definido por un patrón de nombre de archivo y una regla de que las líneas solo se añaden.