CI Check

Run CI checks locally first, then verify GitHub Actions if the branch has been pushed.

Step 1: Run local CI

Run ./scripts/ci-local.sh to execute the same checks as GitHub Actions: install, build, typecheck, and docker build. If any step fails, fix it before proceeding.

Use ./scripts/ci-local.sh --quick to skip the docker build when iterating on TypeScript fixes.

Step 2: Check remote CI (if pushed)

Run gh run list --branch $(git branch --show-current) --limit 1 to find the most recent CI run for this branch. If no runs exist, the branch hasn't been pushed yet — tell the user.

If the run status is completed and conclusion is success, report that CI is green and stop.

If the run is in_progress, run gh run watch <run-id> to wait for completion. Then re-check.

If the run failed, proceed to Step 3.

Step 3: Read the failure logs

Run gh run view <run-id> --log-failed to get only the log lines from failed steps. This is more focused than --log which dumps everything.

Identify which step failed:

• pnpm install --frozen-lockfile — lockfile out of sync
• pnpm turbo build — TypeScript compilation error
• pnpm turbo typecheck — type errors without build
• docker build — Dockerfile issue

Step 4: Fix locally

Based on the failure:

Lockfile drift: Run pnpm install locally and commit the updated pnpm-lock.yaml.

Build/typecheck failure: Read the error, find the file and line, fix the issue. Run ./scripts/ci-local.sh --quick to verify before pushing.

Docker build failure: Read the error. Common causes: missing COPY for a new config file, changed package name, missing dependency. Run ./scripts/ci-local.sh (full) to verify.

Step 5: Push and re-check

After fixing, push the branch and run Step 2 again. Repeat until CI is green.

Commands Reference

Command	Purpose
./scripts/ci-local.sh	Full local CI (install, build, typecheck, docker)
./scripts/ci-local.sh --quick	Local CI without docker build
gh run list --branch <branch> --limit 5	List recent runs for a branch
gh run view <id>	Summary of a specific run
gh run view <id> --log-failed	Only failed step logs
gh run watch <id>	Wait for an in-progress run