Check gate

The checker reads every page of a built site before anything moves. One failure stops the job. Zero is the only passing score.

Run it

Check a draft

python spidercaster.py check sites/my-site --expect-noindex

Check the words too

Add --project projects/my-site so the checker can compare every visible line with your copy.

Read the result

The last line counts pass, fail, warn, and skip. A skip means the check did not run, and not run is never a pass.

What it reads

Words

Every visible line on the page must come from your copy. Filler text fails the job.

Links

Internal links must lead somewhere, with crawlable addresses and named anchors.

Photos

Local files only, with alt text and set dimensions. Brightness must sit between 90 and 200.

The small print

Title, description, canonical link, one h1 per page, heading order, page language, and the noindex line.

Phones

Body text at 18px and nothing under 16px, text contrast of at least 4.5:1, tap targets of at least 44px, and no sideways scroll at 360, 390, or 412px wide.

The ledger

Each build writes report.json with its token count. An offline build must total zero.

Pass, fail, warn, and skip

Each check prints one row. The last line adds them up, and only the fail count decides.

pass

The check ran and the page met it.

fail

The page broke a rule. The job stops, and the check command exits with code 1.

warn

Worth a look, but not a stop. A short page earns a thin_content warning.

skip

The check could not run, for example because it needs a browser. Not run is never a pass.

A pass and a failure

The end of a passing run, then the same site with its icon deleted on purpose. The check command exits with code 1.

check output, last lines
$ python spidercaster.py check sites/my-site --expect-noindex --project projects/my-site
  [pass] ask_after_proof - offer->proof->ask holds
  [pass] single_primary_cta - 1 page(s), one visible primary per viewport
  [pass] mobile_block - 0 mobile block(s), 360-first
  [pass] token_ledger - mode=offline in=0 out=0 est=$0.0000
  [pass] cited_text - 1 page(s), every visible string cited
result: 59 pass / 0 fail / 2 warn / 3 skip

Exit code: 0

check output, FAIL rows and result
$ python spidercaster.py check sites/broken --expect-noindex
  [FAIL] internal_links - index.html: favicon.svg; index.html: favicon.svg
  [FAIL] favicon_svg - missing favicon.svg beside index.html
result: 56 pass / 2 fail / 2 warn / 4 skip

Exit code: 1

Why one failure stops the job

A page with a broken link, a photo with no alt text, or an invented line should not reach the public. The gate stops the job and names the page and the check, so the fix is one edit and one rebuild.