Release/0.3

.github/CODEOWNERS

@@ -3,12 +3,12 @@
 # The last match takes precedence over previous ones.
 # Do not edit unless specifically mandated to do so.
 
-backend/     @jwasikpsnc @olivhoenen
+backend/     @jwasikpsnc @prasad-sawantdesai @olivhoenen
 
-frontend/    @mfiaudrin-epsyl @deepakmaroo
+frontend/    @mfiaudrin-epsyl @prasad-sawantdesai
 
 # Global/fallback and technical modifications.
-*            @deepakmaroo @olivhoenen 
+*            @prasad-sawantdesai @olivhoenen 
 
 # Modifications to CODEOWNERS and action workflows 
 .github/     @SimonPinches @olivhoenen

.github/dependabot.yml

@@ -0,0 +1,15 @@
+version: 2
+updates:
+  # Enable version updates for Github Actions
+  - package-ecosystem: "github-actions"
+    # Look for `/.github/workflows` and `/action.yml` or `.yaml`
+    directory: "/"
+    # Check for updates once a week
+    schedule:
+      interval: "weekly"
+    # Group actions version bumps into a single PR
+    groups:
+      actions-deps:
+        patterns:
+          - "*"
+

.github/workflows/asv.yml

@@ -0,0 +1,136 @@
+name: ASV Benchmarks
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write       # needed to push HTML report to gh-pages branch
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: '3.11'
+
+      - name: Display Python version
+        run: python -c "import sys; print(sys.version)"
+
+      - name: Install dependencies
+        working-directory: backend
+        run: |
+          python -m pip install --upgrade pip
+          # virtualenv required by asv to create per-commit benchmark environments
+          pip install asv virtualenv
+
+      - name: Download test data from Zenodo
+        run: |
+          mkdir -p test_data
+          # iter_scenario_53298_seq1_DD4: ~14 MB, DD 4.0.0, contains core_profiles + equilibrium
+          # (required by all benchmark node paths). The 123364 file is a SOLPS edge
+          # simulation with no core_profiles/equilibrium so is not used for benchmarks.
+          wget -q -O test_data/iter_scenario_53298_seq1_DD4.nc \
+            "https://zenodo.org/records/17062700/files/iter_scenario_53298_seq1_DD4.nc?download=1"
+          echo "Downloaded files:"
+          ls -lh test_data/
+
+      - name: Configure ASV regression threshold for CI
+        run: |
+          # On GitHub Actions: only flag regressions >2x slower in the HTML report,
+          # matching the --factor 2.0 used in asv continuous below.
+          # On Bamboo/local, asv.conf.json is used as-is (default ASV threshold of 5%).
+          python - <<'EOF'
+          import pathlib
+          conf_path = pathlib.Path('asv.conf.json')
+          conf = conf_path.read_text()
+          # Insert threshold entry before the final closing brace
+          assert conf.rstrip().endswith('}'), "Unexpected asv.conf.json ending"
+          patched = conf.rstrip()[:-1].rstrip().rstrip(',') + ',\n    "regressions_thresholds": {".*": 2.0}\n}\n'
+          conf_path.write_text(patched)
+          print("CI: regressions_thresholds set to 2.0")
+          EOF
+
+      - name: Run ASV continuous benchmarks
+        id: asv
+        # continue-on-error so we can post the PR comment before re-failing the job
+        continue-on-error: true
+        env:
+          # Tells benchmarks/__init__.py where the test data lives
+          IBEX_TEST_DATA_DIR: ${{ github.workspace }}/test_data
+        run: |
+          asv machine --yes
+
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            # Compare base branch vs PR head — both on the same runner, same hardware
+            BASELINE="origin/${{ github.base_ref }}"
+            CONTENDER="${{ github.sha }}"
+          else
+            # Compare previous commit vs current commit on push/manual trigger
+            # Guard: skip if there is no previous commit (e.g. initial branch push)
+            if ! git rev-parse HEAD~1 >/dev/null 2>&1; then
+              echo "No previous commit to compare against — skipping benchmark comparison."
+              exit 0
+            fi
+            BASELINE="HEAD~1"
+            CONTENDER="HEAD"
+          fi
+
+          # Resolve to full SHAs for clarity in the log
+          BASELINE_SHA=$(git rev-parse "${BASELINE}" 2>/dev/null || echo "${BASELINE}")
+          CONTENDER_SHA=$(git rev-parse "${CONTENDER}" 2>/dev/null || echo "${CONTENDER}")
+          echo "Comparing commits:"
+          echo "  BASELINE  : ${BASELINE} → ${BASELINE_SHA}"
+          echo "  CONTENDER : ${CONTENDER} → ${CONTENDER_SHA}"
+
+          # --factor 2.0: only flag as regression if a benchmark is >2x slower
+          # (filters out GitHub runner hardware noise, ~20-50% typical variance)
+          asv continuous --quick --show-stderr --factor 2.0 "${BASELINE_SHA}" "${CONTENDER_SHA}" \
+            2>&1 | tee asv_output.txt
+
+          # Print a direct before/after comparison table (ratio per benchmark).
+          # This makes it easy to see which benchmarks changed and by how much.
+          echo ""
+          echo "=== Before vs After comparison ==="
+          asv compare --factor 2.0 --split "${BASELINE_SHA}" "${CONTENDER_SHA}" 2>&1 | tee -a asv_output.txt
+
+      - name: Fail job if regression detected
+        if: steps.asv.outcome == 'failure'
+        run: |
+          echo "FAILED: Performance regression detected (>2x threshold). See benchmark output above."
+          exit 1
+
+      - name: Generate HTML results
+        # Only meaningful on push to develop/main — asv publish builds the branch
+        # timeline, so PR commits (not yet on any branch) are simply skipped with
+        # "Couldn't find <sha> in branches". Run only after a merge to avoid noise.
+        if: github.event_name != 'pull_request'
+        run: |
+          # asv publish resolves branch names from asv.conf.json via git rev-list.
+          # On PR checkouts only the PR branch is a local ref. Using
+          # refspec <remote>:<local> creates local branches directly so that
+          # git rev-list develop / main succeeds (plain fetch only makes
+          # remotes/origin/develop which asv does not resolve).
+          git fetch origin develop:develop 2>/dev/null || true
+          git fetch origin main:main 2>/dev/null || true
+          asv publish
+
+      - name: Deploy HTML report to GitHub Pages
+        # Only run on push to develop/main, same reasoning as Generate HTML above.
+        if: github.event_name != 'pull_request'
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: .asv/html
+          destination_dir: benchmarks
+          keep_files: false

