.pre-commit-config.yaml

# Pre-commit hooks for code quality and consistency
# Install: pip install pre-commit && pre-commit install
# Run manually: pre-commit run --all-files

repos:
  # Code formatting
  - repo: https://github.com/psf/black
    rev: 25.9.0
    hooks:
      - id: black
        language_version: python3
        args: ['--line-length=100']
  
  # Import sorting
  - repo: https://github.com/pycqa/isort
    rev: 5.13.2
    hooks:
      - id: isort
        args: ['--profile', 'black', '--line-length=100']
  
  # Fast linting (replaces flake8)
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.8.4
    hooks:
      - id: ruff
        args: ['--fix', '--exit-non-zero-on-fix']
      - id: ruff-format
  
  # Type checking
  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.18.2
    hooks:
      - id: mypy
        additional_dependencies: [types-all]
        args: ['--ignore-missing-imports', '--no-strict-optional']
        exclude: ^(tests/|tools/|scripts/)
  
  # Trailing whitespace and basic checks
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v5.0.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
      - id: check-json
      - id: check-toml
      - id: check-added-large-files
      - id: check-merge-conflict
      - id: check-case-conflict
      - id: detect-private-key
  
  # Custom benchmark validation hooks
  - repo: local
    hooks:
      # Benchmark warmup validation - CRITICAL for accurate measurements
      # Low warmup causes JIT/compile overhead to be included in timing results.
      - id: check-benchmark-warmup
        name: Check Benchmark Warmup Settings
        entry: python scripts/audit_warmup_settings.py
        language: system
        types: [python]
        files: ^(ch\d+|labs)/.*\.py$
        pass_filenames: false
        description: >
          Ensures all benchmarks have sufficient warmup iterations to exclude
          JIT/compile overhead from measurements. torch.compile, Triton, and
          CUDA JIT all need warmup to reach steady-state performance.