Sessions & Findings

JSONL Run Logs

One JSON object per line, capturing every iteration. Stored in sessions/:

ASR

ASR = (findings with score >= threshold) / (total probe attempts)

Ed25519 Signed Findings Log

Findings entries can be appended to a signed, append-only JSONL log. Every entry carries an Ed25519 signature (the private key never touches disk — only the public key is embedded in the signed record), so any mutation of a stored entry is detected at load time. All writes are atomic (temp file + fsync + rename).

Report & Export

Omit the log path to use the latest run in sessions/. Reports are markdown by default, styled HTML with --html; export always emits structured JSON (add --fail-on-finding to use it as a CI gate).