Phase 08: GitHub Action + README

.env.example

@@ -1,11 +1,22 @@
-# Required: GitHub Personal Access Token with repo read permissions
-# Generate at: https://github.com/settings/tokens
-# Scopes needed: repo (or public_repo for public repos only)
+# Local CLI/runtime configuration for github-pr-kb.
+# This file is for local development and manual runs only.
+# Workflow repository secrets belong in GitHub repository secrets, not here.
+# Do not add KB_VARIABLES_TOKEN, KB_VARIABLES_APP_ID, or KB_VARIABLES_APP_PRIVATE_KEY to .env.
+
+# Required for local extraction and for any command that reads GitHub PR data.
 GITHUB_TOKEN=your_github_token_here
 
-# Future variables (added in their respective phases):
-# ANTHROPIC_API_KEY=your_anthropic_api_key_here  # Phase 4: Classification
-# ANTHROPIC_MODEL=claude-haiku-4-5-20251001  # Optional: override classifier model
-# ANTHROPIC_GENERATE_MODEL=claude-sonnet-4-5  # Optional: override article generator model
-# KB_OUTPUT_DIR=kb  # Optional: change the generated knowledge base output directory
-# MIN_CONFIDENCE=0.5  # Optional: generator skips classifications below this confidence
+# Required for local classify/generate runs.
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+
+# Optional classifier model override.
+ANTHROPIC_MODEL=claude-haiku-4-5-20251001
+
+# Optional article-generation model override.
+ANTHROPIC_GENERATE_MODEL=claude-sonnet-4-5
+
+# Optional output directory for generated KB files.
+KB_OUTPUT_DIR=kb
+
+# Optional minimum confidence threshold for KB generation.
+MIN_CONFIDENCE=0.5

.github/workflows/ci.yml

@@ -8,6 +8,7 @@ on:
   merge_group:
     branches:
       - main
+  workflow_dispatch:
 
 permissions:
   contents: read
@@ -59,3 +60,26 @@ jobs:
 
       - name: Run phase 7 e2e harness
         run: .venv/bin/python -m pytest tests/test_phase7_uat_envs.py -v -m e2e
+
+  e2e-pipeline:
+    name: e2e-pipeline
+    if: github.ref == 'refs/heads/main' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: uv sync --all-groups --frozen
+
+      - name: Run E2E pipeline against demo repo
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          RUN_INTEGRATION_TESTS: "1"
+        run: .venv/bin/python -m pytest tests/test_e2e_pipeline.py -v -m e2e