Reproduce the Documentation
Requirements:
- Node.js 22 or newer
- npm
- Go, only when regenerating
godoc.jsonfrom source
Run from the repository root:
npm ci
npm run verify:runx-version
npm run snapshot
npm run inventory
npm run build
npm run mappings
npm run hashes
npm testThe governed CLI command is deliberately pinned:
npx -y @runxhq/cli@0.6.14 --versionExpected literal output:
runx-cli 0.6.14npm run snapshot executes Sourcey's godoc adapter against
source/redsync. npm run build consumes the committed godoc.json in
snapshot mode, so Read the Docs does not need a Go toolchain to reproduce the
static HTML. The snapshot wrapper uses a writable OS temporary Go build cache
and GOFLAGS=-buildvcs=false; disabling VCS stamping avoids irrelevant errors
from copied example packages while source identity remains pinned separately.
SOURCEY_GODOC_OUTPUT can override the default godoc.json destination in a
restricted build sandbox; it does not change the Sourcey adapter or source.
Sourcey initially writes a wall-clock generated_at value. For reproducible
snapshot bytes, the wrapper replaces only that field with the pinned source
commit's real committer timestamp from .source-pin.json, normalized to UTC as
2026-07-02T06:37:50Z. The value identifies the immutable source-time basis;
it is not presented as the wall-clock time of a later rebuild.
