diff --git a/README.md b/README.md
index 869acfadb..bffdea21e 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,19 @@ One command. Walk away. Come back to a built project with clean git history.
 
 ---
 
+## What's New in v2.28
+
+- **`gsd headless query`** — instant JSON snapshot of project state (~50ms, no LLM session)
+- **`/gsd update`** — update GSD to the latest version without leaving your session
+- **`/gsd export --html --all`** — generate retrospective HTML reports for all milestones at once
+- **Reliability hardening** — atomic file writes, OAuth fetch timeouts, RPC exit detection, blob GC, LSP init retry with backoff
+- **RPC utilities** now part of the public API for headless/scripted integrations
+- **npm** established as the canonical package manager
+
+See the full [Changelog](./CHANGELOG.md) for details.
+
+---
+
 ## Documentation
 
 Full documentation is available in the [`docs/`](./docs/) directory:
diff --git a/docs/auto-mode.md b/docs/auto-mode.md
index 59b05a400..5a6e83f1b 100644
--- a/docs/auto-mode.md
+++ b/docs/auto-mode.md
@@ -157,7 +157,11 @@ After a milestone completes, GSD auto-generates a self-contained HTML report in
 auto_report: true    # enabled by default
 ```
 
-Generate manually anytime with `/gsd export --html`.
+Generate manually anytime with `/gsd export --html`, or generate reports for all milestones at once with `/gsd export --html --all` (v2.28).
+
+### Failure Recovery (v2.28)
+
+v2.28 hardens auto-mode reliability with multiple safeguards: atomic file writes prevent corruption on crash, OAuth fetch timeouts (30s) prevent indefinite hangs, RPC subprocess exit is detected and reported, and blob garbage collection prevents unbounded disk growth. Combined with the existing crash recovery and headless auto-restart, auto-mode is designed for true "fire and forget" overnight execution.
 
 ## Controlling Auto Mode
 
diff --git a/docs/commands.md b/docs/commands.md
index 13ddea04c..a34673c90 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -19,6 +19,8 @@
 | `/gsd cleanup` | Clean up GSD state files and stale worktrees |
 | `/gsd visualize` | Open workflow visualizer (progress, deps, metrics, timeline) |
 | `/gsd export --html` | Generate self-contained HTML report for current or completed milestone |
+| `/gsd export --html --all` | Generate retrospective reports for all milestones at once |
+| `/gsd update` | Update GSD to the latest version in-session |
 | `/gsd knowledge` | Add persistent project knowledge (rule, pattern, or lesson) |
 | `/gsd help` | Categorized command reference with descriptions for all GSD subcommands |
 
@@ -192,3 +194,30 @@ gsd --mode mcp
 ```
 
 The server registers all tools from the agent session and maps MCP `tools/list` and `tools/call` requests to GSD tool definitions. It runs until the transport closes.
+
+## In-Session Update
+
+`/gsd update` checks npm for a newer version of GSD and installs it without leaving the session.
+
+```bash
+/gsd update
+# Current version: v2.28.0
+# Checking npm registry...
+# Updated to v2.29.0. Restart GSD to use the new version.
+```
+
+If already up to date, it reports so and takes no action.
+
+## Export
+
+`/gsd export` generates reports of milestone work.
+
+```bash
+# Generate HTML report for the active milestone
+/gsd export --html
+
+# Generate retrospective reports for ALL milestones at once
+/gsd export --html --all
+```
+
+Reports are saved to `.gsd/reports/` with a browseable `index.html` that links to all generated snapshots.
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 68599f171..c2e991f58 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -8,7 +8,7 @@ npm install -g gsd-pi
 
 Requires Node.js ≥ 20.6.0 (22+ recommended) and Git.
 
-GSD checks for updates once every 24 hours. When a new version is available, you'll see an interactive prompt at startup with the option to update immediately or skip.
+GSD checks for updates once every 24 hours. When a new version is available, you'll see an interactive prompt at startup with the option to update immediately or skip. You can also update from within a session with `/gsd update`.
 
 ### VS Code Extension