Keep logs structured — every log is a typed event
- Use an
event_typefield with enums like:import_createdimport_processedmemory_ingestedauto_taggederror
Keep logs tied to entities
- Add references:
user_idimport_idmemory_idprompt_id
Avoid logging excessively granular steps
- No need to log “normalized field X” unless debugging
- Focus on discrete lifecycle transitions
Keep them immutable
- Logs should be write-once and never edited