From f56a4de6df57fd47b93b9ff454afe8e0dcaa4006 Mon Sep 17 00:00:00 2001
From: Imran Siddique <imran.siddique@opaque.co>
Date: Fri, 19 Jun 2026 13:40:19 -0700
Subject: [PATCH] docs: custom domain, workflow fix, build-dir assembly

Switch site_url to cmcp.agentrust-io.com, add CNAME file, fix
checkout@v6 to v4, add concurrency guard, add build-dir assembly
step to match trace-spec pattern.

Signed-off-by: Imran Siddique <imran.siddique@opaque.co>
---
 .github/workflows/docs.yml | 31 +++++++++++++++++++++++++++++--
 CNAME                      |  1 +
 mkdocs.yml                 |  2 +-
 3 files changed, 31 insertions(+), 3 deletions(-)
 create mode 100644 CNAME

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 5be6754..03450d3 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -13,18 +13,23 @@ on:
       - "GOVERNANCE.md"
       - "ROADMAP.md"
       - "LIMITATIONS.md"
+      - "CNAME"
   workflow_dispatch:
 
 permissions:
   contents: write
 
+concurrency:
+  group: docs-deploy
+  cancel-in-progress: false
+
 jobs:
   deploy:
     name: Build and deploy docs
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -38,5 +43,27 @@ jobs:
           pip install -r requirements-docs.txt
           pip install -e ".[dev]"
 
+      - name: Configure git for gh-deploy
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Assemble docs build directory
+        run: |
+          BUILD=.docs_build
+          mkdir -p $BUILD
+
+          if [ -d docs ]; then cp -r docs $BUILD/docs; fi
+
+          for fname in README.md CHANGELOG.md CONTRIBUTING.md GOVERNANCE.md ROADMAP.md LIMITATIONS.md CNAME; do
+            if [ -f "$fname" ]; then cp "$fname" "$BUILD/$fname"; fi
+          done
+
+          echo "Build dir contains $(find $BUILD -type f | wc -l) files"
+
+      - name: Generate build config
+        run: |
+          sed 's|^docs_dir: \.$|docs_dir: .docs_build|' mkdocs.yml > .mkdocs_build.yml
+
       - name: Build and deploy to GitHub Pages
-        run: mkdocs gh-deploy --force --clean
+        run: mkdocs gh-deploy --force --clean --config-file .mkdocs_build.yml
diff --git a/CNAME b/CNAME
new file mode 100644
index 0000000..00fe2d3
--- /dev/null
+++ b/CNAME
@@ -0,0 +1 @@
+cmcp.agentrust-io.com
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index e5e433d..cdb2157 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,6 +1,6 @@
 site_name: cMCP
 site_description: Confidential MCP Runtime — hardware-attested policy enforcement for MCP tool calls
-site_url: https://agentrust-io.github.io/cmcp
+site_url: https://cmcp.agentrust-io.com
 repo_url: https://github.com/agentrust-io/cmcp
 repo_name: agentrust-io/cmcp
 edit_uri: edit/main/