.github/workflows/backend-pytest.yml

@@ -0,0 +1,58 @@
+name: backend pytest
+
+on: 
+  push:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Display Python version
+        run: python -c "import sys; print(sys.version)"
+
+      - name: Install dependencies
+        working-directory: backend
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+          python -m pip install .[test]
+
+      - name: Test with pytest
+        working-directory: backend
+        run: |
+          mkdir -p test-reports
+          python -m pytest -n auto --cov=ibex --cov-report=term-missing --cov-report=html --junit-xml=test-reports/pytest-report.xml tests
+
+      - name: Upload report
+        uses: actions/upload-artifact@v7
+        with:
+          name: pytest-report-${{ matrix.python-version }}
+          path: backend/test-reports/pytest-report.xml
+
+      - name: Upload coverage html
+        if: matrix.python-version == '3.11' # coverage doesn't change between python versions.
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-html
+          path: backend/htmlcov
+

.github/workflows/frontend-build-and-packaging.yml

@@ -0,0 +1,29 @@
+name: frontend-build-and-packaging
+
+on:
+  push:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  build-and-packaging:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout frontend sources
+        uses: actions/checkout@v7
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '20'
+
+      - name: Display Node version
+        run: node -v && npm -v
+
+      - name: Install frontend dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Run build and package
+        working-directory: frontend
+        run: npm run package

.github/workflows/frontend-e2e-tests.yml

@@ -0,0 +1,86 @@
+name: frontend-e2e-tests
+
+on:
+  push:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  e2e:
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v7
+
+
+      - name: Setup Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: '3.13'
+
+      - name: Display Python version
+        run: python -c "import sys; print(sys.version)"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Install Xvfb
+        run: sudo apt-get update && sudo apt-get install -y xvfb
+
+      - name: Define dataset list and cache key
+        id: datasets
+        run: |
+          urls=($(cat zenodo_datasets.txt))
+          echo "files=${urls[*]}" >> $GITHUB_OUTPUT
+
+          # Generate a hash key from the URLs list, this is used for caching
+          key=$(echo "${urls[*]}" | sha256sum | cut -d ' ' -f1)
+          echo "key=${key}" >> $GITHUB_OUTPUT
+
+      - name: Cache Zenodo datasets
+        id: cache-datasets
+        uses: actions/cache/restore@v6
+        with:
+          path: e2e_datasets
+          key: ${{ steps.datasets.outputs.key }}
+
+      - if: ${{ steps.cache-datasets.outputs.cache-hit != 'true' }}
+        name: Download datasets if not cached
+        run: |
+          mkdir -p e2e_datasets
+          for url in ${{ steps.datasets.outputs.files }}; do
+            echo "Downloading $(basename $url) ..."
+            wget -P e2e_datasets/ "$url"
+          done
+
+      - name: Always save Zenodo datasets (even if pytest would fail)
+        id: cache-datasets-save
+        if: always() && steps.cache-datasets.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v6
+        with:
+          key: ${{ steps.cache-datasets.outputs.cache-primary-key }}
+          path: e2e_datasets
+
+      - name: Run E2E tests
+        working-directory: frontend
+        run: |
+          xvfb-run --auto-servernum --server-args="-screen 0 1920x1080x24" bash -c "
+            python3 -m venv ../ibex_venv
+            source ../ibex_venv/bin/activate
+            pip install --upgrade pip setuptools wheel
+            cd ../backend
+            pip install -e .
+            cd ../frontend
+            npm run start:e2e &
+            npx wait-on tcp:9222
+            npx wait-on http://127.0.0.1:8000/docs/
+            sleep 5
+            npm run test:e2e
+          "

.github/workflows/frontend-linting.yml

@@ -0,0 +1,33 @@
+name: frontend-linting-and-formatting
+
+on:
+  push:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  lint:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout frontend sources
+        uses: actions/checkout@v7
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '20'
+
+      - name: Display Node version
+        run: node -v && npm -v
+
+      - name: Install frontend dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Run code formatting
+        working-directory: frontend
+        run: npm run format
+
+      - name: Run linting
+        working-directory: frontend
+        run: npm run lint