From e383aacfbed1475f6f121d9d8045f19ec73ba2c8 Mon Sep 17 00:00:00 2001
From: akemmanuel <akemmanuel@users.noreply.github.com>
Date: Sat, 1 Aug 2026 14:16:30 -0300
Subject: [PATCH] fix(release): unpack Photon WASM for Desktop

---
 CHANGELOG.md                              | 5 +++++
 docs/docker.md                            | 2 +-
 package.json                              | 5 +++--
 scripts/electron-package-metadata.test.ts | 5 +++++
 4 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1445a173..4fc7da54 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.6.0-rc.2 — release candidate
+
+- Fixed Linux and other packaged Desktop builds failing to start the Host sidecar because Photon’s
+  WebAssembly runtime was not unpacked beside `dist-electron/backend.js`.
+
 ## 0.6.0-rc.1 — release candidate
 
 This candidate replaces the external coding-agent integration architecture with the first-party
diff --git a/docs/docker.md b/docs/docker.md
index 102e7279..f6a9dbc2 100644
--- a/docs/docker.md
+++ b/docs/docker.md
@@ -15,7 +15,7 @@ curl --fail http://127.0.0.1:${PORT:-4839}/api/health
 For this prerelease, select the RC explicitly because prereleases never update `latest`:
 
 ```bash
-OPENGUI_IMAGE=ghcr.io/akemmanuel/opengui:0.6.0-rc.1 docker compose up -d
+OPENGUI_IMAGE=ghcr.io/akemmanuel/opengui:0.6.0-rc.2 docker compose up -d
 ```
 
 Open `http://127.0.0.1:4839`. The first browser creates the Host owner Account. The compose file
diff --git a/package.json b/package.json
index a6ce3e4e..bfd97fb7 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "opengui",
-  "version": "0.6.0-rc.1",
+  "version": "0.6.0-rc.2",
   "private": false,
   "description": "OpenGUI - first-party coding agent for desktop and web",
   "homepage": "https://github.com/akemmanuel/OpenGUI",
@@ -134,7 +134,8 @@
     "asarUnpack": [
       "dist-electron/backend.js",
       "dist-electron/backend.js.map",
-      "dist-electron/package.json"
+      "dist-electron/package.json",
+      "dist-electron/*.wasm"
     ],
     "linux": {
       "target": [
diff --git a/scripts/electron-package-metadata.test.ts b/scripts/electron-package-metadata.test.ts
index 6c2c4244..32b9f733 100644
--- a/scripts/electron-package-metadata.test.ts
+++ b/scripts/electron-package-metadata.test.ts
@@ -1,4 +1,5 @@
 import { describe, expect, test } from "vite-plus/test";
+import packageJson from "../package.json" with { type: "json" };
 import { createElectronRuntimePackage, packageIdForImport } from "./electron-package-metadata";
 
 describe("Electron package metadata", () => {
@@ -29,4 +30,8 @@ describe("Electron package metadata", () => {
   ])("resolves package boundary for %s", (specifier, expected) => {
     expect(packageIdForImport(specifier)).toBe(expected);
   });
+
+  test("unpacks sidecar WebAssembly assets beside the backend bundle", () => {
+    expect(packageJson.build.asarUnpack).toContain("dist-electron/*.wasm");
+  });
 });