ObsidianCdpTransportOptions.shouldFailOnStaleBuild?

ObsidianCdpTransportOptions › shouldFailOnStaleBuild?

Whether a dist/ older than the sources it was built from fails the run.

When true (the default) the global setup compares main.js in the dist folder it is about to install against the newest file under src/ (tests excluded), plus manifest.json and styles.css, and throws StaleBuildError when the build is older — before the owned instance is launched, so a stale build costs a stat rather than a boot.

Set it to false for a project that deliberately tests a shipped artifact. Doing so downgrades the failure to a warning — it never goes silent, because a suite that PASSES against a stale build proves nothing and says so to nobody. For a single run, OBSIDIAN_TEST_ALLOW_STALE_BUILD=1 does the same without editing a tracked file, and takes precedence over this option.