feat: vary electron AppImage desktopName/productName per stage

Adds patchElectronStageBranding helper invoked from all 4 electron build
entry points after config-effective.json is written. Writes the kebab-case
stage identifier into both src-electron/electron-builder.yml productName
(becomes the .desktop StartupWMClass) and src-electron/package.json
desktopName (Electron 41.5+ Wayland app_id) so they match per stage:
  dev   -> phoenix-code-experimental-build
  stage -> phoenix-code-pre-release
  prod  -> phoenix-code

Without per-stage identifiers the AppImages collapse into one taskbar
entry / icon slot when installed side-by-side.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: abose

package-lock.json

@@ -9,7 +9,7 @@ import {
 import { EOL } from "os";
 import os from "os";
 import fs from 'fs';
-import {patchTauriConfigWithMetricsHTML} from "./utils.js";
+import {patchTauriConfigWithMetricsHTML, patchElectronStageBranding} from "./utils.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -182,6 +182,8 @@ function createElectronReleaseAssets() {
     console.log('gaMetricsURL:', effectiveConfig.gaMetricsURL);
     console.log('version:', effectiveConfig.version);
     fs.writeFileSync(configEffectivePath, JSON.stringify(effectiveConfig, null, 2));
+
+    patchElectronStageBranding(electronDir, effectiveConfig.productName);
 }
 
 ciCreateTauriDistReleaseConfig();

src-build/ci-setupDistFolders.js

@@ -4,7 +4,7 @@ import { dirname, join } from 'path';
 import fs from 'fs';
 import * as os from 'os';
 import chalk from 'chalk';
-import { getPlatformDetails, patchTauriConfigWithMetricsHTML } from './utils.js';
+import { getPlatformDetails, patchTauriConfigWithMetricsHTML, patchElectronStageBranding } from './utils.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -164,6 +164,8 @@ function createElectronConfig() {
     console.log('gaMetricsURL:', effectiveConfig.gaMetricsURL);
     console.log('version:', effectiveConfig.version);
     fs.writeFileSync(configEffectivePath, JSON.stringify(effectiveConfig, null, 2));
+
+    patchElectronStageBranding(electronDir, effectiveConfig.productName);
 }
 
 function buildElectron() {

src-build/createDistRelease.js

@@ -4,7 +4,7 @@ import { dirname, join } from 'path';
 import fs from 'fs';
 import * as os from 'os';
 import chalk from 'chalk';
-import { getPlatformDetails } from './utils.js';
+import { getPlatformDetails, patchElectronStageBranding } from './utils.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -160,6 +160,8 @@ function createElectronConfig() {
     console.log('gaMetricsURL:', effectiveConfig.gaMetricsURL);
     console.log('version:', effectiveConfig.version);
     fs.writeFileSync(configEffectivePath, JSON.stringify(effectiveConfig, null, 2));
+
+    patchElectronStageBranding(electronDir, effectiveConfig.productName);
 }
 
 function buildElectron() {

src-build/createDistTestRelease.js

@@ -4,7 +4,7 @@ import { dirname, join } from 'path';
 import fs from 'fs';
 import * as os from 'os';
 import chalk from 'chalk';
-import { getPlatformDetails } from './utils.js';
+import { getPlatformDetails, patchElectronStageBranding } from './utils.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -136,6 +136,8 @@ function createElectronConfig() {
     console.log('gaMetricsURL:', effectiveConfig.gaMetricsURL);
     console.log('version:', effectiveConfig.version);
     fs.writeFileSync(configEffectivePath, JSON.stringify(effectiveConfig, null, 2));
+
+    patchElectronStageBranding(electronDir, effectiveConfig.productName);
 }
 
 function buildElectron() {

src-build/createSrcRelease.js

@@ -103,6 +103,35 @@ const METRIC_URL_FOR_STAGE = {
     "production": "https://phcode.dev/desktop-metrics.html"
 };
 
+/**
+ * Patches the electron build inputs so each stage has a unique app identity:
+ *   - src-electron/package.json `desktopName` (Electron 41.5+ uses this as the Wayland app_id)
+ *   - src-electron/electron-builder.yml `productName` (becomes the .desktop StartupWMClass + binary name)
+ * Both are set to the kebab-case form of `productName` so they match. Without matching values,
+ * the running window can't be paired to its .desktop entry and falls back to the generic Electron icon.
+ *
+ * @param {string} electronDir - absolute path to src-electron/
+ * @param {string} productName - stage-specific display name from config-effective.json
+ *                               (e.g. "Phoenix Code", "Phoenix Code Pre-release", "Phoenix Code Experimental Build")
+ */
+export function patchElectronStageBranding(electronDir, productName) {
+    const appId = productName.toLowerCase().trim().replace(/\s+/g, '-');
+    console.log(`Patching electron stage branding -> ${appId}`);
+
+    const pkgPath = path.join(electronDir, 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath));
+    pkg.desktopName = appId;
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+
+    const builderPath = path.join(electronDir, 'electron-builder.yml');
+    const builderYml = fs.readFileSync(builderPath, 'utf8');
+    const patched = builderYml.replace(/^productName:.*$/m, `productName: ${appId}`);
+    if (patched === builderYml) {
+        throw new Error(`Could not find productName line in ${builderPath}`);
+    }
+    fs.writeFileSync(builderPath, patched);
+}
+
 export function patchTauriConfigWithMetricsHTML(tauriConf, useClonedPhoenix) {
     const platform = getPlatformDetails().platform;
     let phoenixConfigPath = (platform === "win") ? `${__dirname}\\..\\..\\phoenix\\dist\\config.json`