configure-precommit 1.0.0

package/lib/sensor.sh

@@ -0,0 +1,222 @@
+#!/usr/bin/env bash
+# Phase 1: Contextual Sensor
+# Gathers repository metadata for LLM analysis
+
+set -euo pipefail
+
+# Directories to exclude from file tree
+EXCLUDED_DIRS=(
+    ".git"
+    # JavaScript/Node
+    "node_modules"
+    ".next"
+    ".nuxt"
+    "coverage"
+    # Python
+    "venv"
+    ".venv"
+    "env"
+    ".env"
+    "__pycache__"
+    ".mypy_cache"
+    ".pytest_cache"
+    ".ruff_cache"
+    ".tox"
+    "*.egg-info"
+    # Go
+    "vendor"
+    # Java/Build
+    "target"
+    "build"
+    "dist"
+    ".gradle"
+    # Infrastructure
+    ".terraform"
+    ".terragrunt-cache"
+)
+
+# Manifest files to harvest
+MANIFEST_PATTERNS=(
+    # Python
+    "pyproject.toml"
+    "requirements.txt"
+    "setup.py"
+    "setup.cfg"
+    "Pipfile"
+    # JavaScript/TypeScript
+    "package.json"
+    "tsconfig.json"
+    ".eslintrc"
+    ".eslintrc.js"
+    ".eslintrc.json"
+    ".eslintrc.yml"
+    ".prettierrc"
+    ".prettierrc.js"
+    ".prettierrc.json"
+    ".prettierrc.yml"
+    # Go
+    "go.mod"
+    "go.sum"
+    # Java
+    "pom.xml"
+    "build.gradle"
+    "build.gradle.kts"
+    "settings.gradle"
+    # Infrastructure
+    "Dockerfile"
+    "docker-compose.yml"
+    "docker-compose.yaml"
+    "*.tf"
+    "terragrunt.hcl"
+    # Config
+    ".pre-commit-config.yaml"
+    ".yamllint"
+    ".yamllint.yml"
+    ".yamllint.yaml"
+)
+
+# Build find exclusion arguments
+build_exclude_args() {
+    local args=""
+    for dir in "${EXCLUDED_DIRS[@]}"; do
+        args="$args -name '$dir' -prune -o"
+    done
+    echo "$args"
+}
+
+# Generate file tree as JSON array
+generate_file_tree() {
+    local repo_root="$1"
+
+    # Change to repo root so paths are relative
+    cd "$repo_root"
+
+    # Find all files, exclude directories, output as JSON array
+    echo "["
+    local first=true
+    while IFS= read -r file; do
+        # Skip empty lines
+        [[ -z "$file" ]] && continue
+
+        # Remove leading ./
+        file="${file#./}"
+
+        # Skip if file is in excluded directory
+        local skip=false
+        for dir in "${EXCLUDED_DIRS[@]}"; do
+            if [[ "$file" == *"/$dir/"* ]] || [[ "$file" == "$dir/"* ]] || [[ "$file" == *"/$dir" ]] || [[ "$file" == ".git/"* ]]; then
+                skip=true
+                break
+            fi
+        done
+        [[ "$skip" == true ]] && continue
+
+        if [[ "$first" == true ]]; then
+            first=false
+        else
+            echo ","
+        fi
+        # Escape quotes and backslashes for JSON
+        file="${file//\\/\\\\}"
+        file="${file//\"/\\\"}"
+        printf '    "%s"' "$file"
+    done < <(find . -type f 2>/dev/null | sort)
+    echo ""
+    echo "  ]"
+}
+
+# Harvest manifest files and their contents
+harvest_manifests() {
+    local repo_root="$1"
+
+    echo "{"
+    local first=true
+
+    for pattern in "${MANIFEST_PATTERNS[@]}"; do
+        # Find files matching pattern
+        while IFS= read -r file; do
+            [[ -z "$file" ]] && continue
+            [[ ! -f "$file" ]] && continue
+
+            # Skip if in excluded directory
+            local skip=false
+            for dir in "${EXCLUDED_DIRS[@]}"; do
+                if [[ "$file" == *"/$dir/"* ]] || [[ "$file" == "./$dir/"* ]]; then
+                    skip=true
+                    break
+                fi
+            done
+            [[ "$skip" == true ]] && continue
+
+            # Get relative path
+            local rel_path="${file#"$repo_root"/}"
+            rel_path="${rel_path#./}"
+
+            # Read file content (limit to 50KB to avoid huge manifests)
+            local content
+            content=$(head -c 51200 "$file" 2>/dev/null || echo "")
+
+            # Escape for JSON
+            content="${content//\\/\\\\}"
+            content="${content//\"/\\\"}"
+            content="${content//$'\n'/\\n}"
+            content="${content//$'\r'/\\r}"
+            content="${content//$'\t'/\\t}"
+
+            rel_path="${rel_path//\\/\\\\}"
+            rel_path="${rel_path//\"/\\\"}"
+
+            if [[ "$first" == true ]]; then
+                first=false
+            else
+                echo ","
+            fi
+            printf '    "%s": "%s"' "$rel_path" "$content"
+        done < <(find "$repo_root" -name "$pattern" -type f 2>/dev/null)
+    done
+
+    echo ""
+    echo "  }"
+}
+
+# Check if .pre-commit-config.yaml exists
+check_existing_precommit() {
+    local repo_root="$1"
+    if [[ -f "$repo_root/.pre-commit-config.yaml" ]]; then
+        echo "true"
+    else
+        echo "false"
+    fi
+}
+
+# Main function: Generate complete repo context
+generate_repo_context() {
+    local repo_root="${1:-.}"
+
+    # Resolve to absolute path
+    repo_root="$(cd "$repo_root" && pwd)"
+
+    # Verify it's a git repo
+    if [[ ! -d "$repo_root/.git" ]]; then
+        echo "ERROR: Not a git repository: $repo_root" >&2
+        return 1
+    fi
+
+    local existing_precommit
+    existing_precommit=$(check_existing_precommit "$repo_root")
+
+    # Generate JSON output
+    cat <<EOF
+{
+  "repo_root": "$repo_root",
+  "existing_precommit": $existing_precommit,
+  "file_tree": $(generate_file_tree "$repo_root"),
+  "manifests": $(harvest_manifests "$repo_root")
+}
+EOF
+}
+
+# If run directly (not sourced), execute main function
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    generate_repo_context "$@"
+fi

