From e89b68e52aaaf5cb9c7c8ff5b0f80a762d7de3ad Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 24 Sep 2026 03:21:05 +0000
Subject: [PATCH] Fix desktop app not opening / engine not starting (v1.1.1)

- A listen error other than EADDRINUSE on the fixed port (Windows returns
  EACCES for ports in Hyper-V/WSL/Docker excluded ranges) left startup
  rejected with no window while the process kept running and holding the
  single-instance lock, so every later launch silently did nothing. Fall
  back to a random port on any listen error; if startup still fails, show
  an error box and exit.
- Electron's BrowserWindow doesn't honor COOP/COEP, so SharedArrayBuffer
  was undefined and the multi-threaded engine never started. Enable it
  with the SharedArrayBuffer feature switch.
- second-instance: show/focus the window, or create one if none exists.
- Portable .exe shows a splash screen while it unpacks.

Verified in real Electron (dev and packaged) under Xvfb: engine runs
multi-threaded, port-taken fallback works, second launch hands off.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017ZHKbLKcpoa8QJGzqkbDTJ
---
 build/splash.bmp             | Bin 0 -> 327654 bytes
 docs/release-notes/v1.1.1.md |  16 +++++++++++++++
 electron/main.cjs            |  37 +++++++++++++++++++++++++++++------
 package-lock.json            |   4 ++--
 package.json                 |   5 ++++-
 progress.txt                 |  15 ++++++++++++++
 6 files changed, 68 insertions(+), 9 deletions(-)
 create mode 100644 build/splash.bmp
 create mode 100644 docs/release-notes/v1.1.1.md

diff --git a/build/splash.bmp b/build/splash.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..ecc9a401bd48cb117e2e69475ded6b9a6f8fe8e1
GIT binary patch
literal 327654
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

literal 0
HcmV?d00001

diff --git a/docs/release-notes/v1.1.1.md b/docs/release-notes/v1.1.1.md
new file mode 100644
index 0000000..a5aa4d1
--- /dev/null
+++ b/docs/release-notes/v1.1.1.md
@@ -0,0 +1,16 @@
+## Fixes the Windows app not opening
+
+### Fixed
+- **The app could fail to open on Windows, and then do nothing on every later launch.** If Windows reserved the app's local port (common with Hyper-V, WSL, or Docker), v1.1.0 never showed a window and kept running in the background. It now falls back to another port, and if it truly can't start it shows an error instead of hanging.
+- **The engine didn't start in the desktop app.** The multi-threaded engine needs a browser feature that the desktop shell wasn't enabling. It's now turned on explicitly, so the full-strength, multi-core engine runs as intended.
+- Launching the app while it's already open now brings up the existing window, and opens a new one if there isn't one.
+
+### Improved
+- The Windows portable `.exe` now shows a splash screen while it unpacks, so you can tell it's starting.
+
+### If v1.1.0 wouldn't open for you
+A hidden v1.1.0 process may still be running. Open Task Manager, end any **Chess Solver** processes (or run `taskkill /IM "Chess Solver.exe" /F`), then launch v1.1.1.
+
+### Downloads
+- **Windows:** `Chess.Solver.1.1.1.exe`, a portable build. SmartScreen may warn because it's unsigned: choose *More info → Run anyway*.
+- **macOS:** `Chess.Solver-1.1.1-universal.dmg` (Intel + Apple Silicon). It isn't notarized, so right-click the app → **Open** on first launch.
diff --git a/electron/main.cjs b/electron/main.cjs
index 6b4402d..805f54e 100644
--- a/electron/main.cjs
+++ b/electron/main.cjs
@@ -1,4 +1,4 @@
-const { app, BrowserWindow, shell } = require('electron');
+const { app, BrowserWindow, dialog, shell } = require('electron');
 const path = require('path');
 const http = require('http');
 const fs = require('fs');
