preflight

Run hero-skills:preflight to execute all blocking checks across tooling, repo, runtime, and pipeline buckets. The script exits with code 1 if any blocker fires, so the pipeline halts before creating branches or pushing code.

Use the --bucket flag to run one bucket (tooling, repo, runtime, or pipeline) and --projects to restrict runtime checks to specific project paths from HERO.md. This is useful when a diff only touches part of a monorepo.

The tooling bucket verifies the GitHub CLI with repo scope authentication, jq, Node 18 or later, Playwright MCP registration, the pr-review-toolkit plugin, and pre-commit when a .pre-commit-config.yaml exists.

No, the script is read-only. It never edits files, creates branches, modifies remote state, or runs interactive prompts, so it is safe to run on every invocation.

The port check uses lsof to detect listeners on declared ports. If lsof is unavailable, common in minimal containers, the check reports SKIP rather than a false OK.

The recalibrate argument tunes the HERO.md fields that preflight reads, then stops without running the checks. It reports current field values and asks only about unset, absent, or incorrect entries.