ci(release): attach changelog and release docs to GitHub Release

Stage CHANGELOG and docs/releases/v* notes + asset manifest as okcode-*.md
uploads alongside desktop artifacts.

Made-with: Cursor

Author: BunsDev

.github/workflows/release.yml

@@ -285,6 +285,26 @@ jobs:
             release-assets/latest-mac-x64.yml
           rm -f release-assets/latest-mac-x64.yml
 
+      - name: Stage documentation for release assets
+        env:
+          RELEASE_VERSION: ${{ needs.preflight.outputs.version }}
+        run: |
+          set -euo pipefail
+          v="${RELEASE_VERSION}"
+          notes="docs/releases/v${v}.md"
+          manifest="docs/releases/v${v}/assets.md"
+          if [[ ! -f "$notes" ]]; then
+            echo "Missing release notes: $notes" >&2
+            exit 1
+          fi
+          if [[ ! -f "$manifest" ]]; then
+            echo "Missing asset manifest: $manifest" >&2
+            exit 1
+          fi
+          cp CHANGELOG.md release-assets/okcode-CHANGELOG.md
+          cp "$notes" release-assets/okcode-RELEASE-NOTES.md
+          cp "$manifest" release-assets/okcode-ASSETS-MANIFEST.md
+
       - name: Publish release
         uses: softprops/action-gh-release@v2
         with:
@@ -301,6 +321,9 @@ jobs:
             release-assets/*.exe
             release-assets/*.blockmap
             release-assets/latest*.yml
+            release-assets/okcode-CHANGELOG.md
+            release-assets/okcode-RELEASE-NOTES.md
+            release-assets/okcode-ASSETS-MANIFEST.md
           fail_on_unmatched_files: true
 
   finalize:

docs/release.md

@@ -11,7 +11,7 @@ This document covers how to run desktop releases from one tag, first without sig
   - macOS `x64` DMG
   - Linux `x64` AppImage
   - Windows `x64` NSIS installer
-- Publishes one GitHub Release with all produced files.
+- Publishes one GitHub Release with all produced files (desktop installers, updater metadata, and copies of `CHANGELOG.md` plus `docs/releases/vX.Y.Z.md` and `docs/releases/vX.Y.Z/assets.md` as `okcode-*.md` attachments).
   - Versions with a suffix after `X.Y.Z` (for example `1.2.3-alpha.1`) are published as GitHub prereleases.
   - Only plain `X.Y.Z` releases are marked as the repository's latest release.
 - Includes Electron auto-update metadata (for example `latest*.yml` and `*.blockmap`) in release assets.

docs/releases/README.md

@@ -7,3 +7,5 @@ Human-readable notes and asset inventories for tagged releases.
 | [0.0.1](v0.0.1.md) | First public tag | [manifest](v0.0.1/assets.md) |
 
 The repository root [CHANGELOG.md](../../CHANGELOG.md) summarizes versions in Keep a Changelog form.
+
+Each release workflow also uploads **`okcode-CHANGELOG.md`**, **`okcode-RELEASE-NOTES.md`**, and **`okcode-ASSETS-MANIFEST.md`** to the GitHub Release (see [.github/workflows/release.yml](../../.github/workflows/release.yml)).

docs/releases/v0.0.1/assets.md

@@ -2,7 +2,15 @@
 
 Binaries are **not** stored in this git repository; they are attached to the [GitHub Release for `v0.0.1`](https://github.com/OpenKnots/okcode/releases/tag/v0.0.1) by the [Release Desktop workflow](../../.github/workflows/release.yml).
 
-After the workflow completes, expect artifacts similar to the following (exact names may include the product name `OK Code` and version `0.0.1`).
+The GitHub Release also includes **documentation attachments** (same content as in-repo, stable filenames for download):
+
+| File                        | Source in repo                        |
+| --------------------------- | ------------------------------------- |
+| `okcode-CHANGELOG.md`       | [CHANGELOG.md](../../../CHANGELOG.md) |
+| `okcode-RELEASE-NOTES.md`   | [v0.0.1.md](../v0.0.1.md)             |
+| `okcode-ASSETS-MANIFEST.md` | This file                             |
+
+After the workflow completes, expect **installer and updater** artifacts similar to the following (exact names may include the product name `OK Code` and version `0.0.1`).
 
 ## Desktop installers and payloads