Merge pull request #13 from eqtylab/gov-220

GOV-220: Retire deployment docsite sources

Author: captjt

.github/workflows/docsite-ci.yaml

@@ -7,7 +7,6 @@ on:
       - ".github/workflows/helm-ci.yaml"
       - "charts/**"
       - "releases/**"
-      - "docs-site/**"
       - "schemas/**"
   push:
     branches:
@@ -16,7 +15,6 @@ on:
       - ".github/workflows/helm-ci.yaml"
       - "charts/**"
       - "releases/**"
-      - "docs-site/**"
       - "schemas/**"
   workflow_dispatch:
 
@@ -136,6 +134,9 @@ jobs:
 
             validation_mode="$(yq '.validation.mode' "$manifest")"
             validation_status="$(yq '.validation.evidence.status' "$manifest")"
+            docs_provider="$(yq '.docs.provider // ""' "$manifest")"
+            docs_version="$(yq '.docs.version // ""' "$manifest")"
+            docs_state="$(yq '.docs.state // ""' "$manifest")"
 
             if [ "$validation_mode" != "manual" ]; then
               echo "::error file=${manifest}::validation.mode must be manual"
@@ -150,6 +151,51 @@ jobs:
                 ;;
             esac
 
+            case "$docs_provider" in
+              readme|self-hosted) ;;
+              *)
+                echo "::error file=${manifest}::docs.provider must be readme or self-hosted"
+                exit 1
+                ;;
+            esac
+
+            if [ -z "$docs_version" ] || [ "$docs_version" = "null" ]; then
+              echo "::error file=${manifest}::docs.version is required"
+              exit 1
+            fi
+
+            case "$docs_state" in
+              beta|public|hidden|deprecated) ;;
+              *)
+                echo "::error file=${manifest}::docs.state must be beta, public, hidden, or deprecated"
+                exit 1
+                ;;
+            esac
+
+            if [ "$docs_provider" = "self-hosted" ]; then
+              docs_source_repo="$(yq '.docs.sourceRepository // ""' "$manifest")"
+              docs_source_commit="$(yq '.docs.sourceCommit // ""' "$manifest")"
+              docs_source_format="$(yq '.docs.sourceFormat // ""' "$manifest")"
+              docs_workflow_run_url="$(yq '.docs.workflowRunUrl // ""' "$manifest")"
+
+              if [ "$docs_source_repo" != "eqtylab/governance-platform-docs" ]; then
+                echo "::error file=${manifest}::self-hosted docs must set docs.sourceRepository=eqtylab/governance-platform-docs"
+                exit 1
+              fi
+              if [ "$docs_source_format" != "mdx" ]; then
+                echo "::error file=${manifest}::self-hosted docs must set docs.sourceFormat=mdx"
+                exit 1
+              fi
+              if [ -z "$docs_source_commit" ] || [ "$docs_source_commit" = "null" ]; then
+                echo "::error file=${manifest}::self-hosted docs must set docs.sourceCommit"
+                exit 1
+              fi
+              if [ -z "$docs_workflow_run_url" ] || [ "$docs_workflow_run_url" = "null" ]; then
+                echo "::error file=${manifest}::self-hosted docs must set docs.workflowRunUrl"
+                exit 1
+              fi
+            fi
+
             images=(authService governanceService governanceStudio integrityService)
             if [ "$(yq '.charts.eqtyPdfgen.name // ""' "$manifest")" = "eqty-pdfgen" ]; then
               images+=(eqtyPdfgen)
@@ -194,7 +240,7 @@ jobs:
 
       - name: Prevent latest image tags in release-facing files
         run: |
-          if grep -RIn --include='*.yaml' --include='*.yml' --include='*.md' ':latest' charts releases docs-site 2>/dev/null; then
+          if grep -RIn --include='*.yaml' --include='*.yml' --include='*.md' ':latest' charts releases 2>/dev/null; then
             echo "::error::Customer release files must not reference latest image tags."
             exit 1
           fi

.github/workflows/helm-ci.yaml

@@ -151,6 +151,55 @@ jobs:
             fi
           done
 
