vibe-forge 0.1.0

package/bin/forge-setup.sh

@@ -0,0 +1,458 @@
+#!/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")"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Parse arguments
+NON_INTERACTIVE=false
+if [[ "$1" == "--non-interactive" ]]; then
+    NON_INTERACTIVE=true
+fi
+
+echo ""
+echo -e "${YELLOW}🔥 Vibe Forge Setup${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+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
+
+    echo -e "Platform detected: ${BLUE}$PLATFORM${NC}"
+}
+
+# =============================================================================
+# 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
+        echo -e "${GREEN}✅ Found Git Bash:${NC} $GIT_BASH_PATH"
+        return 0
+    else
+        echo -e "${RED}❌ Git Bash not found.${NC}"
+        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 ""
+                    echo -e "${GREEN}Git installed.${NC} Please restart your terminal and run 'forge init' again."
+                    exit 0
+                else
+                    echo -e "${RED}Installation failed.${NC} Please install Git manually."
+                    exit 1
+                fi
+            fi
+        fi
+
+        echo "Please install Git and run 'forge init' again."
+        exit 1
+    fi
+}
+
+# =============================================================================
+# STEP 3: Check Claude Code
+# =============================================================================
+
+check_claude() {
+    echo ""
+    echo "Checking Claude Code installation..."
+
+    if ! command -v claude &> /dev/null; then
+        echo -e "${RED}❌ Claude Code not found.${NC}"
+        echo ""
+        echo "Claude Code CLI is required. Install from:"
+        echo "  https://claude.ai/download"
+        echo ""
+        exit 1
+    fi
+
+    echo -e "${GREEN}✅ Claude Code found${NC}"
+}
+
+# =============================================================================
+# 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
+
+    echo -e "${GREEN}✅ Config created:${NC} $config_dir/config.json"
+}
+
+# =============================================================================
+# STEP 5: 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
+        echo -e "${GREEN}✅ Claude Code working${NC}"
+
+        # Update config to mark as validated
+        local config_file="$FORGE_ROOT/.forge/config.json"
+        if [[ -f "$config_file" ]]; then
+            # Simple sed replacement for validated field
+            sed -i 's/"validated": false/"validated": true/' "$config_file" 2>/dev/null || true
+        fi
+
+        return 0
+    else
+        echo -e "${RED}❌ Claude Code validation failed${NC}"
+        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
+        # Add terminal_type to config (insert before closing brace)
+        sed -i 's/}$/,\n    "terminal_type": "'"$terminal_choice"'"\n}/' "$config_file" 2>/dev/null || true
+    fi
+
+    echo ""
+    case "$terminal_choice" in
+        "windows-terminal")
+            echo -e "${GREEN}✅ Windows Terminal selected${NC}"
+            echo "   Workers will auto-spawn in new tabs via wt"
+            ;;
+        *)
+            echo -e "${YELLOW}ℹ️  Manual mode selected${NC}"
+            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
+        # Add daemon_enabled to config
+        sed -i 's/"validated": true/"validated": true,\n    "daemon_enabled": '"$( [[ "$enable_daemon" == "y" ]] && echo "true" || echo "false" )"'/' "$config_file" 2>/dev/null || true
+    fi
+
+    if [[ "$enable_daemon" == "y" ]]; then
+        echo ""
+        echo -e "${GREEN}✅ Daemon enabled${NC}"
+        echo ""
+        echo "Starting daemon..."
+        "$SCRIPT_DIR/forge-daemon.sh" start
+    else
+        echo ""
+        echo -e "${YELLOW}ℹ️  Daemon disabled${NC}"
+        echo "   You can start it later with: forge daemon start"
+    fi
+}
+
+# =============================================================================
+# STEP 8: 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
+        echo -e "${YELLOW}ℹ️  Project context already exists${NC}"
+        echo "   $context_file"
+        return 0
+    fi
+
+    echo ""
+    echo -e "Detected project: ${BLUE}$PROJECT_NAME${NC}"
+    if [[ -n "$TECH_STACK" ]]; then
+        echo -e "Detected stack:   ${BLUE}$TECH_STACK${NC}"
+    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
+        sed -i "s/\[Project Name\]/$PROJECT_NAME/g" "$context_file" 2>/dev/null || true
+        sed -i "s/\[Your Name\]/Developer/g" "$context_file" 2>/dev/null || true
+
+        if [[ -n "$TECH_STACK" ]]; then
+            sed -i "s/\[e.g., React, Node.js, PostgreSQL\]/$TECH_STACK/g" "$context_file" 2>/dev/null || true
+        fi
+
+        if [[ -n "$PROJECT_DESC" ]]; then
+            sed -i "s/\[Brief description of the project\]/$PROJECT_DESC/g" "$context_file" 2>/dev/null || true
+        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
+
+    echo -e "${GREEN}✅ Project context created:${NC} $context_file"
+    echo "   Edit this file to add more project details."
+}
+
+# =============================================================================
+# STEP 9: Setup Complete
+# =============================================================================
+
+setup_complete() {
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${GREEN}🔥 Vibe Forge initialized!${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Ready to start! Run:"
+    echo ""
+    echo -e "  ${BLUE}forge${NC}              Start the Planning Hub"
+    echo -e "  ${BLUE}forge status${NC}       Check forge status"
+    echo -e "  ${BLUE}forge help${NC}         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
+
+    if validate_setup; then
+        configure_terminal
+        configure_daemon
+        create_project_context
+        setup_complete
+    else
+        echo ""
+        echo -e "${RED}Setup incomplete.${NC} Please check the errors above."
+        exit 1
+    fi
+}
+
+main "$@"

package/bin/forge-spawn.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+#
+# Vibe Forge - Agent Spawner
+# Spawns worker agents in new terminal windows/tabs based on configured terminal type
+#
+# Usage: forge-spawn.sh <agent-name>
+#
+# Supports:
+#   - Windows Terminal (wt new-tab)
+#   - Manual (prints instructions)
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FORGE_ROOT="$(dirname "$SCRIPT_DIR")"
+CONFIG_FILE="$FORGE_ROOT/.forge/config.json"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# =============================================================================
+# Load Configuration
+# =============================================================================
+
+load_config() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        echo -e "${RED}Error: Vibe Forge not initialized.${NC}"
+        echo "Run 'forge init' first."
+        exit 1
+    fi
+
+    PLATFORM=$(grep -o '"platform": *"[^"]*"' "$CONFIG_FILE" | cut -d'"' -f4)
+    TERMINAL_TYPE=$(grep -o '"terminal_type": *"[^"]*"' "$CONFIG_FILE" | cut -d'"' -f4)
+    GIT_BASH_PATH=$(grep -o '"git_bash_path": *"[^"]*"' "$CONFIG_FILE" | cut -d'"' -f4)
+
+    # Default to manual if not set
+    if [[ -z "$TERMINAL_TYPE" ]]; then
+        TERMINAL_TYPE="manual"
+    fi
+}
+
+# =============================================================================
+# Spawn Functions
+# =============================================================================
+
+spawn_windows_terminal() {
+    local agent="$1"
+
+    echo -e "${BLUE}Spawning $agent in Windows Terminal...${NC}"
+
+    if command -v wt &> /dev/null || command -v wt.exe &> /dev/null; then
+        # Windows Terminal: open new tab with forge command
+        # Use Git Bash if available, otherwise use bash
+        if [[ -n "$GIT_BASH_PATH" ]]; then
+            local bash_path="${GIT_BASH_PATH//\//\\}"
+            wt.exe new-tab --title "$agent" "$bash_path" -c "cd '$FORGE_ROOT' && ./bin/forge.sh start $agent"
+        else
+            wt.exe new-tab --title "$agent" bash -c "cd '$FORGE_ROOT' && ./bin/forge.sh start $agent"
+        fi
+        echo -e "${GREEN}✅ $agent spawned in new Windows Terminal tab${NC}"
+    else
+        echo -e "${RED}Error: wt command not found.${NC}"
+        echo "Make sure Windows Terminal is installed."
+        echo ""
+        echo "Manual fallback:"
+        print_manual_instructions "$agent"
+        exit 1
+    fi
+}
+
+print_manual_instructions() {
+    local agent="$1"
+
+    echo ""
+    echo -e "${YELLOW}To start $agent manually:${NC}"
+    echo ""
+    echo "  1. Open a new terminal window/tab"
+    echo "  2. Navigate to: $FORGE_ROOT"
+    echo "  3. Run: ./bin/forge.sh start $agent"
+    echo ""
+    echo "Or copy this command:"
+    echo ""
+    echo "  cd '$FORGE_ROOT' && ./bin/forge.sh start $agent"
+    echo ""
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+main() {
+    local agent="${1:-}"
+
+    if [[ -z "$agent" ]]; then
+        echo -e "${RED}Error: No agent specified.${NC}"
+        echo ""
+        echo "Usage: forge-spawn.sh <agent-name>"
+        echo ""
+        echo "Available agents:"
+        echo "  anvil     - Frontend Developer"
+        echo "  furnace   - Backend Developer"
+        echo "  crucible  - Tester / QA"
+        echo "  sentinel  - Code Reviewer"
+        echo "  scribe    - Documentation"
+        echo "  herald    - Release Manager"
+        echo "  ember     - DevOps"
+        echo "  aegis     - Security"
+        exit 1
+    fi
+
+    load_config
+
+    echo ""
+    echo -e "${YELLOW}🔥 Forge Spawn: $agent${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    case "$TERMINAL_TYPE" in
+        "windows-terminal")
+            spawn_windows_terminal "$agent"
+            ;;
+        *)
+            print_manual_instructions "$agent"
+            ;;
+    esac
+}
+
+main "$@"

