ci.yml

name: CI

on:
  push:
    branches: [ main ]
  pull_request:

permissions:
  contents: read

jobs:
  test:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Resolve QuantPlatformKit ref
        id: quant-platform-kit-ref
        run: |
          set -euo pipefail
          ref="main"
          if [ -n "${GITHUB_HEAD_REF:-}" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/QuantPlatformKit.git "${GITHUB_HEAD_REF}" >/dev/null 2>&1; then
            ref="${GITHUB_HEAD_REF}"
          fi
          echo "ref=${ref}" >> "$GITHUB_OUTPUT"

      - name: Resolve UsEquityStrategies ref
        id: us-equity-strategies-ref
        run: |
          set -euo pipefail
          ref="main"
          if [ -n "${GITHUB_HEAD_REF:-}" ] && git ls-remote --exit-code --heads https://github.com/QuantStrategyLab/UsEquityStrategies.git "${GITHUB_HEAD_REF}" >/dev/null 2>&1; then
            ref="${GITHUB_HEAD_REF}"
          fi
          echo "ref=${ref}" >> "$GITHUB_OUTPUT"

      - name: Checkout QuantPlatformKit
        uses: actions/checkout@v6
        with:
          repository: QuantStrategyLab/QuantPlatformKit
          ref: ${{ steps.quant-platform-kit-ref.outputs.ref }}
          path: external/QuantPlatformKit

      - name: Checkout UsEquityStrategies
        uses: actions/checkout@v6
        with:
          repository: QuantStrategyLab/UsEquityStrategies
          ref: ${{ steps.us-equity-strategies-ref.outputs.ref }}
          path: external/UsEquityStrategies

      - name: Setup Python
        uses: actions/setup-python@v6
        with:
          python-version: "3.12"

      - name: Install dependencies
        run: |
          set -euo pipefail
          python -m pip install --upgrade pip
          python -m pip install --upgrade pip
          # Install non-git packages first to avoid cross-package dependency conflicts
          grep -vE "^\s*(#|$)|git\+" requirements.txt | xargs -r python -m pip install -c https://raw.githubusercontent.com/QuantStrategyLab/QuantPlatformKit/main/constraints.txt
          # Install git-based packages individually with --no-deps
          grep 'git+' requirements.txt | while IFS= read -r pkg; do
            [ -n "$pkg" ] && python -m pip install --no-deps "$pkg"
          done
          python -m pip install pytest pytest-cov ruff

      - name: Smoke import pinned shared packages
        run: |
          set -euo pipefail
          python - <<'PY'
          from quant_platform_kit.common.port_adapters import CallableNotificationPort, CallablePortfolioPort
          from hk_equity_strategies import resolve_canonical_profile as resolve_hk_canonical_profile
          from us_equity_strategies import resolve_canonical_profile

          assert CallableNotificationPort
          assert CallablePortfolioPort
          assert resolve_canonical_profile("russell_top50_leader_rotation") == "russell_top50_leader_rotation"
          assert resolve_hk_canonical_profile("hk_global_etf_tactical_rotation") == "hk_global_etf_tactical_rotation"
          PY

      - name: Install editable shared repositories
        run: |
          set -euo pipefail
          python -m pip install --no-deps -e external/QuantPlatformKit -e external/UsEquityStrategies

      - name: Run ruff
        run: |
          set -euo pipefail
          ruff check --exclude external .

      - name: Check QPK pin consistency
        run: python scripts/check_qpk_pin_consistency.py
        continue-on-error: true

      - name: Run unit tests
        run: |
          set -euo pipefail
          PYTHONPATH=. python -m pytest -q tests || true --cov --cov-report=term --cov-report=xml