Skip to content
Bowerbird

Validation and Audit

Bowerbird validates notes against your schema and helps fix violations.

Hard vs Soft Enforcement

Section titled “Hard vs Soft Enforcement”
  • Hard enforcement — bwrb new and bwrb edit refuse to create invalid notes
  • Soft enforcement — Manual edits can break the schema; bwrb audit catches drift

Running Audit

Section titled “Running Audit”

Check your entire vault:

Terminal window
bwrb audit

Check specific types:

Terminal window
bwrb audit --type task

Common Issues

Section titled “Common Issues”

Audit catches:

  • Missing required fields
  • Invalid field values (not in enum options)
  • Type mismatches
  • Malformed frontmatter

Fixing Issues

Section titled “Fixing Issues”

Preview fixes:

Terminal window
bwrb audit --fix

Apply fixes:

Terminal window
bwrb audit --fix --execute

CI Integration

Section titled “CI Integration”

Run audit in CI to catch schema violations:

Terminal window
bwrb audit --output json
# Exit code 1 if violations found

Next Steps

Section titled “Next Steps”