Restructure into self-contained per-project Lambdas

Split the repo into three self-contained projects (router, automator,
moderator), each with its own src/, scripts/, tests/, pyproject.toml and
uv.lock. Move automator's build files out of the repo root; consolidate tests
per project so moderator's tests now run in CI.

CI is now per-project with native path filters: test-{router,automator,
moderator}.yml run only on their own changes, and deploy-{automator,router}.yml
deploy after their tests pass on main. Moderator is parked (tests only, no
deploy).

Convert automator's un-mocked integration/test.py into mocked end-to-end
reaction-routing tests (tests/test_reactions_e2e.py). Remove clutter
(IMPLEMENTATION_SUMMARY, QUICK_REFERENCE, logs_output, setup_cicd_user,
notebooks) and update docs.

Author: alexeygrigorev

.github/workflows/deploy.yml .github/workflows/deploy-automator.yml.github/workflows/deploy.yml renamed to .github/workflows/deploy-automator.yml

@@ -1,22 +1,28 @@
-name: Deploy Lambda Function
+name: Deploy Automator
 
 on:
   workflow_run:
-    workflows: ["Run Tests"]
+    workflows: ["Test Automator"]
     types:
       - completed
   workflow_dispatch:
 
+env:
+  AWS_REGION: eu-west-1
+  FUNCTION_NAME: automator-process-reaction
+
 jobs:
   deploy:
     runs-on: ubuntu-latest
-    # Only deploy when tests pass on main branch, or when manually triggered from main
+    # Deploy only when Test Automator passed on main, or when manually run from main.
     if: (github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.head_branch == 'main') || (github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main')
-    
+    defaults:
+      run:
+        working-directory: automator
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-      
+
     - name: Install uv
       uses: astral-sh/setup-uv@v3
       with:
@@ -27,17 +33,19 @@ jobs:
       with:
         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-        aws-region: eu-west-1
-        
+        aws-region: ${{ env.AWS_REGION }}
+
     - name: Package Lambda function
-      run: |
-        bash package.sh
-        
+      run: bash scripts/package.sh
+
     - name: Deploy to AWS Lambda
-      run: |
-        bash deploy.sh
+      run: bash scripts/deploy.sh
 
     - name: Verify deployment
       run: |
-        aws lambda get-function --function-name automator-process-reaction --region eu-west-1 --query 'Configuration.LastModified' --output text
-        echo "✅ Lambda function updated successfully"
+        aws lambda get-function \
+          --function-name "$FUNCTION_NAME" \
+          --region "$AWS_REGION" \
+          --query 'Configuration.LastModified' \
+          --output text
+        echo "Automator Lambda function updated successfully"

.github/workflows/deploy-router.yml

@@ -1,8 +1,8 @@
-name: Deploy Router Lambda
+name: Deploy Router
 
 on:
   workflow_run:
-    workflows: ["Run Tests"]
+    workflows: ["Test Router"]
     types:
       - completed
   workflow_dispatch:
@@ -14,8 +14,11 @@ env:
 jobs:
   deploy-router:
     runs-on: ubuntu-latest
+    # Deploy only when Test Router passed on main, or when manually run from main.
     if: (github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.head_branch == 'main') || (github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main')
-
+    defaults:
+      run:
+        working-directory: router
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
@@ -28,12 +31,10 @@ jobs:
         aws-region: ${{ env.AWS_REGION }}
 
     - name: Package router Lambda
-      run: |
-        bash router/package.sh
+      run: bash scripts/package.sh
 
     - name: Deploy router Lambda
-      run: |
-        bash router/deploy.sh
+      run: bash scripts/deploy.sh
 
     - name: Verify router deployment
       run: |

.github/workflows/test-automator.yml

@@ -0,0 +1,35 @@
+name: Test Automator
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'automator/**'
+      - '.github/workflows/test-automator.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'automator/**'
+      - '.github/workflows/test-automator.yml'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: automator
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        python-version: '3.12'
+
+    - name: Install dependencies
+      run: uv sync
+
+    - name: Run tests
+      run: uv run python -m unittest discover tests -v

.github/workflows/test-moderator.yml

@@ -0,0 +1,36 @@
+name: Test Moderator
+
+# Moderator is parked (not deployed). Tests still run so it does not rot.
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'moderator/**'
+      - '.github/workflows/test-moderator.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'moderator/**'
+      - '.github/workflows/test-moderator.yml'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: moderator
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        python-version: '3.12'
+
+    - name: Install dependencies
+      run: uv sync
+
+    - name: Run tests
+      run: uv run python -m unittest discover tests -v

.github/workflows/test.yml .github/workflows/test-router.yml.github/workflows/test.yml renamed to .github/workflows/test-router.yml

@@ -1,29 +1,35 @@
-name: Run Tests
+name: Test Router
 
 on:
   push:
     branches: [ main ]
+    paths:
+      - 'router/**'
+      - '.github/workflows/test-router.yml'
   pull_request:
     branches: [ main ]
+    paths:
+      - 'router/**'
+      - '.github/workflows/test-router.yml'
   workflow_dispatch:
 
 jobs:
   test:
     runs-on: ubuntu-latest
-    
+    defaults:
+      run:
+        working-directory: router
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-      
+
     - name: Install uv
       uses: astral-sh/setup-uv@v3
       with:
         python-version: '3.12'
 
     - name: Install dependencies
-      run: |
-        uv sync --all-extras
+      run: uv sync
 
     - name: Run tests
-      run: |
-        uv run python -m unittest discover tests -v
+      run: uv run python -m unittest discover tests -v