Rulvar API reference / @rulvar/core / JournaledSynthesisCandidate
Interface: JournaledSynthesisCandidate
Defined in: packages/core/src/stores/synthesis-candidates.ts:81
One finish candidate, folded from its journaled verdict (RV2902).
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
bytesUnavailableReason? | string | Why the candidate's BYTES are not retained (RV4207), from the decision itself: 'hash-only-persistence' names the declared policy, 'store-write-failed' a retention that was declared and refused by the store. Absent on journals written before the field, and everywhere no reason applies; a blob later deleted by retention leaves the hash and this field as the honest remainder. | packages/core/src/stores/synthesis-candidates.ts:115 |
callId? | string | The finish call id the verdict was keyed by. | packages/core/src/stores/synthesis-candidates.ts:89 |
candidateChars? | number | - | packages/core/src/stores/synthesis-candidates.ts:104 |
candidateHash? | string | The candidate's identity (RV2507): the candidateHashOf hash and the char count. Journaled on every non-accepted verdict since RV2507, and on the ACCEPTED verdict too under a declared candidatePersistence (RV4207), where it names the resolved document (deterministic patch or sectional splice applied), so the whole chain reads by hash. | packages/core/src/stores/synthesis-candidates.ts:103 |
candidateRef? | string | The rejected candidate's transcript blob, under retention. | packages/core/src/stores/synthesis-candidates.ts:106 |
contractHash? | string | The contract generation the verdict was rendered under. | packages/core/src/stores/synthesis-candidates.ts:94 |
costUsd? | number | The window priced per call at the caller's table. Present only when a price function was given and it priced EVERY window wire; an unpriced model drops the field rather than shrinking it. | packages/core/src/stores/synthesis-candidates.ts:152 |
failed | readonly SynthesisCandidateFailure[] | The failed validators with their reasons, verbatim. | packages/core/src/stores/synthesis-candidates.ts:117 |
maxRepairs? | number | - | packages/core/src/stores/synthesis-candidates.ts:92 |
repairsUsed? | number | Repairs spent BEFORE this candidate, from the verdict itself. | packages/core/src/stores/synthesis-candidates.ts:91 |
spanLabel? | string | The hosting span's dispatch label (RV2901), when journaled. | packages/core/src/stores/synthesis-candidates.ts:119 |
spanSeq? | number | The hosting span's running entry seq (RV3802): the span's identity within the run, so two candidates can be read as neighbors of ONE composition invocation (the repair-turn pairing below) instead of accidental neighbors across spans. Absent exactly when unhosted. | packages/core/src/stores/synthesis-candidates.ts:126 |
usage? | Usage | Summed recorded usage of the window's wires; same condition. | packages/core/src/stores/synthesis-candidates.ts:140 |
usageUnknownWires? | number | Window wires that recorded NO usage on a non-ok outcome: the provider may have billed them anyway, so costUsd is a floor whenever this is nonzero. | packages/core/src/stores/synthesis-candidates.ts:146 |
verdict | "rejected" | "repair" | "accepted" | The journaled verdict: 'accepted', 'repair', or 'rejected'. | packages/core/src/stores/synthesis-candidates.ts:83 |
verdictAt? | string | The verdict decision's stamp, when the entry carried one. | packages/core/src/stores/synthesis-candidates.ts:87 |
verdictSeq | number | The verdict decision's seq: the candidate's address in the run. | packages/core/src/stores/synthesis-candidates.ts:85 |
windowMs? | number | Wall from the previous boundary (the span's start, or the prior verdict) to this verdict's stamp. Absent when the candidate is not hosted by a settled synthesize span or a stamp is missing. | packages/core/src/stores/synthesis-candidates.ts:132 |
wires? | number | Provider wire requests inside this candidate's window (absorbed continuations counted). Present only when the incremental rows cover the hosting span's terminal call records exactly. | packages/core/src/stores/synthesis-candidates.ts:138 |