Keep logs structured — every log is a typed event

  • Use an event_type field with enums like:
    • import_created
    • import_processed
    • memory_ingested
    • auto_tagged
    • error

Keep logs tied to entities

  • Add references:
    • user_id
    • import_id
    • memory_id
    • prompt_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