feat(config)!: add shared top-level steps

[jdx]

Summary

• add a top-level steps map inherited by implicit check, fix, and pre-commit hooks
• let explicit hooks override inherited steps and add enabled = false for execution/install suppression
• preserve additive XDG/project merging and scope subproject defaults correctly
• generate concise v2 configs from hk init and hk migrate pre-commit

Defaults

• check: check mode, no staging
• fix: fix mode, no staging
• pre-commit: fix mode, staging enabled, Git stash
• no implicit pre-push

Stack

• Depends on feat(builtins)!: expose configurable builtin factories #1253
• Part 2 of the hk v2 breaking-change rollout (repository issues are disabled, so the PR stack is the tracker)

Testing

• cargo test --no-default-features (286 passed before the final generator assertion update; focused generator tests pass afterward)
• mise run test:bats test/top_level_steps.bats
• mise run test:bats test/migrate_precommit.bats (behavior passed; expectations updated for implicit pre-commit output)
• cargo fmt
• git diff --check

AI-assisted — Tool: Codex; model: unavailable/unavailable; version: unavailable.

---

Note

High Risk
This is a breaking config and hook-default change that affects how every project’s check, fix, pre-commit, install, and monorepo merge behave.

Overview
This PR introduces hk v2-style configuration: define linters once in a top-level steps map instead of repeating the same step lists under check, fix, and pre-commit.

At load time, materialize_default_hooks builds those three implicit hooks from shared steps (check-only / fix without staging / pre-commit with fix, staging, and Git stash). Explicit hook entries override steps by name and can set enabled = false to turn off an implicit hook so hk check, hk install, and runs skip it as a successful no-op.

hk init, the default template, and hk migrate pre-commit now emit shorter configs (top-level steps; optional hooks only for disabled implicit hooks or extras like pre-push). Subproject and hkrc merging were updated so top-level steps compose correctly and disabled subproject hooks are not merged.

Docs and bats tests reflect the new model; hk builtins alone can exit early without spinning up the full runtime.

^{Reviewed by Cursor Bugbot for commit 3df92ae. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 3ba736c9-2420-42ef-a4ab-ce5103f6a7fd

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Greptile Summary

This PR adds shared top-level steps inherited by the implicit check, fix, and pre-commit hooks, including explicit disabling and override behavior.

• Materializes shared steps across project, user, and subproject configuration.
• Updates hook execution and installation to honor enabled = false.
• Emits concise top-level-step configurations from initialization and pre-commit migration.
• Updates documentation and integration coverage for the new configuration model.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
src/config.rs	Materializes implicit hooks and merges shared steps while correctly excluding disabled subproject hooks.
src/hook.rs	Adds the enabled hook property with a backward-compatible true default.
src/hook_options.rs	Makes disabled hook execution a successful structured no-op.
src/cli/install.rs	Excludes disabled hooks and manual check/fix commands from installable Git events.
src/cli/migrate/pre_commit.rs	Moves migrated pre-commit steps into the shared top-level map while retaining explicit non-default stages.
src/cli/init/generator.rs	Generates concise shared-step configurations and explicit disable entries for unselected implicit hooks.
pkl/Config.pkl	Extends the public configuration schema with top-level steps and hook enablement.

_{Reviews (20): Last reviewed commit: "perf(builtins): skip runtime for bare li..." | Re-trigger Greptile}

[github-actions]

Instruction counts

benchmark	trend	instructions	Δ	wall (min)	Δ
builtins	████████████████▁	1,989,871 → 1,542,592	-22.48%	2.92 → 1.78ms	-38.87%
check	—	—	—	21.50 → 21.34ms	-0.76%
usage	▆▆▆▄▄▆▂█▁▁▁▅▅▅██▄	4,650,086 → 4,647,993	-0.05%	3.16 → 3.10ms	-1.80%
validate	—	—	—	5.48 → 5.00ms	-8.80%

No instruction-count regression above 1%.

_{Only instruction counts gate. Wall clock is shown for context — on identical hardware it moves 4-20% run to run.}

_{Measured by tak — instruction-counted CLI benchmarks, stored in this repository's git notes.}

_{3df92ae2edb0 vs a15fcdfb197f · measured on the runner, not pushed to the history.}

[jdx]

Stack continuation: #1256 implements contextual staging, followed by #1257 for the deprecated v1 interface removal and migration guide.

AI-assisted — Tool: Codex; model: unavailable/unavailable; version: unavailable.

[jdx]

Fixed in 7d713d7. Disabled subproject hooks are now skipped before root hook creation and step scoping, so they neither create an installable Git event nor contribute executable steps. Added unit coverage for the disabled-only subproject case.

AI-assisted — Tool: Codex; model: unavailable/unavailable; version: unavailable.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit eea92ba. Configure here.}