| name | l-b4push |
| description | Run comprehensive pre-push validation covering code quality, builds, tests, and doc site. Use when: (1) Completing a PR or feature implementation, (2) Before pushing significant changes, (3) After large refactors or multi-file edits, (4) User says 'b4push', 'before push', 'check everything', 'run all checks', or 'ready to push'. |
| user-invocable | true |
| allowed-tools | ["Bash"] |
Before Push Check
Run pnpm b4push from the project root. This executes scripts/run-b4push.sh which runs all checks in order:
- Code quality (root) - Prettier + ESLint
- TypeScript build - Compile to dist/
- Unit tests - Vitest suite (232 tests)
- Doc data generation - doc-titles.json + category-nav.json
- Doc quality checks - TypeScript + ESLint + Prettier
- Doc site build - Full Docusaurus production build
Takes ~40 seconds. All 6 steps must pass.
On failure
- Read the failure output to identify which step failed
- Auto-fix what you can:
- Formatting:
pnpm check:fix (root) or cd doc && pnpm check:fix (doc)
- Lint:
pnpm lint:fix (root) or cd doc && pnpm lint:fix (doc)
- Re-run
pnpm b4push to confirm all checks pass
- Report the final status