@@ -20,7 +20,9 @@ const MIME_TYPES = {
 // A fixed port keeps the app's origin stable between launches. localStorage
 // (theme, line count, think time) and the HTTP cache are keyed by origin, so a
 // random port silently reset settings every launch and forced a full
-// recompile of the 100MB+ engine. Falls back to any free port if taken.
+// recompile of the 100MB+ engine. Falls back to any free port if the
+// preferred one can't be used — taken (EADDRINUSE) or, on Windows, inside a
+// range reserved by Hyper-V/WSL/Docker (EACCES).
 const PREFERRED_PORT = 47813;
 
 // 'wasm-unsafe-eval' and blob: workers are required by the multi-threaded
@@ -108,8 +110,11 @@ function startServer() {
     const server = http.createServer(handleRequest);
     const listen = (port) => server.listen(port, '127.0.0.1');
     server.once('listening', () => resolve(server.address().port));
+    let triedFallback = false;
     server.on('error', (err) => {
-      if (err.code === 'EADDRINUSE' && server.address() === null) {
+      if (!triedFallback && server.address() === null) {
+        triedFallback = true;
+        console.warn(`[server] port ${PREFERRED_PORT} unavailable (${err.code}); using a random port`);
         listen(0);
       } else {
         reject(err);
@@ -119,6 +124,13 @@ function startServer() {
   });
 }
 
+// The multi-threaded Stockfish build needs SharedArrayBuffer. The server's
+// COOP/COEP headers make browsers cross-origin isolate the page, but
+// Electron's BrowserWindow doesn't reliably honor them (crossOriginIsolated
+// stays false), which left SharedArrayBuffer undefined and the engine unable
+// to start. Enable it explicitly; must run before the app is ready.
+app.commandLine.appendSwitch('enable-features', 'SharedArrayBuffer');
+
 let appOrigin = null;
 
 function createWindow() {
@@ -170,16 +182,29 @@ if (!gotInstanceLock) {
     const [win] = BrowserWindow.getAllWindows();
     if (win) {
       if (win.isMinimized()) win.restore();
+      win.show();
       win.focus();
+    } else if (appOrigin !== null) {
+      createWindow();
     }
   });
 }
 
 app.whenReady().then(async () => {
   if (!gotInstanceLock) return;
-  const port = await startServer();
-  appOrigin = `http://127.0.0.1:${port}`;
-  createWindow();
+  try {
+    const port = await startServer();
+    appOrigin = `http://127.0.0.1:${port}`;
+    createWindow();
+  } catch (err) {
+    // Never linger as a windowless background process: it would hold the
+    // single-instance lock and make every later launch silently do nothing.
+    dialog.showErrorBox(
+      'Chess Solver could not start',
+      `The app's local server failed to start:\n\n${err && err.message ? err.message : err}`
+    );
+    app.exit(1);
+  }
 });
 
 // macOS convention: the app stays alive with no windows and reopens one when
diff --git a/package-lock.json b/package-lock.json
index b7ebf6b..c12a63d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "chess-solver",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "chess-solver",
-      "version": "1.1.0",
+      "version": "1.1.1",
       "license": "MIT",
       "dependencies": {
         "@fontsource/dm-sans": "^5.3.0",
diff --git a/package.json b/package.json
index e5e8252..b5c9d2f 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "chess-solver",
   "private": true,
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Desktop chess analysis tool powered by Stockfish 18 — set up any position and get engine-recommended moves with evaluations, tactical motifs, and principal variations.",
   "author": "ccharafeddine",
   "license": "MIT",
@@ -37,6 +37,9 @@
       "target": "portable",
       "icon": "build/icon.ico"
     },
+    "portable": {
+      "splashImage": "build/splash.bmp"
+    },
     "mac": {
       "target": [
         {
diff --git a/progress.txt b/progress.txt
index 731f441..e185e48 100644
--- a/progress.txt
+++ b/progress.txt
@@ -1,5 +1,20 @@
 # Chess Solver — Progress
 
+## v1.1.1 (2026-09-24): Windows launch fix
+- v1.1.0 .exe did nothing on launch. Two causes: (1) a listen error other
+  than EADDRINUSE on the fixed port (Windows returns EACCES for ports in
+  Hyper-V/WSL/Docker excluded ranges) rejected startServer unhandled, so no
+  window was created but the process lived on, holding the single-instance
+  lock and making every later launch exit silently. Now any listen error
+  falls back to a random port, and a total failure shows an error box and
+  exits. (2) Electron's BrowserWindow doesn't honor COOP/COEP
+  (crossOriginIsolated stays false), so SharedArrayBuffer was undefined and
+  the multi-threaded engine never started; fixed with
+  app.commandLine.appendSwitch('enable-features', 'SharedArrayBuffer').
+  Both verified in real Electron under Xvfb (engine runs 3 threads, ~1M
+  nps; port-taken fallback; second-instance handoff).
+- Portable .exe shows build/splash.bmp while it unpacks (~320MB per launch).
+
 ## v1.1.0 (2026-09-24): engine speed/strength + reliability audit
 - The app had been shipping the SINGLE-threaded Stockfish build
   (public/stockfish.* byte-matched stockfish-18-single), so the Threads