pdages

KSemenenko · KSemenenko · commit bfcb511f2f92 · 2026-03-19T16:58:55.000+01:00
diff --git a/.github/workflows/gh-pages-deploy.yml b/.github/workflows/gh-pages-deploy.yml
@@ -1,14 +1,6 @@
 name: Deploy GitHub Pages
 
 on:
-  release:
-    types: [published]
-  push:
-    branches:
-      - main
-    paths:
-      - 'gh-pages/**'
-      - '.github/workflows/gh-pages-deploy.yml'
   workflow_dispatch:
 
 permissions:
@@ -35,30 +27,42 @@ jobs:
           GH_TOKEN: ${{ github.token }}
         run: |
           release_info=$(gh api repos/${{ github.repository }}/releases/latest 2>/dev/null || echo '{}')
+          releases_url="https://github.com/${{ github.repository }}/releases"
 
           if [[ "$release_info" == "{}" ]] || [[ -z "$(echo "$release_info" | jq -r '.tag_name // empty')" ]]; then
-            echo "No releases found, using default values"
-            echo "version=1.0.0" >> "$GITHUB_OUTPUT"
-            echo "publish_date=$(date +%Y-%m-%d)" >> "$GITHUB_OUTPUT"
-            echo "macos_url=https://github.com/${{ github.repository }}/releases" >> "$GITHUB_OUTPUT"
-            echo "windows_url=https://github.com/${{ github.repository }}/releases" >> "$GITHUB_OUTPUT"
-            echo "linux_url=https://github.com/${{ github.repository }}/releases" >> "$GITHUB_OUTPUT"
+            echo "No releases found, using the repo version prefix"
+            version_prefix="$(sed -n "s:.*<DotPilotVersionPrefix[^>]*>\\([^<]*\\)</DotPilotVersionPrefix>.*:\\1:p" ./Directory.Build.props | head -n 1)"
+            if [[ -z "${version_prefix}" ]]; then
+              version_prefix="0.0"
+            fi
+
+            {
+              echo "version=${version_prefix}"
+              echo "publish_date=$(date +%Y-%m-%d)"
+              echo "release_url=${releases_url}"
+              echo "macos_url=${releases_url}"
+              echo "windows_url=${releases_url}"
+              echo "linux_url=${releases_url}"
+            } >> "$GITHUB_OUTPUT"
             exit 0
           fi
 
           version=$(echo "$release_info" | jq -r '.tag_name' | sed 's/^v//')
           publish_date=$(echo "$release_info" | jq -r '.published_at' | cut -d'T' -f1)
-          echo "publish_date=${publish_date}" >> "$GITHUB_OUTPUT"
-          echo "version=${version}" >> "$GITHUB_OUTPUT"
+          release_url=$(echo "$release_info" | jq -r '.html_url // empty')
 
           macos_url=$(echo "$release_info" | jq -r '.assets[] | select(.name | contains("macos")) | .browser_download_url' | head -n 1)
           windows_url=$(echo "$release_info" | jq -r '.assets[] | select(.name | contains("windows")) | .browser_download_url' | head -n 1)
           linux_url=$(echo "$release_info" | jq -r '.assets[] | select(.name | contains("linux")) | .browser_download_url' | head -n 1)
 
-          releases_url="https://github.com/${{ github.repository }}/releases/latest"
-          echo "macos_url=${macos_url:-$releases_url}" >> "$GITHUB_OUTPUT"
-          echo "windows_url=${windows_url:-$releases_url}" >> "$GITHUB_OUTPUT"
-          echo "linux_url=${linux_url:-$releases_url}" >> "$GITHUB_OUTPUT"
+          {
+            echo "publish_date=${publish_date}"
+            echo "version=${version}"
+            echo "release_url=${release_url:-$releases_url}"
+            echo "macos_url=${macos_url:-$releases_url}"
+            echo "windows_url=${windows_url:-$releases_url}"
+            echo "linux_url=${linux_url:-$releases_url}"
+          } >> "$GITHUB_OUTPUT"
 
       - name: Prepare Site
         run: |
@@ -69,6 +73,7 @@ jobs:
           cp ./gh-pages/robots.txt ./site/robots.txt
 
           sed -i "s|{{VERSION}}|${{ steps.release.outputs.version }}|g" ./site/index.html
