YUCLAW 8.0.0: making evidence demos reproducible with an explicit snapshot mode

YUCLAW released version 8.0.0, adding an explicit snapshot mode set via the environment variable YUCLAW_CORPUS=snapshot so that check-claim and README transcript checks use a bundled snapshot dated 2026-08-06 instead of the live research-node path. The open-source local workbench for financial-AI evidence keeps its byte-exact comparison and tests snapshot mode both with and without a reachable disposable node, while separate tests retain default node behavior. The project, built in Canada and described as experimental with no independent security audit or human-benefit study, states the design lesson is to specify the data source as part of an example's contract rather than let the host environment choose it silently.

Disclosure: I am affiliated with YUCLAW. This post was prepared with AI assistance. One practical problem while preparing YUCLAW 8.0.0 was that the same CLI demo could return different output depending on whether a research database was reachable. A byte-exact README check passed on one host and failed on another, despite matching package bytes. The released implementation makes the transcript’s source explicit: YUCLAW CORPUS=snapshot . In that mode, check-claim uses the bundled snapshot rather than attempting the research-node path. README generation and installed-package transcript checks use the same mode. The output identifies its source; the bundled snapshot is dated 2026-08-06 , not live data. The comparison remains byte-exact. We did not ignore a differing line just to make CI pass. Tests exercise snapshot mode with and without a reachable disposable node, while separate tests retain the default node behavior. The design lesson was to specify the data source as part of the example’s contract, rather than let the host environment silently choose it. It makes the demo reproducible without claiming that the snapshot represents today’s world. This sits inside an open-source local workbench for financial-AI evidence: The packaged guide also walks through exporting an evidence packet and verifying it in a fresh workspace. How do you test reproducible evidence examples across environments while keeping the distinction between a fixed snapshot and current data clear? I would welcome feedback on this implementation and its test coverage. Source and released package https://github.com/YuClawLab/yuclaw-brain/releases/tag/v8.0.0 · Project https://yuclaw.ca Built in Canada. Experimental; local setup is required. No independent security audit or human-benefit study has been performed. This is a workflow tool, not a general guarantee against prompt injection.