From 71906469938ebb8fbea59ce9181a3f74cf32de0b Mon Sep 17 00:00:00 2001
From: Jory Irving <joryirving@users.noreply.github.com>
Date: Fri, 19 Jun 2026 10:34:58 -0600
Subject: [PATCH 1/2] docs(release): require hand-written release notes

---
 AGENTS.md | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 140ed79..0870ff9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -351,7 +351,27 @@ Dispatch follows semver. Releases are cut from `main` after each notable fix or
    gh pr merge --repo misospace/dispatch --squash --delete-branch
    ```
 
-6. **Tag and publish release**
+6. **Write release notes**
+   Hand-write release notes by listing the user-facing changes since the previous tag. Do not use `--generate-notes` — auto-generated notes mix dependency bumps and CI chores into the changelog and bury the actual fixes/features operators care about.
+
+   A good template:
+
+   ```markdown
+   ## What's changed
+
+   ### Fixes
+   - <one-line summary of each user-visible bug fix, with PR #>
+
+   ### Features
+   - <one-line summary of each new capability, with PR #>
+
+   ### Maintenance
+   - <dependency bumps, CI/internal changes, with PR #>
+   ```
+
+   Pull the candidate list from `git log v<previous>..HEAD --oneline`, then trim to what operators/users will notice.
+
+7. **Tag and publish release**
    ```bash
    git checkout main
    git pull --ff-only
@@ -360,7 +380,7 @@ Dispatch follows semver. Releases are cut from `main` after each notable fix or
    gh release create v<version> \
      --repo misospace/dispatch \
      --title "v<version>" \
-     --generate-notes
+     --notes-file release-notes-v<version>.md
    ```
 
    The tag push triggers the `Build Dispatch Image` workflow on GitHub Actions, which publishes to `ghcr.io/misospace/dispatch:v<version>`.

From fa700ffd171ec042722bfa3b90f657d9152de2e0 Mon Sep 17 00:00:00 2001
From: Jory Irving <joryirving@users.noreply.github.com>
Date: Fri, 19 Jun 2026 10:34:58 -0600
Subject: [PATCH 2/2] chore: release v0.5.2

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2f808d0..e49d651 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "dispatch",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "dispatch",
-      "version": "0.5.1",
+      "version": "0.5.2",
       "dependencies": {
         "@dnd-kit/core": "^6.1.0",
         "@dnd-kit/sortable": "^10.0.0",
diff --git a/package.json b/package.json
index 49ff06f..0e9902b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "dispatch",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "private": true,
   "engines": {
     "node": ">=24"