Taskfile.yml

version: '3'

dotenv:
  - .env

tasks:
  default:
    desc: List available tasks
    cmds:
      - task --list

  setup:
    desc: Install dependencies without overwriting config or data
    cmds:
      - |
        set -eu
        if [ ! -f .env ]; then
          install -m 0600 .env.example .env
          printf '%s\n' \
            'setup: created .env; review all credentials before deployment'
        else
          printf '%s\n' 'setup: .env exists, leaving it untouched'
        fi
        npm ci
        (cd backend && go mod download)

  doctor:
    desc: Run read-only environment checks (MODE=runtime|ci)
    cmds:
      - ./scripts/doctor.sh "{{.MODE}}"

  dev:
    desc: Start the frontend and backend in the foreground
    cmds:
      - task --parallel frontend backend

  frontend:
    desc: Start the Vite development server
    cmds:
      - npm run dev

  backend:
    desc: Build and start the local PocketBase extension
    cmds:
      - |
        cd backend
        CGO_ENABLED=0 GOOS=linux go build -tags nocgo \
          -o ebook-pocketbase ./cmd/ebook-pocketbase
        PUBLIC_DIR=../dist ./ebook-pocketbase serve \
          --http="${POCKETBASE_HOST:-127.0.0.1}:${POCKETBASE_PORT:-8090}" \
          --dir "${POCKETBASE_DATA_DIR:-../.local/pb_data}" \
          --hooksDir ../pb_hooks

  bootstrap:
    desc: Create the local PocketBase collections and demo users
    cmds:
      - node scripts/bootstrap-pocketbase.mjs

  stop:
    desc: Explain how to stop foreground development processes
    cmds:
      - |
        printf '%s\n' \
          'NOT_APPLICABLE task=stop reason=dev-runs-in-foreground-use-signal'
        exit 4

  status:
    desc: Check local frontend and backend endpoints
    cmds:
      - |
        set +e
        rc=0
        frontend_url="http://${FRONTEND_HOST:-127.0.0.1}:${FRONTEND_PORT:-5173}"
        backend_url="http://${POCKETBASE_HOST:-127.0.0.1}:${POCKETBASE_PORT:-8090}"
        printf 'frontend: %s\n' "$frontend_url"
        curl -fsS --max-time 3 "$frontend_url" >/dev/null || rc=1
        printf 'backend: %s/api/health\n' "$backend_url"
        curl -fsS --max-time 3 "$backend_url/api/health" >/dev/null || rc=1
        exit "$rc"

  logs:
    desc: Explain foreground development log handling
    cmds:
      - |
        printf '%s\n' \
          'NOT_APPLICABLE task=logs reason=dev-logs-stream-to-foreground'
        exit 4

  fmt:
    desc: Format frontend, configuration, and Go sources
    cmds:
      - npm run format
      - gofmt -w backend

  fmt:check:
    desc: Check formatting without modifying files
    cmds:
      - npm run format:check
      - |
        unformatted="$(gofmt -l backend)"
        if [ -n "$unformatted" ]; then
          printf 'GOFMT_REQUIRED\n%s\n' "$unformatted" >&2
          exit 1
        fi

  lint:
    desc: Run frontend, shell, and Go linters
    cmds:
      - npm run lint
      - shellcheck scripts/*.sh
      - cd backend && go vet ./...

  typecheck:
    desc: Run frontend type checking
    cmds:
      - npm run typecheck

  test:
    desc: Run data path, frontend, and backend tests
    cmds:
      - ./scripts/test-data-path.sh
      - npm test
      - cd backend && go test ./...

  build:
    desc: Build frontend and backend artifacts
    cmds:
      - npm run build
      - |
        mkdir -p .local/go-build-cache
        cd backend
        GOCACHE="$PWD/../.local/go-build-cache" CGO_ENABLED=0 GOOS=linux go build -tags nocgo \
          -o ebook-pocketbase ./cmd/ebook-pocketbase

  config:
    desc: Validate manifest and merged Compose configuration
    cmds:
      - node scripts/validate-config.mjs

  check:
    desc: Run ordered, side-effect-free project checks
    cmds:
      - task doctor MODE=ci
      - task fmt:check
      - task lint
      - task typecheck
      - task test
      - task build
      - task config

  deploy:
    desc: Deploy incremental frontend/backend changes
    cmds:
      - ./scripts/deploy-fast.sh

  deploy:verify:
    desc: Check and deploy the application with Compose v2
    cmds:
      - task check
      - task deploy:image

  deploy:image:
    desc: Build the application image and start it with Compose v2
    cmds:
      - |
        data_path="$(./scripts/resolve-data-path.sh)"
        builder_cache_path="${DOCKER_BUILDER_CACHE_PATH:-./.local/docker-build-cache}"
        mkdir -p "$data_path/tmp" "$builder_cache_path"
        chmod 0750 "$data_path" "$builder_cache_path"
        chmod 1777 "$data_path/tmp"
        if ! docker network inspect cicd-observability >/dev/null 2>&1; then
          printf '%s\n' \
            'DEPENDENCY_MISSING network=cicd-observability run=cicd-setup' >&2
          exit 3
        fi
        DOCKER_PB_DATA_PATH="$data_path" \
          DOCKER_BUILDER_CACHE_PATH="$builder_cache_path" \
          docker compose -p ebook-reader-uzqw \
          -f compose.yaml -f compose.build.yaml \
          -f compose.observability.yaml config --quiet
        DOCKER_PB_DATA_PATH="$data_path" \
          DOCKER_BUILDER_CACHE_PATH="$builder_cache_path" \
          docker compose -p ebook-reader-uzqw \
          -f compose.yaml -f compose.build.yaml \
          -f compose.observability.yaml up -d --build --force-recreate

  deploy:down:
    desc: Stop the deployment without deleting persistent data
    cmds:
      - |
        data_path="$(./scripts/resolve-data-path.sh)"
        builder_cache_path="${DOCKER_BUILDER_CACHE_PATH:-./.local/docker-build-cache}"
        DOCKER_PB_DATA_PATH="$data_path" \
          DOCKER_BUILDER_CACHE_PATH="$builder_cache_path" \
          docker compose -p ebook-reader-uzqw \
          -f compose.yaml -f compose.build.yaml \
          -f compose.observability.yaml down

  deploy:logs:
    desc: Show deployment logs (FOLLOW=1, TAIL=n)
    cmds:
      - |
        data_path="$(./scripts/resolve-data-path.sh)"
        builder_cache_path="${DOCKER_BUILDER_CACHE_PATH:-./.local/docker-build-cache}"
        follow_arg=
        [ "${FOLLOW:-0}" != 1 ] || follow_arg=--follow
        DOCKER_PB_DATA_PATH="$data_path" \
          DOCKER_BUILDER_CACHE_PATH="$builder_cache_path" \
          docker compose -p ebook-reader-uzqw \
          -f compose.yaml -f compose.build.yaml \
          -f compose.observability.yaml logs \
          --tail "${TAIL:-100}" $follow_arg

  clean:
    desc: Remove only regenerable build and cache artifacts
    cmds:
      - |
        rm -rf -- dist node_modules/.vite node_modules/.cache
        rm -f -- backend/ebook-pocketbase
        printf '%s\n' 'clean: removed build outputs and tool caches'