package/bin/forge.cmd

@@ -0,0 +1,83 @@
+@echo off
+REM Vibe Forge - Windows Launcher
+REM Wraps forge.sh for Windows compatibility
+
+setlocal EnableDelayedExpansion
+
+set "SCRIPT_DIR=%~dp0"
+set "FORGE_ROOT=%SCRIPT_DIR%.."
+set "CONFIG_FILE=%FORGE_ROOT%\.forge\config.json"
+
+REM Check if this is init or help (doesn't require config)
+set "CMD=%~1"
+if "%CMD%"=="init" goto :find_bash
+if "%CMD%"=="help" goto :find_bash
+if "%CMD%"=="--help" goto :find_bash
+if "%CMD%"=="-h" goto :find_bash
+
+REM For other commands, check if initialized
+if not exist "%CONFIG_FILE%" (
+    echo Error: Vibe Forge not initialized.
+    echo Run 'forge init' first.
+    exit /b 1
+)
+
+REM Extract git_bash_path from config using PowerShell for reliable JSON parsing
+for /f "usebackq delims=" %%a in (`powershell -NoProfile -Command "(Get-Content '%CONFIG_FILE%' | ConvertFrom-Json).git_bash_path"`) do (
+    set "GIT_BASH_PATH=%%a"
+)
+
+REM Convert forward slashes to backslashes if needed
+set "GIT_BASH_PATH=!GIT_BASH_PATH:/=\!"
+
+REM Verify the path exists
+if not exist "!GIT_BASH_PATH!" (
+    echo Error: Git Bash not found at: !GIT_BASH_PATH!
+    echo Please run 'forge init' again.
+    exit /b 1
+)
+
+goto :run_forge
+
+:find_bash
+REM Find Git Bash for init/help commands
+set "GIT_BASH_PATH="
+
+REM Check common paths
+if exist "C:\Program Files\Git\bin\bash.exe" (
+    set "GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe"
+    goto :run_forge
+)
+if exist "C:\Program Files (x86)\Git\bin\bash.exe" (
+    set "GIT_BASH_PATH=C:\Program Files (x86)\Git\bin\bash.exe"
+    goto :run_forge
+)
+if exist "D:\Program Files\Git\bin\bash.exe" (
+    set "GIT_BASH_PATH=D:\Program Files\Git\bin\bash.exe"
+    goto :run_forge
+)
+if exist "D:\applications\git\bin\bash.exe" (
+    set "GIT_BASH_PATH=D:\applications\git\bin\bash.exe"
+    goto :run_forge
+)
+
+REM Try to find via where command
+for /f "tokens=*" %%i in ('where git 2^>nul') do (
+    set "GIT_PATH=%%~dpi"
+    set "GIT_BASH_PATH=!GIT_PATH!..\bin\bash.exe"
+    if exist "!GIT_BASH_PATH!" goto :run_forge
+)
+
+REM Still not found
+echo Error: Git Bash not found.
+echo Please install Git from https://git-scm.com/downloads/win
+exit /b 1
+
+:run_forge
+REM Set environment variable for Claude Code
+set "CLAUDE_CODE_GIT_BASH_PATH=%GIT_BASH_PATH%"
+
+REM Run the bash script with all arguments
+"%GIT_BASH_PATH%" "%SCRIPT_DIR%forge.sh" %*
+
+endlocal