chore(release): prepare v0.19.0

Author: BunsDev

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.19.0] - 2026-04-08
+
+See [docs/releases/v0.19.0.md](docs/releases/v0.19.0.md) for full notes and [docs/releases/v0.19.0/assets.md](docs/releases/v0.19.0/assets.md) for release asset inventory.
+
+### Changed
+
+- Harden release workflow staging and optional CLI publishing.
+- Fix branch-handling issues that could confuse release-related push and PR flows.
+- Clear release-preflight blockers around server snapshot decoding and strict type checks.
+
+### Fixed
+
+- Fix formatting drift and release-preflight cleanup issues discovered during rollout.
+
 ## [0.18.0] - 2026-04-07
 
 See [docs/releases/v0.18.0.md](docs/releases/v0.18.0.md) for full notes and [docs/releases/v0.18.0/assets.md](docs/releases/v0.18.0/assets.md) for release asset inventory.

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/desktop",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "private": true,
   "main": "dist-electron/main.js",
   "scripts": {

apps/mobile/android/app/build.gradle

@@ -8,7 +8,7 @@ android {
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode 1
-        versionName "0.18.0"
+        versionName "0.19.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         aaptOptions {
              // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.

apps/mobile/ios/App/App.xcodeproj/project.pbxproj

@@ -303,7 +303,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.18.0;
+				MARKETING_VERSION = 0.19.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.18.0;
+				MARKETING_VERSION = 0.19.0;
 				PRODUCT_BUNDLE_IDENTIFIER = com.openknots.okcode.mobile;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";

apps/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/mobile",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "private": true,
   "type": "module",
   "scripts": {

apps/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okcodes",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "license": "MIT",
   "repository": {
     "type": "git",

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okcode/web",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "private": true,
   "type": "module",
   "scripts": {

docs/releases/README.md

@@ -9,6 +9,7 @@ Use this directory for versioned release notes and asset manifests only:
 
 | Version              | Summary                                                                                      | Assets                        |
 | -------------------- | -------------------------------------------------------------------------------------------- | ----------------------------- |
+| [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) |

docs/releases/v0.19.0.md

@@ -1,23 +1,53 @@
 # OK Code v0.19.0
 
+**Date:** 2026-04-08
+**Tag:** [`v0.19.0`](https://github.com/OpenKnots/okcode/releases/tag/v0.19.0)
+
+## Summary
+
+Harden the release pipeline, clean up branch-handling around PR creation, and remove the release-preflight blockers that were slowing down the rollout path.
+
 ## Highlights
 
-- Release workflow hardening and release-pipeline reliability fixes.
-- Git/PR flow fixes to stop stale branch metadata from hijacking push and PR creation.
-- Release-preflight fixes for server snapshot decoding and exact optional property checks.
+- **Make the release workflow more resilient.** Release documentation staging, optional CLI publication, and post-release version updates now have clearer guardrails.
+- **Fix branch metadata handling.** Push and PR creation no longer trip over stale or mismatched branch data during release-related flows.
+- **Clear the release-preflight blockers.** Server snapshot decoding and strict type-check issues are fixed so the release gate can stay green.
+- **Keep the release bundle tidy.** The release notes, asset manifest, and changelog now line up with the attached release artifacts.
+
+## Detailed changes
+
+### Release flow
+
+- Improved release workflow resilience around staged release documentation.
+- Made optional CLI publishing less fragile during the coordinated release process.
+- Tightened the finalize path so version bump handling stays predictable after publish.
 
-## Changes
+### Git and PR handling
+
+- Fixed stale branch metadata so push and PR creation use the right branch context.
+- Improved release-related branch resolution when the active workspace and upstream refs diverge.
+
+### Preflight cleanup
 
-- Improved release workflow resilience around staged release documentation and optional CLI publishing.
 - Fixed snapshot query handling for thread `githubRef` data.
 - Fixed `wsServer.ts` type issues blocking strict server typecheck.
 - Fixed formatting drift and release-preflight blockers discovered during rollout.
 
-## Desktop downloads
+## Breaking changes
+
+- None.
+
+## Upgrade and install
+
+- **CLI:** `npm install -g okcodes@0.19.0` when the package is published.
+- **Desktop:** Download from [GitHub Releases](https://github.com/OpenKnots/okcode/releases/tag/v0.19.0). Filenames are listed in [assets.md](v0.19.0/assets.md).
+- **iOS:** Available via TestFlight when the coordinated release workflow completes with signing enabled.
+
+## Release verification references
 
-See the attached assets on this GitHub Release.
+- Review the [asset manifest](v0.19.0/assets.md) to confirm every expected GitHub Release attachment is present.
+- Use the [rollout checklist](v0.19.0/rollout-checklist.md) for preflight, publish, and post-release verification.
 
-## Notes
+## Known limitations
 
-- See the attached assets on this GitHub Release.
-- This release includes release-process fixes landed during the rollout itself.
+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.

docs/releases/v0.19.0/assets.md

@@ -1,11 +1,48 @@
-# OK Code v0.19.0 Assets
+# v0.19.0 — Release assets (manifest)
 
-This release contains:
+Binaries are **not** stored in this git repository; they are attached to the [GitHub Release for `v0.19.0`](https://github.com/OpenKnots/okcode/releases/tag/v0.19.0) by the [Release Desktop workflow](../../.github/workflows/release.yml).
 
-- macOS (arm64): `.dmg` and updater manifests where applicable
-- Linux (x64): `.AppImage`
-- Windows (x64): `.exe`
-- Bundled release documentation artifacts:
-  - `okcode-RELEASE-NOTES.md`
-  - `okcode-CHANGELOG.md`
-  - `okcode-ASSETS-MANIFEST.md`
+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.19.0.md](../v0.19.0.md)           |
+| `okcode-ASSETS-MANIFEST.md` | This file                             |
+
+## Desktop installers and updater payloads
+
+| Platform            | Kind           | Expected attachment class |
+| ------------------- | -------------- | ------------------------- |
+| macOS Apple Silicon | DMG (signed)   | `*.dmg` (arm64)           |
+| macOS Intel         | DMG (signed)   | `*.dmg` (x64, compat run) |
+| macOS               | ZIP (updater)  | `*.zip`                   |
+| Linux x64           | AppImage       | `*.AppImage`              |
+| Windows x64         | NSIS installer | `*.exe`                   |
+
+### macOS code signing and notarization
+
+All macOS DMG and ZIP payloads are expected to be code-signed with an Apple Developer ID certificate and notarized before publication. Gatekeeper should verify the signature on first launch. The hardened runtime is enabled with entitlements defined in `apps/desktop/resources/entitlements.mac.plist`.
+
+## Electron updater metadata
+
+| File pattern       | Purpose                                              |
+| ------------------ | ---------------------------------------------------- |
+| `latest-mac.yml`   | macOS update manifest merged from release CI outputs |
+| `latest-linux.yml` | Linux update manifest                                |
+| `latest.yml`       | Windows update manifest                              |
+| `*.blockmap`       | Differential download block maps                     |
+
+## iOS (TestFlight)
+
+The iOS build is uploaded directly to App Store Connect / TestFlight by the [Release iOS workflow](../../.github/workflows/release-ios.yml) when signing secrets are configured. No IPA artifact is attached to the GitHub Release.
+
+| Detail            | Value                              |
+| ----------------- | ---------------------------------- |
+| Bundle ID         | `com.openknots.okcode.mobile`      |
+| Marketing version | `0.19.0`                           |
+| Build number      | Set from `GITHUB_RUN_NUMBER` in CI |
+
+## Checksums
+
+SHA-256 checksums are not committed here; verify downloads via GitHub's release UI or `gh release download` if you use the GitHub CLI.