Eval candidates
An eval candidate is a proposed behavior definition derived from one or several verified failure groups. It is not an executed test result.

Candidate contents
Section titled “Candidate contents”- one or more representative cases;
- proposed input or fixture description;
- expected behavior;
- rubric and grader proposal;
- source failure groups and findings;
- evidence spans and telemetry gaps;
- immutable generator and detector provenance;
- explicit review state.
Create from one investigation
Section titled “Create from one investigation”From Investigation, choose Create eval candidate. Review the evidence packet, expectations, rubric, grader, source run/revision, and telemetry-gap summary before creating one draft.
Bulk creation
Section titled “Bulk creation”From Failure Inbox, select several exact groups and choose Create evals. The preview reports:
- proposed candidates;
- existing candidates that will not be duplicated;
- excluded groups and reasons;
- representative occurrence chosen per group.
Create the batch only after reviewing the preview. You do not need to select every trace individually.
Representative selection
Section titled “Representative selection”Perseval selects a bounded representative occurrence using deterministic group evidence. Exact groups remain canonical even when feature similarity is enabled. Candidate identity and evidence hashes do not change because a secondary cohort was rebuilt.
Review queue
Section titled “Review queue”
Drafts enter the review queue as Pending. A reviewer can:
- Accept a definition for downstream use;
- Reject it with an explicit decision;
- Defer it while keeping it in the queue.
Decisions and reviewer reference persist across restart. Review does not activate a grader or mutate the source finding.
Troubleshooting
Section titled “Troubleshooting”Candidate already exists
Section titled “Candidate already exists”Generation is idempotent for the same source identity. Open the queue and find the existing definition instead of creating a duplicate.
Group is excluded
Section titled “Group is excluded”Choose one explicit project, confirm a concrete evidence occurrence exists, and resolve severe telemetry gaps before retrying.
Candidate missing after restart
Section titled “Candidate missing after restart”Check project scope and queue-state filters. Accepted, rejected, deferred, and pending records are durable.