chore(release): prepare v0.17.0

BunsDev · BunsDev · commit 75727c7f688f · 2026-04-07T00:17:10.000-05:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-04-07
+
+See [docs/releases/v0.17.0.md](docs/releases/v0.17.0.md) for full notes and [docs/releases/v0.17.0/assets.md](docs/releases/v0.17.0/assets.md) for release asset inventory.
+
+### Added
+
+- Add stale worktree pruning controls in the sidebar.
+- Add merged worktree cleanup flow and cleanup dialog.
+- Add floating chat widget shell for the mobile layout.
+- Add cached syntax highlighting for chat diffs.
+- Add copy buttons to assistant responses.
+- Add collapsible diff file headers.
+- Add PR review workspace helper scripts.
+- Add persistent saved layout preferences.
+
+### Changed
+
+- Unify the right panel into tabbed Files, Editor, and Diffs views.
+- Open terminal file links directly in the code viewer.
+- Show an open-diff action when file summaries are unavailable.
+- Import package scripts when creating projects.
+- Improve sidebar thread shortcuts, header spacing, controls, and project-header contrast.
+- Remove sidebar blur and side-panel hint text from code viewers.
+- Tighten preview blocking so empty toast overlays do not hide the browser preview.
+- Shorten chat shortcut guide titles.
+- Add PR request-changes tone setting support.
+- Prevent the review pane from scrolling independently.
+- Streamline thread UI and desktop build packaging.
+
+### Fixed
+
+- Fix theme hydration and terminal and file navigation stability.
+- Fix desktop release packaging regressions before ship.
+
 ## [0.16.1] - 2026-04-06
 
 See [docs/releases/v0.16.1.md](docs/releases/v0.16.1.md) for full notes and [docs/releases/v0.16.1/assets.md](docs/releases/v0.16.1/assets.md) for release asset inventory.
@@ -517,3 +551,4 @@ First public version tag. See [docs/releases/v0.0.1.md](docs/releases/v0.0.1.md)
 [0.14.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.14.0
 [0.13.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.13.0
 [0.16.1]: https://github.com/OpenKnots/okcode/releases/tag/v0.16.1
+[0.17.0]: https://github.com/OpenKnots/okcode/releases/tag/v0.17.0
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/desktop",
-  "version": "0.16.0",
+  "version": "0.17.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.16.0"
+        versionName "0.17.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
@@ -303,7 +303,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.16.0;
+				MARKETING_VERSION = 0.17.0;
 				OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
 				PRODUCT_BUNDLE_IDENTIFIER = com.openknots.okcode.mobile;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -325,7 +325,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.16.0;
+				MARKETING_VERSION = 0.17.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.16.0",
+  "version": "0.17.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.16.0",
+  "version": "0.17.0",
   "license": "MIT",
   "repository": {
     "type": "git",
diff --git a/apps/server/src/wsServer.test.ts b/apps/server/src/wsServer.test.ts
@@ -54,6 +54,7 @@ import type { GitCoreShape } from "./git/Services/GitCore.ts";
 import { GitCore } from "./git/Services/GitCore.ts";
 import { GitActionExecutionError, GitCommandError } from "./git/Errors.ts";
 import { MigrationError } from "@effect/sql-sqlite-bun/SqliteMigrator";
+import { serverBuildInfo } from "./buildInfo";
 
 const asEventId = (value: string): EventId => EventId.makeUnsafe(value);
 const asProviderItemId = (value: string): ProviderItemId => ProviderItemId.makeUnsafe(value);
@@ -81,6 +82,11 @@ const defaultProviderHealthService: ProviderHealthShape = {
   getStatuses: Effect.succeed(defaultProviderStatuses),
 };
 
+const expectedServerBuildInfo = expect.objectContaining({
+  surface: "server",
+  version: serverBuildInfo.version,
+});
+
 class MockTerminalManager implements TerminalManagerShape {
   private readonly sessions = new Map<string, TerminalSessionSnapshot>();
   private readonly listeners = new Set<(event: TerminalEvent) => void>();
@@ -873,10 +879,7 @@ describe("WebSocket Server", () => {
       issues: [],
       providers: defaultProviderStatuses,
       availableEditors: expect.any(Array),
-      buildInfo: expect.objectContaining({
-        surface: "server",
-        version: "0.16.0",
-      }),
+      buildInfo: expectedServerBuildInfo,
     });
     expectAvailableEditors((response.result as { availableEditors: unknown }).availableEditors);
   });
@@ -903,10 +906,7 @@ describe("WebSocket Server", () => {
       issues: [],
       providers: defaultProviderStatuses,
       availableEditors: expect.any(Array),
-      buildInfo: expect.objectContaining({
-        surface: "server",
-        version: "0.16.0",
-      }),
+      buildInfo: expectedServerBuildInfo,
     });
     expectAvailableEditors((response.result as { availableEditors: unknown }).availableEditors);
 
@@ -944,10 +944,7 @@ describe("WebSocket Server", () => {
       ],
       providers: defaultProviderStatuses,
       availableEditors: expect.any(Array),
-      buildInfo: expect.objectContaining({
-        surface: "server",
-        version: "0.16.0",
-      }),
+      buildInfo: expectedServerBuildInfo,
     });
     expectAvailableEditors((response.result as { availableEditors: unknown }).availableEditors);
     expect(fs.readFileSync(keybindingsPath, "utf8")).toBe("{ not-json");
@@ -1164,10 +1161,7 @@ describe("WebSocket Server", () => {
       issues: [],
       providers: defaultProviderStatuses,
       availableEditors: expect.any(Array),
-      buildInfo: expect.objectContaining({
-        surface: "server",
-        version: "0.16.0",
-      }),
+      buildInfo: expectedServerBuildInfo,
     });
     expectAvailableEditors((response.result as { availableEditors: unknown }).availableEditors);
   });
