# The docs, as `just docs` checks them: every relative link and anchor
# lands, and every Mermaid block draws with Pele, as the pages draw it
# (harness/docs.mjs); and the site docs-site/ makes of them, served at
# /docs, builds. Pele comes from web/'s packages and the site's from
# docs-site/'s, each kept between runs and installed again only when its
# lockfile changes.
image: node:24.22.1
# Every push to main, and pulls into it or a feature/ branch, at their
# heads merged with their base, that change the docs, their check, the
# site, the lexicons and tokens it takes, Pele's version or this file.
# A pull changing none passes at once, noted as skipped.
on:
  push: {refs: [refs/heads/main]}
  pull:
    base: [refs/heads/main, refs/heads/feature/*]
    paths: [docs/**, README.md, AGENTS.md, deploy/README.md, harness/docs.mjs, docs-site/**, lexicons/**, web/src/tokens.css, web/package-lock.json, .knotless/workflows/docs.yml, .knotless/uses.lock]
cache: [web/node_modules, docs-site/node_modules]
steps:
  - uses: chadtmiller.com/steps/npm-ci@1
    name: web
    with: {dir: web}
  - uses: chadtmiller.com/steps/npm-ci@1
    name: docs-site
    with: {dir: docs-site}
  - name: docs
    run: node harness/docs.mjs
  - name: site
    run: cd docs-site && npm run build