docs: Add comprehensive guide for auto-compilation flow development and deployment strategies

Author: jumski

.changeset/auto-compile-http-control.md

@@ -0,0 +1,6 @@
+---
+'pgflow': minor
+'@pgflow/edge-worker': minor
+---
+
+Add auto-compilation flow and HTTP control plane server for edge worker

.github/workflows/ci.yml

@@ -53,7 +53,7 @@ jobs:
         run: echo "BASE=$NX_BASE HEAD=$NX_HEAD"
 
       - name: Pre-start Supabase for affected packages
-        run: ./scripts/ci-prestart-supabase.sh core client
+        run: ./scripts/ci-prestart-supabase.sh core client cli
 
       - name: Quality gate (lint + typecheck + test)
         run: pnpm nx affected -t lint typecheck test --parallel --configuration=production --base="$NX_BASE" --head="$NX_HEAD"
@@ -117,9 +117,62 @@ jobs:
         if: steps.check-affected.outputs.affected == 'true'
         run: pnpm nx affected -t test:e2e --parallel --base="$NX_BASE" --head="$NX_HEAD"
 
+  # ─────────────────────────────────────── 2b. CLI E2E ──────────────────────────────────────
+  cli-e2e:
+    runs-on: ubuntu-latest
+    env:
+      NX_CLOUD_ACCESS_TOKEN: ${{ secrets.NX_CLOUD_ACCESS_TOKEN }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: ./.github/actions/setup
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: '2.1.4'
+
+      - name: Install sqruff
+        uses: ./.github/actions/setup-sqruff
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Atlas
+        uses: ariga/setup-atlas@master
+        with:
+          cloud-token: ${{ secrets.ATLAS_CLOUD_TOKEN }}
+
+      - name: Set Nx base for affected commands
+        run: |
+          echo "NX_BASE=origin/main" >> $GITHUB_ENV
+          echo "NX_HEAD=HEAD" >> $GITHUB_ENV
+
+      - name: Verify NX_BASE and NX_HEAD are set
+        run: echo "BASE=$NX_BASE HEAD=$NX_HEAD"
+
+      - name: Pre-start Supabase for CLI
+        run: ./scripts/ci-prestart-supabase.sh cli
+
+      - name: Check if CLI e2e tests are affected
+        id: check-affected
+        run: |
+          if pnpm nx show projects --affected -t test:e2e --base="$NX_BASE" --head="$NX_HEAD" | grep -q "^cli$"; then
+            echo "affected=true" >> $GITHUB_OUTPUT
+            echo "CLI e2e tests are affected by changes"
+          else
+            echo "affected=false" >> $GITHUB_OUTPUT
+            echo "CLI e2e tests are not affected by changes - skipping"
+          fi
+
+      - name: Run CLI e2e tests
+        if: steps.check-affected.outputs.affected == 'true'
+        run: pnpm nx test:e2e cli
+
   # ────────────────────────────────── 3. DEPLOY WEBSITE ───────────────────────────
   deploy-website:
-    needs: [build-and-test, edge-worker-e2e]
+    needs: [build-and-test, edge-worker-e2e, cli-e2e]
     runs-on: ubuntu-latest
     environment: ${{ github.event_name == 'pull_request' && 'preview' || 'production' }}
     env:
@@ -203,7 +256,7 @@ jobs:
   # ────────────────────────────────── 4. DEPLOY DEMO ───────────────────────────
   deploy-demo:
     if: false # temporarily disabled
-    needs: [build-and-test, edge-worker-e2e]
+    needs: [build-and-test, edge-worker-e2e, cli-e2e]
     runs-on: ubuntu-latest
     environment: ${{ github.event_name == 'pull_request' && 'preview' || 'production' }}
     env: