Taskfile.yml

# https://taskfile.dev

version: "3"

vars:
  CONTAINER_NAME: ghcr.io/openimagingdata/findingmodelforge
  DATE_TAG: "{{now | date \"20060102\"}}"

tasks:
  default:
    desc: "Show available tasks"
    cmds:
      - task -l
    silent: true

  install:
    desc: "Install dependencies and setup environment"
    cmds:
      - echo "📦 Installing Python dependencies..."
      - uv sync --all-extras --dev
      - echo "📦 Installing Node.js dependencies..."
      - npm install
      - echo "✅ Dependencies installed!"
    silent: true

  setup:
    desc: "Setup development environment (install deps + create .env + build assets)"
    cmds:
      - task: install
      - |
        if [ ! -f ".env" ]; then
          echo "📝 Creating .env file from template..."
          cp .env.example .env
          echo "⚠️  Please edit .env file with your GitHub OAuth credentials"
        else
          echo "✅ .env file already exists"
        fi
      - echo "🎨 Building frontend assets..."
      - npm run build
      - echo "✅ Setup complete!"
    silent: true

  # Development tasks
  dev:
    desc: "Start development server"
    cmds:
      - echo "🚀 Starting Finding Model Forge development server..."
      - task: setup
      - echo "🌐 Starting server on http://localhost:8000"
      - uv run uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload --proxy-headers --forwarded-allow-ips "*"
    silent: true

  dev-vite:
    desc: "Start development server with Vite dev mode"
    cmds:
      - echo "🚀 Starting Finding Model Forge with Vite dev mode..."
      - task: setup
      - echo "👀 Starting Vite dev server in background..."
      - npm run dev &
      - echo "🌐 Starting FastAPI server on http://localhost:8000"
      - echo "💡 Vite dev server running on http://localhost:5173"
      - echo "💡 Frontend changes will auto-reload. Press Ctrl+C to stop both processes."
      - uv run uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload --proxy-headers --forwarded-allow-ips "*"
    silent: true

  dev-watch:
    desc: "Start development server with CSS watch mode"
    cmds:
      - echo "🚀 Starting Finding Model Forge with CSS watching..."
      - task: setup
      - echo "👀 Starting CSS watch mode in background..."
      - npm run watch:css &
      - echo "🌐 Starting server on http://localhost:8000"
      - echo "💡 CSS changes will auto-rebuild. Press Ctrl+C to stop both processes."
      - uv run uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload --proxy-headers --forwarded-allow-ips "*"
    silent: true

  run:
    desc: "Run the app (alias for dev)"
    cmds:
      - task: dev

  # Frontend tasks
  build-css:
    desc: "Build CSS from Tailwind sources"
    cmds:
      - echo "🎨 Building CSS..."
      - npm run build:css
      - echo "✅ CSS build complete!"
    silent: true

  watch-css:
    desc: "Watch and rebuild CSS on changes"
    cmds:
      - echo "👀 Watching CSS for changes..."
      - npm run watch:css
    silent: true

  watch-js:
    desc: "Watch and rebuild JavaScript on changes (Vite dev mode)"
    cmds:
      - echo "� Starting Vite dev server for JavaScript watching..."
      - npm run dev
    silent: true

  build-frontend:
    desc: "Build all frontend assets (CSS + JS)"
    cmds:
      - echo "🎨 Building frontend assets..."
      - npm run build
      - echo "✅ Frontend build complete!"
    silent: true

  # Code quality tasks
  format:
    desc: "Format code and markdown (fixes formatting issues)"
    cmds:
      - echo "🎨 Formatting Finding Model Forge code..."
      - uv run ruff format .
      - echo "🎨 Formatting Markdown files..."
      - npm run format
      - echo "✅ Code and Markdown formatting complete!"
    silent: true

  format-code:
    desc: "Format Python code only"
    cmds:
      - echo "🎨 Formatting Python code..."
      - uv run ruff format .
      - echo "✅ Code formatting complete!"
    silent: true

  format-markdown:
    desc: "Format Markdown files only"
    cmds:
      - echo "🎨 Formatting Markdown files..."
      - npm run format
      - echo "✅ Markdown formatting complete!"
    silent: true

  lint:
    desc: "Lint and fix code and markdown issues"
    cmds:
      - echo "🎨 Formatting and linting Finding Model Forge code..."
      - uv run ruff format .
      - echo "🔍 Fixing linting issues..."
      - uv run ruff check --fix .
      - echo "🎨 Formatting Markdown files..."
      - npm run format
      - echo "🔎 Running type checking..."
      - uv run mypy .
      - echo "✅ Code and Markdown formatting and linting complete!"
    silent: true

  check:
    desc: "Run quality checks (read-only, for CI)"
    cmds:
      - echo "🔍 Running Finding Model Forge quality checks..."
      - echo "🔍 Checking linting..."
      - uv run ruff check .
      - echo "🎨 Checking code formatting..."
      - uv run ruff format --check .
      - echo "🎨 Checking Markdown formatting..."
      - npm run format:check
      - echo "🔎 Running type checking..."
      - uv run mypy .
      - echo "✅ All quality checks passed!"
    silent: true

  # Testing tasks
  test:
    desc: "Run tests with coverage"
    cmds:
      - echo "🧪 Running Finding Model Forge tests..."
      - echo "📋 Running tests with coverage..."
      - uv run pytest -m "not playwright" --cov=app --cov-report=term-missing --cov-report=html
      - echo "✅ All tests passed!"
    silent: true

  test-unit:
    desc: "Run unit tests only (fast, for development)"
    cmds:
      - echo "⚡ Running unit tests (excluding integration tests)..."
      - uv run pytest -m "not integration and not playwright" --no-cov -q
      - echo "✅ Unit tests passed!"
    silent: true

  test-integration:
    desc: "Run integration tests only"
    cmds:
      - echo "🔗 Running integration tests..."
      - uv run pytest -m "integration and not playwright" --no-cov -q
      - echo "✅ Integration tests passed!"
    silent: true

  test-ui:
    desc: "Run all UI/browser tests (organized in tests/ui/)"
    cmds:
      - echo "🎭 Running UI/browser tests..."
      - echo "💡 Make sure the development server is running on localhost:8000"
      - uv run pytest tests/ui/ -v --no-cov
      - echo "✅ UI tests passed!"
    silent: true

  test-ui-headed:
    desc: "Run UI tests with visible browser (for debugging)"
    cmds:
      - echo "🎭 Running UI tests with visible browser..."
      - echo "💡 Make sure the development server is running on localhost:8000"
      - PLAYWRIGHT_HEADLESS=false uv run pytest tests/ui/ -v --no-cov -s
      - echo "✅ UI tests completed!"
    silent: true

  test-ui-profile:
    desc: "Run only profile page UI tests"
    cmds:
      - echo "🏠 Running profile page tests..."
      - echo "💡 Make sure the development server is running on localhost:8000"
      - uv run pytest tests/ui/test_profile.py -v --no-cov
      - echo "✅ Profile tests passed!"
    silent: true

  test-ui-creation:
    desc: "Run only creation workflow UI tests"
    cmds:
      - echo "⚡ Running creation workflow tests..."
      - echo "💡 Make sure the development server is running on localhost:8000"
      - uv run pytest tests/ui/test_creation_workflow.py -v --no-cov
      - echo "✅ Creation workflow tests passed!"
    silent: true

  test-ui-drafts:
    desc: "Run only draft management UI tests"
    cmds:
      - echo "📝 Running draft management tests..."
      - echo "💡 Make sure the development server is running on localhost:8000"
      - uv run pytest tests/ui/test_draft_management.py -v --no-cov
      - echo "✅ Draft management tests passed!"
    silent: true

  # Legacy commands for backward compatibility
  test-playwright:
    desc: "Run all UI tests (alias for test-ui)"
    cmds:
      - task: test-ui

  test-playwright-headed:
    desc: "Run UI tests with visible browser (alias for test-ui-headed)"
    cmds:
      - task: test-ui-headed

  test-full:
    desc: "Run full test suite with quality checks"
    cmds:
      - task: check
      - task: test
    silent: true

  # Docker tasks
  build:
    desc: "Build Docker image"
    cmds:
      - echo "🐳 Building Finding Model Forge Docker image..."
      - docker build --platform linux/amd64 -t {{.CONTAINER_NAME}}:latest -t {{.CONTAINER_NAME}}:{{.DATE_TAG}} .
      - echo "📊 Image sizes:"
      - docker images {{.CONTAINER_NAME}} --format "table {{`{{.Repository}}`}}\t{{`{{.Tag}}`}}\t{{`{{.Size}}`}}" | head -6 || echo "No images found"
      - echo "✅ Docker build complete!"
    silent: true

  run-container:
    desc: "Run the app in a Docker container"
    cmds:
      - echo "🐳 Running FindingModelForge container..."
      - docker run --name findingmodelforge --platform linux/amd64 -d --env-file .env.container -p 8000:8000 --rm {{.CONTAINER_NAME}}:latest
      - echo "🌐 Container running on http://localhost:8000"
      - echo "💡 Use 'docker logs findingmodelforge' to see logs"
      - echo "💡 Use 'docker stop findingmodelforge' to stop"
      - echo "✅ Container automatically handles proxy headers (X-Forwarded-Proto, etc.)"
    silent: true

  # Utility tasks
  clean:
    desc: "Clean up build artifacts and caches"
    cmds:
      - echo "🧹 Cleaning up Python artifacts..."
      - rm -rf .pytest_cache/ .mypy_cache/ .ruff_cache/ htmlcov/ .coverage
      - echo "🧹 Cleaning up frontend build artifacts..."
      - rm -f static/css/output.css
      - rm -rf static/.vite/ static/js/
      - echo "🧹 Cleaning up Node.js artifacts..."
      - rm -rf node_modules/
      - echo "✅ Cleanup complete!"
    silent: true

  pre-commit:
    desc: "Install and run pre-commit hooks"
    cmds:
      - echo "🔗 Setting up pre-commit..."
      - uv run pre-commit install
      - echo "🔍 Running pre-commit on all files..."
      - uv run pre-commit run --all-files
    silent: true