kmemo-core/dev.kmemo/CandidateTrace

CandidateTrace

class CandidateTrace(val prompt: String, val similarity: Double, val aboveThreshold: Boolean, val guardVerdicts: Map<String, GuardVerdict>)

One candidate entry and every guard's verdict on it, from a CacheExplanation.

The difference from a real lookup is that guardVerdicts holds every guard's verdict, not just the first rejection. A lookup stops at the first guard that objects, because one veto is enough to refuse; an explanation keeps going, because when you are tuning you want to know that three guards objected and which three, not only that the first did.

Constructors

CandidateTrace

constructor(prompt: String, similarity: Double, aboveThreshold: Boolean, guardVerdicts: Map<String, GuardVerdict>)

Properties

aboveThreshold

val aboveThreshold: Boolean

Whether similarity cleared the threshold. A guard verdict on a candidate below it is moot.

guardVerdicts

val guardVerdicts: Map<String, GuardVerdict>

Every guard's verdict, in the order the guards run, keyed by MatchGuard.name. The guards are evaluated in the same direction a lookup uses them — query against this cached prompt.

prompt

val prompt: String

The cached prompt this candidate holds.

rejectingGuards

val rejectingGuards: List<String>

The guards that rejected this candidate, in guard order. Empty when every guard abstained.

similarity

val similarity: Double

Its similarity to the query, in [-1.0, 1.0].

wouldServe

val wouldServe: Boolean

True when this candidate cleared the threshold and no guard rejected it.

Functions

toString

open override fun toString(): String