chore(release): prepare v0.22.0

BunsDev · BunsDev · commit 298da1db07ae · 2026-04-09T20:30:33.000-05:00
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/desktop",
-  "version": "0.21.0",
+  "version": "0.22.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.21.0"
+        versionName "0.22.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.21.0;
+				MARKETING_VERSION = 0.22.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.21.0;
+				MARKETING_VERSION = 0.22.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.21.0",
+  "version": "0.22.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.21.0",
+  "version": "0.22.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.21.0",
+  "version": "0.22.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/bun.lock b/bun.lock
diff --git a/docs/releases/v0.22.0/assets.md b/docs/releases/v0.22.0/assets.md
@@ -55,6 +55,13 @@ The iOS build is uploaded directly to App Store Connect / TestFlight by the coor
 | Marketing version | `0.22.0`                      |
 | Build number      | Set from `GITHUB_RUN_NUMBER`  |
 
+## Rollout documentation
+
+| Document                                     | Purpose                                                           |
+| -------------------------------------------- | ----------------------------------------------------------------- |
+| [rollout-checklist.md](rollout-checklist.md) | Step-by-step release playbook from preflight through post-release |
+| [soak-test-plan.md](soak-test-plan.md)       | Structured release validation for the highest-risk surfaces       |
+
 ## 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/docs/releases/v0.22.0/rollout-checklist.md b/docs/releases/v0.22.0/rollout-checklist.md
