# Build the Starlight wiki site on every push to main.
# Keeps the builder green; does not publish the orphan `pages` branch
# (that needs a write credential in Spindle secrets — see
# wiki/process/workflows.md). The serialized local `tools/task.sh finish`
# path publishes after the main push; manual landings must run
# ./tools/site-deploy.sh themselves.

when:
  - event: ["push"]
    branch: ["main"]
  - event: ["pull_request"]
    branch: ["main"]
  - event: ["manual"]
    branch: ["main"]

engine: "nixery"

clone:
  skip: false
  depth: 1
  submodules: false

dependencies:
  nixpkgs:
    - nodejs
    - pnpm
    - git
    - bash
    - coreutils
    # pnpm's node_modules/.bin/astro shim shells out to sed.
    - gnused
    # sharp's install script needs these for the prebuilt binary path.
    - gnutar
    - gzip

steps:
  - name: "site build (Starlight)"
    command: |
      set -euo pipefail
      log=/tangled/workspace/site-build.log
      if bash tools/site-build.sh > "$log" 2>&1; then
        echo "site build: OK"
        tail -n 20 "$log"
      else
        echo "=== site build FAILED ==="
        cat "$log"
        exit 1
      fi