@@ -1217,10 +1211,7 @@ describe("WebSocket Server", () => {
       issues: [],
       providers: defaultProviderStatuses,
       availableEditors: expect.any(Array),
-      buildInfo: expect.objectContaining({
-        surface: "server",
-        version: "0.16.0",
-      }),
+      buildInfo: expectedServerBuildInfo,
     });
     expectAvailableEditors(
       (configResponse.result as { availableEditors: unknown }).availableEditors,
diff --git a/apps/web/package.json b/apps/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/web",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/apps/web/src/components/CodeViewerPanel.test.tsx b/apps/web/src/components/CodeViewerPanel.test.tsx
@@ -230,6 +230,7 @@ describe("CodeViewerFileContent", () => {
       data: {
         relativePath: "photo.heic",
         contents: "",
+        hasTextContents: false,
         truncated: false,
         sizeBytes: 32,
         previewDataUrl: "data:image/heic;base64,AAAA",
@@ -281,6 +282,7 @@ describe("CodeViewerFileContent", () => {
       data: {
         relativePath: "icon.svg",
         contents: "<svg />",
+        hasTextContents: true,
         truncated: false,
         sizeBytes: 7,
         previewDataUrl: "data:image/svg+xml;base64,PHN2ZyAvPg==",
diff --git a/apps/web/src/components/CodeViewerPanel.tsx b/apps/web/src/components/CodeViewerPanel.tsx
@@ -34,13 +34,21 @@ const AUTOSAVE_DELAY_MS = 750;
 const MANUAL_SAVE_SUCCESS_FLASH_MS = 2200;
 
 function hasTextContentsFromQuery(
-  data: { contents?: string | null } | undefined,
+  data: { contents?: string | null; hasTextContents?: boolean } | undefined,
 ): data is { contents: string } {
+  if (data?.hasTextContents === false) {
+    return false;
+  }
   return typeof data?.contents === "string";
 }
 
 function hasPreviewFromQuery(
-  data: { previewDataUrl?: string | null; previewMimeType?: string | null } | undefined,
+  data:
+    | {
+        previewDataUrl?: string | null | undefined;
+        previewMimeType?: string | null | undefined;
+      }
+    | undefined,
 ): data is { previewDataUrl: string; previewMimeType: string } {
   return typeof data?.previewDataUrl === "string" && typeof data?.previewMimeType === "string";
 }
@@ -446,7 +454,7 @@ export const CodeViewerFileContent = memo(function CodeViewerFileContent(
     );
   }
 
-  if (!hasTextContents && !hasImage) {
+  if (!hasTextContents && preview === null) {
     return (
       <div className="flex flex-1 items-center justify-center px-5 text-center text-xs text-muted-foreground/70">
         No content available.
diff --git a/apps/web/src/components/WorktreeCleanupDialog.tsx b/apps/web/src/components/WorktreeCleanupDialog.tsx
@@ -60,7 +60,7 @@ export function WorktreeCleanupDialog() {
   const removeWorktreeMutation = useMutation(gitRemoveWorktreeMutationOptions({ queryClient }));
   const pruneWorktreesMutation = useMutation(gitPruneWorktreesMutationOptions({ queryClient }));
 
-  const candidates = candidatesQuery.data ?? [];
+  const candidates = Array.isArray(candidatesQuery.data) ? candidatesQuery.data : [];
   const hasCandidates = candidates.length > 0;
   const isBusy = removeWorktreeMutation.isPending || pruneWorktreesMutation.isPending;
 
diff --git a/bun.lock b/bun.lock
diff --git a/docs/releases/README.md b/docs/releases/README.md
@@ -7,11 +7,12 @@ 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.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.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.17.0.md b/docs/releases/v0.17.0.md
@@ -0,0 +1,68 @@
+# OK Code v0.17.0
+
+**Date:** 2026-04-07
+**Tag:** [`v0.17.0`](https://github.com/OpenKnots/okcode/releases/tag/v0.17.0)
+
+## Summary
+
+Unify file and diff review into a cleaner right-panel workflow, improve chat and mobile-shell usability, and tighten worktree cleanup and desktop release stability in OK Code.
+
+## Highlights
+
+- **Unify the right panel into tabbed Files, Editor, and Diffs views.** Review and editing now share one predictable panel instead of bouncing between separate surfaces.
+- **Improve diff-review ergonomics.** Collapsible diff file headers, open-diff fallbacks, terminal-file linking, and non-scrolling review panes make long review sessions easier to manage.
+- **Add persistent layout and mobile chat shell improvements.** Layout preferences persist, the sidebar is cleaner, and the mobile shell gets a floating chat widget for faster thread access.
+- **Harden worktree lifecycle cleanup.** OK Code can now surface stale worktrees in the sidebar and prune merged worktrees as part of thread cleanup flows.
+- **Make chat output easier to use.** Assistant responses now include copy actions, and chat diffs use cached syntax highlighting to stay responsive under heavier transcripts.
+- **Improve project bootstrap and maintainer workflows.** Project creation can import package scripts, and new PR review workspace scripts support faster repo-level review work.
+- **Stabilize theming, navigation, and desktop packaging.** This release fixes theme hydration, terminal and file navigation handoff, and desktop build regressions before ship.
+
+## Detailed changes
+
+### Review and code navigation
+
+- The right panel now presents Files, Editor, and Diffs in one tabbed surface.
+- Diff review adds collapsible file sections and better fallback actions when summaries are missing.
+- Terminal file links open directly in the code viewer.
+- The review pane no longer scrolls independently from the rest of the workspace.
+
+### Chat and shell UX
+
+- Assistant messages now expose one-click copy actions.
+- Diff syntax highlighting is cached to reduce repeated render cost in long conversations.
+- The mobile shell now includes a floating chat widget.
+- Layout preferences persist across sessions.
+- Shortcut guidance, sidebar spacing, sidebar controls, and project-header contrast were tightened for faster scanning.
+
+### Worktrees and project lifecycle
+
+- Sidebar worktree management now surfaces stale worktrees for pruning.
+- Thread cleanup can prune merged worktrees through a dedicated cleanup flow.
+- Project creation can import package scripts automatically.
+- Preview blocking ignores empty toast overlays so the browser preview stays visible when it should.
+
+### Reliability
+
+- Theme hydration now resolves cleanly on startup.
+- Terminal and file navigation handoff is more reliable.
+- Desktop build packaging was fixed before release to keep the release train healthy.
+
+## Breaking changes
+
+- None.
+
+## Upgrade and install
+
+- **CLI:** `npm install -g okcodes@0.17.0` (after the package is published by the release workflow).
+- **Desktop:** Download from [GitHub Releases](https://github.com/OpenKnots/okcode/releases/tag/v0.17.0). Filenames and attachment classes are listed in [assets.md](v0.17.0/assets.md).
+- **iOS:** Available via TestFlight when the coordinated release workflow completes with signing enabled.
+
+## Release verification references
+
+- Review the [asset manifest](v0.17.0/assets.md) to confirm every expected GitHub Release attachment is present.
+- Use the [rollout checklist](v0.17.0/rollout-checklist.md) for preflight, publish, and post-release verification.
+- Use the [soak test plan](v0.17.0/soak-test-plan.md) for focused RC validation if an RC is cut before stable promotion.
+
+## 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.17.0/assets.md b/docs/releases/v0.17.0/assets.md
diff --git a/docs/releases/v0.17.0/rollout-checklist.md b/docs/releases/v0.17.0/rollout-checklist.md
diff --git a/docs/releases/v0.17.0/soak-test-plan.md b/docs/releases/v0.17.0/soak-test-plan.md
diff --git a/packages/contracts/package.json b/packages/contracts/package.json

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@okcode/desktop",`
`3`		`- "version": "0.16.0",`
	`3`	`+ "version": "0.17.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.16.0",`
	`3`	`+ "version": "0.17.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.16.0",`
	`3`	`+ "version": "0.17.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.16.0",`
	`3`	`+ "version": "0.17.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`