ci: reproducible deepagent tests + venv workflow

.github/workflows/python-test.yml

@@ -0,0 +1,155 @@
+name: Python Tests (consolidated)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+    inputs:
+      run_providers:
+        description: 'Set to true to run the providers matrix (manual run)'
+        required: false
+        default: 'false'
+
+jobs:
+  static-analysis:
+    name: Static analysis & unit tests (one python)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+      - name: Install dependencies for static
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest pytest-cov mypy
+      - name: Run unit tests with coverage
+        run: |
+          PYTHONPATH=. pytest --cov=src/ --cov-report=xml
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+      - name: Run mypy static analysis
+        run: mypy src/
+
+  tests:
+    name: Run tests matrix
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.11, 3.12]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m venv .venv_ci
+          . .venv_ci/bin/activate
+          pip install --upgrade pip setuptools wheel
+          pip install -r requirements.txt
+      - name: Run tests
+        env:
+          PYTHONPATH: .
+        run: |
+          python -m pytest -q
+
+  deepagent-test:
+    name: DeepAgent focused tests (fast)
+    runs-on: ubuntu-latest
+    needs: tests
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-3.12-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+      - name: Install test deps only
+        run: |
+          python -m pip install --upgrade pip
+          python -m venv .venv_ci
+          . .venv_ci/bin/activate
+          pip install --upgrade pip setuptools wheel
+          pip install pytest python-dotenv
+      - name: Run deepagent unit tests
+        env:
+          PYTHONPATH: .
+        run: |
+          python -m pytest -q test/unit/test_deepagent.py test/unit/test_deepagent_providers.py
+
+  provider-smoke:
+    name: Provider smoke (manual)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+      - name: Install provider packages
+        run: |
+          python -m pip install --upgrade pip
+          python -m venv .venv_ci
+          . .venv_ci/bin/activate
+          pip install --upgrade pip setuptools wheel
+          pip install langchain-google-genai langchain-community langchain-ollama python-dotenv
+      - name: Quick deepagent smoke (dry-run disabled)
+        env:
+          PYTHONPATH: .
+        run: |
+          python -c "from src.agents import deepagent; a=deepagent.SDLCFlexibleAgent(provider='gemini', model='chat-bison-001', dry_run=True); print('constructed', getattr(a, 'llm', None))"
+
+  providers:
+    name: Providers matrix (optional)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.run_providers == 'true'
+    strategy:
+      matrix:
+        provider: [gemini, openai, ollama]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+      - name: Install provider packages
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install langchain-google-genai langchain-community langchain-ollama
+      - name: Run provider smoke for matrix provider
+        env:
+          PYTHONPATH: .
+        run: |
+          python -c "from src.agents import deepagent; p='${{ matrix.provider }}'; d = deepagent.SDLCFlexibleAgent(provider=p, dry_run=True); print('provider', p, 'dry_run', getattr(d, 'dry_run', False))"

requirements.txt

@@ -0,0 +1,18 @@
+
+langchain==0.3.27
+# Note: `langchain-deepagent` is not published on PyPI at the pinned version and
+# caused CI install failures. It's intentionally omitted here; install any
+# deepagent/local adapters manually or in provider-specific CI jobs.
+
+# Keep provider adapters optional; install them per-job if needed
+# Provider adapters (optional) - pinned to validated versions from the dev environment
+langchain-google-genai==2.1.9
+langchain-community==0.3.27
+# Ollama adapter left unpinned (install per-job if needed)
+langchain-ollama==0.3.6
+
+# python-dotenv used by the module when running locally
+python-dotenv==1.1.1
+
+# Test/runtime helpers
+pytest==8.4.1

scripts/run-tests.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Lightweight test runner that creates an isolated venv, installs pinned deps,
+# and runs pytest for the repository. Designed for CI and local reproducibility.
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+VENV_DIR="$ROOT_DIR/.venv_ci"
+
+echo "Using venv: $VENV_DIR"
+
+if [ ! -d "$VENV_DIR" ]; then
+  python3 -m venv "$VENV_DIR"
+fi
+
+"$VENV_DIR/bin/python" -m pip install --upgrade pip setuptools wheel
+"$VENV_DIR/bin/python" -m pip install -r "$ROOT_DIR/requirements.txt"
+"$VENV_DIR/bin/python" -m pip install pytest==8.4.1
+
+PYTHONPATH="$ROOT_DIR" "$VENV_DIR/bin/python" -m pytest "$@"