Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/store-conformance / KillPointScenarioOptions

Interface: KillPointScenarioOptions

Defined in: packages/store-conformance/src/kill-points.ts:598

Properties

PropertyTypeDescriptionDefined in
closeStore?(fixture) => void | Promise<void>Closes what KillPointScenarioOptions.openStore opened.packages/store-conformance/src/kill-points.ts:629
dirstringScratch directory for the report file.packages/store-conformance/src/kill-points.ts:606
env?Record<string, string>Extra environment for the worker process.packages/store-conformance/src/kill-points.ts:631
execArgv?string[]Extra node arguments placed before the writer script.packages/store-conformance/src/kill-points.ts:633
openStore() => | FencedTranscriptsFixture | Promise<FencedTranscriptsFixture>Opens the referee's own fixture over the SAME store location for the resume and the final state verification.packages/store-conformance/src/kill-points.ts:627
resumeDeadlineMs?numberCeiling on lease-held resume retries; default 15000 ms.packages/store-conformance/src/kill-points.ts:635
scenario| string | KillPointScenarioThe scenario to execute, by table entry or id.packages/store-conformance/src/kill-points.ts:608
storePath?stringStore location handed to the worker config; default join(dir, 'kp.db').packages/store-conformance/src/kill-points.ts:610
ttlMs?numberThe WORKER'S lease ttl; default 2000 ms. The referee waits it out after the kill (retrying the resume on the typed rejection), so it stays short, but NOT so short that a scheduler stall on a loaded test runner can expire the WORKER'S own lease between its renewals before the kill point is even reached: a lost lease cancels the run by contract, the worker then exits zero as ran-to-completion, and the scenario reads a self-inflicted takeover as a violation. The same reasoning keeps the referee's own store (the openStore fixture) on its GENEROUS default ttl.packages/store-conformance/src/kill-points.ts:622
writerScriptstringAbsolute path of the consumer's writer script. It must construct the store over killPointWorkerConfigFromEnv() and call runKillPointWorker.packages/store-conformance/src/kill-points.ts:604