Project

Reproduce the Documentation

Requirements:

Requirements:

  • Node.js 22 or newer
  • npm
  • Go, only when regenerating godoc.json from 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 test

The governed CLI command is deliberately pinned:

npx -y @runxhq/cli@0.6.14 --version

Expected literal output:

runx-cli 0.6.14

npm 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.