[philippsuess]

💡 Motivation and Context

Hey! I noticed this repository doesn't use git prek hooks yet, so I put together a very minimal set as a starting point.

What's included

• prek.toml with these built-in hooks:
  • check-case-conflict
  • check-merge-conflict
  • check-symlinks
  • check-xml
  • check-yaml
  • detect-private-key
• A protect-main-branch pre-push hook (scripts/check-protected-branch.sh, same as posthog-js) that rejects pushes while on main. It is skipped in GitHub Actions.
• make bootstrap now installs prek and runs prek install, which installs both the pre-commit and pre-push hooks

Hooks are opt-in per clone, and CI stays the source of truth.

💚 How did you test it?

• Ran prek validate-config prek.toml and prek run --all-files; the hooks pass on the current tree.
• Verified the hook blocks a commit containing an invalid YAML file.
• Verified protect-main-branch passes on a feature branch, fails on main with exit 1, and exits 0 when GITHUB_ACTIONS=true.
• Verified prek install installs both .git/hooks/pre-commit and .git/hooks/pre-push in a fresh clone.
• Ran the new brew install prek and prek install bootstrap lines directly. A full make bootstrap run stopped earlier at gem install cocoapods due to system Ruby permissions on my machine, unrelated to this change.

📝 Checklist

• I reviewed the submitted code.
• I added tests to verify the changes.
• I updated the docs if needed.
• No breaking change or entry added to the changelog.

If releasing new changes

• Ran pnpm changeset to generate a changeset file

Not needed: tooling-only change, no releasable SDK change.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Drafted with Claude Code at the author's direction. The hook set was kept intentionally small.

🤖 Generated with Claude Code

[marandaneto]

we use https://github.com/j178/prek for some other sdks
can we use prek here as well? if not, why?

[philippsuess]

Sorry for the late reply @marandaneto. Thanks for pointing it out. Yes, of course, we can use prek. I have never used it. I will update the PR, shortly.

[philippsuess]

Good call, switched to prek. It reads the same .pre-commit-config.yaml, so the hook config is unchanged; make bootstrap now runs brew install prek and prek install, and CONTRIBUTING.md documents it.

Verified locally with prek 0.5.7: prek run --all-files passes, and an invalid YAML file is blocked on commit. One gotcha, documented: if someone already ran pre-commit install, they need prek install --force, otherwise the old hook runs in migration mode and blocks commits.

[philippsuess]

Same as https://github.com/PostHog/posthog-js/blob/main/scripts/check-protected-branch.sh