Actualizar daimon
uv tool upgrade daimon-briefing
Los scripts de hooks y los archivos de skill instalados son copias de contenido que se mueve con la CLI, así que refrescalos después de actualizar.
- Refrescá los scripts de hooks en cada host que los tenga instalados:
daimon hooks install <host>. Sin host, daimon detecta lo que corre esta máquina. Un host servido por el plugin de daimon no necesita nada. - Revisá las skills con
daimon skill status. Informa cada skill instalada comoCURRENT,STALE,MISSINGy así, y sale con código distinto de cero si hay deriva. Arreglá la deriva condaimon skill install. - Si usás checks de reglas,
daimon hooks installydaimon check syncreconstruyen el manifiesto que lee un host.daimon check sync --checklo audita y no escribe nada. - Corré
daimon status. Una línealegacy:significa que existe un bucket escrito con la regla de nombres previa a la 0.42.0 para este proyecto, y la sección de abajo lo mueve.
Leé la entrada de la versión en CHANGELOG.md antes de cambiar. daimon es pre-1.0, así que un cambio incompatible sale como versión menor y figura bajo BREAKING CHANGES.
Actualizar a través de la 0.42.0
Antes de la 0.42.0 la biblioteca nombraba el bucket de un proyecto a partir de la ruta literal que recibía. Desde la 0.42.0 cada entry point resuelve la ruta primero: la vuelve absoluta, colapsa los symlinks y después la normaliza al toplevel de git. Por eso hay dos formas de ruta que ahora nombran un bucket distinto al de antes:
- una ruta con un symlink en cualquier parte, en macOS eso incluye todo lo
que se alcanza a través de
/tmp, y cualquier punto de montaje que sea un enlace; - una ruta debajo de un toplevel de git, cuando la escritura vino por la biblioteca y no por la línea de comandos.
La CLI ya resolvía las dos cosas antes de la 0.42.0, así que un bucket escrito
corriendo daimon en una terminal no está afectado. Un bucket escrito por un
proceso anfitrión que llamó a la biblioteca desde una ruta así queda con el
nombre viejo, y nada lo lee.
daimon status lo dice. Cada vez que existe un bucket escrito con la regla
vieja para la ruta donde estás parado, el bloque de salud trae una línea
legacy: que lo nombra. Movelo una sola vez:
daimon bucket migrate # este proyecto
daimon bucket migrate --project /ruta/al/proyecto
daimon bucket migrate --project /ruta/al/proyecto --dry-run
El movimiento renombra el directorio viejo cuando el nuevo todavía no existe, y
en caso contrario fusiona. Una fusión agrega cada línea de ledger que el bucket
nuevo no tenga ya, y suma los punteros del bucket viejo a la cadena del nuevo.
Los punteros que ya están en el bucket nuevo nunca se borran ni se desplazan:
son del proyecto vivo. Los punteros viejos entran en los espacios que deje
libres DAIMON_CHECKPOINT_HISTORY, del más nuevo al más viejo, salvo que una
copia vieja de una sesión a la que el bucket nuevo ya apunta reemplaza ese
único espacio cuando es la más nueva de las dos. Todo lo demás, un puntero
viejo sin espacio libre o un archivo que daimon no escribe, queda exactamente
donde está y se nombra en el reporte junto con qué hacer al respecto.
Correrlo dos veces es seguro: una segunda corrida sobre un estado sin cambios no
escribe nada nuevo y devuelve el código que corresponde al estado que encuentra.
--dry-run imprime el mismo plan y no escribe nada.
La salida 0 significa que el movimiento terminó y el bucket viejo ya no está.
La salida 1 significa que no, y stdout nombra cada cosa que quedó con su propio
remedio: subí DAIMON_CHECKPOINT_HISTORY al número que indica y volvé a correr
para los punteros sin espacio libre; arreglá o movés un archivo que no se pudo
leer; sacá del bucket viejo un archivo que daimon no escribe. Un movimiento
parcial no cuenta como migrado, así que las filas del bucket viejo todavía no se
leen como historia de este proyecto. Si terminás el trabajo por tu cuenta
limpiando el directorio viejo, la siguiente corrida lo registra y la migración
queda completa.
La salida 2 es un rechazo. Un --project con un componente .. se rechaza
porque la regla vieja colapsa el .. antes de seguir un symlink y la actual
sigue el symlink primero, así que las dos nombran directorios distintos; un
bucket escrito antes de 0.42.0 se escribió bajo el slug literal de la ruta ya
colapsada, así que pasá esa ruta. En un home con alcance de inquilino
(DAIMON_TENANT_SCOPED) un --project explícito se rechaza directamente y el
proyecto sale de DAIMON_PROJECT_DIR, o del directorio de trabajo: una
migración escribe un alias duradero entre dos buckets, y elegir cuáles dos es
elegir un alcance. La misma regla vale para todos los verbos: en un home con alcance de inquilino se rechaza un --project que nombre otro bucket, sea cual sea el verbo.
Cada movimiento completado agrega una línea a
~/.daimon/checkpoints/migrations.jsonl. Ese archivo es lo que permite que
daimon recall y la bandeja de pedidos sigan encontrando el historial bajo el
nombre viejo del bucket una vez que el directorio ya no está: los archivos de
checkpoint por sesión conservan el nombre con el que fueron sellados, porque sus
receipts atan sus bytes exactos. Cuando un bucket ya absorbió a otro, daimon status muestra una línea migrated: from <bucket viejo> on <fecha> en lugar de
la advertencia.