feat(cli): add vp hooks command for managing Git hooks (#2219)

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/cli_helper_message/snapshots/cli_helper_message.md

@@ -13,6 +13,7 @@ Start:
   create      Create a new project from a template
   migrate     Migrate an existing project to Vite+
   config      Configure hooks and agent integration
+  hooks       Manage the Git hook dispatcher
   staged      Run linters on staged files
   install, i  Install all dependencies, or add packages if package names are provided
   env         Manage Node.js versions

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/cli_helper_message/snapshots/cli_helper_message_local.md

@@ -24,6 +24,7 @@ Core Commands:
   preview        Preview production build
   cache          Manage the task cache
   config         Configure hooks and agent integration
+  hooks          Manage the Git hook dispatcher
   staged         Run linters on staged files
 
 Package Manager Commands:

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_config_help/snapshots/command_config_help.md

@@ -10,7 +10,7 @@ Usage: vp config [OPTIONS]
 Configure Vite+ for the current project (hook dispatcher + agent integration).
 
 Options:
-  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks)
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used in this clone)
   --no-hooks          Skip hook dispatcher installation
   --no-agent          Skip updating coding agent instructions
   -h, --help          Show this help message
@@ -31,7 +31,7 @@ Usage: vp config [OPTIONS]
 Configure Vite+ for the current project (hook dispatcher + agent integration).
 
 Options:
-  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks)
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used in this clone)
   --no-hooks          Skip hook dispatcher installation
   --no-agent          Skip updating coding agent instructions
   -h, --help          Show this help message
@@ -52,7 +52,7 @@ Usage: vp config [OPTIONS]
 Configure Vite+ for the current project (hook dispatcher + agent integration).
 
 Options:
-  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks)
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used in this clone)
   --no-hooks          Skip hook dispatcher installation
   --no-agent          Skip updating coding agent instructions
   -h, --help          Show this help message

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_helper/snapshots/command_helper.md

@@ -24,6 +24,7 @@ Core Commands:
   preview        Preview production build
   cache          Manage the task cache
   config         Configure hooks and agent integration
+  hooks          Manage the Git hook dispatcher
   staged         Run linters on staged files
 
 Package Manager Commands:

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_hooks_help/snapshots.toml

@@ -0,0 +1,8 @@
+[[case]]
+name = "command_hooks_help"
+vp = ["local", "global"]
+steps = [
+  { argv = ["vp", "hooks", "-h"], continue-on-failure = true },
+  { argv = ["vp", "hooks", "--help"], continue-on-failure = true },
+  { argv = ["vp", "help", "hooks"], continue-on-failure = true },
+]

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_hooks_help/snapshots/command_hooks_help.global.md

