chore: move dev checks to CI instead of commit hook

Author: skylarmb

.github/workflows/tox-full-suite.yml

@@ -165,6 +165,16 @@ jobs:
           echo "✨ Running format checks..."
           tox -e format
 
+      - name: Validate tracer patterns
+        run: |
+          echo "🔍 Validating tracer patterns..."
+          bash scripts/validate-tracer-patterns.sh
+
+      - name: Check feature documentation sync
+        run: |
+          echo "📋 Checking feature documentation synchronization..."
+          python scripts/check-feature-sync.py
+
       - name: Build documentation
         run: |
           echo "📚 Building documentation..."
@@ -219,6 +229,11 @@ jobs:
             echo "has_honeyhive_key=false" >> $GITHUB_OUTPUT
           fi
 
+      - name: Validate no mocks in integration tests
+        run: |
+          echo "🔍 Validating integration tests use real APIs (no mocks)..."
+          bash scripts/validate-no-mocks-integration.sh
+
       - name: Run integration tests with real APIs (NO MOCKS)
         if: steps.check_credentials.outputs.has_honeyhive_key == 'true'
         run: |

.pre-commit-config.yaml

@@ -34,17 +34,34 @@ The Maintainers
 **Option A: Nix Flakes (Recommended)**
 
 ```bash
+git clone https://github.com/honeyhiveai/python-sdk.git
 cd python-sdk
-direnv allow  # One-time setup - automatically configures environment
+
+# Allow direnv (one-time setup)
+direnv allow
+
+# That's it! Environment automatically configured with:
+# - Python 3.12
+# - All dev dependencies
+# - Tox environments
 ```
 
+See [NIX_SETUP.md](NIX_SETUP.md) for full details on the Nix development environment.
+
 **Option B: Traditional Setup**
 
 ```bash
+git clone https://github.com/honeyhiveai/python-sdk.git
 cd python-sdk
+
+# Create and activate virtual environment named 'python-sdk' (required)
 python -m venv python-sdk
-source python-sdk/bin/activate
+source python-sdk/bin/activate  # On Windows: python-sdk\Scripts\activate
+
+# Install in development mode with all dependencies
 pip install -e ".[dev,docs]"
+
+# Set up development environment (installs tools, runs verification)
 ./scripts/setup-dev.sh
 ```
 
