hk - Git Hook Manager

hk runs linters and formatters as git hooks. It coordinates file access and isolates staged changes when stashing is enabled. Configuration is Pkl. Commands still need accurate file selection and declared effects.

Mental Model

Detect the repository's version and hook contract before composing steps or wiring hooks. A maintenance task preserves that contract unless the user asks to change it.

Setup Workflow

1. Detect