CI

On every pull requestCopy Anchor Link

- run: npx copybook check --base origin/main
- run: npx copybook test --changed --base origin/main

• check fails when a snapshot is missing, stale, or orphaned, and warns about renames without aliases and about definitions nothing renders.
• test --changed parses and typechecks only what the pull request changed. Add --tier syntax,typecheck,run once your fixtures have credentials.

Pull request commentsCopy Anchor Link

copybook report prints a Markdown summary of the definitions a pull request changes:

• each definition's kind, placements, the files that render it, and its latest test results;
• its rendered snapshot diff, collapsed.

npx copybook test --changed --base origin/main
npx copybook report --base origin/main > report.md
gh pr comment "$PR" --body-file report.md

The report starts with a hidden <!-- copybook-report --> marker, so a workflow can find its earlier comment and update it instead of posting a new one. The repository's pr-report.yml workflow does exactly that.

NightlyCopy Anchor Link

npx copybook test --tier syntax,typecheck,run
CI=true npx copybook eval --history-dir eval-history --budget-usd 10

Run the run tier and evals on a schedule, with the credentials your fixtures need. Keep eval history in git (the repository's evals.yml uses an orphan copybook-results branch), so unchanged prompts aren't re-evaluated and pass rates have a history. See Evals.

OwnershipCopy Anchor Link

Snapshots are plain files, so CODEOWNERS works on them:

copybook/snapshots/console.* @acme/devrel
copybook/snapshots/ai-gateway.* @acme/ai-platform