name: meshtasticator-e2e

# Radio-level end-to-end validation against Meshtasticator's interactive
# simulator (real MeshtasticD per node + simulated LoRa PHY). Runs on demand
# until it is validated green on the runner; afterwards switch `on` to also
# trigger on pull_request touching plugin/ and this workflow.
#
# Docker access follows the deployment examples in
# https://git.ericxliu.me/eric/actions-docker (docker is available to jobs);
# Meshtasticator's docker mode publishes node TCP API ports (4404+n) from the
# meshtastic/meshtasticd container and the simulator connects to them on
# localhost. scripts/meshtasticator_e2e/run_e2e.sh starts localhost->daemon
# TCP forwards automatically when DOCKER_HOST is a tcp:// daemon, which is how
# this job is configured.

on:
  workflow_dispatch:
  # pull_request:
  #   paths:
  #     - 'plugin/**'
  #     - 'scripts/meshtasticator_e2e/**'
  #     - '.gitea/workflows/meshtasticator-e2e.yaml'

concurrency:
  # One e2e run at a time: Meshtasticator hardcodes the container/volume name
  # ("Meshtastic"/"Meshtasticator") on the shared docker daemon.
  group: meshtasticator-e2e
  cancel-in-progress: true

jobs:
  e2e:
    runs-on: ubuntu-latest
    timeout-minutes: 60
    env:
      DOCKER_HOST: tcp://docker.local:2375
      MESHTASTICATOR_COMMIT: 17ceb8231079d87b070abc6132181e4c6b20202d
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Python 3.13 (matches Hermes image)
        uses: actions/setup-python@v5
        with:
          python-version: '3.13'

      - name: Install uv
        run: pip install uv

      # --- Hermes gateway contract env (mirrors .gitea/workflows/release.yaml) ---
      - name: Clone pinned Hermes gateway source (deployed image tag)
        run: |
          git clone --depth 1 --branch v2026.8.31 \
            https://github.com/NousResearch/hermes-agent.git plugin/.hermes-src
          test "$(git -C plugin/.hermes-src rev-parse HEAD)" = \
            "29112bef099274229cadff79cdff7bf7b99c4b77"

      - name: Editable install hermes-agent + pytest + plugin (meshtastic client lib)
        run: |
          uv venv --python 3.13 plugin/.venv-contract
          uv pip install --python plugin/.venv-contract/bin/python -e plugin/.hermes-src
          uv pip install --python plugin/.venv-contract/bin/python pytest
          uv pip install --python plugin/.venv-contract/bin/python -e plugin

      # --- Simulator env (isolated: meshtasticator pins meshtastic~=2.6.1) ---
      - name: Clone Meshtasticator at pinned commit
        run: |
          git clone https://github.com/meshtastic/meshtasticator.git "$HOME/meshtasticator"
          git -C "$HOME/meshtasticator" checkout "$MESHTASTICATOR_COMMIT"
          test "$(git -C "$HOME/meshtasticator" rev-parse HEAD)" = "$MESHTASTICATOR_COMMIT"

      - name: Simulator venv (its own requirements + docker SDK)
        run: |
          uv venv --python 3.13 "$HOME/sim-venv"
          uv pip install --python "$HOME/sim-venv/bin/python" \
            -r "$HOME/meshtasticator/requirements.txt" docker

      - name: Run Meshtasticator e2e suite
        run: |
          export MESHTASTICATOR_DIR="$HOME/meshtasticator"
          export SIM_VENV="$HOME/sim-venv"
          export E2E_VENV="plugin/.venv-contract"
          bash scripts/meshtasticator_e2e/run_e2e.sh --mode docker

      - name: Print simulator log (on failure)
        if: failure()
        run: |
          echo "===== meshtasticator-sim.log (tail) ====="
          tail -n 400 meshtasticator-sim.log 2>/dev/null || true
          echo "===== meshtasticator-nodes.log (if any) ====="
          tail -n 200 meshtasticator-nodes.log 2>/dev/null || true
          echo "===== docker ps ====="
          docker ps -a 2>/dev/null || true