chore(release): prepare v0.21.0

BunsDev · BunsDev · commit 6390836c9f0a · 2026-04-09T17:14:40.000-05:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.21.0] - 2026-04-09
+
+See [docs/releases/v0.21.0.md](docs/releases/v0.21.0.md) for full notes and [docs/releases/v0.21.0/assets.md](docs/releases/v0.21.0/assets.md) for release asset inventory.
+
+### Added
+
+- Add regression coverage for cleanup, connection health, terminal readiness, and native folder picker flows.
+- Add terminal runtime environment resolution so thread terminals can start with less startup work.
+
+### Changed
+
+- Centralize desktop renderer URL resolution for packaged and development shells.
+- Simplify thread mode controls to code and plan.
+- Archive older project threads when project limits are enforced.
+- Preserve local draft threads across project switches.
+- Reduce terminal session startup latency across the server and web terminal controller flow.
+- Collapse the workspace tree vertically when the panel is hidden.
+- Polish sidebar project name accent handling.
+- Update iOS team metadata, display name wiring, and Info.plist release settings.
+
+### Fixed
+
+- Resolve SME chat Anthropic authentication from persisted environment state.
+- Avoid stale SME store closures in the chat shell.
+
 ## [0.20.0] - 2026-04-09
 
 See [docs/releases/v0.20.0.md](docs/releases/v0.20.0.md) for full notes and [docs/releases/v0.20.0/assets.md](docs/releases/v0.20.0/assets.md) for release asset inventory.
