docs: tighten repo metadata and release narrative

Author: pallyoung

.github/workflows/publish.yml

@@ -100,7 +100,16 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          gh release create "${{ steps.release.outputs.tag }}" \
-            --title "@spencer-kit/coder-studio ${{ steps.release.outputs.version }}" \
-            --generate-notes \
-            --verify-tag
+          release_notes_file="docs/promotion/releases/${{ steps.release.outputs.tag }}.md"
+
+          if [ -f "${release_notes_file}" ]; then
+            gh release create "${{ steps.release.outputs.tag }}" \
+              --title "@spencer-kit/coder-studio ${{ steps.release.outputs.version }}" \
+              --notes-file "${release_notes_file}" \
+              --verify-tag
+          else
+            gh release create "${{ steps.release.outputs.tag }}" \
+              --title "@spencer-kit/coder-studio ${{ steps.release.outputs.version }}" \
+              --generate-notes \
+              --verify-tag
+          fi

docs/promotion/releases/README.md

@@ -0,0 +1,21 @@
+# Release Narratives
+
+These files are the human-facing release stories for Coder Studio.
+
+They are not a replacement for `packages/cli/CHANGELOG.md`. The changelog remains the canonical package history, while release narratives explain why a release matters, who benefits, and what changed in product terms.
+
+## When to add one
+
+Add a release narrative when a version is published to GitHub and npm, especially when the raw changeset summary is too terse for first-time evaluators.
+
+## Suggested structure
+
+1. Why this release matters
+2. What changed in product language
+3. Who benefits most
+4. Install or upgrade command
+5. Full changelog comparison link
+
+## Current releases
+
+- [v0.3.5](v0.3.5.md)

docs/promotion/releases/v0.3.5.md

@@ -0,0 +1,35 @@
+# Coder Studio v0.3.5
+
+## Why this patch matters
+
+Coder Studio is most valuable when you let Claude Code or Codex run for a while, step away, and return later from another device. That workflow breaks down fast if a silent websocket disconnect causes terminal output to disappear.
+
+`v0.3.5` is a reliability patch focused on that gap. It strengthens terminal recovery so buffered PTY output is replayed after silent disconnects, with better probe-based recovery and keepalive handling.
+
+In practice, this release means:
+
+- less missing terminal output after short network interruptions
+- more confidence when leaving long-running AI tasks unattended
+- better continuity when checking progress from desktop, tablet, or phone
+
+## Included in v0.3.5
+
+- fix terminal websocket recovery so buffered PTY output is replayed after silent disconnects
+- improve probe-based recovery and keepalive handling for long-running terminal sessions
+
+## Who benefits most
+
+- developers running long Claude Code or Codex tasks
+- users checking workspace progress from another device
+- anyone relying on Coder Studio as a persistent browser-based AI coding workspace
+
+## Install or upgrade
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+## Full changelog
+
+- [Compare `v0.3.4...v0.3.5`](https://github.com/spencerkit/coder-studio/compare/v0.3.4...v0.3.5)