@@ -0,0 +1,97 @@
+# command_hooks_help
+
+## `vp hooks -h`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Usage: vp hooks <COMMAND> [OPTIONS]
+
+Manage the Vite+ Git hook dispatcher for this repository.
+
+Commands:
+  setup    Install or refresh the hook dispatcher (sets core.hooksPath)
+  disable  Disable hooks: unset core.hooksPath, remove <dir>/_, persist preference
+  enable   Re-enable hooks after disable (same as setup)
+  status   Show preference, core.hooksPath, and dispatcher state
+
+Options:
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used)
+  -h, --help          Show this help message
+
+Environment:
+  VP_GIT_HOOKS=0  Skip dispatcher install in setup/enable (and skip hooks at commit time)
+
+Examples:
+  vp hooks setup
+  vp hooks setup --hooks-dir .custom-hooks
+  vp hooks disable
+  vp hooks enable
+  vp hooks status
+
+Documentation: https://viteplus.dev/guide/commit-hooks
+```
+
+## `vp hooks --help`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Usage: vp hooks <COMMAND> [OPTIONS]
+
+Manage the Vite+ Git hook dispatcher for this repository.
+
+Commands:
+  setup    Install or refresh the hook dispatcher (sets core.hooksPath)
+  disable  Disable hooks: unset core.hooksPath, remove <dir>/_, persist preference
+  enable   Re-enable hooks after disable (same as setup)
+  status   Show preference, core.hooksPath, and dispatcher state
+
+Options:
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used)
+  -h, --help          Show this help message
+
+Environment:
+  VP_GIT_HOOKS=0  Skip dispatcher install in setup/enable (and skip hooks at commit time)
+
+Examples:
+  vp hooks setup
+  vp hooks setup --hooks-dir .custom-hooks
+  vp hooks disable
+  vp hooks enable
+  vp hooks status
+
+Documentation: https://viteplus.dev/guide/commit-hooks
+```
+
+## `vp help hooks`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Usage: vp hooks <COMMAND> [OPTIONS]
+
+Manage the Vite+ Git hook dispatcher for this repository.
+
+Commands:
+  setup    Install or refresh the hook dispatcher (sets core.hooksPath)
+  disable  Disable hooks: unset core.hooksPath, remove <dir>/_, persist preference
+  enable   Re-enable hooks after disable (same as setup)
+  status   Show preference, core.hooksPath, and dispatcher state
+
+Options:
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used)
+  -h, --help          Show this help message
+
+Environment:
+  VP_GIT_HOOKS=0  Skip dispatcher install in setup/enable (and skip hooks at commit time)
+
+Examples:
+  vp hooks setup
+  vp hooks setup --hooks-dir .custom-hooks
+  vp hooks disable
+  vp hooks enable
+  vp hooks status
+
+Documentation: https://viteplus.dev/guide/commit-hooks
+```

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_hooks_help/snapshots/command_hooks_help.local.md

@@ -0,0 +1,97 @@
+# command_hooks_help
+
+## `vp hooks -h`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Usage: vp hooks <COMMAND> [OPTIONS]
+
+Manage the Vite+ Git hook dispatcher for this repository.
+
+Commands:
+  setup    Install or refresh the hook dispatcher (sets core.hooksPath)
+  disable  Disable hooks: unset core.hooksPath, remove <dir>/_, persist preference
+  enable   Re-enable hooks after disable (same as setup)
+  status   Show preference, core.hooksPath, and dispatcher state
+
+Options:
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used)
+  -h, --help          Show this help message
+
+Environment:
+  VP_GIT_HOOKS=0  Skip dispatcher install in setup/enable (and skip hooks at commit time)
+
+Examples:
+  vp hooks setup
+  vp hooks setup --hooks-dir .custom-hooks
+  vp hooks disable
+  vp hooks enable
+  vp hooks status
+
+Documentation: https://viteplus.dev/guide/commit-hooks
+```
+
+## `vp hooks --help`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Usage: vp hooks <COMMAND> [OPTIONS]
+
+Manage the Vite+ Git hook dispatcher for this repository.
+
+Commands:
+  setup    Install or refresh the hook dispatcher (sets core.hooksPath)
+  disable  Disable hooks: unset core.hooksPath, remove <dir>/_, persist preference
+  enable   Re-enable hooks after disable (same as setup)
+  status   Show preference, core.hooksPath, and dispatcher state
+
+Options:
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used)
+  -h, --help          Show this help message
+
+Environment:
+  VP_GIT_HOOKS=0  Skip dispatcher install in setup/enable (and skip hooks at commit time)
+
+Examples:
+  vp hooks setup
+  vp hooks setup --hooks-dir .custom-hooks
+  vp hooks disable
+  vp hooks enable
+  vp hooks status
+
+Documentation: https://viteplus.dev/guide/commit-hooks
+```
+
+## `vp help hooks`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Usage: vp hooks <COMMAND> [OPTIONS]
+
+Manage the Vite+ Git hook dispatcher for this repository.
+
+Commands:
+  setup    Install or refresh the hook dispatcher (sets core.hooksPath)
+  disable  Disable hooks: unset core.hooksPath, remove <dir>/_, persist preference
+  enable   Re-enable hooks after disable (same as setup)
+  status   Show preference, core.hooksPath, and dispatcher state
+
+Options:
+  --hooks-dir <path>  Custom hooks directory (default: .vite-hooks, or last used)
+  -h, --help          Show this help message
+
+Environment:
+  VP_GIT_HOOKS=0  Skip dispatcher install in setup/enable (and skip hooks at commit time)
+
+Examples:
+  vp hooks setup
+  vp hooks setup --hooks-dir .custom-hooks
+  vp hooks disable
+  vp hooks enable
+  vp hooks status
+
+Documentation: https://viteplus.dev/guide/commit-hooks
+```

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_hooks_lifecycle/.vite-hooks/pre-commit

@@ -0,0 +1 @@
+vp staged

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_hooks_lifecycle/package.json

@@ -0,0 +1,3 @@
+{
+  "name": "command-hooks-lifecycle"
+}

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_hooks_lifecycle/snapshots.toml

@@ -0,0 +1,20 @@
+[[case]]
+name = "command_hooks_lifecycle"
+vp = "local"
+skip-platforms = ["windows"]
+steps = [
+  { argv = ["git", "init"], snapshot = false, continue-on-failure = true },
+  { argv = ["vp", "hooks", "status"], comment = "preference not set before setup", continue-on-failure = true },
+  { argv = ["vp", "hooks", "setup"], comment = "install dispatcher", continue-on-failure = true },
+  { argv = ["vp", "hooks", "status"], comment = "preference enabled after setup", continue-on-failure = true },
+  { argv = ["git", "config", "--local", "core.hooksPath"], comment = "should be .vite-hooks/_", continue-on-failure = true },
+  { argv = ["vp", "hooks", "disable"], comment = "tear down and persist preference", continue-on-failure = true },
+  { argv = ["vp", "hooks", "status"], comment = "preference disabled (local)", continue-on-failure = true },
+  { argv = ["vpt", "stat-file", ".vite-hooks/_/pre-commit", "--assert", "missing"], comment = "dispatcher removed", continue-on-failure = true },
+  { argv = ["vpt", "print-file", ".vite-hooks/pre-commit"], comment = "project-owned hook left unchanged", continue-on-failure = true },
+  { argv = ["vp", "config", "--no-agent"], comment = "prepare-like config should skip reinstall", envs = [["npm_lifecycle_event", "prepare"]], continue-on-failure = true },
+  { argv = ["vpt", "stat-file", ".vite-hooks/_/pre-commit", "--assert", "missing"], comment = "still missing after vp config", continue-on-failure = true },
+  { argv = ["vp", "hooks", "enable"], comment = "re-enable after disable", continue-on-failure = true },
+  { argv = ["vp", "hooks", "status"], comment = "preference enabled again", continue-on-failure = true },
+  { argv = ["git", "config", "--local", "core.hooksPath"], comment = "dispatcher restored", continue-on-failure = true },
+]