Core Concepts

Audit Trail

Complete decision traceability and evidence packs

Complete Traceability

Every decision in Semeion is logged and traceable. This audit trail is essential for compliance, debugging, and understanding system behavior.

Audit trail: Gate evaluations and overrides flow to decision_logs and evidence_packs
Complete diagram · Fit to page

Full-size diagram

Audit trail: Gate evaluations and overrides flow to decision_logs and evidence_packs

Decision Logs

The decision_logs table records gate decisions and overrides:

  • Gate evaluations (eventType: "gate_evaluation")
  • Manual overrides (eventType: "override", with reason and actor)

Evidence Packs

Evidence packs are immutable snapshots of all inputs to a decision. They capture:

  • The signals considered
  • The scores computed
  • The cluster state at decision time
  • The gate configuration used

This allows any decision to be fully reconstructed and audited after the fact.

Override Visibility

When a human overrides an automated gate decision, the override is permanently visible. The original automated decision, the override, the actor, and the reason are all preserved.