From a94c5adc6f19268c8fc97a6074eecc677b968538 Mon Sep 17 00:00:00 2001
From: "marcin p. joachimiak" <4625870+realmarcin@users.noreply.github.com>
Date: Tue, 30 Jun 2026 14:17:20 -0700
Subject: [PATCH] Deploy docs/ to GitHub Pages via Actions

Flip the Pages workflow from artifact-upload to actions/deploy-pages: publish
the committed docs/ web root (landing, browser, UMAP, data) and auto-enable
Pages (configure-pages enablement: true). Served verbatim (no Jekyll).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .github/workflows/generate-pages.yaml | 68 +++++++++++----------------
 1 file changed, 28 insertions(+), 40 deletions(-)

diff --git a/.github/workflows/generate-pages.yaml b/.github/workflows/generate-pages.yaml
index e551d432..69da0bdc 100644
--- a/.github/workflows/generate-pages.yaml
+++ b/.github/workflows/generate-pages.yaml
@@ -1,60 +1,48 @@
-name: Generate per-community pages
+name: Deploy GitHub Pages
 
-# Renders Phase 5 per-community HTML pages with embedded Mermaid
-# membership graphs. Uploads as workflow artifact (no Pages deploy
-# yet — flip to actions/deploy-pages once you've enabled Pages in
-# repo settings).
-#
-# Phase 5 of the dismech-pattern port; see
-# ../../../culturebotai-claw/docs/proposals/phase5_mkdocs_material_and_browser_parity.md
+# Publishes CommunityMech's static site (the committed `docs/` web root:
+# landing page, faceted community browser, per-community pages, community
+# UMAP, and data) to GitHub Pages via the Actions deploy path. `docs/` is
+# generated locally (`just gen-html` / `just gen-umap`) and committed; the
+# site is served verbatim (docs/.nojekyll).
 
 on:
   push:
     branches: [main]
     paths:
-      - "kb/communities/**.yaml"
-      - "src/communitymech/templates/**"
-      - "src/communitymech/render_community_pages.py"
+      - "docs/**"
       - ".github/workflows/generate-pages.yaml"
   workflow_dispatch:
 
 permissions:
   contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
 
 jobs:
-  build:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout CommunityMech
+      - name: Checkout
         uses: actions/checkout@v4
-        with:
-          path: CommunityMech
 
-      - name: Checkout claw (kg_microbe_browser)
-        uses: actions/checkout@v4
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
         with:
-          repository: CultureBotAI/culturebotai-claw
-          path: culturebotai-claw
+          enablement: true
 
-      - uses: actions/setup-python@v5
+      - name: Upload docs/ artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          python-version: "3.13"
-
-      - name: Install deps
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install pyyaml jinja2 markupsafe
-
-      - name: Render per-community pages
-        env:
-          PYTHONPATH: ${{ github.workspace }}/culturebotai-claw/src
-        run: |
-          cd CommunityMech
-          python src/communitymech/render_community_pages.py
-
-      - name: Upload artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: community-pages-${{ github.run_id }}
-          path: CommunityMech/pages/
-          retention-days: 30
+          path: docs
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4