| name | local-preflight |
| description | Run the smallest useful local validation set for this repo before pushing or after a failed CI run. Use when you need fast local checks for Docker, devcontainer, mise, hk, or Python workflow regressions. Supports standard, tool-specific, and image-specific modes. |
Local Preflight
Overview
Use the plugin script to run the repo-local validation stack.
Commands
Standard preflight:
plugins/dotfiles-build-optimizer/scripts/local_preflight.sh
Tool admission check:
plugins/dotfiles-build-optimizer/scripts/local_preflight.sh tool <tool-name>
Image-aware preflight:
IMAGE_REF=ghcr.io/ray-manaloto/dotfiles-devcontainer:dev \
plugins/dotfiles-build-optimizer/scripts/local_preflight.sh image
Included Checks
hk validate
hk run pre-commit --all
dotfiles-setup verify
mise doctor
- optional
mise test-tool
- optional image smoke + benchmark (local only; in CI, smoke runs in the
smoke-test gate and benchmark runs async in image-analysis.yml)