Pre-commit hook: auto-recover broken venv before running checks #61

New Issue

kert · 2026-03-21T19:12:14Z

kert commented

2026-03-21 19:12:14 +00:00

Problem

When .venv is broken (symlink to /root, stale uv version, missing editable install), the pre-commit hook fails at the first uv run call with a cryptic permission error. The developer has to manually rm -rf .venv && uv sync — a friction point.

Fix

Add a venv health check at the top of .git/hooks/pre-commit:

# Ensure venv is healthy before running checks
if ! uv run python -c 'import sys' 2>/dev/null; then
  echo "==> pre-commit: venv broken, running uv sync --dev"
  uv sync --dev
fi

This auto-recovers the venv if it's broken, before any lint/test/notebook checks run.

Files

.git/hooks/pre-commit

## Problem When `.venv` is broken (symlink to /root, stale uv version, missing editable install), the pre-commit hook fails at the first `uv run` call with a cryptic permission error. The developer has to manually `rm -rf .venv && uv sync` — a friction point. ## Fix Add a venv health check at the top of `.git/hooks/pre-commit`: ```bash # Ensure venv is healthy before running checks if ! uv run python -c 'import sys' 2>/dev/null; then echo "==> pre-commit: venv broken, running uv sync --dev" uv sync --dev fi ``` This auto-recovers the venv if it's broken, before any lint/test/notebook checks run. ## Files - `.git/hooks/pre-commit`

kert added this to the P12: uv Hygiene — fix venv, build system, python resolution milestone 2026-03-21 19:12:14 +00:00

kert added the config label 2026-03-21 19:12:14 +00:00

kert referenced this issue from a commit

2026-03-21 19:16:25 +00:00

uv hygiene: build-system, uv.toml, version pins, auto-recovery hook

kert referenced this issue

2026-03-21 19:16:44 +00:00

P12: uv hygiene — build-system, link-mode, version pins, auto-recovery #62

kert closed this issue

2026-03-21 19:34:02 +00:00

Sign in to join this conversation.