Add local pre-commit quality gates and installer

Author: ranfdev

.githooks/checks.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env sh
+set -eu
+
+echo "Running pre-commit checks..."
+echo "• cargo fmt --all -- --check"
+cargo fmt --all -- --check
+
+echo "• cargo clippy --all-targets --all-features"
+cargo clippy --all-targets --all-features
+
+echo "• cargo test --all-features"
+cargo test --all-features

.githooks/install.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env sh
+set -eu
+
+repo_root="$(git rev-parse --show-toplevel)"
+cd "$repo_root"
+
+git config --local core.hooksPath .githooks
+chmod +x .githooks/pre-commit .githooks/checks.sh
+
+echo "Git hooks enabled from .githooks/"

.githooks/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+set -eu
+
+script_dir="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+sh "$script_dir/checks.sh"

README.md

@@ -74,6 +74,19 @@ Supported terminals:
 
 Contributions are welcome! Please open an issue or pull request on GitHub.
 
+### Enable local pre-commit checks
+
+To block commits when formatting, clippy, or tests fail, enable the repository hook once:
+
+```bash
+./.githooks/install.sh
+```
+
+The pre-commit hook runs:
+- `cargo fmt --all -- --check`
+- `cargo clippy --all-targets --all-features`
+- `cargo test --all-features`
+
 ## License
 
 DistroShelf is licensed under the GPL-3.0-or-later license.