Registros

Utilice epismo log para comentarios, actualizaciones de agentes y notas de revisión adjuntas a seguimientos de tareas y objetivos. Los registros no editan el propio content de la pista; crean una línea de tiempo junto a él. Cualquiera que pueda acceder a una pista puede leer y agregar registros en esa pista.

Agregar y eliminar registros es gratis. Listar registros cuesta 1 crédito.

Crear un registro

epismo log create <track-reference> --content "Blocked on missing test fixtures."
epismo log create <track-reference> --kind review --content "Tests failed" --metadata '{"verdict":"fail"}'
epismo log create <track-reference> --content "Retry-safe note" --idempotency-key 00000000-0000-4000-8000-000000000001

<track-reference> debe ser un UUID de tarea o objetivo, o una URL que contenga uno. Los alias de pista no existen.

--kind es uno de:

comment es el valor predeterminado. El tipo interno system está reservado para entradas generadas por la plataforma y no se puede escribir a través del CLI.

--metadata acepta un objeto JSON, con un límite de 16 KB una vez serializado. Úselo para campos compactos legibles por máquina; coloque detalles más grandes legibles por humanos en --content. Utilice --idempotency-key con un UUID cuando vuelva a intentarlo de forma segura. La reutilización de una clave de idempotencia devuelve el registro existente a menos que ese registro se haya eliminado, en cuyo caso el comando falla y genera un conflicto.

Listar registros

epismo log list <track-reference>                       # newest first for one track
epismo log list <track-reference> --cursor <logId>      # older history
epismo log list <track-reference> --order asc           # chronological from the start
epismo log list                                          # every log you can see, newest first
epismo log list --author-id <userId>                     # only logs one user wrote

epismo log list lee los registros de una pista cuando pasa por <track-reference>. Omítelo para obtener un feed de actividades separado en cada pista a la que puedas acceder actualmente. --author-id limita cualquiera de los modos.

Los resultados son los más nuevos primero de forma predeterminada (--order desc). Utilice --order asc para la reproducción cronológica o, con --cursor, para recuperar solo lo que se agregó después de un registro conocido. La paginación es la misma en ambos modos: pase el nextCursor de la respuesta como --cursor con el mismo --order para buscar la página siguiente.

Las lecturas con alcance de pista siempre reflejan la ACL actual de la pista. La transmisión cruzada refleja una instantánea de ACL tomada cuando se escribió cada registro, no una nueva verificación en vivo. Si luego te eliminan de una pista, es posible que los registros que ya podías ver allí sigan apareciendo en el feed; epismo log list <track-reference> no se ve afectado y verifica la ACL actual de la pista.

Cada registro incluye los userId y authorName resueltos cuando la persona que llama puede ver ese autor. Los autores fuera del conjunto visible de la persona que llama se devuelven como "unknown" en lugar de exponer su identificación de cuenta. Si --author-id apunta a un autor que la persona que llama no puede ver, el resultado está vacío.

Eliminar un registro

epismo log delete <logId>

log delete elimina un registro. Los autores pueden eliminar sus propios registros; El creador de una pista puede eliminar cualquier registro de esa pista. Los registros eliminados se omiten en los resultados de la lista futura.

Costo

Errores comunes

• Pase un UUID de pista o una URL que contenga uno a create y list con alcance de pista. Los alias de pista no existen.
• Mantenga --order sin cambios al pasar nextCursor a --cursor.
• Utilice --metadata únicamente para datos estructurados compactos. Las actualizaciones largas pertenecen a --content.