Robot2

.github/workflows/integration-tests.yml

@@ -27,7 +27,25 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-
+
+    - name: Verify required secrets
+      env:
+        DEEPGRAM_API_KEY: ${{ secrets.DEEPGRAM_API_KEY }}
+        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      run: |
+        echo "Verifying required secrets..."
+        if [ -z "$DEEPGRAM_API_KEY" ]; then
+          echo "❌ ERROR: DEEPGRAM_API_KEY secret is not set"
+          exit 1
+        fi
+        if [ -z "$OPENAI_API_KEY" ]; then
+          echo "❌ ERROR: OPENAI_API_KEY secret is not set"
+          exit 1
+        fi
+        echo "✓ DEEPGRAM_API_KEY is set (length: ${#DEEPGRAM_API_KEY})"
+        echo "✓ OPENAI_API_KEY is set (length: ${#OPENAI_API_KEY})"
+        echo "✓ All required secrets verified"
+
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3
 

.github/workflows/robot-tests.yml

@@ -24,6 +24,24 @@ jobs:
     - name: Checkout code
       uses: actions/checkout@v4
 
+    - name: Verify required secrets
+      env:
+        DEEPGRAM_API_KEY: ${{ secrets.DEEPGRAM_API_KEY }}
+        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      run: |
+        echo "Verifying required secrets..."
+        if [ -z "$DEEPGRAM_API_KEY" ]; then
+          echo "❌ ERROR: DEEPGRAM_API_KEY secret is not set"
+          exit 1
+        fi
+        if [ -z "$OPENAI_API_KEY" ]; then
+          echo "❌ ERROR: OPENAI_API_KEY secret is not set"
+          exit 1
+        fi
+        echo "✓ DEEPGRAM_API_KEY is set (length: ${#DEEPGRAM_API_KEY})"
+        echo "✓ OPENAI_API_KEY is set (length: ${#OPENAI_API_KEY})"
+        echo "✓ All required secrets verified"
+
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3
       with:
@@ -161,6 +179,26 @@ jobs:
 
         echo "✓ All services ready!"
 