@@ -57,18 +74,27 @@ make help
 ```
 
 Key commands:
-- `make check` - Run all comprehensive checks (everything that was in pre-commit)
+- `make check` - Run all comprehensive checks (format, lint, tests, docs, validation)
 - `make test` - Run all tests
-- `make format` - Format code
+- `make format` - Format code with Black and isort
+- `make lint` - Run linting checks
 - `make generate-sdk` - Generate SDK from OpenAPI spec
 
-### Pre-commit Hooks
+### Code Quality Checks
+
+Before pushing code, run:
+```bash
+make check
+```
 
-Pre-commit hooks are **fast** (runs in seconds) and automatically enforce:
+This runs all quality checks:
 - ✅ Black formatting
 - ✅ Import sorting (isort)
 - ✅ Static analysis (pylint + mypy)
-- ✅ YAML validation
 - ✅ Unit tests (fast, mocked)
+- ✅ Integration test validation
+- ✅ Documentation builds
+- ✅ Tracer pattern validation
+- ✅ Feature documentation sync
 
-**Heavy checks moved to Makefile**: Integration tests, documentation builds, and compliance checks are now run via `make check-all` instead of on every commit. This makes commits fast while still allowing comprehensive validation when needed.
+All these checks also run automatically in CI when you push or create a pull request.

CONTRIBUTING.md

@@ -75,69 +75,6 @@ pip install honeyhive
 
 For detailed guidance on including HoneyHive in your `pyproject.toml`, see our [pyproject.toml Integration Guide](https://honeyhiveai.github.io/python-sdk/how-to/deployment/pyproject-integration.html).
 
-### Development Installation
-
-**Option A: Nix Flakes (Recommended)**
-
-```bash
-git clone https://github.com/honeyhiveai/python-sdk.git
-cd python-sdk
-
-# Allow direnv (one-time setup)
-direnv allow
-
-# That's it! Environment automatically configured with:
-# - Python 3.12
-# - All dev dependencies
-# - Pre-commit hooks
-```
-
-See [NIX_SETUP.md](NIX_SETUP.md) for full details.
-
-**Option B: Traditional Setup**
-
-```bash
-git clone https://github.com/honeyhiveai/python-sdk.git
-cd python-sdk
-
-# Create and activate virtual environment named 'python-sdk' (required)
-python -m venv python-sdk
-source python-sdk/bin/activate  # On Windows: python-sdk\Scripts\activate
-
-# Install in development mode
-pip install -e .
-
-# 🚨 MANDATORY: Set up development environment (one-time setup)
-./scripts/setup-dev.sh
-
-# Verify setup (should pass all checks)
-tox -e format && tox -e lint
-```
-
-#### Development Environment Setup
-
-**⚠️ CRITICAL: All developers must run the setup script once (unless using Nix):**
-
-```bash
-# This installs pre-commit hooks for automatic code quality enforcement
-./scripts/setup-dev.sh
-```
-
-**Pre-commit hooks automatically enforce:**
-- **Black formatting** (88-character lines)
-- **Import sorting** (isort with black profile)  
-- **Static analysis** (pylint + mypy)
-- **YAML validation** (yamllint with 120-character lines)
-- **Documentation synchronization** (feature docs, changelog)
-- **Tox verification** (format and lint checks)
-
-**Before every commit, the system automatically runs:**
-1. Code formatting and import sorting
-2. Static analysis and type checking
-3. Documentation build verification
-4. Feature documentation synchronization
-5. Mandatory changelog update verification
-
 ## 🔧 Quick Start
 
 ### Basic Usage
@@ -382,4 +319,8 @@ src/honeyhive/
 | `HH_HTTP_PROXY` | HTTP proxy URL | `None` |
 | `HH_HTTPS_PROXY` | HTTPS proxy URL | `None` |
 | `HH_NO_PROXY` | Proxy bypass list | `None` |
-| `HH_VERIFY_SSL` | SSL verification | `true`
+| `HH_VERIFY_SSL` | SSL verification | `true`
+
+## 🤝 Contributing
+
+Want to contribute to HoneyHive? See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

README.md

@@ -53,7 +53,6 @@ dev = [
     "typeguard>=4.0.0",
     "psutil>=5.9.0",
     "yamllint>=1.37.0",
-    "pre-commit>=3.0.0",  # For git hooks
     "requests>=2.31.0",  # For docs navigation validation
     "beautifulsoup4>=4.12.0",  # For docs navigation validation
     "datamodel-code-generator==0.25.0",  # For model generation from OpenAPI spec (pinned to match original generation)

pyproject.toml

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Development environment setup script for HoneyHive Python SDK
-# This ensures all developers have consistent tooling and pre-commit hooks
+# This ensures all developers have consistent tooling
 
 set -e
 
@@ -35,11 +35,6 @@ echo "✅ Virtual environment: $VIRTUAL_ENV"
 # Install development dependencies
 echo "📦 Installing development dependencies..."
 pip install -e .
-pip install pre-commit>=3.6.0
-
-# Install pre-commit hooks
-echo "🪝 Installing pre-commit hooks..."
-pre-commit install
 
 # Verify tools are working
 echo "🔍 Verifying development tools..."
@@ -66,9 +61,9 @@ echo ""
 echo "🎉 Development environment setup complete!"
 echo ""
 echo "📋 Next steps:"
-echo "  1. All commits will now automatically run quality checks"
-echo "  2. To manually run checks: tox -e lint && tox -e format"
-echo "  3. To skip pre-commit hooks (emergency only): git commit --no-verify"
+echo "  1. Run 'make check' to validate your changes before committing"
+echo "  2. All checks will run in CI when you push"
+echo "  3. Use 'make help' to see all available commands"
 echo ""
 echo "📚 More info:"
 echo "  - praxis OS standards: .praxis-os/standards/"