Run the checks locally

What CI gates

Every PR runs three things: atlas doctor (topology + generated-data freshness), atlas site lint (the authored-content seam), and the SvelteKit build. You can run all of them locally first.

Steps

1. Work in a worktree — never edit the primary checkout:

   scripts/worktree.sh add my-change      # scripts/worktree.ps1 add my-change on Windows
   cd .worktrees/my-change
   

2. Run the structural checks (zero-dependency, no install):

   node bin/atlas.mjs doctor              # the whole constellation gate
   node bin/atlas.mjs site lint --strict  # the authored-content seam
   

3. Build the site — it needs BITSPARK_CI_TOKEN for the private @bitspark packages:

   export BITSPARK_CI_TOKEN="$(gh auth token)"
   npm --prefix site ci
   npm --prefix site run check            # svelte-check
   npm --prefix site run build            # adapter-static prerender
   

4. Run the unit tests (zero-dependency):

   node --test
   

Notes

• If doctor reports a stale generated artifact, regenerate it (atlas topology gen, atlas diagram gen, atlas constellation collect) and commit the result — never hand-edit a generated file.
• site lint --strict fails on warnings; a draft/downstream member without a page is only a note, never a failure.