feat: Enhance testing framework with new functional tests and CI integration

- Added new functional tests for client replay and generated artifacts to ensure compatibility with live API.
- Introduced integration tests for mounted file edits to verify persistence of changes.
- Updated pytest markers in `pyproject.toml` for better test categorization.
- Enhanced GitHub Actions workflow to include integration tests alongside existing unit tests.
- Revised documentation to reflect new test organization and execution strategies.

Author: usnavy13

.github/workflows/lint.yml

@@ -46,6 +46,64 @@ jobs:
         run: |
           pytest tests/unit/
 
+      - name: Run Integration Tests
+        run: |
+          pytest tests/integration/
+
+  functional-live:
+    runs-on: ubuntu-latest
+    timeout-minutes: 75
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest pytest-asyncio pytest-cov pytest-mock
+
+      - name: Prepare environment
+        run: |
+          cp .env.example .env
+
+      - name: Start live test stack
+        run: |
+          docker compose up -d --build
+
+      - name: Wait for API health
+        run: |
+          for i in $(seq 1 24); do
+            if curl -fs http://localhost:8000/health >/dev/null; then
+              exit 0
+            fi
+            sleep 5
+          done
+          docker compose logs --no-color api
+          exit 1
+
+      - name: Run Functional Live API Tests
+        env:
+          API_BASE: http://localhost:8000
+          API_KEY: your-secure-api-key-here-change-this-in-production
+        run: |
+          pytest tests/functional/ -m live_api -v
+
+      - name: Dump stack logs on failure
+        if: failure()
+        run: |
+          docker compose logs --no-color
+
+      - name: Stop live test stack
+        if: always()
+        run: |
+          docker compose down -v
+
   docker-build:
     runs-on: ubuntu-latest
     steps: