refactor: single Docker invocation for pre-push hook

- Pre-push hook now sources env.sh + docker/exec.sh and delegates
  itself, so both format and lint run in one container (not two)
- install-hooks.sh sources env.sh for consistent logging
- Fix "all scripts" wording in README and CLAUDE.md to clarify that
  install-hooks.sh runs directly on the host

Author: wambitz

.githooks/pre-push

@@ -4,20 +4,23 @@ set -e
 ###############################################################################
 # Git pre-push hook
 #
-# Runs formatting and linting checks before pushing. Delegates to the project
-# scripts, which auto-delegate to Docker when run outside the container.
+# Runs formatting and linting checks before pushing. Delegates to Docker
+# as a single container invocation (via the same mechanism as other scripts).
 ###############################################################################
 
-REPO_ROOT="$(git rev-parse --show-toplevel)"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../scripts" && pwd)"
+source "$SCRIPT_DIR/env.sh"
+source "$SCRIPT_DIR/docker/exec.sh"
+delegate_to_container "$@"
 
-echo "=== Pre-push: checking formatting ==="
-"$REPO_ROOT/scripts/format.sh" --check
+log_info "Pre-push: checking formatting..."
+"$PROJECT_ROOT/scripts/format.sh" --check
 
-BUILD_DIR="$REPO_ROOT/build"
+BUILD_DIR="$PROJECT_ROOT/build"
 if [ ! -f "$BUILD_DIR/compile_commands.json" ]; then
-    echo "=== Pre-push: skipping clang-tidy (no compile_commands.json) ==="
-    echo "Run ./scripts/build.sh first to enable lint checks."
+    log_warn "Pre-push: skipping clang-tidy (no compile_commands.json)"
+    log_warn "Run ./scripts/build.sh first to enable lint checks."
 else
-    echo "=== Pre-push: running clang-tidy ==="
-    "$REPO_ROOT/scripts/lint.sh"
+    log_info "Pre-push: running clang-tidy..."
+    "$PROJECT_ROOT/scripts/lint.sh"
 fi

CLAUDE.md

@@ -15,9 +15,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ./scripts/docs.sh                                # Generate Doxygen documentation
 ```
 
-Git hooks live in `.githooks/` (version-controlled). Install once after cloning: `./scripts/install-hooks.sh`
+Git hooks live in `.githooks/` (version-controlled). Install once after cloning: `./scripts/install-hooks.sh` (runs directly on the host).
 
-All scripts auto-delegate to Docker when run outside the container (`docker run --rm`). The delegation logic lives in `scripts/docker/exec.sh`, sourced by each script via `scripts/env.sh`. Inside the container or CI (`CI=true`), scripts run directly with no overhead. See `docs/ci-container-delegation.md` for details on the CI strategy and a GHCR upgrade path.
+Build and quality scripts auto-delegate to Docker when run outside the container (`docker run --rm`). The delegation logic lives in `scripts/docker/exec.sh`, sourced by each script via `scripts/env.sh`. Inside the container or CI (`CI=true`), scripts run directly with no overhead. See `docs/ci-container-delegation.md` for details on the CI strategy and a GHCR upgrade path.
 
 ## Architecture
 

README.md

@@ -31,7 +31,7 @@ git clone <your-fork> my_project && cd my_project
 ./scripts/test.sh
 ```
 
-Every script in `scripts/` auto-delegates to Docker when run from the host. You don't need CMake, clang-format, or any other tool installed locally — just Docker. See [docs/ci-container-delegation.md](docs/ci-container-delegation.md) for details.
+Build and quality scripts auto-delegate to Docker when run from the host. You don't need CMake, clang-format, or any other tool installed locally — just Docker. See [docs/ci-container-delegation.md](docs/ci-container-delegation.md) for details.
 
 ---
 
@@ -71,7 +71,7 @@ Every script in `scripts/` auto-delegates to Docker when run from the host. You
 
 ## Scripts
 
-All scripts auto-delegate to Docker when run on the host. Inside the container or CI (`CI=true`), they run directly.
+Build and quality scripts auto-delegate to Docker when run on the host. Inside the container or CI (`CI=true`), they run directly. `install-hooks.sh` runs directly on the host to configure git.
 
 ### Build and Development
 

scripts/install-hooks.sh

@@ -8,10 +8,12 @@ set -e
 # are used automatically. Run once after cloning:
 #
 #   ./scripts/install-hooks.sh
+#
+# This script runs directly on the host (no Docker delegation).
 ###############################################################################
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(dirname "$SCRIPT_DIR")"
+source "$SCRIPT_DIR/env.sh"
 
-git -C "$REPO_ROOT" config core.hooksPath .githooks
-echo "[INFO] Git hooks installed (.githooks/). core.hooksPath set."
+git -C "$PROJECT_ROOT" config core.hooksPath .githooks
+log_info "Git hooks installed (.githooks/). core.hooksPath set."