configure-precommit 1.0.0

package/lib/builder.sh

@@ -0,0 +1,311 @@
+#!/usr/bin/env bash
+# Phase 3: Builder
+# Installs pre-commit and configures hooks
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Logging functions (can be overridden by main script)
+# 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
+}
+
+# Check if pre-commit is installed
+is_precommit_installed() {
+    command -v pre-commit &>/dev/null
+}
+
+# Check if agentform is installed
+is_agentform_installed() {
+    command -v agentform &>/dev/null
+}
+
+# Install agentform-cli
+install_agentform() {
+    if is_agentform_installed; then
+        log_info "agentform is already installed: $(command -v agentform)"
+        return 0
+    fi
+
+    log_info "Installing agentform-cli..."
+
+    # Try pipx first (preferred for CLI tools)
+    if command -v pipx &>/dev/null; then
+        log_info "Using pipx to install agentform-cli"
+        if pipx install agentform-cli 2>/dev/null; then
+            export PATH="$HOME/.local/bin:$PATH"
+            return 0
+        fi
+        log_warn "pipx install failed, trying pip..."
+    fi
+
+    # Try pip in the precommit venv if it exists
+    local venv_dir="${PRECOMMIT_VENV_DIR:-$HOME/.precommit-venv}"
+    if [[ -d "$venv_dir" ]]; then
+        log_info "Installing agentform-cli in existing venv"
+        if "$venv_dir/bin/pip" install agentform-cli 2>/dev/null; then
+            return 0
+        fi
+    fi
+
+    # Try pip3 --user
+    if command -v pip3 &>/dev/null; then
+        log_info "Using pip3 --user to install agentform-cli"
+        if pip3 install --user agentform-cli 2>/dev/null; then
+            export PATH="$HOME/.local/bin:$PATH"
+            return 0
+        fi
+    fi
+
+    log_warn "Could not install agentform-cli. Will use direct API calls as fallback."
+    return 1
+}
+
+# Create a virtual environment for pre-commit
+create_precommit_venv() {
+    local venv_dir="${PRECOMMIT_VENV_DIR:-$HOME/.precommit-venv}"
+
+    log_info "Creating virtual environment at $venv_dir..."
+
+    # Find Python 3
+    local python_cmd=""
+    if command -v python3 &>/dev/null; then
+        python_cmd="python3"
+    elif command -v python &>/dev/null; then
+        python_cmd="python"
+    else
+        log_error "Python not found"
+        return 1
+    fi
+
+    # Create venv
+    if ! $python_cmd -m venv "$venv_dir"; then
+        log_error "Failed to create virtual environment"
+        return 1
+    fi
+
+    # Install pre-commit in venv
+    if ! "$venv_dir/bin/pip" install pre-commit; then
+        log_error "Failed to install pre-commit in virtual environment"
+        return 1
+    fi
+
+    # Add to PATH for this session
+    export PATH="$venv_dir/bin:$PATH"
+
+    log_info "Virtual environment created successfully"
+    log_info "Add this to your shell profile: export PATH=\"$venv_dir/bin:\$PATH\""
+
+    return 0
+}
+
+# Install pre-commit using available package manager
+install_precommit() {
+    if is_precommit_installed; then
+        log_info "pre-commit is already installed: $(command -v pre-commit)"
+        return 0
+    fi
+
+    log_info "Installing pre-commit..."
+
+    # Try pipx first (preferred for CLI tools)
+    if command -v pipx &>/dev/null; then
+        log_info "Trying pipx..."
+        if pipx install pre-commit 2>/dev/null; then
+            log_info "Installed via pipx"
+            # pipx installs to ~/.local/bin
+            export PATH="$HOME/.local/bin:$PATH"
+            return 0
+        fi
+        log_warn "pipx install failed, trying next method..."
+    fi
+
+    # Try homebrew on macOS (before pip to avoid PEP 668 issues)
+    if command -v brew &>/dev/null; then
+        log_info "Trying Homebrew..."
+        if brew install pre-commit 2>/dev/null; then
+            log_info "Installed via Homebrew"
+            return 0
+        fi
+        log_warn "Homebrew install failed, trying next method..."
+    fi
+
+    # Try pip with --user flag (may fail on PEP 668 systems)
+    if command -v pip3 &>/dev/null; then
+        log_info "Trying pip3 --user..."
+        if pip3 install --user pre-commit 2>/dev/null; then
+            log_info "Installed via pip3"
+            export PATH="$HOME/.local/bin:$PATH"
+            return 0
+        fi
+        log_warn "pip3 install failed (likely PEP 668), trying next method..."
+    fi
+
+    # Try apt on Debian/Ubuntu
+    if command -v apt-get &>/dev/null; then
+        log_info "Trying apt..."
+        if sudo apt-get update && sudo apt-get install -y pre-commit 2>/dev/null; then
+            log_info "Installed via apt"
+            return 0
+        fi
+        log_warn "apt install failed, trying next method..."
+    fi
+
+    # Fallback: Create a virtual environment
+    log_info "Falling back to virtual environment..."
+    if create_precommit_venv; then
+        return 0
+    fi
+
+    log_error "Cannot install pre-commit. Please install it manually:"
+    log_error "  brew install pre-commit"
+    log_error "  OR: pipx install pre-commit"
+    log_error "  OR: pip install --user pre-commit (if not PEP 668 restricted)"
+    return 1
+}
+
+# Write the pre-commit config to file
+write_config() {
+    local config_content="$1"
+    local config_path="${2:-.pre-commit-config.yaml}"
+
+    echo "$config_content" > "$config_path"
+    log_info "Wrote configuration to $config_path"
+}
+
+# Update hook versions to latest
+update_versions() {
+    local skip_autoupdate="${PRECOMMIT_SKIP_AUTOUPDATE:-false}"
+
+    if [[ "$skip_autoupdate" == "true" ]]; then
+        log_warn "Skipping version auto-update (PRECOMMIT_SKIP_AUTOUPDATE=true)"
+        return 0
+    fi
+
+    log_info "Updating hook versions to latest..."
+
+    # Replace AUTOUPDATE placeholder with a valid placeholder first
+    # pre-commit autoupdate needs valid semver tags to work
+    if grep -q "rev: AUTOUPDATE" .pre-commit-config.yaml 2>/dev/null; then
+        # Use a recent known version as starting point
+        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
+    fi
+
+    if ! pre-commit autoupdate; then
+        log_warn "Some hooks failed to update. Continuing with available versions."
+    fi
+}
+
+# Install git hooks
+install_git_hooks() {
+    log_info "Installing git hooks..."
+
+    if ! pre-commit install; then
+        log_error "Failed to install git hooks"
+        return 1
+    fi
+
+    log_info "Git hooks installed successfully"
+}
+
+# Pre-fetch hook environments
+prefetch_hooks() {
+    log_info "Pre-fetching hook environments (this may take a moment)..."
+
+    if ! pre-commit install-hooks; then
+        log_warn "Some hooks failed to install. They will be installed on first run."
+    fi
+
+    log_info "Hook environments ready"
+}
+
+# Main builder function
+run_builder() {
+    local config_content="$1"
+    local repo_root="${2:-.}"
+    local dry_run="${PRECOMMIT_DRY_RUN:-false}"
+
+    cd "$repo_root"
+
+    # Write config
+    write_config "$config_content"
+
+    if [[ "$dry_run" == "true" ]]; then
+        log_warn "Dry run mode - skipping installation"
+        return 0
+    fi
+
+    # Install pre-commit if needed
+    if ! install_precommit; then
+        return 1
+    fi
+
+    # Ensure pre-commit is in PATH after installation
+    if ! is_precommit_installed; then
+        # Try to find it in common locations
+        local possible_paths=(
+            "$HOME/.local/bin/pre-commit"
+            "$HOME/.precommit-venv/bin/pre-commit"
+            "$HOME/Library/Python/3.*/bin/pre-commit"
+            "/usr/local/bin/pre-commit"
+            "/opt/homebrew/bin/pre-commit"
+        )
+        for path_pattern in "${possible_paths[@]}"; do
+            for path in $path_pattern; do
+                if [[ -x "$path" ]]; then
+                    local bin_dir
+                    bin_dir="$(dirname "$path")"
+                    export PATH="$bin_dir:$PATH"
+                    log_info "Added $bin_dir to PATH"
+                    break 2
+                fi
+            done
+        done
+    fi
+
+    # Verify installation
+    if ! is_precommit_installed; then
+        log_error "pre-commit installed but not found in PATH"
+        log_error "You may need to restart your shell or add ~/.local/bin to PATH"
+        return 1
+    fi
+
+    # Update versions
+    update_versions
+
+    # Install hooks
+    install_git_hooks
+
+    # Pre-fetch environments
+    prefetch_hooks
+
+    log_info "Builder phase complete"
+    return 0
+}
+
+# If run directly (not sourced)
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    if [[ $# -lt 1 ]]; then
+        echo "Usage: $0 <config-content> [repo-root]"
+        echo "  config-content: The YAML content for .pre-commit-config.yaml"
+        echo "  repo-root: Repository root directory (default: current directory)"
+        exit 1
+    fi
+    run_builder "$@"
+fi

package/lib/logging.sh

@@ -0,0 +1,201 @@
+#!/usr/bin/env bash
+# Logging utilities for pre-commit setup
+# Logs to both console and file
+
+# Initialize logging
+# Creates a timestamped log file in /tmp/precommit-setup/
+init_logging() {
+    local repo_name="${1:-unknown}"
+
+    # Create log directory
+    LOG_DIR="/tmp/precommit-setup"
+    mkdir -p "$LOG_DIR"
+
+    # Create timestamped log file
+    local timestamp
+    timestamp=$(date +"%Y%m%d_%H%M%S")
+    LOG_FILE="$LOG_DIR/${repo_name}_${timestamp}.log"
+
+    # Initialize log file with header
+    {
+        echo "=============================================="
+        echo "Pre-commit Setup Log"
+        echo "=============================================="
+        echo "Timestamp: $(date)"
+        echo "Repository: $repo_name"
+        echo "User: $(whoami)"
+        echo "Platform: $(uname -s)"
+        echo "=============================================="
+        echo ""
+    } > "$LOG_FILE"
+
+    export LOG_FILE
+    export LOG_DIR
+
+    echo "Logging to: $LOG_FILE" >&2
+}
+
+# Get timestamp for log entries
+_log_timestamp() {
+    date +"%Y-%m-%d %H:%M:%S"
+}
+
+# Core logging function
+_log() {
+    local level="$1"
+    local message="$2"
+    local timestamp
+    timestamp=$(_log_timestamp)
+
+    # Write to log file (without colors)
+    if [[ -n "${LOG_FILE:-}" ]]; then
+        echo "[$timestamp] [$level] $message" >> "$LOG_FILE"
+    fi
+}
+
+# Colors for console output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+# CYAN is available for future use
+# shellcheck disable=SC2034
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Logging functions with console colors and file output
+# All logs go to stderr to avoid polluting stdout (which is used for return values)
+log_info() {
+    local message="$1"
+    echo -e "${GREEN}[INFO]${NC} $message" >&2
+    _log "INFO" "$message"
+}
+
+log_warn() {
+    local message="$1"
+    echo -e "${YELLOW}[WARN]${NC} $message" >&2
+    _log "WARN" "$message"
+}
+
+log_error() {
+    local message="$1"
+    echo -e "${RED}[ERROR]${NC} $message" >&2
+    _log "ERROR" "$message"
+}
+
+log_debug() {
+    local message="$1"
+    if [[ "${DEBUG:-false}" == "true" ]]; then
+        echo -e "${BLUE}[DEBUG]${NC} $message" >&2
+    fi
+    _log "DEBUG" "$message"
+}
+
+log_phase() {
+    local phase_num="$1"
+    local phase_name="$2"
+
+    local separator="━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    echo "" >&2
+    echo -e "${BLUE}$separator${NC}" >&2
+    echo -e "${BLUE}  PHASE $phase_num: $phase_name${NC}" >&2
+    echo -e "${BLUE}$separator${NC}" >&2
+    echo "" >&2
+
+    _log "PHASE" "========== PHASE $phase_num: $phase_name =========="
+}
+
+# Log command execution with output capture
+log_cmd() {
+    local _description="$1"  # Used for documentation, kept for API compatibility
+    shift
+    local cmd="$*"
+
+    log_debug "Executing ($_description): $cmd"
+    _log "CMD" ">>> $cmd"
+
+    # Execute and capture output
+    local output
+    local exit_code
+    output=$("$@" 2>&1) || exit_code=$?
+    exit_code=${exit_code:-0}
+
+    # Log output to file
+    if [[ -n "${LOG_FILE:-}" ]] && [[ -n "$output" ]]; then
+        echo "$output" >> "$LOG_FILE"
+    fi
+
+    _log "CMD" "Exit code: $exit_code"
+
+    # Return output and exit code
+    echo "$output"
+    return "$exit_code"
+}
+
+# Log a section divider
+log_section() {
+    local title="$1"
+    _log "SECTION" "--- $title ---"
+    echo -e "${GREEN}[INFO]${NC} --- $title ---" >&2
+}
+
+# Log raw content (e.g., config files, API responses)
+log_content() {
+    local label="$1"
+    local content="$2"
+    local max_lines="${3:-50}"
+
+    _log "CONTENT" "=== $label (first $max_lines lines) ==="
+
+    if [[ -n "${LOG_FILE:-}" ]]; then
+        echo "$content" | head -n "$max_lines" >> "$LOG_FILE"
+        local total_lines
+        total_lines=$(echo "$content" | wc -l)
+        if [[ $total_lines -gt $max_lines ]]; then
+            echo "... ($total_lines total lines, truncated)" >> "$LOG_FILE"
+        fi
+    fi
+}
+
+# Get path to current log file
+get_log_file() {
+    echo "${LOG_FILE:-}"
+}
+
+# List recent log files
+list_recent_logs() {
+    local count="${1:-10}"
+    local log_dir="/tmp/precommit-setup"
+
+    if [[ -d "$log_dir" ]]; then
+        echo "Recent log files:" >&2
+        # shellcheck disable=SC2012
+        ls -lt "$log_dir"/*.log 2>/dev/null | head -n "$count" | while read -r line; do
+            echo "  $line" >&2
+        done
+    else
+        echo "No logs found in $log_dir" >&2
+    fi
+}
+
+# Finalize logging - add summary
+finalize_logging() {
+    local exit_code="${1:-0}"
+
+    if [[ -n "${LOG_FILE:-}" ]]; then
+        {
+            echo ""
+            echo "=============================================="
+            echo "Log completed at: $(date)"
+            echo "Exit code: $exit_code"
+            echo "=============================================="
+        } >> "$LOG_FILE"
+    fi
+
+    if [[ $exit_code -eq 0 ]]; then
+        log_info "Full log available at: $LOG_FILE"
+    else
+        log_error "Full log available at: $LOG_FILE"
+    fi
+}