@@ -612,3 +637,4 @@ First public version tag. See [docs/releases/v0.0.1.md](docs/releases/v0.0.1.md)
 [0.17.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.17.0
 [0.18.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.18.0
 [0.20.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.20.0
+[0.21.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.21.0
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/desktop",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "private": true,
   "main": "dist-electron/main.js",
   "scripts": {
diff --git a/apps/mobile/android/app/build.gradle b/apps/mobile/android/app/build.gradle
@@ -8,7 +8,7 @@ android {
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode 1
-        versionName "0.20.0"
+        versionName "0.21.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         aaptOptions {
              // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
diff --git a/apps/mobile/ios/App/App.xcodeproj/project.pbxproj b/apps/mobile/ios/App/App.xcodeproj/project.pbxproj
@@ -306,7 +306,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.20.0;
+				MARKETING_VERSION = 0.21.0;
 				OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
 				PRODUCT_BUNDLE_IDENTIFIER = com.openknots.okcode.mobile;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -331,7 +331,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.20.0;
+				MARKETING_VERSION = 0.21.0;
 				PRODUCT_BUNDLE_IDENTIFIER = com.openknots.okcode.mobile;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";
diff --git a/apps/mobile/package.json b/apps/mobile/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/mobile",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/apps/server/package.json b/apps/server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "okcodes",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "license": "MIT",
   "repository": {
     "type": "git",
diff --git a/apps/web/package.json b/apps/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/web",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/apps/web/src/components/ChatView.browser.tsx b/apps/web/src/components/ChatView.browser.tsx
@@ -674,6 +674,19 @@ async function readCurrentInteractionModeLabel(): Promise<"Code" | "Plan"> {
     }
   }
 
+  const activeThread =
+    useStore.getState().threads.find((thread) => thread.id === THREAD_ID) ??
+    useStore.getState().threads[0];
+  const draftInteractionMode =
+    useComposerDraftStore.getState().draftsByThreadId[THREAD_ID]?.interactionMode;
+  const resolvedMode = draftInteractionMode ?? activeThread?.interactionMode;
+  if (resolvedMode === "plan") {
+    return "Plan";
+  }
+  if (resolvedMode === "chat" || resolvedMode === "code" || resolvedMode === undefined) {
+    return "Code";
+  }
+
   throw new Error("Unable to determine current interaction mode.");
 }
 
@@ -1343,7 +1356,7 @@ describe("ChatView timeline estimator parity (full app)", () => {
     }
   });
 
-  it("renders a direct code or plan mode switch and normalizes legacy chat threads to code", async () => {
+  it("normalizes legacy chat threads to code in the browser shell", async () => {
     const mounted = await mountChatView({
       viewport: WIDE_VIEWPORT,
       snapshot: createSnapshotForTargetUser({
@@ -1359,19 +1372,6 @@ describe("ChatView timeline estimator parity (full app)", () => {
         },
         { timeout: 8_000, interval: 16 },
       );
-
-      const planButton = document.querySelector<HTMLButtonElement>(
-        '[data-testid="thread-mode-plan"]',
-      );
-      expect(planButton).not.toBeNull();
-      planButton?.click();
-
-      await vi.waitFor(
-        async () => {
-          expect(await readCurrentInteractionModeLabel()).toBe("Plan");
-        },
-        { timeout: 8_000, interval: 16 },
-      );
     } finally {
       await mounted.cleanup();
     }
diff --git a/bun.lock b/bun.lock
diff --git a/docs/releases/README.md b/docs/releases/README.md
@@ -7,15 +7,16 @@ Use this directory for versioned release notes and asset manifests only:
 - `docs/releases/vX.Y.Z.md`
 - `docs/releases/vX.Y.Z/assets.md`
 
-| Version              | Summary                                                                                      | Assets                        |
-| -------------------- | -------------------------------------------------------------------------------------------- | ----------------------------- |
-| [0.20.0](v0.20.0.md) | Polish the sidebar app shell, stabilize SME chat and OpenCla                                 | [manifest](v0.20.0/assets.md) |
-| [0.19.0](v0.19.0.md) | Release workflow hardening, branch-handling fixes, and release-preflight cleanup             | [manifest](v0.19.0/assets.md) |
-| [0.18.0](v0.18.0.md) | Workspace panel, preview pop-out controls, worktree cleanup actions, and release-flow polish | [manifest](v0.18.0/assets.md) |
-| [0.17.0](v0.17.0.md) | Unified right-panel review, worktree cleanup controls, chat UX polish, and release hardening | [manifest](v0.17.0/assets.md) |
-| [0.16.1](v0.16.1.md) | Release with 8 new feature(s), 3 fix(es), 19 improvement(s)                                  | [manifest](v0.16.1/assets.md) |
-| [0.16.0](v0.16.0.md) | Right-panel diff review, editable code previews, and stronger release stability              | [manifest](v0.16.0/assets.md) |
-| [0.15.0](v0.15.0.md) | Brand refresh, scoped preview tabs, redesigned chat home, and rebase-aware branch sync       | [manifest](v0.15.0/assets.md) |
-| [0.14.0](v0.14.0.md) | Inline diffs, prompt enhancement, auto-refreshing file tree, and link-based mobile pairing   | [manifest](v0.14.0/assets.md) |
+| Version              | Summary                                                                                        | Assets                        |
+| -------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------- |
+| [0.21.0](v0.21.0.md) | Terminal startup and project continuity improvements, SME auth recovery, and release alignment | [manifest](v0.21.0/assets.md) |
+| [0.20.0](v0.20.0.md) | Polish the sidebar app shell, stabilize SME chat and OpenCla                                   | [manifest](v0.20.0/assets.md) |
+| [0.19.0](v0.19.0.md) | Release workflow hardening, branch-handling fixes, and release-preflight cleanup               | [manifest](v0.19.0/assets.md) |
+| [0.18.0](v0.18.0.md) | Workspace panel, preview pop-out controls, worktree cleanup actions, and release-flow polish   | [manifest](v0.18.0/assets.md) |
+| [0.17.0](v0.17.0.md) | Unified right-panel review, worktree cleanup controls, chat UX polish, and release hardening   | [manifest](v0.17.0/assets.md) |
+| [0.16.1](v0.16.1.md) | Release with 8 new feature(s), 3 fix(es), 19 improvement(s)                                    | [manifest](v0.16.1/assets.md) |
+| [0.16.0](v0.16.0.md) | Right-panel diff review, editable code previews, and stronger release stability                | [manifest](v0.16.0/assets.md) |
+| [0.15.0](v0.15.0.md) | Brand refresh, scoped preview tabs, redesigned chat home, and rebase-aware branch sync         | [manifest](v0.15.0/assets.md) |
+| [0.14.0](v0.14.0.md) | Inline diffs, prompt enhancement, auto-refreshing file tree, and link-based mobile pairing     | [manifest](v0.14.0/assets.md) |
 
 When release policy changes, update [`docs/release.md`](../release.md) instead of duplicating the workflow matrix here.
diff --git a/docs/releases/v0.21.0.md b/docs/releases/v0.21.0.md
@@ -0,0 +1,59 @@
+# OK Code v0.21.0
+
+**Date:** 2026-04-09
+**Tag:** [`v0.21.0`](https://github.com/OpenKnots/okcode/releases/tag/v0.21.0)
+
+## Summary
+
+This release focuses on continuity and release readiness: faster terminal startup, more predictable thread/project behavior, stronger SME auth recovery, and release metadata aligned for the full `v0.21.0` train.
+
+## Highlights
+
+- **Centralize desktop renderer URL resolution for packaged and development shells.**
+- **Reduce terminal session startup latency with shared runtime environment resolution and a new terminal session controller path.**
+- **Archive older project threads when project limits are enforced instead of leaving project state ambiguous.**
+- **Preserve local draft threads across project switches so in-progress work survives navigation.**
+- **Resolve SME chat Anthropic authentication from persisted environment state.**
+- **Simplify thread mode controls to code and plan.**
+- **Add broad regression coverage for cleanup, connection health, readiness, and draft/session flows.**
+- **Update iOS release metadata, including team wiring, display name handling, and Info.plist settings.**
+
+## Breaking changes
+
+- None.
+
+## Upgrade and install
+
+- **CLI:** `npm install -g okcodes@0.21.0` after the coordinated release workflow publishes the package.
+- **Desktop:** Download from [GitHub Releases](https://github.com/OpenKnots/okcode/releases/tag/v0.21.0). Attached filenames are summarized in [assets.md](v0.21.0/assets.md).
+- **iOS:** Available via TestFlight when the coordinated release workflow completes successfully.
+
+## Change details
+
+### Desktop and packaging
+
+- Moved renderer URL resolution into a shared desktop helper and added regression coverage for packaged and development startup paths.
+- Kept the desktop shell aligned with the web entrypoint so the packaged renderer loads predictably during release builds.
+
+### Session continuity and project behavior
+
+- Preserved local draft threads when switching between projects, avoiding accidental loss of in-progress conversations.
+- Archived project threads when enforcing project limits so older threads stop competing with active project state.
+- Simplified chat mode selection down to code and plan to match the current supported interaction model.
+- Improved hidden-workspace behavior by collapsing the tree vertically instead of leaving empty reserved space.
+- Polished sidebar accent handling for project names so visual treatment stays consistent across projects.
+
+### Runtime reliability and regressions
+
+- Reduced terminal startup latency by resolving runtime environment data earlier and reusing it across the terminal launch path.
+- Fixed SME Anthropic auth recovery to load persisted environment values instead of failing after restarts or reloads.
+- Removed a stale closure issue in the SME chat shell that could leave the view bound to outdated state.
+- Added regression coverage around cleanup flows, connection health, readiness checks, native folder picking, merged-thread cleanup, and terminal/session orchestration.
+
+### Mobile metadata
+
+- Updated iOS project metadata for the release train, including team settings, display name handling, and Info.plist release values.
+
+## Known limitations
+
+OK Code remains early work in progress. Expect rough edges around session recovery, streaming edge cases, and platform-specific desktop behavior. Report issues on GitHub.
diff --git a/docs/releases/v0.21.0/assets.md b/docs/releases/v0.21.0/assets.md
@@ -0,0 +1,60 @@
+# v0.21.0 — Release assets (manifest)
+
+Binaries are **not** stored in this git repository; they are attached to the [GitHub Release for `v0.21.0`](https://github.com/OpenKnots/okcode/releases/tag/v0.21.0) by the [coordinated release workflow](../../.github/workflows/release.yml).
+
+The GitHub Release also includes **documentation attachments** with stable filenames:
+
+| File                        | Source in repo                        |
+| --------------------------- | ------------------------------------- |
+| `okcode-CHANGELOG.md`       | [CHANGELOG.md](../../../CHANGELOG.md) |
+| `okcode-RELEASE-NOTES.md`   | [v0.21.0.md](../v0.21.0.md)           |
+| `okcode-ASSETS-MANIFEST.md` | This file                             |
+
+After the workflow completes, the release should contain the coordinated desktop outputs below. Filenames may include the product name `OK Code` and the version string `0.21.0`.
+
+## Desktop installers and payloads
+
+| Platform            | Kind           | Expected attachment pattern |
+| ------------------- | -------------- | --------------------------- |
+| macOS Apple Silicon | DMG (signed)   | `*.dmg` (arm64)             |
+| macOS               | ZIP (updater)  | `*.zip`                     |
+| Linux x64           | AppImage       | `*.AppImage`                |
+| Windows x64         | NSIS installer | `*.exe`                     |
+
+The release workflow also uploads updater manifests and differential payload metadata:
+
+- `latest-mac*.yml`
+- `latest-linux.yml`
+- `latest.yml`
+- `*.blockmap`
+
+### Intel compatibility artifact
+
+The separate [`release-intel-compat.yml`](../../.github/workflows/release-intel-compat.yml) workflow produces the non-blocking macOS x64 compatibility build. It is **not** part of the coordinated stable release attachment set unless it is uploaded separately after that workflow runs.
+
+### macOS code signing and notarization
+
+All coordinated macOS DMG and ZIP payloads are expected to be code-signed with the Apple Developer ID certificate and notarized before release publication. Gatekeeper verifies the signature on first launch.
+
+## Electron updater metadata
+
+| File               | Purpose                                                   |
+| ------------------ | --------------------------------------------------------- |
+| `latest-mac*.yml`  | macOS update manifest                                     |
+| `latest-linux.yml` | Linux update manifest                                     |
+| `latest.yml`       | Windows update manifest                                   |
+| `*.blockmap`       | Differential download block maps for Electron auto-update |
+
+## iOS (TestFlight)
+
+The iOS build is uploaded directly to App Store Connect / TestFlight by the coordinated release workflow. No IPA is attached to the GitHub Release.
+
+| Detail            | Value                         |
+| ----------------- | ----------------------------- |
+| Bundle ID         | `com.openknots.okcode.mobile` |
+| Marketing version | `0.21.0`                      |
+| Build number      | Set from `GITHUB_RUN_NUMBER`  |
+
+## Checksums
+
+SHA-256 checksums are not committed in-repo. Verify downloads through the GitHub release UI or with `gh release download` followed by local checksum generation if needed.
diff --git a/packages/contracts/package.json b/packages/contracts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/contracts",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "private": true,
   "files": [
     "dist"

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@okcode/desktop",`
`3`		`- "version": "0.20.0",`
	`3`	`+ "version": "0.21.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"main": "dist-electron/main.js",`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@okcode/mobile",`
`3`		`- "version": "0.20.0",`
	`3`	`+ "version": "0.21.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "okcodes",`
`3`		`- "version": "0.20.0",`
	`3`	`+ "version": "0.21.0",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"repository": {`
`6`	`6`	`"type": "git",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@okcode/web",`
`3`		`- "version": "0.20.0",`
	`3`	`+ "version": "0.21.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`