mcp-rubber-duck 1.1.0

package/scripts/deploy.sh

@@ -0,0 +1,322 @@
+#!/bin/bash
+
+# MCP Rubber Duck - Universal Deployment Script
+# Works on macOS, Linux, Windows (WSL), and Raspberry Pi
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+DEPLOYMENT_MODE="${DEPLOYMENT_MODE:-auto}"
+PLATFORM="${PLATFORM:-auto}"
+
+# Functions
+log() {
+    echo -e "${GREEN}[$(date +'%Y-%m-%d %H:%M:%S')] $1${NC}"
+}
+
+warn() {
+    echo -e "${YELLOW}[$(date +'%Y-%m-%d %H:%M:%S')] WARNING: $1${NC}"
+}
+
+error() {
+    echo -e "${RED}[$(date +'%Y-%m-%d %H:%M:%S')] ERROR: $1${NC}"
+    exit 1
+}
+
+info() {
+    echo -e "${BLUE}[$(date +'%Y-%m-%d %H:%M:%S')] INFO: $1${NC}"
+}
+
+print_usage() {
+    cat << EOF
+Usage: $0 [OPTIONS]
+
+Universal deployment script for MCP Rubber Duck
+Works on: macOS, Linux, Windows (WSL), Raspberry Pi
+
+OPTIONS:
+    -m, --mode MODE         Deployment mode: local, docker, ssh
+    -p, --platform PLATFORM Target platform: pi, desktop, auto
+    --profile PROFILE       Docker compose profile: lightweight, desktop, with-ollama
+    --ssh-host HOST         SSH host for remote deployment
+    --dry-run               Show what would be done
+    -h, --help              Show this help message
+
+DEPLOYMENT MODES:
+    local       - Run from source code (npm start)
+    docker      - Use Docker containers (recommended)
+    ssh         - Deploy via SSH to remote host
+
+PLATFORMS:
+    pi          - Raspberry Pi (optimized for low memory)
+    desktop     - Desktop/server (higher resource limits)
+    auto        - Auto-detect platform
+
+EXAMPLES:
+    # Auto-detect platform and deploy with Docker
+    $0
+    
+    # Deploy to Raspberry Pi with lightweight profile
+    $0 --platform pi --profile lightweight
+    
+    # Deploy to desktop with Ollama support
+    $0 --platform desktop --profile with-ollama
+    
+    # Deploy to remote Raspberry Pi via SSH
+    $0 --mode ssh --ssh-host pi@192.168.1.100
+
+EOF
+}
+
+# Detect platform
+detect_platform() {
+    if [[ "$PLATFORM" != "auto" ]]; then
+        echo "$PLATFORM"
+        return
+    fi
+    
+    # Check system info
+    local arch=$(uname -m)
+    local system=$(uname -s)
+    local mem_kb=$(grep MemTotal /proc/meminfo 2>/dev/null | awk '{print $2}' || echo "8000000")
+    local mem_gb=$((mem_kb / 1024 / 1024))
+    
+    # Raspberry Pi detection
+    if [[ -f /proc/device-tree/model ]] && grep -q "Raspberry Pi" /proc/device-tree/model 2>/dev/null; then
+        echo "pi"
+        return
+    fi
+    
+    # Low memory systems (< 2GB)
+    if [[ $mem_gb -lt 2 ]]; then
+        echo "pi"
+        return
+    fi
+    
+    echo "desktop"
+}
+
+# Create environment file based on platform
+create_env_file() {
+    local platform=$1
+    local env_file=".env"
+    
+    if [[ -f "$env_file" ]]; then
+        info "Using existing $env_file file"
+        return
+    fi
+    
+    log "Creating environment file for $platform platform..."
+    
+    if [[ "$platform" == "pi" ]]; then
+        cp .env.pi.example "$env_file" 2>/dev/null || cp .env.template "$env_file"
+    else
+        cp .env.desktop.example "$env_file" 2>/dev/null || cp .env.template "$env_file"
+    fi
+    
+    warn "Please edit $env_file and add your API keys"
+}
+
+# Deploy with Docker
+deploy_docker() {
+    local platform=$1
+    local profile=${COMPOSE_PROFILE:-}
+    
+    log "Deploying with Docker for $platform platform..."
+    
+    # Set platform-specific defaults
+    if [[ "$platform" == "pi" ]]; then
+        export DOCKER_CPU_LIMIT="${DOCKER_CPU_LIMIT:-1.5}"
+        export DOCKER_MEMORY_LIMIT="${DOCKER_MEMORY_LIMIT:-512M}"
+        export DOCKER_MEMORY_RESERVATION="${DOCKER_MEMORY_RESERVATION:-256M}"
+        export NODE_OPTIONS="${NODE_OPTIONS:---max-old-space-size=256}"
+        profile="${profile:-lightweight}"
+    else
+        export DOCKER_CPU_LIMIT="${DOCKER_CPU_LIMIT:-4.0}"
+        export DOCKER_MEMORY_LIMIT="${DOCKER_MEMORY_LIMIT:-2G}"
+        export DOCKER_MEMORY_RESERVATION="${DOCKER_MEMORY_RESERVATION:-1G}"
+        export NODE_OPTIONS="${NODE_OPTIONS:---max-old-space-size=1024}"
+        profile="${profile:-desktop}"
+    fi
+    
+    # Create environment file
+    create_env_file "$platform"
+    
+    # Docker commands
+    local compose_cmd="docker compose"
+    if [[ -n "$profile" && "$profile" != "default" ]]; then
+        compose_cmd="$compose_cmd --profile $profile"
+    fi
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Would run:"
+        info "  $compose_cmd pull"
+        info "  $compose_cmd up -d"
+        return
+    fi
+    
+    # Pull and start
+    log "Pulling Docker images..."
+    $compose_cmd pull
+    
+    log "Starting containers..."
+    $compose_cmd up -d
+    
+    # Show status
+    log "Checking container status..."
+    docker ps --filter name=mcp-rubber-duck
+    
+    log "✅ Deployment completed!"
+    info "Check logs with: docker logs mcp-rubber-duck"
+    info "Stop with: $compose_cmd down"
+}
+
+# Deploy via SSH
+deploy_ssh() {
+    local ssh_host=$1
+    
+    if [[ -z "$ssh_host" ]]; then
+        error "SSH host not specified. Use --ssh-host option."
+    fi
+    
+    log "Deploying to remote host: $ssh_host"
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Would deploy to $ssh_host"
+        return
+    fi
+    
+    # Copy files to remote host
+    log "Copying files to remote host..."
+    ssh "$ssh_host" "mkdir -p ~/mcp-rubber-duck"
+    scp docker-compose.yml "$ssh_host:~/mcp-rubber-duck/"
+    scp .env.template "$ssh_host:~/mcp-rubber-duck/"
+    scp scripts/deploy.sh "$ssh_host:~/mcp-rubber-duck/"
+    
+    # Run deployment on remote host
+    log "Running deployment on remote host..."
+    ssh "$ssh_host" "cd ~/mcp-rubber-duck && bash deploy.sh --mode docker --platform pi"
+    
+    log "✅ Remote deployment completed!"
+}
+
+# Deploy from source
+deploy_local() {
+    local platform=$1
+    
+    log "Deploying from source for $platform platform..."
+    
+    # Check prerequisites
+    if ! command -v node &> /dev/null; then
+        error "Node.js is not installed"
+    fi
+    
+    if ! command -v npm &> /dev/null; then
+        error "npm is not installed"
+    fi
+    
+    # Set platform-specific environment
+    create_env_file "$platform"
+    
+    if [[ "$platform" == "pi" ]]; then
+        export NODE_OPTIONS="${NODE_OPTIONS:---max-old-space-size=256}"
+    else
+        export NODE_OPTIONS="${NODE_OPTIONS:---max-old-space-size=1024}"
+    fi
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Would run:"
+        info "  npm install"
+        info "  npm run build"
+        info "  npm start"
+        return
+    fi
+    
+    # Build and run
+    log "Installing dependencies..."
+    npm install
+    
+    log "Building project..."
+    npm run build
+    
+    log "Starting MCP server..."
+    info "MCP Rubber Duck is now running from source"
+    npm start
+}
+
+# Parse command line arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -m|--mode)
+            DEPLOYMENT_MODE="$2"
+            shift 2
+            ;;
+        -p|--platform)
+            PLATFORM="$2"
+            shift 2
+            ;;
+        --profile)
+            COMPOSE_PROFILE="$2"
+            shift 2
+            ;;
+        --ssh-host)
+            SSH_HOST="$2"
+            shift 2
+            ;;
+        --dry-run)
+            DRY_RUN="true"
+            shift
+            ;;
+        -h|--help)
+            print_usage
+            exit 0
+            ;;
+        *)
+            error "Unknown option: $1"
+            ;;
+    esac
+done
+
+# Main execution
+log "🦆 Starting MCP Rubber Duck deployment"
+
+# Detect platform
+DETECTED_PLATFORM=$(detect_platform)
+log "Platform: $DETECTED_PLATFORM"
+
+# Auto-detect deployment mode if needed
+if [[ "$DEPLOYMENT_MODE" == "auto" ]]; then
+    if command -v docker &> /dev/null; then
+        DEPLOYMENT_MODE="docker"
+    else
+        DEPLOYMENT_MODE="local"
+    fi
+fi
+
+info "Deployment mode: $DEPLOYMENT_MODE"
+info "Target platform: $DETECTED_PLATFORM"
+
+# Deploy based on mode
+case $DEPLOYMENT_MODE in
+    docker)
+        deploy_docker "$DETECTED_PLATFORM"
+        ;;
+    ssh)
+        deploy_ssh "${SSH_HOST:-}"
+        ;;
+    local)
+        deploy_local "$DETECTED_PLATFORM"
+        ;;
+    *)
+        error "Unknown deployment mode: $DEPLOYMENT_MODE"
+        ;;
+esac
+
+log "🎉 Deployment completed successfully!"