+          sed -i "s|{{RELEASE_URL}}|${{ steps.release.outputs.release_url }}|g" ./site/index.html
           sed -i "s|{{MACOS_URL}}|${{ steps.release.outputs.macos_url }}|g" ./site/index.html
           sed -i "s|{{WINDOWS_URL}}|${{ steps.release.outputs.windows_url }}|g" ./site/index.html
           sed -i "s|{{LINUX_URL}}|${{ steps.release.outputs.linux_url }}|g" ./site/index.html
diff --git a/.github/workflows/release-publish.yml b/.github/workflows/release-publish.yml
@@ -80,6 +80,8 @@ jobs:
     timeout-minutes: 60
     needs:
       - prepare_release
+    outputs:
+      asset_name: ${{ steps.stage_asset.outputs.asset_name }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -133,18 +135,21 @@ jobs:
             -p:DotPilotBuildNumber=${{ needs.prepare_release.outputs.application_version }}
 
       - name: Stage macOS Release Asset
+        id: stage_asset
         shell: bash
         run: |
           mkdir -p ./artifacts/releases
           source_path="./DotPilot/bin/Release/net10.0-desktop/${{ steps.macos_rid.outputs.rid }}/publish/DotPilot.dmg"
-          target_path="./artifacts/releases/dotpilot-${{ needs.prepare_release.outputs.release_version }}-${{ steps.macos_rid.outputs.asset_suffix }}.dmg"
+          asset_name="dotpilot-${{ needs.prepare_release.outputs.release_version }}-${{ steps.macos_rid.outputs.asset_suffix }}.dmg"
+          target_path="./artifacts/releases/${asset_name}"
 
           if [[ ! -f "${source_path}" ]]; then
             echo "Expected macOS release asset was not produced: ${source_path}" >&2
             exit 1
           fi
 
           cp "${source_path}" "${target_path}"
+          echo "asset_name=${asset_name}" >> "$GITHUB_OUTPUT"
 
       - name: Upload macOS Release Artifact
         uses: actions/upload-artifact@v7
@@ -160,6 +165,8 @@ jobs:
     timeout-minutes: 60
     needs:
       - prepare_release
+    outputs:
+      asset_name: ${{ steps.stage_asset.outputs.asset_name }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -190,17 +197,20 @@ jobs:
           -p:DotPilotBuildNumber=${{ needs.prepare_release.outputs.application_version }}
 
       - name: Stage Windows Release Asset
+        id: stage_asset
         shell: pwsh
         run: |
           New-Item -ItemType Directory -Force -Path .\artifacts\releases | Out-Null
           $sourcePath = ".\DotPilot\bin\Release\net10.0-desktop\win-x64\publish\DotPilot.exe"
-          $targetPath = ".\artifacts\releases\dotpilot-${{ needs.prepare_release.outputs.release_version }}-windows-x64.exe"
+          $assetName = "dotpilot-${{ needs.prepare_release.outputs.release_version }}-windows-x64.exe"
+          $targetPath = ".\artifacts\releases\$assetName"
 
           if (-not (Test-Path $sourcePath)) {
             throw "Expected Windows release asset was not produced: $sourcePath"
           }
 
           Copy-Item $sourcePath $targetPath -Force
+          "asset_name=$assetName" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
 
       - name: Upload Windows Release Artifact
         uses: actions/upload-artifact@v7
@@ -216,6 +226,8 @@ jobs:
     timeout-minutes: 60
     needs:
       - prepare_release
+    outputs:
+      asset_name: ${{ steps.stage_asset.outputs.asset_name }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -260,18 +272,21 @@ jobs:
           sudo chown -R "$USER:$USER" ./bin/Release/net10.0-desktop/linux-x64
 
       - name: Stage Linux Release Asset
+        id: stage_asset
         shell: bash
         run: |
           mkdir -p ./artifacts/releases
           source_path="$(find ./DotPilot/bin/Release/net10.0-desktop/linux-x64/publish -maxdepth 1 -type f -name '*.snap' | sort | head -n 1)"
-          target_path="./artifacts/releases/dotpilot-${{ needs.prepare_release.outputs.release_version }}-linux-x64.snap"
+          asset_name="dotpilot-${{ needs.prepare_release.outputs.release_version }}-linux-x64.snap"
+          target_path="./artifacts/releases/${asset_name}"
 
           if [[ -z "${source_path}" || ! -f "${source_path}" ]]; then
             echo "Expected Linux snap release asset was not produced." >&2
             exit 1
           fi
 
           cp "${source_path}" "${target_path}"
+          echo "asset_name=${asset_name}" >> "$GITHUB_OUTPUT"
 
       - name: Upload Linux Release Artifact
         uses: actions/upload-artifact@v7
@@ -396,3 +411,75 @@ jobs:
           fi
 
           "${release_command[@]}"
+
+  publish_site:
+    name: Publish Release Website
+    runs-on: ubuntu-latest
+    needs:
+      - prepare_release
+      - publish_macos
+      - publish_windows
+      - publish_linux
+      - create_release
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: ${{ github.sha }}
+
+      - name: Prepare Release Website
+        shell: bash
+        env:
+          MACOS_ASSET_NAME: ${{ needs.publish_macos.outputs.asset_name }}
+          WINDOWS_ASSET_NAME: ${{ needs.publish_windows.outputs.asset_name }}
+          LINUX_ASSET_NAME: ${{ needs.publish_linux.outputs.asset_name }}
+          RELEASE_TAG: ${{ needs.prepare_release.outputs.release_tag }}
+          RELEASE_VERSION: ${{ needs.prepare_release.outputs.release_version }}
+          REPOSITORY: ${{ github.repository }}
+        run: |
+          mkdir -p ./site
+
+          cp ./gh-pages/index.html ./site/index.html
+          cp ./gh-pages/sitemap.xml ./site/sitemap.xml
+          cp ./gh-pages/robots.txt ./site/robots.txt
+
+          release_url="https://github.com/${REPOSITORY}/releases/tag/${RELEASE_TAG}"
+          macos_url="https://github.com/${REPOSITORY}/releases/download/${RELEASE_TAG}/${MACOS_ASSET_NAME}"
+          windows_url="https://github.com/${REPOSITORY}/releases/download/${RELEASE_TAG}/${WINDOWS_ASSET_NAME}"
+          linux_url="https://github.com/${REPOSITORY}/releases/download/${RELEASE_TAG}/${LINUX_ASSET_NAME}"
+          publish_date="$(date -u +%Y-%m-%d)"
+
+          sed -i "s|{{VERSION}}|${RELEASE_VERSION}|g" ./site/index.html
+          sed -i "s|{{RELEASE_URL}}|${release_url}|g" ./site/index.html
+          sed -i "s|{{MACOS_URL}}|${macos_url}|g" ./site/index.html
+          sed -i "s|{{WINDOWS_URL}}|${windows_url}|g" ./site/index.html
+          sed -i "s|{{LINUX_URL}}|${linux_url}|g" ./site/index.html
+          sed -i "s|{{PUBLISH_DATE}}|${publish_date}|g" ./site/sitemap.xml
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: ./site
+
+  deploy_site:
+    name: Deploy Release Website
+    runs-on: ubuntu-latest
+    needs:
+      - publish_site
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/AGENTS.md b/AGENTS.md
@@ -208,6 +208,7 @@ For this app:
 - meaningful GitHub review comments must be evaluated and fixed when they still apply even if the original PR was closed; closed review threads are not a reason to ignore valid engineering feedback
 - PR bodies for issue-backed work must use GitHub closing references such as `Closes #14` so merged work closes the tracked issue automatically
 - the release workflow must run automatically on pushes to `main`, build desktop apps, and publish the GitHub Release without requiring a manual dispatch
+- the release path must also publish the GitHub Pages site after the GitHub Release is created, and every site version or download reference must resolve from that release's actual version and assets instead of fallback literals such as `1.0.0`
 - repository rules for `main` must keep an explicit org-admin bypass path for required status checks so repository administrators can perform direct emergency or operator-owned pushes without deadlocking the branch policy
 - after changing GitHub rulesets, workflows, or release packaging, verify against the specific live blocked operation or failing run instead of assuming the policy or YAML change solved the issue
 - desktop app build or publish jobs must use native runners for their target OS: macOS artifacts on macOS runners, Windows artifacts on Windows runners, and Linux artifacts on Linux runners
diff --git a/docs/ADR/ADR-0002-split-github-actions-build-and-release.md b/docs/ADR/ADR-0002-split-github-actions-build-and-release.md
@@ -35,6 +35,7 @@ We will split GitHub Actions into two explicit workflows:
    - publishes desktop release assets for macOS, Windows, and Linux as real packaged outputs instead of raw publish-folder archives
    - uses `.dmg` for macOS, a self-contained single-file `.exe` for Windows, and `.snap` for Linux
    - creates the GitHub Release
+   - publishes the `gh-pages` website after the GitHub Release is created, using the same resolved release version and release asset URLs
    - prepends repo-owned feature summaries and feature-doc links to GitHub-generated release notes
 
 ## Decision Diagram
@@ -50,6 +51,7 @@ flowchart LR
   Version["Version resolved from DotPilot.csproj prefix + CI build number"]
   Publish["Desktop packaged assets (.dmg, .exe, .snap)"]
   GitHubRelease["GitHub Release with feature notes"]
+  Website["GitHub Pages site"]
 
   Change --> Validation
   Validation --> Quality
@@ -59,6 +61,7 @@ flowchart LR
   Release --> Version
   Release --> Publish
   Release --> GitHubRelease
+  Release --> Website
 ```
 
 ## Alternatives Considered
@@ -90,6 +93,7 @@ That makes release quality depend on operator memory instead of repo-owned histo
 - Desktop publish artifacts move to the workflow that actually needs them.
 - Release notes now combine GitHub-generated notes with repo-owned feature context.
 - Release numbers stay predictable: humans own the major/minor prefix in source and CI owns the last segment.
+- The public website now updates in the same release path as the desktop artifacts, so version and download links stay in sync with the published release.
 
 ### Negative
 
diff --git a/docs/Architecture.md b/docs/Architecture.md
@@ -14,6 +14,7 @@ This file is the required start-here architecture map for non-trivial tasks.
 - **Extraction rule:** large non-UI features start in `DotPilot.Core`, but once a slice becomes big enough to need its own boundary, it should move into a dedicated DLL that references `DotPilot.Core`, while the desktop app references that feature DLL directly.
 - **Solution-shape rule:** solution folders may group projects by stable categories such as libraries and tests, but extracted subsystems must still keep their own files, namespaces, and project-local rules inside their real project directory.
 - **Verification boundary:** [../DotPilot.Tests/](../DotPilot.Tests/) covers caller-visible runtime, persistence, contract, and view-model flows through public boundaries. [../DotPilot.UITests/](../DotPilot.UITests/) covers the desktop operator journey from provider setup to streaming chat.
+- **Release website rule:** the desktop release path owns the GitHub Pages publish for [../gh-pages/](../gh-pages/); the site version badge and release download links must resolve from the same CI-derived release version and assets as the GitHub Release.
 
 ## Scoping
 
@@ -30,13 +31,15 @@ flowchart LR
   Root["dotPilot repository root"]
   Governance["AGENTS.md"]
   Architecture["docs/Architecture.md"]
+  Site["gh-pages static website"]
   Ui["DotPilot Uno desktop shell"]
   Core["DotPilot.Core contracts + shared application code"]
   Unit["DotPilot.Tests"]
   UiTests["DotPilot.UITests"]
 
   Root --> Governance
   Root --> Architecture
+  Root --> Site
   Root --> Ui
   Root --> Core
   Root --> Unit
diff --git a/gh-pages/index.html b/gh-pages/index.html
@@ -77,7 +77,7 @@
         "operatingSystem": ["Windows", "macOS", "Linux"],
         "description": "Open source local agent orchestrator built with C# and .NET. Run multiple AI agents locally, build workflows, connect to any AI provider.",
         "url": "https://dotpilot.managed-code.com",
-        "downloadUrl": "https://github.com/managedcode/dotPilot/releases/latest",
+        "downloadUrl": "{{RELEASE_URL}}",
         "softwareVersion": "{{VERSION}}",
         "author": {
             "@type": "Organization",
@@ -750,7 +750,7 @@
                 <div class="hero-layout">
                     <div class="hero-left">
                         <h1>Your <span class="highlight">agents.</span> Your <span class="bold">stack.</span> Your rules.</h1>
-                        <a href="https://github.com/managedcode/dotPilot/releases/latest" class="btn btn-dark">
+                        <a href="{{RELEASE_URL}}" class="btn btn-dark">
                             <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
                                 <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/>
                                 <polyline points="7 10 12 15 17 10"/>
