ci: Added a compatability matrix workflow to test agentune against lowest/highest supported runtime dependencies with various Python versions

.github/workflows/compatability-matrix.yml

@@ -0,0 +1,58 @@
+name: Dependency Compatability Matrix
+on:
+#  schedule:
+#    - cron: "0 3 * * *"   # daily
+  workflow_dispatch:
+
+
+jobs:
+  test-dependency-matrix:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+        dep-mode: ["lowest", "latest"]
+
+    name: Python ${{ matrix.python-version }} / ${{ matrix.dep-mode }} deps
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: "2.0.1"
+          virtualenvs-create: false
+          installer-parallel: true
+
+      - name: Install uv
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+          pip install uv
+
+      - name: Generate development dependencies list
+        run: |
+          python ${GITHUB_WORKSPACE}/ci/scripts/generate_dev_deps.py
+
+      - name: Install package (latest dependency versions)
+        if: matrix.dep-mode == 'latest'
+        run: |
+          uv pip install --system --resolution highest --upgrade .
+          uv pip install --system -r requirements-dev.txt
+
+      - name: Install package (oldest supported dependency versions)
+        if: matrix.dep-mode == 'lowest'
+        run: |
+          uv pip install --system --resolution=lowest-direct .
+          uv pip install --system -r requirements-dev.txt
+
+      - name: Run tests
+        run: |
+          poetry run python -m pytest

ci/scripts/generate_dev_deps.py

@@ -0,0 +1,77 @@
+#!/usr/bin/env python3
+
+import tomllib
+from pathlib import Path
+
+
+def caret_to_pip(name: str, spec: str) -> str:
+    """Convert Poetry caret constraints to pip-compatible ranges.
+
+    Examples:
+      ^1.18.2   -> >=1.18.2,<2.0.0
+      ^0.12.11  -> >=0.12.11,<0.13.0
+      ^0.0.5    -> >=0.0.5,<0.0.6
+    """
+    if not spec.startswith('^'):
+        return f'{name}{spec}'
+
+    version = spec[1:]
+    parts = version.split('.')
+
+    num_version_parts = 3
+
+    while len(parts) < num_version_parts:
+        parts.append('0')
+
+    major, minor, patch = map(int, parts[:3])
+
+    if major > 0:
+        upper = f'{major + 1}.0.0'
+    elif minor > 0:
+        upper = f'0.{minor + 1}.0'
+    else:
+        upper = f'0.0.{patch + 1}'
+
+    return f'{name}>={version},<{upper}'
+
+
+def normalize_dep(name: str, spec: str) -> str:
+    """Normalize a Poetry dependency entry into pip-compatible syntax."""
+    if isinstance(spec, dict):
+        spec = spec.get('version', '')
+    spec = spec.strip()
+
+    if not spec:
+        return name
+
+    return caret_to_pip(name, spec)
+
+
+def main() -> None:
+    pyproject_path = Path('pyproject.toml')
+
+    if not pyproject_path.exists():
+        raise FileNotFoundError('pyproject.toml not found')
+
+    with pyproject_path.open('rb') as f:
+        data = tomllib.load(f)
+
+    dev_deps = (
+        data
+        .get('tool', {})
+        .get('poetry', {})
+        .get('group', {})
+        .get('dev', {})
+        .get('dependencies', {})
+    )
+
+    output = Path('requirements-dev.txt')
+
+    with output.open('w') as f:
+        for name, spec in dev_deps.items():
+            line = normalize_dep(name, spec)
+            f.write(f'{line}\n')
+
+
+if __name__ == '__main__':
+    main()

pyproject.toml

@@ -46,7 +46,10 @@ packages = [{include = "agentune"}]
 [tool.poetry.dependencies]
 python = "^3.12.6"
 duckdb = ">=1.4.1,<1.5.0"
-pyarrow = ">=19.0.1"
+pyarrow = [
+    { version = ">=19.0.1", python = "<3.14" },
+    { version = ">=22.0.0", python = ">=3.14" }
+]
 numpy = "^2.2.4"
 janus = "^2.0.0"
 polars = "^1.27.1"