@@ -0,0 +1,65 @@
+# v0.22.0 Rollout Checklist
+
+Step-by-step playbook for the v0.22.0 release. Each phase must complete before advancing.
+
+## Phase 0: Pre-flight
+
+- [ ] Verify all release package versions are `0.22.0`:
+  - `apps/server/package.json`
+  - `apps/desktop/package.json`
+  - `apps/web/package.json`
+  - `apps/mobile/package.json`
+  - `packages/contracts/package.json`
+- [ ] Verify Android `versionName` and iOS `MARKETING_VERSION` both match `0.22.0`.
+- [ ] Confirm `CHANGELOG.md` has `## [0.22.0] - 2026-04-09`.
+- [ ] Confirm `docs/releases/v0.22.0.md` exists with Summary, Highlights, and Upgrade sections.
+- [ ] Confirm `docs/releases/v0.22.0/assets.md` exists and lists every expected attachment class.
+- [ ] Confirm `docs/releases/v0.22.0/rollout-checklist.md` and `docs/releases/v0.22.0/soak-test-plan.md` exist.
+- [ ] Confirm `docs/releases/README.md` includes the v0.22.0 row.
+- [ ] Run `bun run release:validate 0.22.0`.
+- [ ] Confirm the working tree is clean.
+- [ ] Confirm you are on `main`.
+
+### Quality gates
+
+- [ ] `bun run fmt:check`
+- [ ] `bun run lint`
+- [ ] `bun run typecheck`
+- [ ] `bun run test`
+- [ ] `bun run --cwd apps/web test:browser`
+- [ ] `bun run test:desktop-smoke`
+- [ ] `bun run release:smoke`
+
+## Phase 1: Publish
+
+- [ ] Push the release-prep commit to `main`.
+- [ ] Create and push tag `v0.22.0`.
+- [ ] Verify the coordinated `release.yml` workflow starts.
+- [ ] Monitor the pipeline through Preflight, Desktop builds, iOS signing preflight, optional iOS TestFlight, Publish GitHub Release, Finalize release, and optional CLI publish if started through manual dispatch.
+
+### Asset verification
+
+- [ ] GitHub Release body matches `docs/releases/v0.22.0.md`.
+- [ ] `okcode-CHANGELOG.md` is attached.
+- [ ] `okcode-RELEASE-NOTES.md` is attached.
+- [ ] `okcode-ASSETS-MANIFEST.md` is attached.
+- [ ] macOS release artifacts are attached: DMG, ZIP, updater manifest, and blockmaps.
+- [ ] Linux release artifacts are attached: AppImage and updater manifest if generated.
+- [ ] Windows release artifacts are attached: installer, updater manifest, and blockmaps.
+- [ ] If the Intel compatibility workflow is run, confirm the x64 macOS DMG is attached separately.
+
+## Phase 2: Post-release verification
+
+- [ ] `npx --yes okcodes@0.22.0 --version` returns `0.22.0`.
+- [ ] macOS installer launches and passes Gatekeeper.
+- [ ] Linux AppImage launches.
+- [ ] Windows installer installs and launches.
+- [ ] Desktop auto-update metadata is present for supported platforms.
+- [ ] If iOS signing was enabled, confirm the new TestFlight build appears.
+- [ ] Confirm the finalize job did not need to push another version-alignment commit, or review its no-op output if versions were already aligned before tagging.
+
+## Phase 3: Follow-through
+
+- [ ] Trigger the Intel compatibility workflow if macOS x64 artifacts are required for this train.
+- [ ] Update external release references or announcements.
+- [ ] Monitor reports for regressions in SME conversation auth, refreshed SME chat flows, settings navigation, and websocket error handling.
diff --git a/docs/releases/v0.22.0/soak-test-plan.md b/docs/releases/v0.22.0/soak-test-plan.md
@@ -0,0 +1,47 @@
+# v0.22.0 Soak Test Plan
+
+Structured validation plan for the highest-risk surfaces in v0.22.0.
+
+## 1. SME provider-aware auth routing
+
+| Step                                                            | Expected                                                                   | Pass |
+| --------------------------------------------------------------- | -------------------------------------------------------------------------- | ---- |
+| Create a new SME conversation and choose a provider/auth method | The selected provider and auth method persist on the conversation          | [ ]  |
+| Reload the app and reopen the same conversation                 | The saved provider/auth settings restore without falling back to old state | [ ]  |
+| Send a message with valid auth configured                       | Validation succeeds and the message routes through the intended backend    | [ ]  |
+| Switch the conversation auth method and send again              | The updated auth choice is honored without needing a new conversation      | [ ]  |
+
+## 2. SME chat workspace refresh
+
+| Step                                                   | Expected                                                            | Pass |
+| ------------------------------------------------------ | ------------------------------------------------------------------- | ---- |
+| Open the SME workspace with multiple conversations     | Sidebar, loading states, and message list render cleanly            | [ ]  |
+| Compose a longer message in the refreshed composer     | Composer grows predictably and remains usable on desktop and mobile | [ ]  |
+| Review longer threads with several message types       | Bubble hierarchy and spacing stay readable without overlapping UI   | [ ]  |
+| Open the knowledge panel while switching conversations | Rail and knowledge panel stay in sync with the active conversation  | [ ]  |
+
+## 3. Settings navigation and section routing
+
+| Step                                                  | Expected                                                              | Pass |
+| ----------------------------------------------------- | --------------------------------------------------------------------- | ---- |
+| Open settings on desktop                              | Sidebar sections navigate between panels without losing active state  | [ ]  |
+| Open settings on a narrow/mobile viewport             | Section picker exposes the same sections and updates the active panel | [ ]  |
+| Move between general and SME-specific settings panels | Section headers and descriptions update with the active destination   | [ ]  |
+| Return to chat after settings changes                 | Updated settings are reflected without stale navigation state         | [ ]  |
+
+## 4. Websocket error redaction
+
+| Step                                                     | Expected                                                             | Pass |
+| -------------------------------------------------------- | -------------------------------------------------------------------- | ---- |
+| Trigger a websocket-facing provider or transport error   | Error content reaches the UI without exposing raw secrets            | [ ]  |
+| Inspect server-side surfaced error text or logs          | Sensitive token-like values are redacted consistently                | [ ]  |
+| Trigger the same failure path through reconnect or retry | Redaction remains stable across transport retries and repeated sends | [ ]  |
+| Review affected UI banners and inline thread errors      | Users see actionable errors without leaked credentials               | [ ]  |
+
+## 5. Release regression checks
+
+| Step                                                 | Expected                                     | Pass |
+| ---------------------------------------------------- | -------------------------------------------- | ---- |
+| Run desktop smoke coverage on the release build path | Desktop packaging remains green              | [ ]  |
+| Verify local CLI package after publish               | `okcodes --version` reports `0.22.0`         | [ ]  |
+| Inspect GitHub Release attachments                   | Every class listed in `assets.md` is present | [ ]  |
diff --git a/packages/contracts/package.json b/packages/contracts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@okcode/contracts",
-  "version": "0.21.0",
+  "version": "0.22.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.21.0",`
	`3`	`+ "version": "0.22.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.21.0",`
	`3`	`+ "version": "0.22.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.21.0",`
	`3`	`+ "version": "0.22.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.21.0",`
	`3`	`+ "version": "0.22.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`