~/daily/work 2026-11-20 · published 2026-11-21
Código fresco primero, una vez por sesión
Un hook PreToolUse que hace pull de una rama por defecto limpia la primera vez que una sesión toca un repositorio y, en los demás casos, solo hace fetch y le dice al modelo qué va atrasado.
- harness
- hooks
- git
- python
- ~/project/versatile-sh
El bug que previene
Un agente lee código que va tres commits por detrás de su remote, planifica un cambio sobre él y abre un pull request que entra en conflicto o revierte algo. Nadie hizo nada mal. El checkout simplemente estaba viejo.
La regla 12 del harness dice que la primera vez que una sesión toca un repositorio, hace fetch y lo actualiza antes de leer o cambiar código. El pull request #178 añadió esa regla el 2026-11-20, junto con el hook que la aplica para que nadie tenga que acordarse.
Qué decide el hook
`hooks/fresh-pull.py` se ejecuta antes de las herramientas de archivos y de shell. Encuentra el repositorio a partir del archivo que se toca, o del primer `cd` de un comando de shell. Actúa solo en repositorios de la organización, y solo una vez por sesión y repositorio (un archivo marcador en el directorio de caché, limpiado tras siete días).
| Estado del checkout | Qué hace el hook |
|---|---|
| Limpio, en su rama por defecto, con upstream | git pull --ff-only, en silencio |
| Cualquier otro, y va atrasado | git fetch, luego una línea de contexto para el modelo: cuántos commits atrasado, en qué rama, si hay cambios locales |
| Cualquier otro, y no va atrasado | Nada |
| Cualquier error o timeout (8 segundos por llamada a git) | Silencio; la llamada a la herramienta continúa |
Nunca hace stash, reset, rebase ni cambia de rama, y nunca bloquea una llamada a una herramienta. Cuando solo hizo fetch, el mensaje le dice al modelo que haga rebase o merge después de que el dueño del trabajo local esté de acuerdo.
Trade-offs
El hook cuesta un fetch en el primer toque, acotado por el timeout. A cambio, el caso común, un checkout limpio de `main`, no requiere pensar. El caso poco común, una rama de feature atrasada, se convierte en una frase en el contexto del modelo en lugar de una sorpresa a la hora del merge.
Dos decisiones vinieron de la cautela. Primera, prefiere no decir nada antes que adivinar: un fetch fallido es silencioso. Segunda, no intenta ser listo con los árboles sucios. Los archivos sin seguimiento se ignoran al decidir si un árbol está sucio, pero las ediciones con seguimiento detienen el pull.
Hay un interruptor de apagado (FRESH_PULL=off) y uno de ampliación para repositorios fuera de la organización (FRESH_PULL_ANY=1). Mantuve el valor por defecto estrecho a propósito: un hook que toca un repositorio que no le pertenece es otro tipo de riesgo.