ci: isolate pre-commit builds and add debug hooks

Group all pre-commit builds under `.pre-commit-builds/` to isolate
them from the developer's default `builddir`. Add new manual hooks
`all-tests-debug` and `all-tests-clang-debug` to support GCC/Clang
debug build validation. Update `.gitignore` and `src/README.md` to
document and support the new configuration.

Author: fangfufu

.gitignore

@@ -11,6 +11,7 @@ doxygen
 
 # Build directories
 /builddir/
+/.pre-commit-builds/
 
 # Meson subprojects (ignore cloned sources but keep wrap files tracked)
 /subprojects/*

.pre-commit-config.yaml

@@ -32,28 +32,61 @@ repos:
         files: \.(c|h)$
     -   id: meson-test
         name: Meson Test
-        entry: meson test -C builddir
+        entry: >-
+          bash -c 'if [ ! -d .pre-commit-builds/release ]; then
+          meson setup .pre-commit-builds/release; fi &&
+          meson test -C .pre-commit-builds/release'
         language: system
         pass_filenames: false
         files: \.(c|h)$
     -   id: all-tests
         name: All Tests
         entry: >-
-          meson test -C builddir
+          bash -c 'if [ ! -d .pre-commit-builds/release ]; then
+          meson setup .pre-commit-builds/release; fi &&
+          meson test -C .pre-commit-builds/release
+          --suite unit_test
+          --suite integration_short
+          --suite integration_long
+          --verbose'
+        language: system
+        pass_filenames: false
+        files: \.(c|h|py|sh)$
+        stages: [manual]
+    -   id: all-tests-debug
+        name: All Tests (Debug)
+        entry: >-
+          bash -c 'if [ ! -d .pre-commit-builds/debug ]; then
+          meson setup .pre-commit-builds/debug --buildtype=debug; fi &&
+          meson test -C .pre-commit-builds/debug
           --suite unit_test
           --suite integration_short
           --suite integration_long
-          --verbose
+          --verbose'
         language: system
         pass_filenames: false
         files: \.(c|h|py|sh)$
         stages: [manual]
     -   id: all-tests-clang
         name: All Tests (Clang)
         entry: >-
-          bash -c 'if [ ! -d builddir_clang ]; then
-          CC=clang meson setup builddir_clang; fi &&
-          meson test -C builddir_clang
+          bash -c 'if [ ! -d .pre-commit-builds/clang-release ]; then
+          CC=clang meson setup .pre-commit-builds/clang-release; fi &&
+          meson test -C .pre-commit-builds/clang-release
+          --suite unit_test
+          --suite integration_short
+          --suite integration_long
+          --verbose'
+        language: system
+        pass_filenames: false
+        files: \.(c|h|py|sh)$
+        stages: [manual]
+    -   id: all-tests-clang-debug
+        name: All Tests (Clang Debug)
+        entry: >-
+          bash -c 'if [ ! -d .pre-commit-builds/clang-debug ]; then
+          CC=clang meson setup .pre-commit-builds/clang-debug --buildtype=debug; fi &&
+          meson test -C .pre-commit-builds/clang-debug
           --suite unit_test
           --suite integration_short
           --suite integration_long

src/README.md

@@ -133,10 +133,16 @@ pre-commit run --all-files
 > # Run all tests using the default compiler (GCC)
 > pre-commit run all-tests --hook-stage manual --all-files
 >
+> # Run all tests (GCC Debug)
+> pre-commit run all-tests-debug --hook-stage manual --all-files
+>
 > # Run all tests using Clang
 > pre-commit run all-tests-clang --hook-stage manual --all-files
+>
+> # Run all tests (Clang Debug)
+> pre-commit run all-tests-clang-debug --hook-stage manual --all-files
 > ```
-> Note that `all-tests-clang` requires `clang` to be installed (e.g.,
+> Note that the Clang-based hooks require `clang` to be installed (e.g.,
 > `sudo apt install clang` on Debian/Ubuntu systems).
 
 ### Running Tests
@@ -180,15 +186,21 @@ configurations:
 ##### 3. Required Pre-Push Validation
 
 Before pushing changes, developers are **required** to manually run the full
-suite using the manual pre-commit hooks to catch potential cache regressions
-locally:
+suite using the manual pre-commit hooks to catch potential cache regressions and
+memory leaks locally:
 
 ```bash
 # Run GCC-based compilation and all tests (unit_test, integration_short, integration_long)
 pre-commit run all-tests --hook-stage manual --all-files
 
+# Run GCC-based compilation in Debug mode (with leak detection enabled) and all tests
+pre-commit run all-tests-debug --hook-stage manual --all-files
+
 # Run Clang-based compilation and all tests
 pre-commit run all-tests-clang --hook-stage manual --all-files
+
+# Run Clang-based compilation in Debug mode (with leak detection enabled) and all tests
+pre-commit run all-tests-clang-debug --hook-stage manual --all-files
 ```
 
 ---