Taskfile.yml

version: "1"
name: coreskill
alias: cs
short_description: CoreSkill - Ewolucyjny system AI z ewoluującymi skillami
description: >
  CoreSkill to inteligentny asystent AI, który potrafi samodzielnie tworzyć,
  naprawiać i rozwijać swoje zdolności (skills). System obsługuje tryb lokalny
  (Docker Compose) oraz produkcyjny (Podman Quadlet).

variables:
  # Core
  APP_NAME: coreskill
  REGISTRY: ghcr.io/wronai
  TAG: latest

  # Platform-specific paths
  BUILD_DIR: dist
  TEST_RESULTS_DIR: test-results
  COVERAGE_DIR: coverage

  # Docker/Compose files
  CHAT_COMPOSE: docker-compose.chat.yml
  TEST_COMPOSE: docker-compose.test.yml
  SIMULATE_COMPOSE: docker-compose.simulate.yml

  # Local settings
  CHAT_PORT: "3000"
  API_PORT: "8001"
  LOCAL_DOMAIN: localhost

environments:
  local:
    desc: Local development environment (Docker Compose)
    container_runtime: docker
    compose_command: docker compose
    variables:
      DOMAIN: ${LOCAL_DOMAIN}
      API_URL: http://${LOCAL_DOMAIN}:${API_PORT}
      CHAT_URL: http://${LOCAL_DOMAIN}:${CHAT_PORT}

  prod:
    desc: Production environment (Podman Quadlet)
    container_runtime: podman
    service_manager: quadlet
    # Auto-configured from environment variables:
    # SSH_HOST → VPS_IP from .env or env var
    # SSH_USER → VPS_USER from .env or env var  
    # SSH_KEY → ~/.ssh/id_ed25519 (default)
    variables:
      # Use VPS_IP from .env or fallback to placeholder
      DOMAIN: ${VPS_IP:-your-vps-ip}
      API_URL: http://${VPS_IP:-your-vps-ip}:${API_PORT}
      CHAT_URL: http://${VPS_IP:-your-vps-ip}:${CHAT_PORT}
      # SSH config from environment
      SSH_HOST: ${VPS_IP:-}
      SSH_USER: ${VPS_USER:-deploy}
      SSH_KEY: ${VPS_SSH_KEY:-~/.ssh/id_ed25519}

platforms:
  web:
    desc: Web application (Docker container)
    variables:
      BUILD_DIR: dist/web

  desktop:
    desc: Desktop application (Electron/webview)
    variables:
      BUILD_DIR: dist/desktop

# ═════════════════════════════════════════════════════════════════════════════
# TASKS
# ═════════════════════════════════════════════════════════════════════════════

