Decision logging specification
Updated August 2026
What is logged
Each screening run records: job snapshot, resume file identity, parse status, duplicate matches, specialization filter outcome, per-criterion scores, overall fit, evidence quotes with source spans, and the recruiter action taken after review.
Timestamps and identity
Events are timestamped in UTC. Logs include tenant id, user id of the reviewer, and a correlation id for the matching run so a single candidate can be traced from parse through shortlist to human decision.
Retention and export
Production tenants can export CSV or JSON audit trails for a date range or a single vacancy. Retention follows the tenant’s contract and applicable employment-record rules. Demo environments use synthetic profiles only and do not store personal data.
Integrity
Log records are append-only. Score changes after a model update do not rewrite historical runs; a new run is stored. Exports include the model/version identifier used for that run.