+          docs_provider="$(yq '.docs.provider // ""' "$MANIFEST")"
+          docs_version="$(yq '.docs.version // ""' "$MANIFEST")"
+          docs_state="$(yq '.docs.state // ""' "$MANIFEST")"
+
+          case "$docs_provider" in
+            readme|self-hosted) ;;
+            *)
+              echo "::error file=${MANIFEST}::docs.provider must be readme or self-hosted."
+              exit 1
+              ;;
+          esac
+
+          if [ -z "$docs_version" ] || [ "$docs_version" = "null" ]; then
+            echo "::error file=${MANIFEST}::docs.version is required."
+            exit 1
+          fi
+
+          case "$docs_state" in
+            beta|public|hidden|deprecated) ;;
+            *)
+              echo "::error file=${MANIFEST}::docs.state must be beta, public, hidden, or deprecated."
+              exit 1
+              ;;
+          esac
+
+          if [ "$docs_provider" = "self-hosted" ]; then
+            docs_source_repo="$(yq '.docs.sourceRepository // ""' "$MANIFEST")"
+            docs_source_commit="$(yq '.docs.sourceCommit // ""' "$MANIFEST")"
+            docs_source_format="$(yq '.docs.sourceFormat // ""' "$MANIFEST")"
+            docs_workflow_run_url="$(yq '.docs.workflowRunUrl // ""' "$MANIFEST")"
+
+            if [ "$docs_source_repo" != "eqtylab/governance-platform-docs" ]; then
+              echo "::error file=${MANIFEST}::self-hosted docs must set docs.sourceRepository=eqtylab/governance-platform-docs."
+              exit 1
+            fi
+            if [ "$docs_source_format" != "mdx" ]; then
+              echo "::error file=${MANIFEST}::self-hosted docs must set docs.sourceFormat=mdx."
+              exit 1
+            fi
+            if [ -z "$docs_source_commit" ] || [ "$docs_source_commit" = "null" ]; then
+              echo "::error file=${MANIFEST}::self-hosted docs must set docs.sourceCommit."
+              exit 1
+            fi
+            if [ -z "$docs_workflow_run_url" ] || [ "$docs_workflow_run_url" = "null" ]; then
+              echo "::error file=${MANIFEST}::self-hosted docs must set docs.workflowRunUrl."
+              exit 1
+            fi
+          fi
+
       - name: Helm validation
         env:
           MANIFEST: ${{ steps.release.outputs.manifest }}
@@ -269,18 +318,14 @@ jobs:
           MANIFEST: ${{ steps.release.outputs.manifest }}
         run: |
           package_root="dist/governance-platform-v${VERSION}"
-          mkdir -p "$package_root/charts" "$package_root/docs" "$package_root/examples"
+          mkdir -p "$package_root/charts" "$package_root/examples"
 
           cp "$MANIFEST" "$package_root/release-manifest.yaml"
           cp dist/chart-digests.yaml "$package_root/chart-digests.yaml"
           cp dist/charts/*.tgz "$package_root/charts/"
           cp dist/charts/*.sha256 "$package_root/charts/"
           cp -R charts/governance-platform/examples "$package_root/examples/governance-platform"
 
-          if [ -d docs-site ]; then
-            cp -R docs-site "$package_root/docs/docs-site"
-          fi
-
           cat > "$package_root/INSTALL.md" <<EOF
           # Governance Platform v${VERSION}
 

.github/workflows/release-platform-package.yaml

@@ -1,6 +1,5 @@
 # Governance Platform Deployment
 
-[![Docsite CI](https://github.com/eqtylab/deployment/actions/workflows/docsite-ci.yaml/badge.svg)](https://github.com/eqtylab/deployment/actions/workflows/docsite-ci.yaml)
 [![Helm CI](https://github.com/eqtylab/deployment/actions/workflows/helm-ci.yaml/badge.svg)](https://github.com/eqtylab/deployment/actions/workflows/helm-ci.yaml)
 [![Release Platform Package](https://github.com/eqtylab/deployment/actions/workflows/release-platform-package.yaml/badge.svg)](https://github.com/eqtylab/deployment/actions/workflows/release-platform-package.yaml)
 
@@ -31,7 +30,6 @@
 - **[`releases/`](./releases/)** — Per-version release manifests pinning chart versions, image digests, and source refs for each platform release.
 - **[`containers/`](./containers/)** — Custom container image builds (e.g. patched PostgreSQL) used by the platform.
 - **[`schemas/`](./schemas/)** — JSON schemas for release manifests and other structured artifacts in this repo.
-- **[`docs-site/`](./docs-site/)** — Source for the hosted customer documentation site.
 
 ## 📦 Versioning