package/scripts/gh-deploy.sh

@@ -0,0 +1,343 @@
+#!/bin/bash
+
+# MCP Rubber Duck - GitHub Container Registry Deployment Script
+# This script simplifies deployment using GitHub CLI and GitHub Container Registry
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+IMAGE_TAG="${IMAGE_TAG:-latest}"
+MAKE_PUBLIC="${MAKE_PUBLIC:-false}"
+BUILD_PLATFORMS="${BUILD_PLATFORMS:-linux/amd64,linux/arm64,linux/arm/v7}"
+
+# Functions
+log() {
+    echo -e "${GREEN}[$(date +'%Y-%m-%d %H:%M:%S')] $1${NC}"
+}
+
+warn() {
+    echo -e "${YELLOW}[$(date +'%Y-%m-%d %H:%M:%S')] WARNING: $1${NC}"
+}
+
+error() {
+    echo -e "${RED}[$(date +'%Y-%m-%d %H:%M:%S')] ERROR: $1${NC}"
+    exit 1
+}
+
+info() {
+    echo -e "${BLUE}[$(date +'%Y-%m-%d %H:%M:%S')] INFO: $1${NC}"
+}
+
+print_usage() {
+    cat << EOF
+Usage: $0 [OPTIONS]
+
+Deploy MCP Rubber Duck to GitHub Container Registry using GitHub CLI
+
+OPTIONS:
+    -t, --tag TAG           Docker image tag (default: latest)
+    --public                Make package public after push
+    --platforms PLATFORMS   Target platforms (default: linux/amd64,linux/arm64,linux/arm/v7)
+    --local-only            Build for local architecture only (faster testing)
+    --dry-run              Show what would be done without executing
+    -v, --verbose          Verbose output
+    -h, --help             Show this help message
+
+EXAMPLES:
+    # Deploy latest version to GitHub Container Registry
+    $0
+    
+    # Deploy with specific tag
+    $0 --tag v1.2.0
+    
+    # Deploy and make package public
+    $0 --public
+    
+    # Local development build
+    $0 --local-only --tag dev
+    
+    # See what would happen
+    $0 --dry-run
+
+REQUIREMENTS:
+    - GitHub CLI (gh) installed and authenticated
+    - Docker with buildx support
+    - Repository must be initialized as git repo
+    - Must have push access to repository
+
+EOF
+}
+
+# Check prerequisites
+check_prerequisites() {
+    log "Checking prerequisites..."
+    
+    # Check if gh is installed
+    if ! command -v gh &> /dev/null; then
+        error "GitHub CLI (gh) is not installed. Install from: https://cli.github.com/"
+    fi
+    
+    # Check if authenticated with GitHub
+    if ! gh auth status &> /dev/null; then
+        error "Not authenticated with GitHub. Run: gh auth login"
+    fi
+    
+    # Check if Docker is installed
+    if ! command -v docker &> /dev/null; then
+        error "Docker is not installed or not in PATH"
+    fi
+    
+    # Check if buildx is available
+    if ! docker buildx version &> /dev/null; then
+        error "Docker buildx is not available. Please update Docker to a newer version."
+    fi
+    
+    # Check if we're in a git repository
+    if ! git rev-parse --git-dir &> /dev/null; then
+        error "This script must be run from within a git repository"
+    fi
+    
+    log "✅ All prerequisites satisfied"
+}
+
+# Get GitHub and repository information
+get_github_info() {
+    log "Getting GitHub repository information..."
+    
+    # Get GitHub username
+    GITHUB_USER=$(gh api user --jq .login 2>/dev/null)
+    if [[ -z "$GITHUB_USER" ]]; then
+        error "Could not get GitHub username. Check your gh authentication."
+    fi
+    
+    # Try to get repository info from current directory
+    if gh repo view &> /dev/null; then
+        REPO_NAME=$(gh repo view --json name --jq .name)
+        REPO_OWNER=$(gh repo view --json owner --jq .owner.login)
+        REPO_URL=$(gh repo view --json url --jq .url)
+        
+        # Check if we have push access
+        if ! gh api "repos/$REPO_OWNER/$REPO_NAME" --jq .permissions.push | grep -q true; then
+            warn "You may not have push access to $REPO_OWNER/$REPO_NAME"
+        fi
+    else
+        # Fallback to git remote
+        REPO_NAME=$(basename "$(git rev-parse --show-toplevel)" 2>/dev/null || echo "mcp-rubber-duck")
+        REPO_OWNER="$GITHUB_USER"
+        REPO_URL="https://github.com/$REPO_OWNER/$REPO_NAME"
+        warn "Could not get repository info from gh. Using fallback: $REPO_OWNER/$REPO_NAME"
+    fi
+    
+    # Build image name
+    IMAGE_NAME="ghcr.io/$REPO_OWNER/$REPO_NAME"
+    
+    info "GitHub User: $GITHUB_USER"
+    info "Repository: $REPO_OWNER/$REPO_NAME"
+    info "Image name: $IMAGE_NAME:$IMAGE_TAG"
+    info "Repository URL: $REPO_URL"
+    
+    log "✅ GitHub information gathered"
+}
+
+# Authenticate Docker with GitHub Container Registry
+authenticate_docker() {
+    log "Authenticating Docker with GitHub Container Registry..."
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Would authenticate Docker with ghcr.io"
+        return
+    fi
+    
+    if ! gh auth token | docker login ghcr.io -u "$GITHUB_USER" --password-stdin; then
+        error "Failed to authenticate Docker with ghcr.io"
+    fi
+    
+    log "✅ Docker authenticated with ghcr.io"
+}
+
+# Build and push Docker image
+build_and_push() {
+    log "Building and pushing Docker image..."
+    
+    # Determine platforms
+    local platforms="$BUILD_PLATFORMS"
+    if [[ "${LOCAL_ONLY:-false}" == "true" ]]; then
+        platforms=""
+        info "Building for local architecture only"
+    fi
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Would build and push:"
+        info "  Image: $IMAGE_NAME:$IMAGE_TAG"
+        info "  Platforms: ${platforms:-$(uname -m)}"
+        return
+    fi
+    
+    # Use the enhanced build script with GitHub support
+    local build_args=(
+        "./scripts/build-multiarch.sh"
+        "--github"
+        "--tag" "$IMAGE_TAG"
+    )
+    
+    if [[ "${LOCAL_ONLY:-false}" == "true" ]]; then
+        build_args+=("--local")
+    fi
+    
+    if [[ "${VERBOSE:-false}" == "true" ]]; then
+        build_args+=("--verbose")
+    fi
+    
+    log "Running: ${build_args[*]}"
+    if "${build_args[@]}"; then
+        log "✅ Build and push completed successfully"
+    else
+        error "❌ Build and push failed"
+    fi
+}
+
+# Manage package visibility and settings
+manage_package() {
+    log "Managing GitHub package settings..."
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Would manage package settings"
+        return
+    fi
+    
+    # Wait a moment for package to appear
+    sleep 5
+    
+    # Check if package exists
+    if ! gh api "user/packages/container/$REPO_NAME" &> /dev/null; then
+        warn "Package not yet available. It may take a moment to appear in GitHub."
+        return
+    fi
+    
+    # Make package public if requested
+    if [[ "$MAKE_PUBLIC" == "true" ]]; then
+        log "Making package public..."
+        if gh api --method PATCH "user/packages/container/$REPO_NAME" --field visibility=public; then
+            log "✅ Package is now public"
+        else
+            warn "Failed to make package public (may require manual action)"
+        fi
+    fi
+    
+    # Link package to repository
+    log "Linking package to repository..."
+    if gh api --method PUT "user/packages/container/$REPO_NAME/restore" --field token="$(gh auth token)" &> /dev/null; then
+        log "✅ Package linked to repository"
+    else
+        info "Package repository linking may require manual action"
+    fi
+    
+    log "✅ Package management completed"
+}
+
+# Show package information and next steps
+show_package_info() {
+    log "📦 Package Information:"
+    
+    if [[ "${DRY_RUN:-false}" == "true" ]]; then
+        info "DRY RUN: Package would be available at:"
+        info "  URL: https://github.com/$REPO_OWNER/packages/container/package/$REPO_NAME"
+        info "  Pull command: docker pull ghcr.io/$REPO_OWNER/$REPO_NAME:$IMAGE_TAG"
+        return
+    fi
+    
+    # Package URL
+    echo "   📍 Package URL: https://github.com/$REPO_OWNER/packages/container/package/$REPO_NAME"
+    
+    # Pull command
+    echo "   🐳 Pull command: docker pull $IMAGE_NAME:$IMAGE_TAG"
+    
+    # Try to get package info
+    if gh api "user/packages/container/$REPO_NAME" &> /dev/null; then
+        local visibility
+        local updated
+        visibility=$(gh api "user/packages/container/$REPO_NAME" --jq .visibility 2>/dev/null || echo "unknown")
+        updated=$(gh api "user/packages/container/$REPO_NAME" --jq .updated_at 2>/dev/null || echo "unknown")
+        
+        echo "   👁️  Visibility: $visibility"
+        echo "   📅 Updated: $updated"
+        
+        # Show versions
+        local versions
+        versions=$(gh api "user/packages/container/$REPO_NAME/versions" --jq 'length' 2>/dev/null || echo "0")
+        echo "   🏷️  Versions: $versions"
+        
+    else
+        warn "Package information not yet available"
+    fi
+    
+    echo
+    log "🚀 Multi-Platform Deployment:"
+    echo "   1. On your deployment target, update docker-compose.yml (or create .env):"
+    echo "      DOCKER_IMAGE=$IMAGE_NAME:$IMAGE_TAG"
+    echo "   2. Pull and run (works on all platforms):"
+    echo "      docker compose pull"
+    echo "      docker compose up -d"
+    
+    if [[ "$MAKE_PUBLIC" != "true" ]]; then
+        echo
+        info "💡 To make package public for easier access:"
+        echo "   gh api --method PATCH user/packages/container/$REPO_NAME --field visibility=public"
+    fi
+}
+
+# Parse command line arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -t|--tag)
+            IMAGE_TAG="$2"
+            shift 2
+            ;;
+        --public)
+            MAKE_PUBLIC="true"
+            shift
+            ;;
+        --platforms)
+            BUILD_PLATFORMS="$2"
+            shift 2
+            ;;
+        --local-only)
+            LOCAL_ONLY="true"
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN="true"
+            shift
+            ;;
+        -v|--verbose)
+            VERBOSE="true"
+            shift
+            ;;
+        -h|--help)
+            print_usage
+            exit 0
+            ;;
+        *)
+            error "Unknown option: $1"
+            ;;
+    esac
+done
+
+# Main execution
+log "🦆 Starting GitHub Container Registry deployment for MCP Rubber Duck"
+
+check_prerequisites
+get_github_info
+authenticate_docker
+build_and_push
+manage_package
+show_package_info
+
+log "🎉 GitHub deployment completed successfully!"