Merging 3 weeks of progress in dev to prod

.env

@@ -0,0 +1 @@
+ARGO_USER=jplfaria

.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11"]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install black isort flake8 mypy pytest mkdocs mkdocs-material
+      - name: Black check
+        run: black --check .
+      - name: isort check
+        run: isort --check-only .
+      - name: flake8 lint
+        run: flake8 .
+      - name: mypy type check
+        run: mypy .
+      - name: pytest
+        run: pytest -q
+      - name: Build docs
+        run: mkdocs build --strict

.github/workflows/deploy-docs.yml

@@ -0,0 +1,26 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - name: Install MKDocs
+        run: |
+          pip install --upgrade pip
+          pip install mkdocs mkdocs-material
+      - name: Build documentation
+        run: mkdocs build --strict
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

.gitignore

@@ -27,6 +27,9 @@ __pycache__/
 # ------------------------------------------------------------------
 *.log
 *.concordia.csv        # result files regenerated each run
+example_data/test_results/    # benchmark test results directory
+eval/results/                # ignore new benchmark results directory
+*.png                        # ignore plot files
 
 # Hugging Face cache (weights are huge; re-downloaded on demand)
 .cache/

.pre-commit-config.yaml

@@ -0,0 +1,19 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 25.1.0
+    hooks:
+      - id: black
+        language_version: python3
+  - repo: https://github.com/pycqa/isort
+    rev: 6.0.1
+    hooks:
+      - id: isort
+  - repo: https://github.com/myint/autoflake
+    rev: v1.4
+    hooks:
+      - id: autoflake
+        args: [--remove-all-unused-imports, --remove-unused-variables, --in-place, --recursive]
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.11.8
+    hooks:
+      - id: ruff