Saltar al contenido principal

Resolución de problemas

Empezá con daimon status. Informa la salud de la captura con honestidad, fallas y saltos incluidos: el checkpoint más nuevo del proyecto y su antigüedad, el último resultado de serialize, y una línea por problema con qué hacer.

Sin briefing, nada capturado​

  • Una sesión más corta que DAIMON_MIN_MESSAGES (10 mensajes por defecto) no se serializa a propósito. Bajalo con echo 'DAIMON_MIN_MESSAGES=4' >> ~/.daimon/env si estás probando con sesiones cortas.
  • Comprobá que los hooks estén instalados con daimon hooks status, y las skills con daimon skill status.
  • Comprobá que el backend responde con daimon configure --test.

Una captura falló​

El próximo inicio de sesión reintenta una vez, en segundo plano, la sesión fallida más nueva con daimon heal. Podés correrlo vos:

daimon heal --dry-run # explica qué se repararía, y por qué no
daimon heal # la falla más reciente
daimon heal --all # cada sesión reparable de esta máquina
daimon heal --force # gasta otro intento en una sesión que usó su reintento

--project <dir> lo limita a un proyecto y --session <id> a una sesión. Una sesión que heal saltea se nombra con su razón:

razónqué significa
retry-exhaustedel reintento ya corrió y la sesión sigue fallando; volvé a correr con --force
unrecoverableno hay registro de lanzamiento, o el transcript ya no está, así que no se puede reparar
hungel serialize arrancó y nunca informó resultado, y el transcript no está disponible
admission-refusedel ledger de eventos del proyecto no se puede leer (mirá abajo)
repairingya está corriendo una reparación de ese ledger
project-unknownun transcript archivado bajo un directorio de proyecto cuyo proyecto no se puede recuperar; corré daimon serialize <transcript> --project <dir>
importun intento de importación, que heal nunca reintenta; volvé a correr daimon import para retomar

Un ledger no se puede leer​

Cuando el events.jsonl de un proyecto no se puede leer (un marcador de conflicto, un byte malo, un error del SO), daimon se niega a escribir un checkpoint para él, antes de llamar al modelo, así que el rechazo no cuesta nada. daimon status nombra el ledger y la cura, y el próximo briefing dice cuántas sesiones esperan. Repará el ledger y dejá que heal las reintente:

daimon ledger repair events --dry-run
daimon ledger repair events

ledger repair reúne las filas partidas en varias líneas y mueve cada línea que no puede parsear a <name>.quarantined-lines junto al ledger. Un rechazo solo se pierde cuando su transcript ya no está.

Una línea legacy: en status​

Existe un bucket escrito antes de la 0.42.0 para este proyecto. daimon bucket migrate lo mueve: mirá Actualizar daimon.

Sincronización de equipo​

El sync es fail-open por diseño: cualquier resultado degradado te deja en el último estado sincronizado y nunca rompe la sesión.

SituaciónQué pasa
Sin conexiónEl sync se pospone; conservas el último estado de equipo sincronizado. Tus checkpoints nuevos commitean localmente y quedan en cola para el siguiente push.
Credenciales git ausentesGit corre no-interactivo (GIT_TERMINAL_PROMPT=0), falla rápido en lugar de colgarse en un prompt de credenciales, y el sync se degrada a sin-conexión.
Pushes concurrentesUn push rechazado es benigno (un compañero ganó la carrera). Daimon integra su cambio y reintenta, acotado a 3 intentos, y luego advierte si sigue rechazado.
Historia compartida reescritaAdvertencia fuerte; daimon deja tu copia local intacta y se niega a auto-reparar. Daimon nunca hace force-push, resuélvelo a mano con git y con tu equipo.
Git no instaladoEl sync se omite y devuelve éxito (rc 0), la memoria de equipo simplemente está inactiva.