Validating with check

Run buildprint check before every buildprint apply. Check validates the workspace against Buildprint's invariants. It is functionally like a CI / build / lint check.

buildprint check

Default scope

By default, check looks at the files that changed compared to the Bubble snapshot for the current branch. That keeps the run fast during an editing loop. Use --all to rerun every rule across the whole workspace (there may be pre-existing issues identified that Bubble's own issue checker did not pick up).

buildprint check --all

Filtering rules

• --rule <id> — narrow to a single rule or a glob (for example --rule 'children-manifest/*'). Quote the glob in zsh.

• --level <error|warning|info> — minimum severity to report. Default info.

Machine-readable output

Use --json to get issues as structured JSON instead of human text. JSON mode is useful when a script wraps check.

Running apply only if check is clean

buildprint check --auto-apply

If --auto-apply is set and check reports zero issues, apply runs immediately. --auto-apply cannot be combined with --rule or --json.