PR 25424 static inspection only; no runtime recovery verified
--- platform ---
Linux 6.8.0-117-generic x86_64
--- exact head ---
362797ef244b2f222a2751caffe20705617553ac
--- scope ---
 docs/user/updating.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
--- recovery guidance ---
### macOS app does not reopen after an Alpha update

Updating an older **T3 Code (Alpha)** installation can replace it with
**T3 Code (Beta)** without reopening the app. Open **T3 Code (Beta)** from
Applications, or run:

```sh
open "/Applications/T3 Code (Beta).app"
```

If an old Dock shortcut no longer opens the app, remove it and add the Beta app
from Applications again.

## If the desktop app does not start

If the desktop app's server keeps failing at startup, T3 Code shows a "T3 Code
could not start" window instead of the app. If a newer version is available,
choose **Update** to install it. If not, the window links to the last version
that started on your computer. Download and install it to go back. Use **Copy
details** to include the error in a bug report.

--- packaging ---

  return `${trimmed.slice(0, versionSeparator)}/${trimmed.slice(versionSeparator + 1)}`;
}

export function resolveDesktopProductName(version: string): string {
  return resolveDesktopUpdateChannel(version) === "nightly"
    ? "T3 Code (Nightly)"
    : (desktopPackageJson.productName ?? "T3 Code");
}

export const createBuildConfig = Effect.fn("createBuildConfig")(function* (
  platform: typeof BuildPlatform.Type,
  target: string,
  version: string,
43:  "productName": "T3 Code (Beta)"
--- linux open implementation ---
/usr/bin/xdg-open
--- macos tools ---
codesign unavailable
sw_vers unavailable
--- neighboring sections preserved ---
diff --git a/docs/user/updating.md b/docs/user/updating.md
index cfe746c187..f3d2eee89f 100644
--- a/docs/user/updating.md
+++ b/docs/user/updating.md
@@ -135,6 +135,19 @@ Only one server can use a T3 home directory at a time. If startup reports that
 another server owns it, stop that server before retrying, or use a separate home
 directory and pair with the running server.
 
+### macOS app does not reopen after an Alpha update
+
+Updating an older **T3 Code (Alpha)** installation can replace it with
+**T3 Code (Beta)** without reopening the app. Open **T3 Code (Beta)** from
+Applications, or run:
+
+```sh
+open "/Applications/T3 Code (Beta).app"
+```
+
+If an old Dock shortcut no longer opens the app, remove it and add the Beta app
+from Applications again.
+
 ## If the desktop app does not start
 
 If the desktop app's server keeps failing at startup, T3 Code shows a "T3 Code