feat(setup): support Git hook runtime initialization

[chenjiahan]

This PR gives generated Rstack Git hooks a controlled runtime initialization path for GUI clients and Node version managers. It loads ${XDG_CONFIG_HOME:-$HOME/.config}/rstack/hooks-init.sh, prepends the project node_modules/.bin, and supports RSTACK_HOOKS=0/2 for opt-out and tracing. Hook failures now report the hook name, exit code, and PATH details for missing commands, while rs setup also respects the opt-out.

[cloudflare-workers-and-pages]

Deploying rstack-cli with    Cloudflare Pages

Latest commit:	7b33b7a
Status:	✅  Deploy successful!
Preview URL:	https://3bb91475.rstack-cli.pages.dev
Branch Preview URL:	https://chenjiahan-feat-git-hook-run.rstack-cli.pages.dev

View logs

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 8c4625bc-6220-4192-8053-b45ae4218ca1

📥 Commits

Reviewing files that changed from the base of the PR and between b7bf930 and 7b33b7a.

📒 Files selected for processing (6)

• packages/rstack/src/setup/hooks.ts
• packages/rstack/src/setup/index.ts
• packages/rstack/src/setup/install.ts
• packages/rstack/tests/cli/setup/index.test.ts
• packages/rstack/tests/setup/hooks.test.ts
• packages/rstack/tests/setup/install.test.ts

---

📝 Walkthrough

Walkthrough

Hook setup now supports disabling installation through RSTACK_HOOKS=0 with explicit CLI reporting. Generated hook dispatchers can load optional initialization scripts, enable tracing, prepend project binaries to PATH, capture hook exit codes, and report failures including missing commands. Tests cover disabled setup, initialization and project binary execution, hook failures, command lookup errors, and environment-aware Git operations.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: Git hook runtime initialization support.
Description check	✅ Passed	The description matches the changeset and describes the new hook initialization, PATH, opt-out, and diagnostics behavior.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chenjiahan/feat-git-hook-runtime

---

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.}