Add skip precommit hook option in commit message

Author: PhysShell

README.md

@@ -30,15 +30,21 @@ Run only tests:
 .\tools\ci.ps1 -TestOnly
 ```
 
-## Pre-commit hook
+## Commit hooks
 
-Install local git hook:
+Install local git hooks:
 
 ```powershell
 .\tools\install-hooks.ps1
 ```
 
-The hook runs `tools/ci.ps1` before every commit.
+Installed hooks:
+- `pre-commit` (lightweight no-op)
+- `commit-msg` (runs `tools/ci.ps1`)
+
+Checks are skipped when:
+- commit message contains `[skip precommit hook]` or `[skip pch]`
+- there are no working tree changes (for example, `git commit --allow-empty ...`)
 
 ## What CI checks
 

tools/hooks/pre-commit

@@ -1,20 +1,6 @@
 #!/bin/sh
 set -e
 
-# Prevent hook-provided Git env vars from leaking into nested temp-repo tests.
-unset GIT_DIR
-unset GIT_WORK_TREE
-unset GIT_INDEX_FILE
-unset GIT_OBJECT_DIRECTORY
-unset GIT_ALTERNATE_OBJECT_DIRECTORIES
-unset GIT_COMMON_DIR
-unset GIT_PREFIX
-
-if command -v pwsh >/dev/null 2>&1; then
-  pwsh -NoProfile -ExecutionPolicy Bypass -File tools/ci.ps1
-elif command -v powershell >/dev/null 2>&1; then
-  powershell -NoProfile -ExecutionPolicy Bypass -File tools/ci.ps1
-else
-  echo "pre-commit: neither pwsh nor powershell is available"
-  exit 1
-fi
+# Validation runs in commit-msg, where Git provides the commit message file.
+# Keep pre-commit lightweight and deterministic.
+exit 0

tools/install-hooks.ps1

@@ -17,14 +17,17 @@ $hookDir = if ([IO.Path]::IsPathRooted($gitDir)) {
     Join-Path $root $gitDir 'hooks'
 }
 
-$source = Join-Path $root 'tools\hooks\pre-commit'
-$destination = Join-Path $hookDir 'pre-commit'
+New-Item -ItemType Directory -Path $hookDir -Force | Out-Null
 
-if (-not (Test-Path $source)) {
-    throw "Hook source not found: $source"
-}
+$hookNames = @('pre-commit', 'commit-msg')
+foreach ($hookName in $hookNames) {
+    $source = Join-Path $root ("tools\hooks\{0}" -f $hookName)
+    $destination = Join-Path $hookDir $hookName
 
-New-Item -ItemType Directory -Path $hookDir -Force | Out-Null
-Copy-Item -Path $source -Destination $destination -Force
+    if (-not (Test-Path $source)) {
+        throw "Hook source not found: $source"
+    }
 
-Write-Host "Installed pre-commit hook: $destination"
+    Copy-Item -Path $source -Destination $destination -Force
+    Write-Host ("Installed {0} hook: {1}" -f $hookName, $destination)
+}