Rulvar API reference / @rulvar/rulvar / evidenceGradeValidator
Function: evidenceGradeValidator()
function evidenceGradeValidator(options?): FinishValidator;Defined in: packages/core/dist/index.d.ts
Requires every evidence-GRADE claim to point at an artifact (RV1212). A sentence that says live-observed, provider bill, or production-proven is claiming the report watched it happen, and a claim of that grade with nothing to check it against is the most expensive kind of wrong: the sixteenth comparison run's answer used the register about a runtime its own live run never observed, and every reader-side check passed because the text was well formed. The rule is deliberately local and deterministic: the artifact reference must appear in the SAME sentence as the phrase (a run id or a path:line citation by default), so moving the evidence three paragraphs away no longer satisfies the grade. Purely textual: what the referenced artifact contains is citedValueValidator's question, and whether it exists on disk is the host's.
The run's OWN id is an artifact (RV2501). DEFAULT_ARTIFACT_PATTERN only ever matched the literal word run followed by a ULID, so the escape the verdict advertised was unreachable for every run whose id the engine did not mint in that exact shape: the comparison run's comparison-rulvar-v12260-aug09-... matched nothing, its synthesis had no artifact it could name, and a document that told the truth about the run it was part of could not be written at all. When FinishValidationInput.runId is supplied (the orchestrator runtime always supplies it), a sentence carrying that id verbatim as a whole token satisfies the grade, and the verdict names the id so the repair instruction is executable rather than aspirational. An id shorter than MIN_RUN_ID_ARTIFACT_CHARS (six) is ignored, and without an id the verdict is byte identical to the historical one.
With the id in hand the failure also carries FinishRepairHint rows (RV3801), one per offending sentence, so the finish loop can perform the verdict's own prescription host side without spending a provider wire; the reasons stay byte identical either way, and the hints are bounded (at most MAX_REPAIR_HINTS offenders) and fail closed (an id whose bytes could split a sentence is never hinted). Default name 'evidence-grade'.
Parameters
| Parameter | Type | Description |
|---|---|---|
options? | { artifactPattern?: string; name?: string; phrases?: readonly string[]; } | - |
options.artifactPattern? | string | - |
options.name? | string | - |
options.phrases? | readonly string[] | Overrides DEFAULT_EVIDENCE_GRADE_PHRASES; matched case-insensitively. |