feat: Add /switch command for agent handoff with context

.env.example

@@ -0,0 +1,28 @@
+# Code Puppy API Keys Configuration
+# Copy this file to .env and fill in your API keys
+# The .env file takes priority over ~/.code_puppy/puppy.cfg
+
+# OpenAI API Key
+# OPENAI_API_KEY=sk-...
+
+# Google Gemini API Key
+# GEMINI_API_KEY=...
+
+# Anthropic (Claude) API Key
+# ANTHROPIC_API_KEY=...
+
+# Cerebras API Key
+# CEREBRAS_API_KEY=...
+
+# OpenRouter API Key
+# OPENROUTER_API_KEY=...
+
+# Z.ai API Key
+# ZAI_API_KEY=...
+
+# Azure OpenAI
+# AZURE_OPENAI_API_KEY=...
+# AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
+
+# Synthetic AI API Key
+# SYN_API_KEY=...

.github/workflows/ci.yml

@@ -0,0 +1,91 @@
+name: Quality Checks
+
+on:
+  pull_request:
+    branches:
+      - '**'
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.13']
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Setup uv virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: uv pip install -e .
+
+      - name: Install pexpect for integration tests
+        run: uv pip install pexpect>=4.9.0
+
+      - name: Debug environment variables
+        env:
+          CEREBRAS_API_KEY: ${{ secrets.CEREBRAS_API_KEY || 'fake-key-for-ci-testing' }}
+          CONTEXT7_API_KEY: ${{ secrets.CONTEXT7_API_KEY || 'fake-key-for-ci-testing' }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'fake-key-for-ci-testing' }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY || 'fake-key-for-ci-testing' }}
+          SYN_API_KEY: ${{ secrets.SYN_API_KEY || 'fake-key-for-ci-testing' }}
+        run: |
+          echo "=== DEBUG: Environment Variables ==="
+          echo "CEREBRAS_API_KEY is set: ${{ secrets.CEREBRAS_API_KEY != '' }}"
+          echo "CONTEXT7_API_KEY is set: ${{ secrets.CONTEXT7_API_KEY != '' }}"
+          echo "OPENAI_API_KEY is set: ${{ secrets.OPENAI_API_KEY != '' }}"
+          echo "ANTHROPIC_API_KEY is set: ${{ secrets.ANTHROPIC_API_KEY != '' }}"
+          echo "SYN_API_KEY is set: ${{ secrets.SYN_API_KEY != '' }}"
+          echo "CEREBRAS_API_KEY length: ${#CEREBRAS_API_KEY}"
+          echo "CONTEXT7_API_KEY length: ${#CONTEXT7_API_KEY}"
+          echo "OPENAI_API_KEY length: ${#OPENAI_API_KEY}"
+          echo "ANTHROPIC_API_KEY length: ${#ANTHROPIC_API_KEY}"
+          echo "SYN_API_KEY length: ${#SYN_API_KEY}"
+          echo "=== END DEBUG ==="
+
+      - name: Run tests
+        env:
+          CEREBRAS_API_KEY: ${{ secrets.CEREBRAS_API_KEY || 'fake-key-for-ci-testing' }}
+          CONTEXT7_API_KEY: ${{ secrets.CONTEXT7_API_KEY || 'fake-key-for-ci-testing' }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'fake-key-for-ci-testing' }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY || 'fake-key-for-ci-testing' }}
+          SYN_API_KEY: ${{ secrets.SYN_API_KEY || 'fake-key-for-ci-testing' }}
+        run: |
+          echo "Running all tests (including integration tests) on ${{ runner.os }} with Python ${{ matrix.python-version }}..."
+          echo "Required environment variables are set (using CI fallbacks if secrets not available)"
+          uv run pytest tests/ -v --cov=code_puppy --cov-report=term-missing
+
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install dev dependencies (ruff)
+        run: pip install ruff
+
+      - name: Install code_puppy
+        run: pip install .
+
+      - name: Lint with ruff
+        run: ruff check .
+
+      - name: Check formatting with ruff
+        run: ruff format --check .

.github/workflows/publish.yml

@@ -12,18 +12,82 @@ on:
       - main
 
 jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-latest]
+        python-version: ['3.13']
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Setup uv virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: uv pip install -e .
+
+      - name: Install pexpect for integration tests
+        run: uv pip install pexpect>=4.9.0
+
+
+
+      - name: Debug environment variables
+        env:
+          CEREBRAS_API_KEY: ${{ secrets.CEREBRAS_API_KEY || 'fake-key-for-ci-testing' }}
+          CONTEXT7_API_KEY: ${{ secrets.CONTEXT7_API_KEY || 'fake-key-for-ci-testing' }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'fake-key-for-ci-testing' }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY || 'fake-key-for-ci-testing' }}
+          SYN_API_KEY: ${{ secrets.SYN_API_KEY || 'fake-key-for-ci-testing' }}
+        run: |
+          echo "=== DEBUG: Environment Variables ==="
+          echo "CEREBRAS_API_KEY is set: ${{ secrets.CEREBRAS_API_KEY != '' }}"
+          echo "CONTEXT7_API_KEY is set: ${{ secrets.CONTEXT7_API_KEY != '' }}"
+          echo "OPENAI_API_KEY is set: ${{ secrets.OPENAI_API_KEY != '' }}"
+          echo "ANTHROPIC_API_KEY is set: ${{ secrets.ANTHROPIC_API_KEY != '' }}"
+          echo "SYN_API_KEY is set: ${{ secrets.SYN_API_KEY != '' }}"
+          echo "CEREBRAS_API_KEY length: ${#CEREBRAS_API_KEY}"
+          echo "CONTEXT7_API_KEY length: ${#CONTEXT7_API_KEY}"
+          echo "OPENAI_API_KEY length: ${#OPENAI_API_KEY}"
+          echo "ANTHROPIC_API_KEY length: ${#ANTHROPIC_API_KEY}"
+          echo "SYN_API_KEY length: ${#SYN_API_KEY}"
+          echo "=== END DEBUG ==="
+
+      - name: Run tests
+        env:
+          CEREBRAS_API_KEY: ${{ secrets.CEREBRAS_API_KEY || 'fake-key-for-ci-testing' }}
+          CONTEXT7_API_KEY: ${{ secrets.CONTEXT7_API_KEY || 'fake-key-for-ci-testing' }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'fake-key-for-ci-testing' }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY || 'fake-key-for-ci-testing' }}
+          SYN_API_KEY: ${{ secrets.SYN_API_KEY || 'fake-key-for-ci-testing' }}
+        run: |
+          echo "Running all tests (including integration tests) on ${{ runner.os }} with Python ${{ matrix.python-version }}..."
+          echo "Required environment variables are set (using CI fallbacks if secrets not available)"
+          uv run pytest tests/ -v --cov=code_puppy --cov-report=term-missing
+
   build-publish:
     runs-on: ubuntu-latest
+    needs: test
     permissions:
       contents: write # Allows writing to the repository
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Python 3.11
+      - name: Setup Python 3.13
         uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: '3.13'
 
       - name: Install uv, build, and twine
         run: pip install uv build twine

.gitignore

@@ -10,3 +10,17 @@ wheels/
 .venv
 
 .coverage
+
+# Session memory
+.puppy_session_memory.json
+
+# Pytest cache
+.pytest_cache/
+
+dummy_path
+
+.idea/
+
+.DS_Store
+.env
+.serena/