CI usage

Use warden check for deterministic CI gates. Use warden review --json only when the pipeline has model credentials and a wrapper can consume the full CommentSet.

checkDeterministic gate

No LLM call. Good for fast CI, pre-commit, and failure summaries.

reviewFull review

Uses model credentials, semantic context, scoped sub-agents, and citations. Better for PR bots or reports.

jsonWrapper contract

Stable output for GitHub, Slack, ClickUp, or custom scripts without terminal scraping.

Deterministic gate

CI-friendlyno LLM

warden check --json

Runs the deterministic path and exits after the review completes. This is the safest default for automation that should not spend model tokens.

Full review output

Wrapper inputLLM enabled

warden review --json --base origin/main

Provides the full typed result for a report or future bot surface. Pass --base when the CI checkout does not expose the same default branch that local review uses.

Current boundary

The future GitHub PR bot is a separate app. The current CLI remains one-shot and exits after the review completes.

Minimal workflow sketch

GitHub Actions shapeexample

pnpm install --frozen-lockfile
pnpm build
pnpm warden check --json

Use the workspace command until the package is published. After publication, swap the last line to npx warden check --json.