configure-precommit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aviv Kaplan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# configure-precommit
+
+Automatically configure pre-commit hooks for any repository using AI-powered analysis.
+
+## Overview
+
+This tool scans your repository, analyzes its structure and tech stack, and generates an optimal `.pre-commit-config.yaml` tailored to your project.
+
+**Supported stacks:**
+- Python (ruff, mypy, bandit)
+- JavaScript/TypeScript (eslint, prettier)
+- Go (golangci-lint, go-fmt)
+- Java (pretty-format-java)
+- Terraform (terraform_fmt, tflint, checkov)
+- Docker (hadolint)
+- Shell (shellcheck)
+- Plus security scanning (gitleaks) and general hygiene hooks
+
+## Installation
+
+```bash
+# Using npx (no install required)
+npx configure-precommit
+
+# Or install globally
+npm install -g configure-precommit
+```
+
+## Quick Start
+
+```bash
+# 1. Set your API key
+export ANTHROPIC_API_KEY="sk-ant-..."
+# OR
+export OPENAI_API_KEY="sk-..."
+
+# 2. Run in your repository
+cd /path/to/your/repo
+configure-precommit
+
+# Or specify a path
+configure-precommit /path/to/your/repo
+```
+
+## Requirements
+
+- **macOS or Linux** (Windows via WSL)
+- **Node.js >= 14** (for npx/npm)
+- **Git repository** (initialized with `git init`)
+- **API key** - Anthropic (preferred) or OpenAI
+- **System tools:** git, jq, curl, python3
+
+The script automatically installs `pre-commit` if not present.
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Phase 1: SENSOR                                                │
+│  └── Scan repo structure, detect languages/frameworks           │
+│                                                                 │
+│  Phase 2: AUDITOR (LLM)                                         │
+│  └── AI analyzes repo, generates optimal pre-commit config      │
+│                                                                 │
+│  Phase 3: BUILDER                                               │
+│  ├── Write .pre-commit-config.yaml                              │
+│  ├── Run pre-commit autoupdate (get latest versions)            │
+│  └── Install git hooks                                          │
+│                                                                 │
+│  Phase 4: VERIFICATION & SELF-HEALING                           │
+│  ├── Run pre-commit on all files                                │
+│  └── If config errors → AI debugger fixes → retry (max 3x)      │
+│                                                                 │
+│  Phase 5: SUMMARY                                               │
+│  └── Report installed hooks and any code issues found           │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## CLI Options
+
+```
+configure-precommit [OPTIONS] [REPO_PATH]
+
+Options:
+  -h, --help          Show help message
+  -v, --version       Show version
+  --dry-run           Generate config without installing hooks
+  --skip-autoupdate   Skip running pre-commit autoupdate
+  --debug             Enable debug output
+```
+
+## Supported Hooks
+
+| Category | Tools | Trigger |
+|----------|-------|---------|
+| **Python** | ruff, ruff-format, mypy, bandit | `.py` files |
+| **JavaScript/TypeScript** | eslint, prettier | `.js`, `.ts`, `.jsx`, `.tsx` |
+| **Go** | golangci-lint, go-fmt, go-imports | `.go` files |
+| **Java** | pretty-format-java | `.java` files |
+| **Shell** | shellcheck | `.sh`, `.bash` files |
+| **Terraform** | terraform_fmt, tflint, checkov | `.tf` files |
+| **Docker** | hadolint | `Dockerfile` |
+| **YAML** | yamllint, check-yaml | `.yaml`, `.yml` |
+| **JSON** | check-json | `.json` |
+| **Security** | gitleaks, detect-private-key | All files |
+| **General** | trailing-whitespace, end-of-file-fixer, check-merge-conflict, no-commit-to-branch | All files |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ANTHROPIC_API_KEY` | Anthropic API key (preferred) |
+| `OPENAI_API_KEY` | OpenAI API key (fallback) |
+| `PRECOMMIT_MAX_RETRIES` | Max self-heal attempts (default: 3) |
+| `PRECOMMIT_DRY_RUN` | Generate config without installing |
+| `PRECOMMIT_SKIP_AUTOUPDATE` | Skip version auto-update |
+| `DEBUG` | Enable debug output |
+
+## Logging
+
+All operations are logged to `/tmp/precommit-setup/`:
+
+```bash
+# View recent logs
+ls -lt /tmp/precommit-setup/*.log | head -5
+
+# Tail a running log
+tail -f /tmp/precommit-setup/myrepo_*.log
+```
+
+## Example Output
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║            AGENTIC PRE-COMMIT SETUP                           ║
+╚═══════════════════════════════════════════════════════════════╝
+
+━━━━━━ PHASE 1: CONTEXTUAL SENSOR ━━━━━━
+[INFO] Scanning repository structure...
+[INFO] Found 47 files and 3 manifest files
+
+━━━━━━ PHASE 2: AUDITOR (LLM Analysis) ━━━━━━
+[INFO] Analyzing repository and generating configuration...
+[INFO] Configuration generated successfully
+
+━━━━━━ PHASE 3: BUILDER ━━━━━━
+[INFO] Wrote configuration to .pre-commit-config.yaml
+[INFO] Updating hook versions to latest...
+[INFO] Git hooks installed successfully
+
+━━━━━━ PHASE 4: VERIFICATION ━━━━━━
+[INFO] All hooks passed successfully!
+
+━━━━━━ PHASE 5: SUMMARY ━━━━━━
+
+INSTALLED HOOKS:
+  - gitleaks
+  - ruff
+  - ruff-format
+  - shellcheck
+  - check-yaml
+  ...
+
+[INFO] Setup complete!
+```
+
+## Troubleshooting
+
+### "Not a git repository"
+Initialize git first: `git init`
+
+### ".pre-commit-config.yaml already exists"
+Remove it first: `rm .pre-commit-config.yaml`
+
+### "No API key found"
+Set one of:
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+export OPENAI_API_KEY="sk-..."
+```
+
+### Hooks fail due to missing tools
+The debugger will automatically move those hooks to `stages: [manual]`. Install the tools later and run manually with `pre-commit run <hook-id> --all-files`.
+
+## File Structure
+
+```
+configure-precommit/
+├── package.json              # npm package config
+├── bin/
+│   └── configure-precommit   # CLI entry point
+├── setup-precommit.sh        # Main orchestration script
+├── lib/
+│   ├── logging.sh            # Logging utilities
+│   ├── sensor.sh             # Repository scanning
+│   ├── builder.sh            # Pre-commit installation
+│   └── verifier.sh           # Verification loop
+├── tests/
+│   └── run_tests.sh          # Test suite
+└── README.md
+```
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/avivkaplan/configure-precommit.git
+cd configure-precommit
+
+# Run tests (requires API key)
+./tests/run_tests.sh
+
+# Lint shell scripts
+shellcheck lib/*.sh bin/configure-precommit setup-precommit.sh
+```
+
+## License
+
+MIT

package/bin/configure-precommit

@@ -0,0 +1,196 @@
+#!/usr/bin/env bash
+#
+# configure-precommit - Agentic pre-commit setup
+# Automatically configures pre-commit hooks for any repository using AI
+#
+# Usage: configure-precommit [options] [repo-path]
+#
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Version from package.json
+VERSION=$(grep '"version"' "$PACKAGE_ROOT/package.json" 2>/dev/null | sed 's/.*"version": "\([^"]*\)".*/\1/' || echo "unknown")
+
+#######################################
+# Print usage
+#######################################
+usage() {
+    cat << EOF
+${CYAN}configure-precommit${NC} v${VERSION}
+
+Agentic pre-commit setup - automatically configures pre-commit hooks
+for any repository using AI analysis.
+
+${CYAN}USAGE:${NC}
+    configure-precommit [OPTIONS] [REPO_PATH]
+
+${CYAN}ARGUMENTS:${NC}
+    REPO_PATH           Path to the git repository (default: current directory)
+
+${CYAN}OPTIONS:${NC}
+    -h, --help          Show this help message
+    -v, --version       Show version
+    --dry-run           Generate config without installing hooks
+    --skip-autoupdate   Skip running pre-commit autoupdate
+    --debug             Enable debug output
+
+${CYAN}ENVIRONMENT VARIABLES:${NC}
+    ANTHROPIC_API_KEY   Anthropic API key (preferred)
+    OPENAI_API_KEY      OpenAI API key (fallback)
+
+${CYAN}EXAMPLES:${NC}
+    configure-precommit                    # Setup in current directory
+    configure-precommit /path/to/repo      # Setup in specific repo
+    configure-precommit --dry-run          # Preview without installing
+
+${CYAN}REQUIREMENTS:${NC}
+    - git, jq, curl (for core functionality)
+    - python3 with PyYAML (for YAML validation)
+    - pre-commit (will be installed if missing)
+
+EOF
+}
+
+#######################################
+# Print version
+#######################################
+print_version() {
+    echo "configure-precommit v${VERSION}"
+}
+
+#######################################
+# Check single dependency
+#######################################
+check_dep() {
+    local cmd="$1"
+    local install_hint="$2"
+
+    if ! command -v "$cmd" &>/dev/null; then
+        echo -e "${RED}[ERROR]${NC} Missing dependency: ${YELLOW}$cmd${NC}"
+        echo -e "        Install with: ${CYAN}$install_hint${NC}"
+        return 1
+    fi
+    return 0
+}
+
+#######################################
+# Check all dependencies
+#######################################
+check_dependencies() {
+    local missing=0
+
+    echo -e "${CYAN}Checking dependencies...${NC}"
+
+    check_dep "git" "brew install git (macOS) or apt install git (Linux)" || ((missing++))
+    check_dep "jq" "brew install jq (macOS) or apt install jq (Linux)" || ((missing++))
+    check_dep "curl" "brew install curl (macOS) or apt install curl (Linux)" || ((missing++))
+    check_dep "python3" "brew install python3 (macOS) or apt install python3 (Linux)" || ((missing++))
+
+    # Check for PyYAML
+    if command -v python3 &>/dev/null; then
+        if ! python3 -c "import yaml" 2>/dev/null; then
+            echo -e "${RED}[ERROR]${NC} Missing Python package: ${YELLOW}PyYAML${NC}"
+            echo -e "        Install with: ${CYAN}pip3 install pyyaml${NC}"
+            ((missing++))
+        fi
+    fi
+
+    if [[ $missing -gt 0 ]]; then
+        echo ""
+        echo -e "${RED}Please install missing dependencies and try again.${NC}"
+        exit 1
+    fi
+
+    echo -e "${GREEN}All dependencies satisfied.${NC}"
+    echo ""
+}
+
+#######################################
+# Check for API key
+#######################################
+check_api_key() {
+    if [[ -z "${ANTHROPIC_API_KEY:-}" ]] && [[ -z "${OPENAI_API_KEY:-}" ]]; then
+        echo -e "${RED}[ERROR]${NC} No API key found."
+        echo ""
+        echo "Please set one of the following environment variables:"
+        echo -e "  ${CYAN}export ANTHROPIC_API_KEY=your-key-here${NC}  (preferred)"
+        echo -e "  ${CYAN}export OPENAI_API_KEY=your-key-here${NC}     (fallback)"
+        echo ""
+        echo "You can get an API key from:"
+        echo "  - Anthropic: https://console.anthropic.com/"
+        echo "  - OpenAI: https://platform.openai.com/"
+        exit 1
+    fi
+}
+
+#######################################
+# Main
+#######################################
+main() {
+    local repo_path="."
+    local dry_run=""
+    local skip_autoupdate=""
+    local debug=""
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            -h|--help)
+                usage
+                exit 0
+                ;;
+            -v|--version)
+                print_version
+                exit 0
+                ;;
+            --dry-run)
+                dry_run="true"
+                shift
+                ;;
+            --skip-autoupdate)
+                skip_autoupdate="true"
+                shift
+                ;;
+            --debug)
+                debug="true"
+                shift
+                ;;
+            -*)
+                echo -e "${RED}Unknown option: $1${NC}"
+                echo "Use --help for usage information."
+                exit 1
+                ;;
+            *)
+                repo_path="$1"
+                shift
+                ;;
+        esac
+    done
+
+    # Check dependencies first
+    check_dependencies
+
+    # Check for API key
+    check_api_key
+
+    # Set environment variables for the main script
+    [[ -n "$dry_run" ]] && export PRECOMMIT_DRY_RUN="true"
+    [[ -n "$skip_autoupdate" ]] && export PRECOMMIT_SKIP_AUTOUPDATE="true"
+    [[ -n "$debug" ]] && export DEBUG="true"
+
+    # Run the main setup script
+    exec "$PACKAGE_ROOT/setup-precommit.sh" "$repo_path"
+}
+
+main "$@"