package/lib/verifier.sh

@@ -0,0 +1,275 @@
+#!/usr/bin/env bash
+# Phase 4: Verifier + Self-Healing Loop
+# Runs hooks and triggers debugger on config errors
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions - write to stderr to avoid polluting stdout
+log_info() {
+    echo -e "${GREEN}[INFO]${NC} $1" >&2
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1" >&2
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1" >&2
+}
+
+log_debug() {
+    if [[ "${DEBUG:-false}" == "true" ]]; then
+        echo -e "${BLUE}[DEBUG]${NC} $1" >&2
+    fi
+}
+
+# Maximum retry attempts for self-healing
+MAX_RETRIES="${PRECOMMIT_MAX_RETRIES:-3}"
+
+# Function to invoke debugger agent (to be implemented by integration layer)
+# This is a placeholder - the main script will override this
+invoke_debugger() {
+    local output="$1"
+    local exit_code="$2"
+    local config_content="$3"
+
+    # Default implementation - should be overridden
+    echo "ERROR: invoke_debugger not implemented"
+    return 1
+}
+
+# Parse debugger response
+parse_debugger_response() {
+    local response="$1"
+
+    # Extract category (first line)
+    local category
+    category=$(echo "$response" | head -1 | tr -d '[:space:]')
+
+    # Extract explanation (second line)
+    local explanation
+    explanation=$(echo "$response" | sed -n '2p')
+
+    # Extract payload (line 3 onwards)
+    local payload
+    payload=$(echo "$response" | tail -n +3)
+
+    echo "$category"
+    echo "$explanation"
+    echo "$payload"
+}
+
+# Run pre-commit and capture output
+run_precommit() {
+    local output
+    local exit_code
+
+    log_info "Running pre-commit on all files..."
+
+    # Capture both stdout and stderr
+    output=$(pre-commit run --all-files 2>&1) || true
+    exit_code=${PIPESTATUS[0]}
+
+    echo "$output"
+    return "$exit_code"
+}
+
+# Analyze if failure is likely a config error vs code issue
+# Returns: "config_error", "code_issue", "network_error", or "unknown"
+quick_classify_error() {
+    local output="$1"
+
+    # Config/setup errors
+    if echo "$output" | grep -qiE "InvalidConfigError|InvalidManifestError|RepositoryNotFoundError|does not provide|An error has occurred|Unexpected key|YAMLError|yaml.scanner|yaml.parser"; then
+        echo "config_error"
+        return
+    fi
+
+    # Missing dependencies
+    if echo "$output" | grep -qiE "Executable.*not found|command not found|FileNotFoundError|No such file or directory.*bin/"; then
+        echo "missing_dep"
+        return
+    fi
+
+    # Network errors
+    if echo "$output" | grep -qiE "Connection refused|timeout|rate limit|Unable to clone|fatal: unable to access"; then
+        echo "network_error"
+        return
+    fi
+
+    # If we see file paths with line numbers, likely code issues found
+    if echo "$output" | grep -qE "^[a-zA-Z0-9_./-]+:[0-9]+:"; then
+        echo "code_issue"
+        return
+    fi
+
+    # Check for common "hook found issues" patterns
+    if echo "$output" | grep -qiE "Fixed|Modified|would reformat|error:|warning:|W[0-9]+:|E[0-9]+:"; then
+        echo "code_issue"
+        return
+    fi
+
+    echo "unknown"
+}
+
+# Main verification loop
+run_verification_loop() {
+    local attempt=0
+    local output
+    local exit_code
+    local category
+    local explanation
+    local new_config
+
+    while [[ $attempt -lt $MAX_RETRIES ]]; do
+        log_info "Verification attempt $((attempt + 1)) of $MAX_RETRIES"
+
+        # Run pre-commit
+        output=$(run_precommit) && exit_code=0 || exit_code=$?
+
+        log_debug "Exit code: $exit_code"
+
+        # Success - all hooks passed
+        if [[ $exit_code -eq 0 ]]; then
+            log_info "All hooks passed successfully!"
+            echo "$output" >&2
+            return 0
+        fi
+
+        # Quick classification to avoid unnecessary LLM calls
+        local quick_class
+        quick_class=$(quick_classify_error "$output")
+        log_debug "Quick classification: $quick_class"
+
+        case "$quick_class" in
+            "code_issue")
+                # Hooks are working - they found issues in code
+                log_info "Hooks are working correctly. Found issues in code:"
+                echo "$output" >&2
+                echo "" >&2
+                log_warn "Your code has issues that the hooks detected. This is expected behavior."
+                log_info "Fix the issues above and run 'git commit' to re-run hooks."
+                return 0  # This is success for our setup
+                ;;
+            "network_error")
+                log_error "Network error detected. Please check your internet connection."
+                echo "$output" >&2
+                return 1
+                ;;
+            "config_error"|"missing_dep"|"unknown")
+                # Need to invoke debugger
+                log_warn "Potential configuration issue detected. Invoking debugger..."
+                ;;
+        esac
+
+        # Read current config
+        local config_content
+        config_content=$(cat .pre-commit-config.yaml)
+
+        # Invoke debugger agent
+        local debugger_response
+        if ! debugger_response=$(invoke_debugger "$output" "$exit_code" "$config_content"); then
+            log_error "Debugger agent failed"
+            return 1
+        fi
+
+        # Parse response
+        category=$(echo "$debugger_response" | head -1 | tr -d '[:space:]')
+        explanation=$(echo "$debugger_response" | sed -n '2p')
+        new_config=$(echo "$debugger_response" | tail -n +3)
+
+        log_info "Debugger classification: $category"
+        log_info "Explanation: $explanation"
+
+        case "$category" in
+            A|B)
+                log_info "Applying corrected configuration..."
+                echo "$new_config" > .pre-commit-config.yaml
+
+                # Re-run autoupdate if versions changed
+                if grep -q "rev: AUTOUPDATE" .pre-commit-config.yaml 2>/dev/null; then
+                    sed -i.bak 's/rev: AUTOUPDATE/rev: v0.0.1/g' .pre-commit-config.yaml 2>/dev/null || \
+                    sed -i '' 's/rev: AUTOUPDATE/rev: v0.0.1/g' .pre-commit-config.yaml
+                    rm -f .pre-commit-config.yaml.bak
+                    pre-commit autoupdate 2>/dev/null || true
+                fi
+
+                # Reinstall hooks with new config
+                pre-commit install-hooks 2>/dev/null || true
+
+                ((attempt++))
+                ;;
+            C)
+                log_info "Hooks are working correctly. Code has issues to address."
+                echo "$output" >&2
+                return 0
+                ;;
+            D)
+                log_error "Network error. Please check connectivity and retry."
+                return 1
+                ;;
+            *)
+                log_error "Unknown debugger response: $category"
+                log_error "Manual intervention required."
+                echo "$output" >&2
+                return 1
+                ;;
+        esac
+    done
+
+    # Max retries exceeded
+    log_error "Could not fix configuration after $MAX_RETRIES attempts"
+    log_error "Last error output:"
+    echo "$output" >&2
+    return 1
+}
+
+# Summary generation - all output to stderr
+generate_summary() {
+    local repo_root="${1:-.}"
+
+    {
+        echo ""
+        echo "========================================"
+        echo "       PRE-COMMIT SETUP COMPLETE        "
+        echo "========================================"
+        echo ""
+        echo "Repository: $repo_root"
+        echo "Config:     .pre-commit-config.yaml"
+        echo ""
+        echo "INSTALLED HOOKS:"
+
+        # Parse installed hooks from config
+        if [[ -f .pre-commit-config.yaml ]]; then
+            grep -E "^\s+- id:" .pre-commit-config.yaml | sed 's/.*- id: /  - /' || true
+        fi
+
+        echo ""
+        echo "NEXT STEPS:"
+        echo "  1. Review any issues found above"
+        echo "  2. Fix issues and stage your changes: git add ."
+        echo "  3. Commit: git commit -m 'your message'"
+        echo "  4. Hooks will run automatically on each commit"
+        echo ""
+        echo "USEFUL COMMANDS:"
+        echo "  pre-commit run --all-files  # Run all hooks manually"
+        echo "  pre-commit autoupdate       # Update hook versions"
+        echo "  pre-commit run <hook-id>    # Run specific hook"
+        echo ""
+        echo "========================================"
+    } >&2
+}
+
+# If run directly (not sourced)
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    echo "This script is meant to be sourced, not run directly."
+    echo "It provides: run_verification_loop, generate_summary"
+    exit 1
+fi

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "configure-precommit",
+  "version": "1.0.0",
+  "description": "Agentic pre-commit setup - automatically configures pre-commit hooks for any repository using AI",
+  "keywords": [
+    "pre-commit",
+    "git-hooks",
+    "linting",
+    "code-quality",
+    "devops",
+    "automation",
+    "ai",
+    "llm",
+    "claude",
+    "openai"
+  ],
+  "author": "Aviv Kaplan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avivkaplan/configure-precommit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/avivkaplan/configure-precommit/issues"
+  },
+  "homepage": "https://github.com/avivkaplan/configure-precommit#readme",
+  "bin": {
+    "configure-precommit": "./bin/configure-precommit"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "scripts": {
+    "test": "./tests/run_tests.sh",
+    "lint": "shellcheck lib/*.sh bin/configure-precommit setup-precommit.sh"
+  }
+}