vibe-forge 0.4.0 → 0.8.1

package/bin/forge-setup.sh

@@ -1,645 +1,661 @@
-#!/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 "$@"
+#!/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..."
+        if ! "$SCRIPT_DIR/forge-daemon.sh" start; then
+            log_warn "Daemon failed to start (sqlite3 may be missing)"
+            echo "   You can install sqlite3 and start it later with: forge daemon start"
+        fi
+    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"
+    mkdir -p "$context_dir/agent-overrides"
+
+    # Create architecture.md if missing
+    if [[ ! -f "$context_dir/architecture.md" ]] && [[ -f "$FORGE_ROOT/context/architecture.md" ]]; then
+        cp "$FORGE_ROOT/context/architecture.md" "$context_dir/architecture.md"
+    fi
+
+    # Create agent-overrides README if missing
+    if [[ ! -f "$context_dir/agent-overrides/README.md" ]] && [[ -f "$FORGE_ROOT/context/agent-overrides/README.md" ]]; then
+        cp "$FORGE_ROOT/context/agent-overrides/README.md" "$context_dir/agent-overrides/README.md"
+    fi
+
+    # 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 project details."
+    echo "         Edit context/architecture.md for architectural guardrails."
+    echo "         Add files to context/agent-overrides/ for per-agent rules."
+    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 "$@"