feat: allow vp config opt-outs (#1842)

## Summary

- add `vp config --no-hooks` to skip hook installation
- add `vp config --no-agent` to skip existing coding agent instruction
updates
- document the new opt-out flags alongside `--hooks-only` and
`VITE_GIT_HOOKS=0`

Closes #1311.

## Verification

- `pnpm exec oxfmt --check packages/cli/src/config/bin.ts
docs/guide/commit-hooks.md`
- static source/docs assertion for the new config flags
- `mri` parsing assertion for `--no-hooks`, `--no-agent`, and
`--hooks-only`

Could not run `pnpm -F vite-plus test
packages/cli/src/config/__tests__/hooks.spec.ts` in this checkout
because the local install does not expose the `vitest` binary.

---------

Co-authored-by: MK (fengmk2) <fengmk2@gmail.com>

Author: wyf027

docs/guide/commit-hooks.md

@@ -22,8 +22,17 @@ If you use [`vp create`](/guide/create) or [`vp migrate`](/guide/migrate), Vite+
 ```bash
 vp config
 vp config --hooks-dir .vite-hooks
+vp config --no-hooks
+vp config --no-agent
 ```
 
+Use `--no-hooks` when you want `vp config` to leave existing Git hook setup unchanged. Use
+`--no-agent` when you want it to skip updates to existing coding agent instruction files. You
+can pass both flags when you want `vp config` to skip both setup steps.
+
+You can also set `VITE_GIT_HOOKS=0` to disable hook installation from lifecycle scripts such as
+`prepare` or `postinstall`.
+
 ### `vp staged`
 
 `vp staged` runs staged-file checks using the `staged` config from `vite.config.ts`. If you set up Vite+ to handle your commit hooks, it will automatically run when you commit your local changes.

packages/cli/snap-tests-global/command-config-custom-dir-hook-path/snap.txt

@@ -1,5 +1,5 @@
 > git init
-> vp config --hooks-only --hooks-dir .config/husky
+> vp config --no-agent --hooks-dir .config/husky
 > mkdir -p node_modules/.bin && printf '#!/usr/bin/env sh\necho hook-path-ok' > node_modules/.bin/test-hook-cmd && chmod +x node_modules/.bin/test-hook-cmd
 > mkdir -p .config/husky && printf 'test-hook-cmd\n' > .config/husky/pre-commit
 > echo test > file.txt && git add file.txt

packages/cli/snap-tests-global/command-config-custom-dir-hook-path/steps.json

@@ -1,7 +1,7 @@
 {
   "commands": [
     { "command": "git init", "ignoreOutput": true },
-    { "command": "vp config --hooks-only --hooks-dir .config/husky", "ignoreOutput": true },
+    { "command": "vp config --no-agent --hooks-dir .config/husky", "ignoreOutput": true },
     {
       "command": "mkdir -p node_modules/.bin && printf '#!/usr/bin/env sh\\necho hook-path-ok' > node_modules/.bin/test-hook-cmd && chmod +x node_modules/.bin/test-hook-cmd",
       "ignoreOutput": true

packages/cli/snap-tests-global/command-config-help/snap.txt

@@ -5,6 +5,8 @@ Configure Vite+ for the current project (hooks + agent integration).
 
 Options:
   --hooks-dir <path>  Custom hooks directory (default: .vite-hooks)
+  --no-hooks          Skip hook installation
+  --no-agent          Skip updating coding agent instructions
   -h, --help          Show this help message
 
 Environment:
@@ -20,6 +22,8 @@ Configure Vite+ for the current project (hooks + agent integration).
 
 Options:
   --hooks-dir <path>  Custom hooks directory (default: .vite-hooks)
+  --no-hooks          Skip hook installation
+  --no-agent          Skip updating coding agent instructions
   -h, --help          Show this help message
 
 Environment:
@@ -35,6 +39,8 @@ Configure Vite+ for the current project (hooks + agent integration).
 
 Options:
   --hooks-dir <path>  Custom hooks directory (default: .vite-hooks)
+  --no-hooks          Skip hook installation
+  --no-agent          Skip updating coding agent instructions
   -h, --help          Show this help message
 
 Environment:

packages/cli/snap-tests-global/command-config-no-agent/AGENTS.md

@@ -0,0 +1,11 @@
+# My Project
+
+Custom instructions here.
+
+<!--VITE PLUS START-->
+
+OUTDATED CONTENT THAT SHOULD NOT BE REPLACED
+
+<!--VITE PLUS END-->
+
+More custom content below.

packages/cli/snap-tests-global/command-config-no-agent/package.json

@@ -0,0 +1,3 @@
+{
+  "name": "command-config-no-agent"
+}

packages/cli/snap-tests-global/command-config-no-agent/snap.txt

@@ -0,0 +1,7 @@
+> git init
+> vp config --no-agent # should install hooks but skip agent instruction updates
+> git config --local core.hooksPath # should be .vite-hooks/_
+.vite-hooks/_
+
+> grep -q 'OUTDATED CONTENT' AGENTS.md && echo 'agent unchanged' || echo 'ERROR: agent updated' # should not update agent instructions
+agent unchanged

packages/cli/snap-tests-global/command-config-no-agent/steps.json

@@ -0,0 +1,8 @@
+{
+  "commands": [
+    { "command": "git init", "ignoreOutput": true },
+    "vp config --no-agent # should install hooks but skip agent instruction updates",
+    "git config --local core.hooksPath # should be .vite-hooks/_",
+    "grep -q 'OUTDATED CONTENT' AGENTS.md && echo 'agent unchanged' || echo 'ERROR: agent updated' # should not update agent instructions"
+  ]
+}

packages/cli/snap-tests-global/command-config-no-agent/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  staged: {
+    '*': 'vp check --fix',
+  },
+});

packages/cli/snap-tests-global/command-config-no-hooks-no-agent/AGENTS.md

@@ -0,0 +1,11 @@
+# My Project
+
+Custom instructions here.
+
+<!--VITE PLUS START-->
+
+OUTDATED CONTENT THAT SHOULD NOT BE REPLACED
+
+<!--VITE PLUS END-->
+
+More custom content below.