replay

type CorpusSummary struct {
	// Frames is the total number of frames analyzed.
	Frames int

	// LabeledFrames is the subset that had an operator-provided Label.
	LabeledFrames int

	// PerMechanism maps mechanism → its TP/FP/FN counts. Precision is
	// TP/(TP+FP); recall is TP/(TP+FN).
	PerMechanism map[string]*MechanismStats

	// FlipFlops is the total count of mechanisms whose tier changed
	// between capture and replay across the entire corpus.
	FlipFlops int
}

type MechanismStats struct {
	TP, FP, FN, TN int
	// AvgTier is the average tier rank for replayed outputs
	// (A=4, B=3, C=2, D=1, unknown=0).
	AvgTierRank float64
}

type ReplayResult struct {
	FrameFile string

	// Original is what the engine emitted at capture time.
	Original []model.VerifiedCause

	// Replayed is what the verifier emits NOW on the same inputs.
	Replayed []model.VerifiedCause

	// TierMatch reports per-mechanism whether the replayed tier
	// equals the original tier. true → deterministic, the engine
	// has not drifted; false → behavior changed since capture.
	TierMatch map[string]bool

	// FlipFlops counts mechanisms whose tier CHANGED between
	// capture and replay. Sentinel for engine non-determinism or
	// behavioral regression.
	FlipFlops int
}