Skip to content

feat(check): implement --plan, --why, and --json #848

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jdx merged 10 commits into from
Apr 19, 2026
Merged

feat(check): implement --plan, --why, and --json #848

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
f26a0a2
feat(check): implement --plan, --why, and --json for plan output
jdx Apr 19, 2026
aaed5b5
fix(check): align plan with runtime behavior and add refactors
jdx Apr 19, 2026
69fa079
fix(check): report real fileCount for profile-skipped steps in plan
jdx Apr 19, 2026
d791637
fix(check): satisfy clippy::redundant_guards in plan condition match
jdx Apr 19, 2026
739b2a3
fix(check): don't headline skipped steps with a truthy-condition reason
jdx Apr 19, 2026
3e150d8
fix(check): --why verbose list no longer duplicates headline reason
jdx Apr 19, 2026
2f13c4b
fix(check): drop --json-without-plan error that broke global --json
jdx Apr 19, 2026
af48e83
fix(check): apply --why <step> filter to JSON output; drop unused enu…
jdx Apr 19, 2026
f79514f
fix(check): guard --json without --plan/--why while preserving --trac…
jdx Apr 19, 2026
109d363
fix(check): prune group stepIds after --why <step> --json filter
jdx Apr 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/cli/check.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,10 @@ Run fix command instead of check command (this is the default behavior unless HK

Run on files that match these glob patterns

### `-J --json`

Output the plan as JSON (requires --plan or --why)

### `-P --plan`

Print the plan instead of running the hook
Expand All @@ -43,6 +47,10 @@ Print the plan instead of running the hook

Run only specific step(s)

### `-W --why <STEP>`

Show detailed reasons for inclusion/exclusion. Pass a step name to focus on one step, or omit the value to show reasons for all steps. Implies --plan

### `--fail-fast`

Abort on first failure
Expand Down
Loading
Loading