+    - name: Verify checked out code
+      working-directory: tests
+      run: |
+        echo "Current git commit:"
+        git log -1 --oneline
+        echo ""
+        echo "Test files in current checkout:"
+        find . -name "*.robot" -type f | head -10
+        echo ""
+        echo "Sample of tags in test files:"
+        grep -h "\[Tags\]" endpoints/*.robot infrastructure/*.robot integration/*.robot 2>/dev/null | head -20 || echo "No tag files found"
+
+    - name: Clean previous test results
+      working-directory: tests
+      run: |
+        echo "Cleaning any previous test results..."
+        rm -rf results
+        mkdir -p results
+        echo "✓ Fresh results directory created"
+
     - name: Run Robot Framework tests
       working-directory: tests
       env:
@@ -170,8 +208,11 @@ jobs:
         OPENAI_MODEL: gpt-4o-mini
         DEEPGRAM_API_KEY: ${{ secrets.DEEPGRAM_API_KEY }}
       run: |
-        # Run all tests
-        make all OUTPUTDIR=results || true
+        # Run all tests (don't fail workflow to allow artifact upload)
+        make all OUTPUTDIR=results
+        TEST_EXIT_CODE=$?
+        echo "test_exit_code=$TEST_EXIT_CODE" >> $GITHUB_ENV
+        exit 0  # Don't fail here, we'll fail at the end after uploading artifacts
 
     - name: Show service logs
       if: always()
@@ -343,3 +384,13 @@ jobs:
       working-directory: backends/advanced
       run: |
         docker compose -f docker-compose-test.yml down -v
+
+    - name: Fail workflow if tests failed
+      if: always()
+      run: |
+        if [ "${{ env.test_exit_code }}" != "0" ]; then
+          echo "❌ Tests failed with exit code ${{ env.test_exit_code }}"
+          exit 1
+        else
+          echo "✅ All tests passed"
+        fi

.github/workflows/speaker-recognition-tests.yml

@@ -32,7 +32,25 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-
+
+    - name: Verify required secrets
+      env:
+        HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        DEEPGRAM_API_KEY: ${{ secrets.DEEPGRAM_API_KEY }}
+      run: |
+        echo "Verifying required secrets..."
+        if [ -z "$HF_TOKEN" ]; then
+          echo "❌ ERROR: HF_TOKEN secret is not set"
+          exit 1
+        fi
+        if [ -z "$DEEPGRAM_API_KEY" ]; then
+          echo "❌ ERROR: DEEPGRAM_API_KEY secret is not set"
+          exit 1
+        fi
+        echo "✓ HF_TOKEN is set (length: ${#HF_TOKEN})"
+        echo "✓ DEEPGRAM_API_KEY is set (length: ${#DEEPGRAM_API_KEY})"
+        echo "✓ All required secrets verified"
+
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3
 

.gitignore

@@ -76,3 +76,9 @@ extras/openmemory-mcp/data/*
 backends/advanced/nginx.conf
 backends/advanced/Caddyfile
 
+app/ios/Pods
+results
+log.html
+output.xml
+report.html
+.secrets

.pre-commit-config.yaml

@@ -1,4 +1,26 @@
 repos:
+  # Local hooks (project-specific checks)
+  - repo: local
+    hooks:
+      # Run Robot Framework endpoint tests before push
+      - id: robot-framework-tests
+        name: Robot Framework Tests (Endpoints)
+        entry: bash -c 'cd tests && make endpoints OUTPUTDIR=.pre-commit-results'
+        language: system
+        pass_filenames: false
+        stages: [push]
+        verbose: true
+
+      # Clean up test results after hook runs
+      - id: cleanup-test-results
+        name: Cleanup Test Results
+        entry: bash -c 'cd tests && rm -rf .pre-commit-results'
+        language: system
+        pass_filenames: false
+        stages: [push]
+        always_run: true
+
+  # Code formatting
   - repo: https://github.com/psf/black
     rev: 24.4.2
     hooks:
@@ -9,6 +31,8 @@ repos:
     hooks:
       - id: isort
         files: ^backends/advanced-backend/src/.*\.py$
+
+  # File hygiene
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.5.0
     hooks:

CLAUDE.md

@@ -38,9 +38,6 @@ uv run pytest tests/test_memory_service.py  # Single test file
 # Environment setup
 cp .env.template .env  # Configure environment variables
 
-# Setup test environment (optional, for running integration tests)
-uv run --with-requirements setup-requirements.txt python setup_test_env.py  # Creates .env.test
-
 # Reset data (development)
 sudo rm -rf backends/advanced/data/
 ```
@@ -71,10 +68,6 @@ cd backends/advanced
 # Requires .env file with DEEPGRAM_API_KEY and OPENAI_API_KEY
 cp .env.template .env  # Configure API keys
 
-# Optional: Setup test environment with test-specific credentials
-# (wizard.py prompts for this, or run manually)
-uv run --with-requirements setup-requirements.txt python setup_test_env.py
-
 # Run full integration test suite
 ./run-test.sh
 
@@ -408,6 +401,31 @@ For detailed technical documentation, see:
 - **[@docs/speaker-recognition.md](docs/speaker-recognition.md)**: Advanced analysis and live inference features
 - **[@docs/distributed-deployment.md](docs/distributed-deployment.md)**: Multi-machine deployment with Tailscale
 
+## Robot Framework Testing
+
+**IMPORTANT: When writing or modifying Robot Framework tests, you MUST follow the testing guidelines.**
+
+Before writing any Robot Framework test:
+1. **Read [@tests/TESTING_GUIDELINES.md](tests/TESTING_GUIDELINES.md)** for comprehensive testing patterns and standards
+2. **Check [@tests/tags.md](tests/tags.md)** for approved tags - ONLY 11 tags are permitted
+3. **SCAN existing resource files** for keywords - NEVER write code that duplicates existing keywords
+4. **Follow the Arrange-Act-Assert pattern** with inline verifications (not abstracted to keywords)
+
+Key Testing Rules:
+- **Check Existing Keywords FIRST**: Before writing ANY test code, scan relevant resource files (`websocket_keywords.robot`, `queue_keywords.robot`, `conversation_keywords.robot`, etc.) for existing keywords
+- **Tags**: ONLY use the 11 approved tags from tags.md, tab-separated (e.g., `[Tags]    infra	audio-streaming`)
+- **Verifications**: Write assertions directly in tests, not in resource keywords
+- **Keywords**: Only create keywords for reusable setup/action operations AFTER confirming no existing keyword exists
+- **Resources**: Always check existing resource files before creating new keywords or duplicating logic
+- **Naming**: Use descriptive names that explain business purpose, not technical implementation
+
+**DO NOT:**
+- Write inline code without checking if a keyword already exists for that operation
+- Create custom tags (use only the 11 approved tags)
+- Abstract verifications into keywords (keep them inline in tests)
+- Use space-separated tags (must be tab-separated)
+- Skip reading the guidelines before writing tests
+
 ## Notes for Claude
 Check if the src/ is volume mounted. If not, do compose build so that code changes are reflected. Do not simply run `docker compose restart` as it will not rebuild the image.
 Check backends/advanced/Docs for up to date information on advanced backend.

Makefile

@@ -29,6 +29,7 @@ menu: ## Show interactive menu (default)
 	@echo "================================"
 	@echo
 	@echo "📋 Quick Actions:"
+	@echo "  setup-dev          🛠️  Setup development environment (git hooks, pre-commit)"
 	@echo "  setup-k8s          🏗️  Complete Kubernetes setup (registry + infrastructure + RBAC)"
 	@echo "  config             📝 Generate all configuration files"
 	@echo "  deploy             🚀 Deploy using configured mode ($(DEPLOYMENT_MODE))"
@@ -114,6 +115,29 @@ help: ## Show detailed help for all targets
 	@echo "🧹 CLEANUP:"
 	@echo "  clean              Clean up generated configuration files"
 
+# ========================================
+# DEVELOPMENT SETUP
+# ========================================
+
+setup-dev: ## Setup development environment (git hooks, pre-commit)
+	@echo "🛠️  Setting up development environment..."
+	@echo ""
+	@echo "📦 Installing pre-commit..."
+	@pip install pre-commit 2>/dev/null || pip3 install pre-commit
+	@echo ""
+	@echo "🔧 Installing git hooks..."
+	@pre-commit install --hook-type pre-push
+	@pre-commit install --hook-type pre-commit
+	@echo ""
+	@echo "✅ Development environment setup complete!"
+	@echo ""
+	@echo "💡 Hooks installed:"
+	@echo "  • Robot Framework tests run before push"
+	@echo "  • Black/isort format Python code on commit"
+	@echo "  • Code quality checks on commit"
+	@echo ""
+	@echo "⚙️  To skip hooks: git push --no-verify / git commit --no-verify"
+
 # ========================================
 # KUBERNETES SETUP
 # ========================================

backends/advanced/.dockerignore

@@ -16,5 +16,6 @@
 !nginx.conf
 !nginx.conf.template
 !start.sh
+!start-k8s.sh
 !start-workers.sh
 !Caddyfile