@sugar-crash-studios/vibe-forge 0.4.0

package/bin/forge-setup.sh

@@ -0,0 +1,645 @@
+#!/usr/bin/env bash
+#
+# Vibe Forge - Setup Script
+# Initializes Vibe Forge for the current project
+#
+# Usage: ./forge-setup.sh [--non-interactive]
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FORGE_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# =============================================================================
+# Load Shared Libraries
+# =============================================================================
+
+# shellcheck source=lib/colors.sh
+source "$SCRIPT_DIR/lib/colors.sh"
+# shellcheck source=lib/constants.sh
+source "$SCRIPT_DIR/lib/constants.sh"
+# shellcheck source=lib/json.sh
+source "$SCRIPT_DIR/lib/json.sh"
+# shellcheck source=lib/util.sh
+source "$SCRIPT_DIR/lib/util.sh"
+
+# Parse arguments
+NON_INTERACTIVE=false
+if [[ "$1" == "--non-interactive" ]]; then
+    NON_INTERACTIVE=true
+fi
+
+echo ""
+log_header "🔥 Vibe Forge Setup"
+echo ""
+
+# =============================================================================
+# STEP 1: Detect Platform
+# =============================================================================
+
+detect_platform() {
+    case "$(uname -s)" in
+        MINGW*|MSYS*|CYGWIN*)
+            PLATFORM="windows"
+            ;;
+        Darwin)
+            PLATFORM="macos"
+            ;;
+        Linux)
+            PLATFORM="linux"
+            ;;
+        *)
+            PLATFORM="unknown"
+            ;;
+    esac
+
+    log_info "Platform detected: $PLATFORM"
+}
+
+# =============================================================================
+# STEP 2: Find Git Bash (Windows only)
+# =============================================================================
+
+find_git_bash() {
+    if [[ "$PLATFORM" != "windows" ]]; then
+        GIT_BASH_PATH=""
+        return 0
+    fi
+
+    echo ""
+    echo "Searching for Git Bash..."
+
+    GIT_BASH_PATH=""
+
+    # Common installation paths
+    local paths=(
+        "C:/Program Files/Git/bin/bash.exe"
+        "C:/Program Files (x86)/Git/bin/bash.exe"
+        "D:/Program Files/Git/bin/bash.exe"
+        "D:/applications/git/bin/bash.exe"
+        "$LOCALAPPDATA/Programs/Git/bin/bash.exe"
+        "$USERPROFILE/AppData/Local/Programs/Git/bin/bash.exe"
+    )
+
+    # Check common paths
+    for path in "${paths[@]}"; do
+        if [[ -f "$path" ]]; then
+            GIT_BASH_PATH="$path"
+            break
+        fi
+    done
+
+    # Try deriving from `where git`
+    if [[ -z "$GIT_BASH_PATH" ]]; then
+        local git_path
+        git_path=$(where git 2>/dev/null | head -1)
+        if [[ -n "$git_path" ]]; then
+            # Git is typically at .../Git/cmd/git.exe or .../Git/bin/git.exe
+            local git_dir
+            git_dir=$(dirname "$(dirname "$git_path")")
+            if [[ -f "$git_dir/bin/bash.exe" ]]; then
+                GIT_BASH_PATH="$git_dir/bin/bash.exe"
+            fi
+        fi
+    fi
+
+    if [[ -n "$GIT_BASH_PATH" ]]; then
+        log_success "Found Git Bash: $GIT_BASH_PATH"
+        return 0
+    else
+        log_error "Git Bash not found."
+        echo ""
+        echo "Git Bash is required for Claude Code on Windows."
+        echo ""
+        echo "Options:"
+        echo "  1. Install via winget:  winget install Git.Git"
+        echo "  2. Download from:       https://git-scm.com/downloads/win"
+        echo ""
+
+        if [[ "$NON_INTERACTIVE" == "false" ]]; then
+            read -p "Auto-install via winget? (y/n): " choice
+            if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
+                echo ""
+                echo "Installing Git..."
+                if winget install Git.Git; then
+                    echo ""
+                    log_success "Git installed. Please restart your terminal and run 'forge init' again."
+                    exit 0
+                else
+                    log_error "Installation failed. Please install Git manually."
+                    exit $EXIT_DEPENDENCY_MISSING
+                fi
+            fi
+        fi
+
+        echo "Please install Git and run 'forge init' again."
+        exit $EXIT_DEPENDENCY_MISSING
+    fi
+}
+
+# =============================================================================
+# STEP 3: Check Claude Code
+# =============================================================================
+
+check_claude() {
+    echo ""
+    echo "Checking Claude Code installation..."
+
+    if ! command -v claude &> /dev/null; then
+        log_error "Claude Code not found."
+        echo ""
+        echo "Claude Code CLI is required. Install from:"
+        echo "  https://claude.ai/download"
+        echo ""
+        exit $EXIT_DEPENDENCY_MISSING
+    fi
+
+    log_success "Claude Code found"
+}
+
+# =============================================================================
+# STEP 4: Create Config
+# =============================================================================
+
+create_config() {
+    echo ""
+    echo "Creating configuration..."
+
+    local config_dir="$FORGE_ROOT/.forge"
+    mkdir -p "$config_dir"
+
+    # Convert path for Windows compatibility
+    local git_bash_escaped="${GIT_BASH_PATH//\\/\\\\}"
+
+    cat > "$config_dir/config.json" << EOF
+{
+    "platform": "$PLATFORM",
+    "git_bash_path": "$git_bash_escaped",
+    "forge_root": "$FORGE_ROOT",
+    "initialized": "$(date -Iseconds)",
+    "validated": false
+}
+EOF
+
+    log_success "Config created: $config_dir/config.json"
+}
+
+# =============================================================================
+# STEP 5: Configure Version Control
+# =============================================================================
+
+configure_vcs() {
+    echo ""
+    echo "Version Control Configuration"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+
+    # Auto-detect VCS
+    local detected_vcs
+    detected_vcs=$(node "$SCRIPT_DIR/lib/vcs.js" detect 2>/dev/null)
+    local detected_type
+    detected_type=$(echo "$detected_vcs" | node -e "const d=require('fs').readFileSync(0,'utf8');try{console.log(JSON.parse(d).type)}catch{console.log('none')}")
+    local confidence
+    confidence=$(echo "$detected_vcs" | node -e "const d=require('fs').readFileSync(0,'utf8');try{console.log(JSON.parse(d).confidence)}catch{console.log('low')}")
+
+    if [[ "$detected_type" != "none" && "$confidence" != "low" ]]; then
+        log_info "Detected: $detected_type (confidence: $confidence)"
+    fi
+
+    echo ""
+    echo "Select your version control platform:"
+    echo ""
+    echo "  1. GitHub (recommended - uses gh CLI)"
+    echo "  2. GitLab"
+    echo "  3. Gitea (self-hosted - uses tea CLI)"
+    echo "  4. Azure DevOps"
+    echo "  5. Bitbucket"
+    echo "  6. Git only (no platform)"
+    echo "  7. None (no version control)"
+    echo ""
+
+    local vcs_choice="github"
+
+    if [[ "$NON_INTERACTIVE" == "false" ]]; then
+        # Set default based on detection
+        local default_choice="1"
+        case "$detected_type" in
+            github) default_choice="1" ;;
+            gitlab) default_choice="2" ;;
+            gitea) default_choice="3" ;;
+            azure-devops) default_choice="4" ;;
+            bitbucket) default_choice="5" ;;
+            git-only) default_choice="6" ;;
+            none) default_choice="7" ;;
+        esac
+
+        read -p "VCS Platform [$default_choice]: " choice
+        choice="${choice:-$default_choice}"
+
+        case "$choice" in
+            1) vcs_choice="github" ;;
+            2) vcs_choice="gitlab" ;;
+            3) vcs_choice="gitea" ;;
+            4) vcs_choice="azure-devops" ;;
+            5) vcs_choice="bitbucket" ;;
+            6) vcs_choice="git-only" ;;
+            7) vcs_choice="none" ;;
+            *) vcs_choice="github" ;;
+        esac
+    else
+        # Non-interactive: use detected or default to github
+        if [[ "$detected_type" != "none" ]]; then
+            vcs_choice="$detected_type"
+        fi
+    fi
+
+    # Initialize VCS folders and save config
+    local init_result
+    init_result=$(node "$SCRIPT_DIR/lib/vcs.js" init "$vcs_choice" "$FORGE_ROOT" 2>/dev/null)
+
+    echo ""
+    case "$vcs_choice" in
+        "github")
+            log_success "GitHub selected"
+            echo "   Branch workflow with PR via gh CLI"
+            echo "   Created: .github/workflows/"
+            ;;
+        "gitlab")
+            log_success "GitLab selected"
+            echo "   Branch workflow with merge requests"
+            echo "   Created: .gitlab/"
+            ;;
+        "gitea")
+            log_success "Gitea selected"
+            echo "   Branch workflow with PR via tea CLI"
+            echo "   Created: .gitea/workflows/"
+            ;;
+        "azure-devops")
+            log_success "Azure DevOps selected"
+            echo "   Branch workflow with PR via az CLI"
+            echo "   Created: .azure/"
+            ;;
+        "bitbucket")
+            log_success "Bitbucket selected"
+            echo "   Branch workflow with manual PRs"
+            ;;
+        "git-only")
+            log_info "Git only (no platform)"
+            echo "   Branch workflow without PR automation"
+            ;;
+        "none")
+            log_info "No version control"
+            echo "   Git workflow guidance will be skipped"
+            ;;
+    esac
+
+    # Save to forge config
+    VCS_TYPE="$vcs_choice"
+}
+
+# =============================================================================
+# STEP 6: Validate Setup
+# =============================================================================
+
+validate_setup() {
+    echo ""
+    echo "Validating setup..."
+
+    local test_cmd="claude --version"
+
+    if [[ "$PLATFORM" == "windows" && -n "$GIT_BASH_PATH" ]]; then
+        # On Windows, test with the git bash path set
+        export CLAUDE_CODE_GIT_BASH_PATH="$GIT_BASH_PATH"
+    fi
+
+    if $test_cmd &> /dev/null; then
+        log_success "Claude Code working"
+
+        # Update config to mark as validated
+        local config_file="$FORGE_ROOT/.forge/config.json"
+        if [[ -f "$config_file" ]]; then
+            json_write_bool "$config_file" "validated" true
+        fi
+
+        return 0
+    else
+        log_error "Claude Code validation failed"
+        return 1
+    fi
+}
+
+# =============================================================================
+# STEP 6: Configure Terminal
+# =============================================================================
+
+configure_terminal() {
+    echo ""
+    echo "Terminal Configuration"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Select your terminal for auto-spawning worker agents:"
+    echo ""
+    echo "  1. Windows Terminal (recommended - uses wt)"
+    echo "  2. Other / Manual (provides instructions)"
+    echo ""
+
+    local terminal_choice="manual"
+
+    if [[ "$NON_INTERACTIVE" == "false" ]]; then
+        read -p "Terminal [1/2]: " choice
+        case "$choice" in
+            1) terminal_choice="windows-terminal" ;;
+            *) terminal_choice="manual" ;;
+        esac
+    else
+        terminal_choice="manual"
+    fi
+
+    # Save to config
+    TERMINAL_TYPE="$terminal_choice"
+
+    # Update config with terminal type
+    local config_file="$FORGE_ROOT/.forge/config.json"
+    if [[ -f "$config_file" ]]; then
+        json_write "$config_file" "terminal_type" "$terminal_choice"
+    fi
+
+    echo ""
+    case "$terminal_choice" in
+        "windows-terminal")
+            log_success "Windows Terminal selected"
+            echo "   Workers will auto-spawn in new tabs via wt"
+            ;;
+        *)
+            log_info "Manual mode selected"
+            echo "   You'll receive instructions to start workers"
+            ;;
+    esac
+}
+
+# =============================================================================
+# STEP 7: Configure Daemon
+# =============================================================================
+
+configure_daemon() {
+    echo ""
+    echo "Daemon Configuration"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "The Forge daemon monitors task folders and routes work automatically."
+    echo "It runs in the background and keeps forge-state.yaml updated."
+    echo ""
+
+    local enable_daemon="y"
+
+    if [[ "$NON_INTERACTIVE" == "false" ]]; then
+        read -p "Enable daemon orchestration? (Y/n): " choice
+        if [[ "$choice" == "n" || "$choice" == "N" ]]; then
+            enable_daemon="n"
+        fi
+    fi
+
+    # Update config with daemon preference
+    local config_file="$FORGE_ROOT/.forge/config.json"
+    if [[ -f "$config_file" ]]; then
+        json_write_bool "$config_file" "daemon_enabled" "$( [[ "$enable_daemon" == "y" ]] && echo "true" || echo "false" )"
+    fi
+
+    if [[ "$enable_daemon" == "y" ]]; then
+        echo ""
+        log_success "Daemon enabled"
+        echo ""
+        echo "Starting daemon..."
+        "$SCRIPT_DIR/forge-daemon.sh" start
+    else
+        echo ""
+        log_info "Daemon disabled"
+        echo "   You can start it later with: forge daemon start"
+    fi
+}
+
+# =============================================================================
+# STEP 7b: Configure Worker Loop (Persistent Mode)
+# =============================================================================
+
+configure_worker_loop() {
+    echo ""
+    echo "Worker Loop Configuration"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Worker Loop keeps agents running continuously."
+    echo "When a worker finishes a task, it automatically checks for new work"
+    echo "instead of exiting. Great for longer coding sessions."
+    echo ""
+
+    local enable_worker_loop="n"
+
+    if [[ "$NON_INTERACTIVE" == "false" ]]; then
+        read -p "Enable persistent worker mode? (y/N): " choice
+        if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
+            enable_worker_loop="y"
+        fi
+    fi
+
+    # Update config with worker loop preference
+    local config_file="$FORGE_ROOT/.forge/config.json"
+    if [[ -f "$config_file" ]]; then
+        json_write_bool "$config_file" "worker_loop_enabled" "$( [[ "$enable_worker_loop" == "y" ]] && echo "true" || echo "false" )"
+    fi
+
+    if [[ "$enable_worker_loop" == "y" ]]; then
+        echo ""
+        log_success "Worker Loop enabled"
+        echo "   Workers will keep running and check for new tasks"
+    else
+        echo ""
+        log_info "Worker Loop disabled"
+        echo "   Workers will exit after completing their tasks"
+        echo "   Enable later with: forge config worker-loop on"
+    fi
+}
+
+# =============================================================================
+# STEP 8: Install Slash Command
+# =============================================================================
+
+install_slash_command() {
+    echo ""
+    echo "Installing /forge slash command..."
+
+    # Parent project directory (one level up from _vibe-forge)
+    local parent_dir
+    parent_dir="$(dirname "$FORGE_ROOT")"
+
+    local target_dir="$parent_dir/.claude/commands"
+    local source_file="$FORGE_ROOT/.claude/commands/forge.md"
+
+    # Create .claude/commands in parent project if it doesn't exist
+    mkdir -p "$target_dir"
+
+    # Copy the forge command
+    if [[ -f "$source_file" ]]; then
+        cp "$source_file" "$target_dir/forge.md"
+        log_success "Slash command installed: $target_dir/forge.md"
+        echo "   Use /forge in Claude Code to access Vibe Forge"
+    else
+        log_warn "Could not find forge command template"
+        echo "   You may need to manually copy .claude/commands/forge.md"
+    fi
+}
+
+# =============================================================================
+# STEP 9: Create Project Context
+# =============================================================================
+
+detect_project_info() {
+    # Try to detect project name
+    PROJECT_NAME=$(basename "$PWD")
+
+    # Try to detect tech stack
+    TECH_STACK=""
+
+    if [[ -f "package.json" ]]; then
+        TECH_STACK="Node.js"
+        # Check for framework hints
+        if grep -q '"react"' package.json 2>/dev/null; then
+            TECH_STACK="React"
+        elif grep -q '"vue"' package.json 2>/dev/null; then
+            TECH_STACK="Vue"
+        elif grep -q '"next"' package.json 2>/dev/null; then
+            TECH_STACK="Next.js"
+        elif grep -q '"svelte"' package.json 2>/dev/null; then
+            TECH_STACK="Svelte"
+        fi
+    elif [[ -f "Cargo.toml" ]]; then
+        TECH_STACK="Rust"
+    elif [[ -f "go.mod" ]]; then
+        TECH_STACK="Go"
+    elif [[ -f "requirements.txt" ]] || [[ -f "pyproject.toml" ]]; then
+        TECH_STACK="Python"
+    elif [[ -f "pom.xml" ]] || [[ -f "build.gradle" ]]; then
+        TECH_STACK="Java"
+    elif [[ -f "*.csproj" ]] || [[ -f "*.sln" ]]; then
+        TECH_STACK="C#/.NET"
+    fi
+}
+
+create_project_context() {
+    echo ""
+    echo "Project Context Setup"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    detect_project_info
+
+    local context_dir="$PWD/context"
+    local context_file="$context_dir/project-context.md"
+    local template_file="$FORGE_ROOT/context/project-context-template.md"
+
+    mkdir -p "$context_dir"
+
+    # Check if context already exists
+    if [[ -f "$context_file" ]]; then
+        log_info "Project context already exists"
+        echo "   $context_file"
+        return 0
+    fi
+
+    echo ""
+    log_info "Detected project: $PROJECT_NAME"
+    if [[ -n "$TECH_STACK" ]]; then
+        log_info "Detected stack: $TECH_STACK"
+    fi
+    echo ""
+
+    if [[ "$NON_INTERACTIVE" == "false" ]]; then
+        # Ask for project description
+        read -p "Brief project description (or Enter to skip): " PROJECT_DESC
+    fi
+
+    # Create project context from template or generate minimal one
+    if [[ -f "$template_file" ]]; then
+        cp "$template_file" "$context_file"
+
+        # Replace placeholders using cross-platform sed
+        sed_inplace "s/\[Project Name\]/$PROJECT_NAME/g" "$context_file"
+        sed_inplace "s/\[Your Name\]/Developer/g" "$context_file"
+
+        if [[ -n "$TECH_STACK" ]]; then
+            sed_inplace "s/\[e.g., React, Node.js, PostgreSQL\]/$TECH_STACK/g" "$context_file"
+        fi
+
+        if [[ -n "$PROJECT_DESC" ]]; then
+            sed_inplace "s/\[Brief description of the project\]/$PROJECT_DESC/g" "$context_file"
+        fi
+    else
+        # Generate minimal context
+        cat > "$context_file" << EOF
+# Project Context
+
+## Project: $PROJECT_NAME
+
+${PROJECT_DESC:-A software project managed with Vibe Forge.}
+
+## Tech Stack
+${TECH_STACK:-To be determined}
+
+## Key Patterns
+- Follow existing code conventions
+- Write tests for new features
+- Document public APIs
+
+## Notes
+Edit this file to add project-specific context for the AI agents.
+EOF
+    fi
+
+    log_success "Project context created: $context_file"
+    echo "   Edit this file to add more project details."
+}
+
+# =============================================================================
+# STEP 10: Setup Complete
+# =============================================================================
+
+setup_complete() {
+    echo ""
+    log_header "🔥 Vibe Forge initialized!"
+    echo ""
+    echo "Ready to start! Open Claude Code in this project and run:"
+    echo ""
+    log_info "/forge              Start the Planning Hub"
+    log_info "/forge status       Show status dashboard"
+    log_info "/forge spawn anvil  Spawn a worker agent"
+    log_info "/forge help         See all commands"
+    echo ""
+    echo "Optional: Edit context/project-context.md to add more details."
+    echo ""
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+main() {
+    detect_platform
+    find_git_bash
+    check_claude
+    create_config
+    configure_vcs
+
+    if validate_setup; then
+        configure_terminal
+        configure_daemon
+        configure_worker_loop
+        install_slash_command
+        create_project_context
+        setup_complete
+    else
+        echo ""
+        log_error "Setup incomplete. Please check the errors above."
+        exit $EXIT_CONFIG_ERROR
+    fi
+}
+
+main "$@"