tasks:
  # ==========================================================================
  # INIT / SETUP
  # ==========================================================================

  init:
    desc: Initialize project - creates .env from .env.example if missing
    cmds:
      - |
        if [ ! -f .env ]; then
          if [ -f .env.example ]; then
            echo "📝 Creating .env from .env.example..."
            cp .env.example .env
            echo "✅ .env created! Please edit it with your settings:"
            echo ""
            echo "   nano .env"
            echo ""
            echo "Required for VPS deploy:"
            echo "   VPS_IP=your.vps.ip.address"
            echo ""
            echo "Then run: taskfile run deploy"
          else
            echo "⚠️  No .env.example found, creating minimal .env"
            echo "# CoreSkill Environment Configuration" > .env
            echo "# Generated by: taskfile run init" >> .env
            echo "" >> .env
            echo "# VPS Configuration (for production deploy)" >> .env
            echo "VPS_IP=" >> .env
            echo "VPS_USER=deploy" >> .env
            echo "VPS_SSH_KEY=~/.ssh/id_ed25519" >> .env
            echo "" >> .env
            echo "# Container Registry" >> .env
            echo "REGISTRY=ghcr.io/wronai" >> .env
            echo "TAG=latest" >> .env
            echo "" >> .env
            echo "# API Keys (optional)" >> .env
            echo "OPENROUTER_API_KEY=" >> .env
            echo "ANTHROPIC_API_KEY=" >> .env
            echo "" >> .env
            echo "# Local Settings" >> .env
            echo "CHAT_PORT=3000" >> .env
            echo "API_PORT=8001" >> .env
            echo "OLLAMA_HOST=http://host.docker.internal:11434" >> .env
            echo "✅ Minimal .env created! Please edit it: nano .env"
          fi
        else
          echo "✅ .env already exists"
        fi

  env-check:
    desc: Check .env configuration and show current settings
    cmds:
      - |
        if [ ! -f .env ]; then
          echo "❌ .env not found! Run: taskfile run init"
          exit 1
        fi
      - echo "📋 Current .env configuration:"
      - echo "================================"
      - |
        # Load and display key variables
        set -a
        source .env 2>/dev/null || true
        set +a
        
        echo "VPS_IP:          ${VPS_IP:-'(not set)'}"
        echo "VPS_USER:        ${VPS_USER:-deploy}"
        echo "VPS_SSH_KEY:     ${VPS_SSH_KEY:-~/.ssh/id_ed25519}"
        echo "REGISTRY:        ${REGISTRY:-ghcr.io/wronai}"
        echo "TAG:             ${TAG:-latest}"
        echo "CHAT_PORT:       ${CHAT_PORT:-3000}"
        echo "API_PORT:        ${API_PORT:-8001}"
        echo ""
        echo "Edit with: nano .env"

  # ==========================================================================
  # DEVELOPMENT
  # ==========================================================================

  install:
    desc: Install Python dependencies
    cmds:
      - pip install -r requirements.txt
      - echo "✅ Dependencies installed"

  dev:
    desc: Run CoreSkill in development mode (interactive shell)
    cmds:
      - python3 main.py --verbose

  dev-fast:
    desc: Run CoreSkill without verbose logging
    cmds:
      - python3 main.py

  check:
    desc: Quick health check
    cmds:
      - python3 main.py --check

  # ==========================================================================
  # TESTING
  # ==========================================================================

  test:
    desc: Run all tests in Docker
    cmds:
      - echo "🧪 Running complete test suite..."
      - ./scripts/run_tests.sh all

  test-unit:
    desc: Run unit tests only (fast)
    cmds:
      - echo "🧪 Running unit tests..."
      - ./scripts/run_tests.sh unit

  test-integration:
    desc: Run integration tests
    cmds:
      - echo "🧪 Running integration tests..."
      - ./scripts/run_tests.sh integration

  test-smoke:
    desc: Quick smoke test
    cmds:
      - echo "🧪 Running smoke tests..."
      - ./scripts/run_tests.sh smoke

  test-e2e:
    desc: Run E2E tests only
    cmds:
      - echo "🧪 Running E2E tests..."
      - ./scripts/run_tests.sh e2e

  test-verbose:
    desc: Run all tests with verbose output
    cmds:
      - echo "🧪 Running tests with verbose output..."
      - ./scripts/run_tests.sh -v all

  test-rebuild:
    desc: Rebuild test images and run all tests
    cmds:
      - echo "🧪 Rebuilding and running tests..."
      - ./scripts/run_tests.sh -r all

  ci-test:
    desc: Run tests for CI with JUnit output
    cmds:
      - docker compose -f ${TEST_COMPOSE} run --rm test python -m pytest tests/
          -v --tb=short --timeout=60
          --junitxml=/app/${TEST_RESULTS_DIR}/junit.xml
          --cov=cores --cov-report=xml:/app/${COVERAGE_DIR}/coverage.xml

  ci-smoke:
    desc: Quick smoke test for CI
    cmds:
      - docker compose -f ${TEST_COMPOSE} run --rm test-smoke

  # ==========================================================================
  # CHAT UI — WEB PLATFORM
  # ==========================================================================

  chat-up:
    desc: Start chat UI services (backend + frontend)
    platform: [web]
    cmds:
      - docker compose -f ${CHAT_COMPOSE} down --remove-orphans 2>/dev/null || true
      - docker compose -f ${CHAT_COMPOSE} up -d --build --force-recreate
      - echo ""
      - echo "✅ CoreSkill Chat ready at http://${LOCAL_DOMAIN}:${CHAT_PORT}"

  chat-down:
    desc: Stop chat UI services
    platform: [web]
    cmds:
      - docker compose -f ${CHAT_COMPOSE} down --remove-orphans
      - echo "✅ Chat services stopped"

  chat-web:
    desc: Start chat and open in browser
    platform: [web]
    cmds:
      - taskfile run chat-up
      - sleep 2
      - xdg-open http://${LOCAL_DOMAIN}:${CHAT_PORT} 2>/dev/null || open http://${LOCAL_DOMAIN}:${CHAT_PORT} 2>/dev/null || echo "Open http://${LOCAL_DOMAIN}:${CHAT_PORT}"

  chat-logs:
    desc: Show live logs from chat services
    platform: [web]
    cmds:
      - docker compose -f ${CHAT_COMPOSE} logs -f --tail=50

  chat-status:
    desc: Show status of chat services + API health
    platform: [web]
    cmds:
      - echo "📊 Service status:"
      - docker compose -f ${CHAT_COMPOSE} ps
      - echo ""
      - echo "🏥 API health:"
      - curl -sf http://${LOCAL_DOMAIN}:${API_PORT}/health 2>/dev/null && echo "" || echo "API not reachable"
      - echo "🤖 LLM status:"
      - curl -sf http://${LOCAL_DOMAIN}:${API_PORT}/api/status 2>/dev/null | python3 -m json.tool 2>/dev/null || echo "API not responding"

  chat-diagnose:
    desc: Run LLM connectivity diagnostics
    platform: [web]
    cmds:
      - echo "🔍 Running diagnostics..."
      - curl -s http://${LOCAL_DOMAIN}:${API_PORT}/api/diagnose 2>/dev/null | python3 -m json.tool || echo "Diagnostics failed"

  chat-shell:
    desc: Open shell in backend container
    platform: [web]
    cmds:
      - docker exec -it coreskill-api bash

  # ==========================================================================
  # CHAT UI — DESKTOP PLATFORM
  # ==========================================================================

  desktop-up:
    desc: Start chat UI for desktop mode
    platform: [desktop]
    cmds:
      - docker compose -f ${CHAT_COMPOSE} up -d
      - echo "✅ Backend ready for desktop mode"

  desktop-run:
    desc: Launch desktop application
    platform: [desktop]
    cmds:
      - ./desktop/run.sh

  desktop:
    desc: Start services and launch desktop app
    platform: [desktop]
    cmds:
      - taskfile run desktop-up
      - sleep 1
      - taskfile run desktop-run

  # ==========================================================================
  # SIMULATION
  # ==========================================================================

  simulate:
    desc: Run CoreSkill simulation
    cmds:
      - docker compose -f ${SIMULATE_COMPOSE} up --build

  simulate-down:
    desc: Stop simulation
    cmds:
      - docker compose -f ${SIMULATE_COMPOSE} down

  # ==========================================================================
  # DEPLOY MATRIX — 4 deploy types
  #
  #  ┌──────────┬───────────────────────┬──────────────────────────┐
  #  │          │ local                 │ prod                     │
  #  ├──────────┼───────────────────────┼──────────────────────────┤
  #  │ desktop  │ ./desktop/run.sh      │ [create installer/pkg]   │
  #  │ web      │ docker compose up     │ podman pull + restart    │
  #  └──────────┴───────────────────────┴──────────────────────────┘
  #
  #  Usage:
  #    taskfile --env local --platform desktop run deploy   # Desktop local
  #    taskfile --env local --platform web run deploy       # Web local
  #    taskfile --env prod --platform web run deploy        # Web prod (requires .env config)
  #    taskfile run deploy                                  # Auto-detect from current env/platform
  # ==========================================================================

  # ─── Deploy: Web × Local ─────────────────────────────────────────────────
  deploy-web-local:
    desc: Deploy web app locally (Docker Compose)
    env: [local]
    platform: [web]
    cmds:
      - docker compose -f ${CHAT_COMPOSE} down --remove-orphans 2>/dev/null || true
      - docker compose -f ${CHAT_COMPOSE} up -d --build --force-recreate
      - echo ""
      - echo "✅ CoreSkill Web deployed locally:"
      - echo "   Frontend: http://${LOCAL_DOMAIN}:${CHAT_PORT}"
      - echo "   API:      http://${LOCAL_DOMAIN}:${API_PORT}"
      - echo "   Health:   http://${LOCAL_DOMAIN}:${API_PORT}/health"

  # ─── Deploy: Web × Production ──────────────────────────────────────────────
  deploy-web-prod:
    desc: Deploy web app to VPS automatically (uses VPS_IP and SSH_KEY from .env)
    env: [prod]
    platform: [web]
    deps: [init, build, vps-setup-check]
    cmds:
      - echo "🚀 Deploying ${APP_NAME}:${TAG} to VPS..."
      - echo "   VPS:      ${VPS_IP}"
      - echo "   User:     ${VPS_USER:-deploy}"
      - echo "   Registry: ${REGISTRY}"
      - |
        # Check SSH connectivity
        echo "🔌 Testing SSH connection to ${VPS_IP}..."
        if ! ssh -o ConnectTimeout=5 -o StrictHostKeyChecking=accept-new ${VPS_USER:-deploy}@${VPS_IP} "echo 'SSH OK'" 2>/dev/null; then
          echo ""
          echo "❌ SSH connection failed!"
          echo ""
          echo "To fix:"
          echo "  1. Copy your SSH key to the VPS:"
          echo "     ssh-copy-id -i ${VPS_SSH_KEY:-~/.ssh/id_ed25519}.pub ${VPS_USER:-deploy}@${VPS_IP}"
          echo ""
          echo "  2. Or set custom SSH key in .env:"
          echo "     VPS_SSH_KEY=~/.ssh/my_key"
          exit 1
        fi
      - |
        # Build and push image
        echo "📦 Building and pushing image..."
        docker build -t ${REGISTRY}/${APP_NAME}:${TAG} -f backend/Dockerfile .
        docker push ${REGISTRY}/${APP_NAME}:${TAG}
      - |
        # Remote deployment via SSH
        echo "📤 Deploying to VPS..."
        ssh ${VPS_USER:-deploy}@${VPS_IP} "
          # Install Podman if not present
          if ! command -v podman &>/dev/null; then
            echo 'Installing Podman...'
            sudo apt-get update && sudo apt-get install -y podman || sudo yum install -y podman
          fi
          
          # Pull and run
          podman pull ${REGISTRY}/${APP_NAME}:${TAG}
          podman stop ${APP_NAME} 2>/dev/null || true
          podman rm ${APP_NAME} 2>/dev/null || true
          podman run -d \
            --name ${APP_NAME} \
            -p ${API_PORT}:8000 \
            -p ${CHAT_PORT}:80 \
            --restart=always \
            ${REGISTRY}/${APP_NAME}:${TAG}
          
          # Cleanup
          podman image prune -f
          
          echo '✅ Deployment complete'
        "
      - echo ""
      - echo "✅ Deployed to http://${VPS_IP}:${CHAT_PORT}"
      - echo "   API: http://${VPS_IP}:${API_PORT}/health"

  # ─── Deploy: Desktop × Local ─────────────────────────────────────────────
  deploy-desktop-local:
    desc: Run desktop app locally (Chrome --app mode)
    env: [local]
    platform: [desktop]
    cmds:
      - |
        # Ensure backend is running
        if ! curl -sf "http://${LOCAL_DOMAIN}:${API_PORT}/health" &>/dev/null; then
          echo "📦 Starting backend first..."
          docker compose -f ${CHAT_COMPOSE} up -d
          sleep 3
        fi
      - echo "🖥️  Launching CoreSkill Desktop..."
      - ./desktop/run.sh

  # ─── Deploy: Desktop × Production ────────────────────────────────────────
  deploy-desktop-prod:
    desc: Build desktop packages and create download page
    env: [prod]
    platform: [desktop]
    cmds:
      - echo "📦 Building desktop packages for distribution..."
      - echo "   Target: ${BUILD_DIR}/desktop"
      - |
        # Create desktop package structure
        mkdir -p ${BUILD_DIR}/desktop
        cp -r desktop/ ${BUILD_DIR}/desktop/
        cp docker-compose.chat.yml ${BUILD_DIR}/desktop/
        cp -r backend ${BUILD_DIR}/desktop/ 2>/dev/null || true
        cp -r frontend ${BUILD_DIR}/desktop/ 2>/dev/null || true
      - |
        # Create launcher script
        cat > ${BUILD_DIR}/desktop/CoreSkill.sh << 'EOF'
        #!/bin/bash
        # CoreSkill Desktop Launcher
        SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
        cd "$SCRIPT_DIR"
        docker compose -f docker-compose.chat.yml up -d
        sleep 2
        ./desktop/run.sh
        EOF
        chmod +x ${BUILD_DIR}/desktop/CoreSkill.sh
      - |
        # Create install script
        cat > ${BUILD_DIR}/desktop/install.sh << 'EOF'
        #!/bin/bash
        # CoreSkill Desktop Installer
        set -e
        echo "Installing CoreSkill Desktop..."
        
        # Check Docker
        if ! command -v docker &>/dev/null; then
          echo "❌ Docker is required. Install from https://docs.docker.com/get-docker/"
          exit 1
        fi
        
        INSTALL_DIR="${HOME}/.local/share/coreskill"
        mkdir -p "$INSTALL_DIR"
        cp -r . "$INSTALL_DIR/"
        
        # Create desktop entry
        mkdir -p "${HOME}/.local/share/applications"
        cat > "${HOME}/.local/share/applications/coreskill.desktop" << 'DESKTOP'
        [Desktop Entry]
        Name=CoreSkill
        Comment=Ewolucyjny system AI
        Exec=${HOME}/.local/share/coreskill/CoreSkill.sh
        Icon=${HOME}/.local/share/coreskill/desktop/icon.png
        Type=Application
        Categories=AI;Utility;
        DESKTOP
        
        echo "✅ CoreSkill Desktop installed!"
        echo "   Launch from: $INSTALL_DIR/CoreSkill.sh"
        echo "   Or from your applications menu"
        EOF
        chmod +x ${BUILD_DIR}/desktop/install.sh
      - |
        # Create download page
        cat > ${BUILD_DIR}/desktop/index.html << EOF
        <!DOCTYPE html>
        <html lang="pl">
        <head>
          <meta charset="UTF-8">
          <meta name="viewport" content="width=device-width, initial-scale=1.0">
          <title>CoreSkill - Download</title>
          <style>
            * { box-sizing: border-box; margin: 0; padding: 0; }
            body {
              font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
              background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
              min-height: 100vh;
              display: flex;
              align-items: center;
              justify-content: center;
              padding: 20px;
            }
            .container {
              background: white;
              border-radius: 20px;
              padding: 40px;
              max-width: 600px;
              width: 100%;
              box-shadow: 0 20px 60px rgba(0,0,0,0.3);
            }
            h1 {
              color: #333;
              margin-bottom: 10px;
              font-size: 2em;
            }
            .subtitle {
              color: #666;
              margin-bottom: 30px;
            }
            .download-grid {
              display: grid;
              gap: 15px;
              margin-bottom: 30px;
            }
            .download-btn {
              display: flex;
              align-items: center;
              padding: 20px;
              border: 2px solid #e0e0e0;
              border-radius: 12px;
              text-decoration: none;
              color: #333;
              transition: all 0.3s ease;
            }
            .download-btn:hover {
              border-color: #667eea;
              background: #f8f9ff;
              transform: translateY(-2px);
            }
            .icon {
              font-size: 2em;
              margin-right: 15px;
            }
            .info h3 {
              margin-bottom: 5px;
              color: #333;
            }
            .info p {
              color: #666;
              font-size: 0.9em;
            }
            .version {
              text-align: center;
              color: #999;
              font-size: 0.85em;
              margin-top: 20px;
            }
            .web-link {
              display: block;
              text-align: center;
              margin-top: 20px;
              padding: 15px;
              background: #667eea;
              color: white;
              text-decoration: none;
              border-radius: 8px;
              font-weight: 500;
            }
            .web-link:hover {
              background: #5568d3;
            }
          </style>
        </head>
        <body>
          <div class="container">
            <h1>🧠 CoreSkill</h1>
            <p class="subtitle">Ewolucyjny system AI z ewoluującymi skillami</p>
            
            <div class="download-grid">
              <a href="CoreSkill.sh" download class="download-btn">
                <span class="icon">🐧</span>
                <div class="info">
                  <h3>Linux</h3>
                  <p>Universal installer (requires Docker)</p>
                </div>
              </a>
              
              <a href="install.sh" download class="download-btn">
                <span class="icon">📦</span>
                <div class="info">
                  <h3>Install Script</h3>
                  <p>Automatic system installation</p>
                </div>
              </a>
              
              <a href="coreskill.zip" download class="download-btn">
                <span class="icon">📁</span>
                <div class="info">
                  <h3>Source Package</h3>
                  <p>Full source with Docker setup</p>
                </div>
              </a>
            </div>
            
            <a href="http://${VPS_IP}:${CHAT_PORT}" class="web-link">
              🌐 Try Web Version →
            </a>
            
            <p class="version">Version ${TAG} | Build $(date -u +%Y-%m-%d)</p>
          </div>
        </body>
        </html>
        EOF
      - |
        # Create ZIP package
        cd ${BUILD_DIR}
        zip -r desktop/coreskill.zip desktop/ -x "*.zip" 2>/dev/null || tar -czf desktop/coreskill.tar.gz desktop/
      - echo ""
      - echo "✅ Desktop package created: ${BUILD_DIR}/desktop/"
      - echo "   - CoreSkill.sh      → Launcher"
      - echo "   - install.sh        → System installer"
      - echo "   - index.html        → Download page"
      - echo "   - coreskill.zip     → Full package"
      - echo ""
      - echo "📤 Deploy download page to VPS:"
      - echo "   taskfile --env prod run desktop-publish"

  # ─── Universal deploy (auto-routes based on --env and --platform) ─────────
  deploy:
    desc: "Deploy to current env+platform (use --env and --platform flags)"
    cmds:
      - echo "🚀 Deploying ${APP_NAME} — env=${ENV:-local} platform=${PLATFORM:-web} tag=${TAG}"
      - |
        ENV_VAL="${ENV:-local}"
        PLATFORM_VAL="${PLATFORM:-web}"
        taskfile --env ${ENV_VAL} --platform ${PLATFORM_VAL} run deploy-${PLATFORM_VAL}-${ENV_VAL}

  # ─── Deploy all platforms ────────────────────────────────────────────────
  release:
    desc: Full release — deploy all platforms
    cmds:
      - echo "🚀 Releasing ${APP_NAME}:${TAG}"
      - git tag -a ${TAG} -m "Release ${TAG}" 2>/dev/null || echo "Tag ${TAG} already exists"
      - git push origin ${TAG} 2>/dev/null || echo "Push skipped"
      - echo ""
      - echo "📦 Deploying web to production..."
      - taskfile --env prod --platform web run deploy-web-prod || echo "⚠️ Web prod deploy failed"
      - echo ""
      - echo "🖥️  Building desktop package..."
      - taskfile --env prod --platform desktop run deploy-desktop-prod
      - echo ""
      - echo "✅ Release ${APP_NAME}:${TAG} complete!"

  # ==========================================================================
  # BUILD
  # ==========================================================================

  build:
    desc: Build Docker images for production
    platform: [web]
    cmds:
      - docker build -t ${REGISTRY}/${APP_NAME}:${TAG} -f backend/Dockerfile backend/
      - docker tag ${REGISTRY}/${APP_NAME}:${TAG} ${APP_NAME}:latest
      - echo "✅ Built ${REGISTRY}/${APP_NAME}:${TAG}"

  build-test:
    desc: Build test Docker images
    cmds:
      - docker compose -f ${TEST_COMPOSE} build
      - echo "✅ Test images built"

  push:
    desc: Push Docker image to registry
    platform: [web]
    cmds:
      - docker push ${REGISTRY}/${APP_NAME}:${TAG}
      - echo "✅ Pushed ${REGISTRY}/${APP_NAME}:${TAG}"

  # ─── VPS Setup ─────────────────────────────────────────────────────────────
  vps-setup:
    desc: Setup VPS for CoreSkill deployment (installs Podman, creates user)
    env: [prod]
    cmds:
      - |
        if [ -z "${VPS_IP}" ]; then
          echo "❌ VPS_IP not set!"
          echo "Add to .env: VPS_IP=your.vps.ip.address"
          exit 1
        fi
      - echo "🔧 Setting up VPS at ${VPS_IP}..."
      - |
        # Run setup on remote server (as root or sudo user)
        ssh ${VPS_USER:-root}@${VPS_IP} "
          echo '=== CoreSkill VPS Setup ==='
          
          # Update system
          apt-get update || yum update -y
          
          # Install Podman
          if ! command -v podman &>/dev/null; then
            echo '📦 Installing Podman...'
            apt-get install -y podman || yum install -y podman
          fi
          
          # Create deploy user if not exists
          if ! id deploy &>/dev/null; then
            echo '👤 Creating deploy user...'
            useradd -m -s /bin/bash deploy
            usermod -aG sudo deploy || usermod -aG wheel deploy
          fi
          
          # Enable linger for deploy user (systemd user services)
          loginctl enable-linger deploy || true
          
          # Open firewall ports
          if command -v ufw &>/dev/null; then
            ufw allow ${CHAT_PORT}/tcp
            ufw allow ${API_PORT}/tcp
            echo '✅ Firewall configured (ufw)'
          elif command -v firewall-cmd &>/dev/null; then
            firewall-cmd --permanent --add-port=${CHAT_PORT}/tcp
            firewall-cmd --permanent --add-port=${API_PORT}/tcp
            firewall-cmd --reload
            echo '✅ Firewall configured (firewalld)'
          fi
          
          echo '✅ VPS setup complete!'
          echo ''
          echo 'Next steps:'
          echo '  1. Copy your SSH key: ssh-copy-id deploy@${VPS_IP}'
          echo '  2. Deploy: taskfile --env prod run deploy-web-prod'
        "

  vps-setup-check:
    desc: Check VPS is ready for deployment
    env: [prod]
    cmds:
      - |
        if [ -z "${VPS_IP}" ]; then
          echo "❌ VPS_IP not set! Add to .env:"
          echo "   VPS_IP=your.vps.ip.address"
          echo "   VPS_USER=deploy"
          echo "   VPS_SSH_KEY=~/.ssh/id_ed25519"
          exit 1
        fi
      - echo "🔍 Checking VPS ${VPS_IP}..."
      - |
        ssh ${VPS_USER:-deploy}@${VPS_IP} "
          echo '✅ SSH connection OK'
          
          # Check Podman
          if command -v podman &>/dev/null; then
            echo '✅ Podman installed:' \$(podman --version)
          else
            echo '⚠️  Podman not found - run: taskfile --env prod run vps-setup'
            exit 1
          fi
          
          # Check ports
          echo '✅ Ports ${CHAT_PORT} and ${API_PORT} should be open'
          
          echo '✅ VPS ready for deployment!'
        " || exit 1

  ssh-key-setup:
    desc: Generate and copy SSH key to VPS
    cmds:
      - |
        KEY_PATH="${VPS_SSH_KEY:-~/.ssh/id_ed25519}"
        if [ ! -f "${KEY_PATH}" ]; then
          echo "🔑 Generating SSH key..."
          ssh-keygen -t ed25519 -f "${KEY_PATH}" -N "" -C "coreskill-deploy"
          echo "✅ Key generated: ${KEY_PATH}"
        else
          echo "✅ SSH key exists: ${KEY_PATH}"
        fi
      - |
        if [ -z "${VPS_IP}" ]; then
          echo "❌ VPS_IP not set!"
          echo "Add to .env: VPS_IP=your.vps.ip.address"
          exit 1
        fi
      - echo "📋 Public key:"
      - cat ${VPS_SSH_KEY:-~/.ssh/id_ed25519}.pub
      - echo ""
      - echo "🔧 Copying key to VPS ${VPS_IP}..."
      - ssh-copy-id -i ${VPS_SSH_KEY:-~/.ssh/id_ed25519}.pub ${VPS_USER:-deploy}@${VPS_IP}
      - echo "✅ SSH key copied! You can now deploy without password."

  # ─── Publish Desktop Download Page ─────────────────────────────────────────
  desktop-publish:
    desc: Publish desktop download page to VPS
    env: [prod]
    platform: [desktop]
    deps: [deploy-desktop-prod]
    cmds:
      - |
        if [ -z "${VPS_IP}" ]; then
          echo "❌ VPS_IP not set!"
          exit 1
        fi
      - echo "📤 Publishing desktop download page to VPS..."
      - echo "   VPS: ${VPS_IP}"
      - |
        # Upload files to VPS web directory
        ssh ${VPS_USER:-deploy}@${VPS_IP} "
          mkdir -p ~/coreskill-downloads
          echo '📁 Created download directory'
        "
      - scp ${BUILD_DIR}/desktop/* ${VPS_USER:-deploy}@${VPS_IP}:~/coreskill-downloads/
      - |
        # Start nginx container for downloads
        ssh ${VPS_USER:-deploy}@${VPS_IP} "
          podman stop coreskill-downloads 2>/dev/null || true
          podman rm coreskill-downloads 2>/dev/null || true
          podman run -d \\
            --name coreskill-downloads \\
            -p 8080:80 \\
            -v ~/coreskill-downloads:/usr/share/nginx/html:ro \\
            --restart=always \\
            nginx:alpine
          echo '✅ Download page deployed!'
          echo '   http://${VPS_IP}:8080'
        "
      - echo ""
      - echo "✅ Desktop download page published!"
      - echo "   🌐 http://${VPS_IP}:8080"
      - echo ""
      - echo "Downloads available:"
      - echo "   • CoreSkill.sh  - Linux launcher"
      - echo "   • install.sh    - System installer"
      - echo "   • coreskill.zip - Full package"

  # ─── Deploy All (SaaS + Desktop) ─────────────────────────────────────────
  deploy-all:
    desc: Deploy everything - SaaS web app + Desktop download page
    env: [prod]
    cmds:
      - echo "🚀 Deploying CoreSkill SaaS + Desktop..."
      - echo "   VPS: ${VPS_IP}"
      - echo ""
      - echo "📦 Step 1/3: Deploy web application (SaaS)..."
      - taskfile --env prod --platform web run deploy-web-prod
      - echo ""
      - echo "🖥️  Step 2/3: Build desktop packages..."
      - taskfile --env prod --platform desktop run deploy-desktop-prod
      - echo ""
      - echo "📤 Step 3/3: Publish download page..."
      - taskfile --env prod --platform desktop run desktop-publish
      - echo ""
      - echo "✅ All deployments complete!"
      - echo ""
      - echo "🌐 Access points:"
      - echo "   • Web App:        http://${VPS_IP}:${CHAT_PORT}"
      - echo "   • API:            http://${VPS_IP}:${API_PORT}"
      - echo "   • Desktop Downloads: http://${VPS_IP}:8080"
      - echo ""
      - echo "📋 Local development:"
      - echo "   taskfile run deploy-web-local      # Local web"
      - echo "   taskfile run deploy-desktop-local    # Local desktop"

  # ==========================================================================
  # QUADLET (Podman production)
  # ==========================================================================

  quadlet-generate:
    desc: Generate Quadlet .container files from docker-compose for Podman
    platform: [web]
    cmds:
      - echo "🔧 Generating Quadlet files..."
      - mkdir -p deploy/quadlet
      - |
        # Generate backend container unit
        cat > deploy/quadlet/${APP_NAME}-backend.container << 'EOF'
        [Unit]
        Description=CoreSkill Backend API
        After=network.target

        [Container]
        Image=${REGISTRY}/${APP_NAME}:${TAG}
        ContainerName=${APP_NAME}-api
        PublishPort=${API_PORT}:8000
        Environment=CORESKILL_MODE=demo
        Environment=OLLAMA_HOST=http://host.docker.internal:11434
        Volume=coreskill-data:/app/data
        Volume=coreskill-logs:/app/logs
        HealthCmd="curl -f http://localhost:8000/health || exit 1"
        HealthInterval=10s
        HealthTimeout=5s
        HealthRetries=3

        [Service]
        Restart=always

        [Install]
        WantedBy=default.target
        EOF
      - |
        # Generate frontend container unit
        cat > deploy/quadlet/${APP_NAME}-frontend.container << 'EOF'
        [Unit]
        Description=CoreSkill Frontend UI
        After=${APP_NAME}-backend.service
        Requires=${APP_NAME}-backend.service

        [Container]
        Image=nginx:alpine
        ContainerName=${APP_NAME}-ui
        PublishPort=${CHAT_PORT}:80
        Volume=${APP_NAME}-frontend:/usr/share/nginx/html:ro

        [Service]
        Restart=always

        [Install]
        WantedBy=default.target
        EOF
      - echo "✅ Quadlet files generated in deploy/quadlet/"
      - echo "   Deploy with: taskfile --env prod run quadlet-deploy"

  quadlet-deploy:
    desc: Deploy Quadlet files to production server (requires SSH)
    env: [prod]
    platform: [web]
    cmds:
      - echo "📤 Uploading Quadlet files to server..."
      - |
        # Uncomment when SSH is configured:
        # scp deploy/quadlet/*.container ${SSH_USER}@${SSH_HOST}:~/.config/containers/systemd/
        # @remote systemctl --user daemon-reload
        # @remote systemctl --user start ${APP_NAME}-backend
        # @remote systemctl --user start ${APP_NAME}-frontend
      - echo "✅ Quadlet deployed (configure SSH to enable)"

  # ==========================================================================
  # REPORTING
  # ==========================================================================

  report:
    desc: Show test report from previous run
    cmds:
      - echo "📊 Test Results"
      - echo "==============="
      - |
        if [ -f ${TEST_RESULTS_DIR}/junit.xml ]; then
          total=$(grep -o 'tests="[0-9]*"' ${TEST_RESULTS_DIR}/junit.xml | head -1 | sed 's/[^0-9]//g')
          failures=$(grep -o 'failures="[0-9]*"' ${TEST_RESULTS_DIR}/junit.xml | head -1 | sed 's/[^0-9]//g' || echo "0")
          errors=$(grep -o 'errors="[0-9]*"' ${TEST_RESULTS_DIR}/junit.xml | head -1 | sed 's/[^0-9]//g' || echo "0")
          echo "Total:    ${total:-0}"
          echo "Failures: ${failures:-0}"
          echo "Errors:   ${errors:-0}"
          passed=$((total - failures - errors))
          echo "Passed:   ${passed:-0}"
        fi
      - |
        if [ -f ${COVERAGE_DIR}/coverage.xml ]; then
          line_rate=$(grep -o 'line-rate="[0-9.]*"' ${COVERAGE_DIR}/coverage.xml | head -1 | sed 's/[^0-9.]//g')
          coverage=$(python3 -c "print(f'${line_rate} * 100:.1f')" 2>/dev/null || echo "?")
          echo "Coverage: ${coverage}%"
        fi
      - echo ""
      - echo "Reports:"
      - echo "  HTML:  ${TEST_RESULTS_DIR}/report.html"
      - echo "  JUnit: ${TEST_RESULTS_DIR}/junit.xml"

  # ==========================================================================
  # CLEANUP
  # ==========================================================================

  clean:
    desc: Clean test artifacts and containers
    cmds:
      - docker compose -f ${TEST_COMPOSE} rm -f 2>/dev/null || true
      - rm -rf ${TEST_RESULTS_DIR}/ ${COVERAGE_DIR}/ htmlcov/
      - find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
      - echo "🧹 Cleaned"

  clean-all:
    desc: Deep clean including Docker images
    cmds:
      - taskfile run clean
      - docker rmi evo-engine-test evo-engine-test-unit evo-engine-test-integration 2>/dev/null || true
      - echo "🧹 All cleaned"

  clean-chat:
    desc: Remove chat containers and volumes
    platform: [web]
    cmds:
      - docker compose -f ${CHAT_COMPOSE} down -v
      - echo "🧹 Chat data cleaned"

  # ==========================================================================
  # MAINTENANCE
  # ==========================================================================

  shell:
    desc: Open shell in test container
    cmds:
      - docker compose -f ${TEST_COMPOSE} run --rm test bash

  update:
    desc: Update dependencies
    cmds:
      - pip install --upgrade -r requirements.txt
      - echo "✅ Dependencies updated"

  lint:
    desc: Run code linting (if configured)
    cmds:
      - echo "🔍 Linting... (configure your linter)"

  format:
    desc: Format code (if configured)
    cmds:
      - echo "✨ Formatting... (configure your formatter)"

  # ==========================================================================
  # QUICK START ALIASES
  # ==========================================================================

  start:
    desc: Quick start - alias for chat-up
    cmds:
      - taskfile run chat-up

  stop:
    desc: Quick stop - alias for chat-down
    cmds:
      - taskfile run chat-down

  restart:
    desc: Restart chat services
    platform: [web]
    cmds:
      - taskfile run chat-down
      - taskfile run chat-up

  status:
    desc: Show system status
    cmds:
      - echo "📊 CoreSkill Status"
      - echo "==================="
      - echo "Environment: local"
      - echo "Chat URL:    http://${LOCAL_DOMAIN}:${CHAT_PORT}"
      - echo "API URL:     http://${LOCAL_DOMAIN}:${API_PORT}"
      - echo ""
      - docker compose -f ${CHAT_COMPOSE} ps 2>/dev/null || echo "Chat services not running"

  # ==========================================================================
  # DOCS & HELP
  # ==========================================================================

  docs:
    desc: Open documentation
    cmds:
      - echo "📚 Documentation:"
      - echo "  - docs/architecture.md      - System architecture"
      - echo "  - docs/api_reference.md      - API Reference"
      - echo "  - docs/creating_skills.md    - Creating skills"
      - echo "  - README.md                  - Main readme"

  help-cli:
    desc: Show CoreSkill CLI help
    cmds:
      - python3 main.py --help || coreskill --help

  version:
    desc: Show CoreSkill version
    cmds:
      - cat VERSION

# ═════════════════════════════════════════════════════════════════════════════
# TASKFILE IMPROVEMENTS & NOTES
# ═════════════════════════════════════════════════════════════════════════════
#
# This Taskfile provides several improvements over the original Makefile:
#
# 1. STRUCTURED ENVIRONMENTS
#    - Define 'local' and 'prod' environments with different settings
#    - Variables cascade: global → environment → platform → CLI → OS
#
# 2. PLATFORM SUPPORT
#    - 'web' platform: Docker-based chat UI
#    - 'desktop' platform: Electron/webview desktop app
#
# 3. UNIFIED INTERFACE
#    - taskfile run <task> works consistently across all tasks
#    - taskfile list shows all available tasks
#
# 4. IMPROVEMENTS TO CONSIDER:
#
#    a) Add production deployment tasks with SSH support:
#       - Uncomment ssh_* settings in 'prod' environment
#       - Add deploy-prod task using @remote prefix
#
#    b) Add Quadlet generation for production Podman deployment:
#       - taskfile quadlet generate --env-file .env.prod
#       - taskfile --env prod quadlet upload
#
#    c) Add CI/CD tasks for GitHub Actions/GitLab CI:
#       - Use --var TAG=$CI_COMMIT_SHA for versioning
#
#    d) Add task dependencies (deps: [test, build]) for complex workflows
#
#    e) Add conditional tasks with 'condition' for idempotency
#
# 5. USAGE EXAMPLES:
#
#    taskfile list                      # Show all tasks
#    taskfile run install               # Install dependencies
#    taskfile run dev                   # Run development mode
#    taskfile run test                  # Run all tests
#    taskfile run chat-up               # Start chat UI
#    taskfile run chat-web              # Start and open browser
#    taskfile --env local --platform web run deploy
#
# ═════════════════════════════════════════════════════════════════════════════