nexora-code 1.0.3 → 1.0.4

package/dist/bundle.cjs

@@ -284542,6 +284542,513 @@ var init_archiver = __esm({
   }
 });
 
+// scripts/desktop/windows-wt-profile.cjs
+var require_windows_wt_profile = __commonJS({
+  "scripts/desktop/windows-wt-profile.cjs"(exports2, module2) {
+    "use strict";
+    var fs51 = require("fs");
+    var path55 = require("path");
+    function getWTSettingsPath() {
+      const localAppData = process.env.LOCALAPPDATA || "";
+      const candidates = [
+        // Store version
+        path55.join(localAppData, "Packages", "Microsoft.WindowsTerminal_8wekyb3d8bbwe", "LocalState", "settings.json"),
+        // Preview version
+        path55.join(localAppData, "Packages", "Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe", "LocalState", "settings.json"),
+        // Winget / scoop version
+        path55.join(localAppData, "Microsoft", "Windows Terminal", "settings.json")
+      ];
+      return candidates.find((p) => {
+        try {
+          fs51.accessSync(p);
+          return true;
+        } catch {
+          return false;
+        }
+      }) || null;
+    }
+    function detectBestShell() {
+      const { execSync: execSync5 } = require("child_process");
+      try {
+        execSync5("where pwsh.exe", { stdio: "pipe" });
+        return { shellExe: "pwsh.exe", shellArgs: "-NoExit -Command nexora-code" };
+      } catch {
+      }
+      return {
+        shellExe: "powershell.exe",
+        shellArgs: "-NoExit -Command nexora-code"
+      };
+    }
+    async function repairWTProfile() {
+      const settingsPath = getWTSettingsPath();
+      if (!settingsPath) return;
+      let settings;
+      try {
+        const raw = fs51.readFileSync(settingsPath, "utf-8");
+        const stripped = raw.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+        settings = JSON.parse(stripped);
+      } catch {
+        return;
+      }
+      const profiles = settings?.profiles?.list;
+      if (!Array.isArray(profiles)) return;
+      let modified = false;
+      for (const profile of profiles) {
+        if (profile.name === "Nexora Code" && profile.commandline === "nexora-code") {
+          const { shellExe, shellArgs } = detectBestShell();
+          profile.commandline = `${shellExe} ${shellArgs}`;
+          modified = true;
+          console.log("  \u2713  Repaired corrupted Windows Terminal profile.");
+          console.log(`  \u2713  Fixed commandline \u2192 ${profile.commandline}`);
+        }
+      }
+      if (modified) {
+        fs51.writeFileSync(settingsPath, JSON.stringify(settings, null, 4), "utf-8");
+      }
+    }
+    module2.exports = { repairWTProfile };
+  }
+});
+
+// scripts/desktop/windows.cjs
+var require_windows2 = __commonJS({
+  "scripts/desktop/windows.cjs"(exports2, module2) {
+    "use strict";
+    var { execSync: execSync5 } = require("child_process");
+    var path55 = require("path");
+    var fs51 = require("fs");
+    var { repairWTProfile } = require_windows_wt_profile();
+    function detectWindowsTerminal() {
+      try {
+        const wtPath = execSync5("where wt.exe", { stdio: "pipe" }).toString().trim();
+        if (wtPath) {
+          try {
+            execSync5("where pwsh.exe", { stdio: "pipe" });
+            return {
+              label: "Windows Terminal + PowerShell 7",
+              shellExe: wtPath,
+              shellArgs: "pwsh.exe -NoExit -Command nexora-code"
+            };
+          } catch {
+            return {
+              label: "Windows Terminal + PowerShell 5",
+              shellExe: wtPath,
+              shellArgs: "powershell.exe -NoExit -Command nexora-code"
+            };
+          }
+        }
+      } catch {
+      }
+      try {
+        const pwsh7 = execSync5("where pwsh.exe", { stdio: "pipe" }).toString().trim();
+        if (pwsh7) return {
+          label: "PowerShell 7",
+          shellExe: pwsh7,
+          shellArgs: "-NoExit -Command nexora-code"
+        };
+      } catch {
+      }
+      const ps5 = `${process.env.SystemRoot}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
+      return {
+        label: "PowerShell 5",
+        shellExe: ps5,
+        shellArgs: "-NoExit -Command nexora-code"
+      };
+    }
+    async function createWindowsShortcut(ctx) {
+      await repairWTProfile();
+      const shortcutPath = path55.join(ctx.desktopPath, "Nexora Code.lnk");
+      const iconPath = path55.join(ctx.iconDir, "icon.ico");
+      const iconExists = fs51.existsSync(iconPath);
+      const terminal2 = detectWindowsTerminal();
+      const escapedShortcut = shortcutPath.replace(/'/g, "''");
+      const escapedShellExe = terminal2.shellExe.replace(/'/g, "''");
+      const escapedArgs = terminal2.shellArgs.replace(/'/g, "''");
+      const iconLine = iconExists ? `$lnk.IconLocation = '${iconPath.replace(/'/g, "''")}'; ` : "";
+      const psLines = [
+        `$s = New-Object -ComObject WScript.Shell`,
+        `$lnk = $s.CreateShortcut('${escapedShortcut}')`,
+        `$lnk.TargetPath = '${escapedShellExe}'`,
+        `$lnk.Arguments = '${escapedArgs}'`,
+        `$lnk.WorkingDirectory = $env:USERPROFILE`,
+        `$lnk.Description = 'Launch Nexora Code AI Workspace'`,
+        iconExists ? `$lnk.IconLocation = '${iconPath.replace(/'/g, "''")}'` : "",
+        `$lnk.Save()`
+      ].filter(Boolean).join("; ");
+      try {
+        execSync5(
+          `powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command "${psLines}"`,
+          { stdio: "pipe", timeout: 2e4 }
+        );
+        console.log(`  \u2713  Shortcut created:  ${shortcutPath}`);
+        console.log(`  \u2713  Shell target:      ${terminal2.shellExe}`);
+        console.log(`  \u2713  Launch command:    ${terminal2.shellArgs}`);
+        console.log(`  \u2713  Terminal:          ${terminal2.label}`);
+        if (iconExists) console.log(`  \u2713  Icon applied:      Nexora Code logo`);
+        console.log("");
+        console.log('  \u2192 Double-click "Nexora Code" on your Desktop to launch!');
+        console.log("");
+      } catch (err6) {
+        throw new Error(`Windows .lnk creation failed: ${err6.message}`);
+      }
+    }
+    function removeWindowsShortcut(ctx) {
+      const shortcutPath = path55.join(ctx.desktopPath, "Nexora Code.lnk");
+      try {
+        fs51.unlinkSync(shortcutPath);
+        console.log("  \u2713  Desktop shortcut removed: Nexora Code.lnk");
+      } catch {
+      }
+    }
+    module2.exports = { createWindowsShortcut, removeWindowsShortcut };
+  }
+});
+
+// scripts/desktop/macos.cjs
+var require_macos = __commonJS({
+  "scripts/desktop/macos.cjs"(exports2, module2) {
+    "use strict";
+    var { execSync: execSync5 } = require("child_process");
+    var path55 = require("path");
+    var fs51 = require("fs");
+    var APP_NAME = "Nexora Code";
+    function detectMacTerminalScript() {
+      if (fs51.existsSync("/Applications/iTerm.app")) {
+        return `#!/bin/bash
+open -a iTerm -- bash -c "nexora-code; exec bash"
+`;
+      }
+      if (fs51.existsSync("/Applications/Warp.app")) {
+        return `#!/bin/bash
+open -a Warp
+osascript -e 'tell application "Warp" to activate'
+`;
+      }
+      if (fs51.existsSync("/Applications/Hyper.app")) {
+        return `#!/bin/bash
+open -a Hyper
+`;
+      }
+      return `#!/bin/bash
+osascript <<'APPLESCRIPT'
+tell application "Terminal"
+  activate
+  do script "nexora-code"
+end tell
+APPLESCRIPT
+`;
+    }
+    function buildPlist(hasIcon) {
+      return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleExecutable</key>
+  <string>nexora-launcher</string>
+  <key>CFBundleIdentifier</key>
+  <string>cloud.getnexora.code</string>
+  <key>CFBundleName</key>
+  <string>${APP_NAME}</string>
+  <key>CFBundleDisplayName</key>
+  <string>${APP_NAME}</string>
+  <key>CFBundleVersion</key>
+  <string>1.0.0</string>
+  <key>CFBundleShortVersionString</key>
+  <string>1.0.0</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  ${hasIcon ? "<key>CFBundleIconFile</key>\n  <string>AppIcon</string>" : ""}
+  <key>LSMinimumSystemVersion</key>
+  <string>11.0</string>
+  <key>NSHighResolutionCapable</key>
+  <true/>
+  <key>LSUIElement</key>
+  <false/>
+</dict>
+</plist>
+`;
+    }
+    function createMacosShortcut(ctx) {
+      const appBundlePath = path55.join(ctx.desktopPath, `${APP_NAME}.app`);
+      const macOSDir = path55.join(appBundlePath, "Contents", "MacOS");
+      const resourceDir = path55.join(appBundlePath, "Contents", "Resources");
+      const icnsPath = path55.join(ctx.iconDir, "icon.icns");
+      const hasIcon = fs51.existsSync(icnsPath);
+      fs51.mkdirSync(macOSDir, { recursive: true });
+      fs51.mkdirSync(resourceDir, { recursive: true });
+      const launcherContent = detectMacTerminalScript();
+      const launcherPath = path55.join(macOSDir, "nexora-launcher");
+      fs51.writeFileSync(launcherPath, launcherContent, "utf-8");
+      fs51.chmodSync(launcherPath, 493);
+      fs51.writeFileSync(
+        path55.join(appBundlePath, "Contents", "Info.plist"),
+        buildPlist(hasIcon),
+        "utf-8"
+      );
+      if (hasIcon) {
+        fs51.copyFileSync(icnsPath, path55.join(resourceDir, "AppIcon.icns"));
+      }
+      try {
+        execSync5(`xattr -dr com.apple.quarantine "${appBundlePath}"`, { stdio: "pipe" });
+      } catch {
+      }
+      try {
+        execSync5(`touch "${appBundlePath}"`, { stdio: "pipe" });
+      } catch {
+      }
+      console.log(`  \u2713  App bundle created: ${appBundlePath}`);
+      createCommandFallback(ctx.desktopPath);
+      console.log("");
+      console.log(`  \u2192 Double-click "${APP_NAME}" on your Desktop to launch Nexora!`);
+      console.log("");
+    }
+    function createCommandFallback(desktopPath) {
+      const commandPath = path55.join(desktopPath, `${APP_NAME} (Terminal).command`);
+      const commandContent = `#!/bin/bash
+clear
+nexora-code
+exec $SHELL
+`;
+      fs51.writeFileSync(commandPath, commandContent, "utf-8");
+      fs51.chmodSync(commandPath, 493);
+      console.log(`  \u2713  .command fallback:  ${commandPath}`);
+    }
+    function removeMacosShortcut(ctx) {
+      const targets = [
+        path55.join(ctx.desktopPath, `${APP_NAME}.app`),
+        path55.join(ctx.desktopPath, `${APP_NAME} (Terminal).command`)
+      ];
+      for (const t of targets) {
+        try {
+          fs51.rmSync(t, { recursive: true, force: true });
+          console.log(`  \u2713  Removed: ${t}`);
+        } catch {
+        }
+      }
+    }
+    module2.exports = { createMacosShortcut, removeMacosShortcut };
+  }
+});
+
+// scripts/desktop/linux.cjs
+var require_linux = __commonJS({
+  "scripts/desktop/linux.cjs"(exports2, module2) {
+    "use strict";
+    var { execSync: execSync5 } = require("child_process");
+    var path55 = require("path");
+    var fs51 = require("fs");
+    var TERMINAL_CANDIDATES = [
+      { bin: "gnome-terminal", args: '-- bash -c "nexora-code; exec bash"' },
+      { bin: "konsole", args: '-e bash -c "nexora-code; exec bash"' },
+      { bin: "xfce4-terminal", args: `--command="bash -c 'nexora-code; exec bash'"` },
+      { bin: "tilix", args: `-e "bash -c 'nexora-code; exec bash'"` },
+      { bin: "alacritty", args: '-e bash -c "nexora-code; exec bash"' },
+      { bin: "kitty", args: 'bash -c "nexora-code; exec bash"' },
+      { bin: "xterm", args: '-e "nexora-code; bash"' },
+      { bin: "x-terminal-emulator", args: '-e bash -c "nexora-code; exec bash"' }
+      // Debian/Ubuntu alias
+    ];
+    function detectLinuxTerminal() {
+      for (const candidate of TERMINAL_CANDIDATES) {
+        try {
+          execSync5(`which ${candidate.bin}`, { stdio: "pipe" });
+          return candidate;
+        } catch {
+          continue;
+        }
+      }
+      return null;
+    }
+    function createLinuxShortcut(ctx) {
+      const terminal2 = detectLinuxTerminal();
+      const iconPath = path55.join(ctx.iconDir, "icon.png");
+      const iconExists = fs51.existsSync(iconPath);
+      const execLine = terminal2 ? `${terminal2.bin} ${terminal2.args}` : "nexora-code";
+      const iconLine = iconExists ? iconPath : "utilities-terminal";
+      const desktopContent = [
+        "[Desktop Entry]",
+        "Version=1.0",
+        "Type=Application",
+        "Name=Nexora Code",
+        "GenericName=AI Developer Workspace",
+        "Comment=Launch Nexora Code \u2014 World-class AI coding assistant",
+        `Exec=${execLine}`,
+        `Icon=${iconLine}`,
+        "Terminal=false",
+        // false: the terminal emulator handles this
+        "StartupNotify=true",
+        "Categories=Development;IDE;",
+        "Keywords=nexora;code;ai;developer;assistant;cli;",
+        "StartupWMClass=nexora-code"
+      ].join("\n") + "\n";
+      const desktopFilePath = path55.join(ctx.desktopPath, "nexora-code.desktop");
+      fs51.writeFileSync(desktopFilePath, desktopContent, "utf-8");
+      fs51.chmodSync(desktopFilePath, 493);
+      console.log(`  \u2713  Desktop launcher:   ${desktopFilePath}`);
+      const appMenuDir = path55.join(ctx.realHomeDir, ".local", "share", "applications");
+      const appMenuPath = path55.join(appMenuDir, "nexora-code.desktop");
+      try {
+        fs51.mkdirSync(appMenuDir, { recursive: true });
+        fs51.writeFileSync(appMenuPath, desktopContent, "utf-8");
+        fs51.chmodSync(appMenuPath, 493);
+        console.log(`  \u2713  App menu entry:     ${appMenuPath}`);
+        try {
+          execSync5("update-desktop-database ~/.local/share/applications", { stdio: "pipe" });
+        } catch {
+        }
+      } catch (err6) {
+        console.log(`  \u26A0  App menu entry skipped: ${err6.message}`);
+      }
+      if (terminal2) {
+        console.log(`  \u2713  Terminal detected:  ${terminal2.bin}`);
+      } else {
+        console.log("  \u26A0  No terminal emulator detected \u2014 using system default.");
+      }
+      console.log("");
+      console.log("  \u2192 Double-click the icon on your Desktop to launch Nexora Code!");
+      if (!terminal2) {
+        console.log('  \u2192 Or run "nexora-code" directly in your terminal.');
+      }
+      console.log("");
+    }
+    function removeLinuxShortcut(ctx) {
+      const targets = [
+        path55.join(ctx.desktopPath, "nexora-code.desktop"),
+        path55.join(ctx.realHomeDir, ".local", "share", "applications", "nexora-code.desktop")
+      ];
+      for (const t of targets) {
+        try {
+          fs51.unlinkSync(t);
+          console.log(`  \u2713  Removed: ${t}`);
+        } catch {
+        }
+      }
+      try {
+        execSync5("update-desktop-database ~/.local/share/applications", { stdio: "pipe" });
+      } catch {
+      }
+    }
+    module2.exports = { createLinuxShortcut, removeLinuxShortcut };
+  }
+});
+
+// scripts/desktop/shortcut.cjs
+var require_shortcut = __commonJS({
+  "scripts/desktop/shortcut.cjs"(exports2, module2) {
+    "use strict";
+    var os18 = require("os");
+    var path55 = require("path");
+    var fs51 = require("fs");
+    function fileExistsSync(p) {
+      try {
+        fs51.accessSync(p);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    function getRealHomeDir() {
+      if (process.env.SUDO_USER) {
+        const plat = process.platform;
+        if (plat === "linux") return `/home/${process.env.SUDO_USER}`;
+        if (plat === "darwin") return `/Users/${process.env.SUDO_USER}`;
+      }
+      return process.env.USERPROFILE || process.env.HOME || os18.homedir();
+    }
+    function findDesktopPath(homeDir, platform2) {
+      const candidates = [];
+      if (platform2 === "windows") {
+        candidates.push(
+          path55.join(homeDir, "Desktop"),
+          path55.join(homeDir, "OneDrive", "Desktop"),
+          // Very common on Win11 + OneDrive
+          path55.join(homeDir, "OneDrive - Personal", "Desktop")
+        );
+      } else if (platform2 === "macos") {
+        candidates.push(path55.join(homeDir, "Desktop"));
+      } else {
+        const xdgDesktop = process.env.XDG_DESKTOP_DIR;
+        if (xdgDesktop) candidates.push(xdgDesktop);
+        candidates.push(
+          path55.join(homeDir, "Desktop"),
+          path55.join(homeDir, "Escritorio"),
+          // Spanish
+          path55.join(homeDir, "Bureau"),
+          // French
+          path55.join(homeDir, "Schreibtisch"),
+          // German
+          path55.join(homeDir, "\u30C7\u30B9\u30AF\u30C8\u30C3\u30D7"),
+          // Japanese
+          path55.join(homeDir, "\u684C\u9762")
+          // Chinese (Simplified)
+        );
+      }
+      for (const candidate of candidates) {
+        if (fileExistsSync(candidate)) return candidate;
+      }
+      return null;
+    }
+    function getPackageDir() {
+      return path55.resolve(__dirname, "..", "..");
+    }
+    function buildUserContext() {
+      const rawPlatform = process.platform;
+      const platform2 = rawPlatform === "win32" ? "windows" : rawPlatform === "darwin" ? "macos" : "linux";
+      const realHomeDir = getRealHomeDir();
+      const desktopPath = findDesktopPath(realHomeDir, platform2);
+      const packageDir = getPackageDir();
+      const iconDir = path55.join(packageDir, "assets");
+      const binaryName = platform2 === "windows" ? "nexora-code.cmd" : "nexora-code";
+      const npmBinDir = path55.dirname(process.execPath);
+      const binaryPath = path55.join(npmBinDir, binaryName);
+      return { platform: platform2, realHomeDir, desktopPath, packageDir, binaryPath, iconDir };
+    }
+    async function createShortcut() {
+      const ctx = buildUserContext();
+      if (!ctx.desktopPath) {
+        console.log("  \u2139  No desktop found (headless / server / WSL environment).");
+        console.log('     Run "nexora-code" in any terminal to start.');
+        return;
+      }
+      console.log("");
+      console.log("  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+      console.log("  \u2502  Nexora Code  \u2014  Desktop Shortcut Setup     \u2502");
+      console.log("  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+      console.log("");
+      switch (ctx.platform) {
+        case "windows":
+          await require_windows2().createWindowsShortcut(ctx);
+          break;
+        case "macos":
+          await require_macos().createMacosShortcut(ctx);
+          break;
+        case "linux":
+          await require_linux().createLinuxShortcut(ctx);
+          break;
+        default:
+          console.log("  \u26A0  Unrecognised platform \u2014 skipping shortcut creation.");
+      }
+    }
+    async function removeShortcut() {
+      const ctx = buildUserContext();
+      if (!ctx.desktopPath) return;
+      switch (ctx.platform) {
+        case "windows":
+          await require_windows2().removeWindowsShortcut(ctx);
+          break;
+        case "macos":
+          await require_macos().removeMacosShortcut(ctx);
+          break;
+        case "linux":
+          await require_linux().removeLinuxShortcut(ctx);
+          break;
+      }
+    }
+    module2.exports = { createShortcut, removeShortcut, buildUserContext };
+  }
+});
+
 // node_modules/pdfjs-dist/legacy/build/pdf.mjs
 var pdf_exports = {};
 __export(pdf_exports, {
@@ -318475,7 +318982,7 @@ function updateNotifier(options) {
 // package.json
 var package_default = {
   name: "nexora-code",
-  version: "1.0.3",
+  version: "1.0.4",
   description: "Nexora Code \u2014 World-Class AI Coding Agent CLI. BYOK \xB7 51 tools \xB7 Multi-action \xB7 Streaming \xB7 Session Memory",
   author: "Enoch Boadu",
   license: "MIT",
@@ -332861,6 +333368,19 @@ var args = import_node_process51.default.argv.slice(2);
 var subcommand = args[0]?.toLowerCase();
 var headless2 = args.includes("--headless");
 async function main2() {
+  if (args.includes("--repair-shortcut")) {
+    const { createShortcut, removeShortcut } = await Promise.resolve().then(() => __toESM(require_shortcut(), 1));
+    console.log("\n  Nexora Code \u2014 Repairing desktop shortcut...\n");
+    try {
+      await removeShortcut();
+      await createShortcut();
+      console.log("\n  \u2713  Shortcut repaired successfully.\n");
+      import_node_process51.default.exit(0);
+    } catch (err6) {
+      console.error("\n  \u2717  Repair failed:", err6.message);
+      import_node_process51.default.exit(1);
+    }
+  }
   const taskIdIndex = args.indexOf("--task-id");
   if (taskIdIndex !== -1 && args[taskIdIndex + 1]) {
     await runBackgroundWorker(args[taskIdIndex + 1]);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "nexora-code",
-    "version": "1.0.3",
+    "version": "1.0.4",
     "description": "Nexora Code — World-Class AI Coding Agent CLI. BYOK · 51 tools · Multi-action · Streaming · Session Memory",
     "author": "Enoch Boadu",
     "license": "MIT",
@@ -94,4 +94,4 @@
     "workspaces": [
         "packages/*"
     ]
-}
+}

package/scripts/desktop/postinstall.cjs

@@ -11,7 +11,7 @@
 
 const { createShortcut } = require('./shortcut.cjs');
 
-function main() {
+async function main() {
   // ── Guard 1: Only run on global installs (-g flag) ──────────────────────────
   // npm sets npm_config_global=true for `npm install -g` commands.
   // Local `npm install` inside the project does NOT set this.
@@ -34,7 +34,10 @@ function main() {
     process.exit(0);
   }
 
-  createShortcut();
+  await createShortcut();
 }
 
-main();
+main().catch(err => {
+  // Never let shortcut errors break the install
+  process.exit(0);
+});

package/scripts/desktop/preuninstall.cjs

@@ -8,7 +8,7 @@
 
 const { removeShortcut } = require('./shortcut.cjs');
 
-function main() {
+async function main() {
   // Only clean up after global uninstalls — not local dev uninstalls
   const isGlobalUninstall = process.env.npm_config_global === 'true';
   if (!isGlobalUninstall) {
@@ -17,13 +17,11 @@ function main() {
 
   console.log('');
   console.log('  Nexora Code — Cleaning up desktop shortcut...');
-  removeShortcut();
+  await removeShortcut();
 }
 
 // Never let cleanup errors break the uninstall
-try {
-  main();
-} catch (err) {
+main().catch(err => {
   console.log(`  ⚠  Cleanup warning: ${err.message}`);
   process.exit(0);
-}
+});

package/scripts/desktop/shortcut.cjs

@@ -101,7 +101,7 @@ function buildUserContext() {
 
 // ── Public API ────────────────────────────────────────────────────────────────
 
-function createShortcut() {
+async function createShortcut() {
   const ctx = buildUserContext();
 
   if (!ctx.desktopPath) {
@@ -117,22 +117,22 @@ function createShortcut() {
   console.log('');
 
   switch (ctx.platform) {
-    case 'windows': require('./windows.cjs').createWindowsShortcut(ctx); break;
-    case 'macos':   require('./macos.cjs').createMacosShortcut(ctx);     break;
-    case 'linux':   require('./linux.cjs').createLinuxShortcut(ctx);     break;
+    case 'windows': await require('./windows.cjs').createWindowsShortcut(ctx); break;
+    case 'macos':   await require('./macos.cjs').createMacosShortcut(ctx);     break;
+    case 'linux':   await require('./linux.cjs').createLinuxShortcut(ctx);     break;
     default:
       console.log('  ⚠  Unrecognised platform — skipping shortcut creation.');
   }
 }
 
-function removeShortcut() {
+async function removeShortcut() {
   const ctx = buildUserContext();
   if (!ctx.desktopPath) return;
 
   switch (ctx.platform) {
-    case 'windows': require('./windows.cjs').removeWindowsShortcut(ctx); break;
-    case 'macos':   require('./macos.cjs').removeMacosShortcut(ctx);     break;
-    case 'linux':   require('./linux.cjs').removeLinuxShortcut(ctx);     break;
+    case 'windows': await require('./windows.cjs').removeWindowsShortcut(ctx); break;
+    case 'macos':   await require('./macos.cjs').removeMacosShortcut(ctx);     break;
+    case 'linux':   await require('./linux.cjs').removeLinuxShortcut(ctx);     break;
   }
 }
 

package/scripts/desktop/windows-wt-profile.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function getWTSettingsPath() {
+  const localAppData = process.env.LOCALAPPDATA || '';
+  const candidates = [
+    // Store version
+    path.join(localAppData, 'Packages', 'Microsoft.WindowsTerminal_8wekyb3d8bbwe', 'LocalState', 'settings.json'),
+    // Preview version
+    path.join(localAppData, 'Packages', 'Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe', 'LocalState', 'settings.json'),
+    // Winget / scoop version
+    path.join(localAppData, 'Microsoft', 'Windows Terminal', 'settings.json'),
+  ];
+  return candidates.find(p => {
+    try { fs.accessSync(p); return true; } catch { return false; }
+  }) || null;
+}
+
+function detectBestShell() {
+  const { execSync } = require('child_process');
+
+  try {
+    execSync('where pwsh.exe', { stdio: 'pipe' });
+    return { shellExe: 'pwsh.exe', shellArgs: '-NoExit -Command nexora-code' };
+  } catch { /* not found */ }
+
+  return {
+    shellExe:  'powershell.exe',
+    shellArgs: '-NoExit -Command nexora-code',
+  };
+}
+
+async function repairWTProfile() {
+  const settingsPath = getWTSettingsPath();
+  if (!settingsPath) return; // WT not installed or can't find settings
+
+  let settings;
+  try {
+    const raw = fs.readFileSync(settingsPath, 'utf-8');
+    // WT settings.json may have comments — strip them before parsing
+    const stripped = raw.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+    settings = JSON.parse(stripped);
+  } catch {
+    return; // Can't parse — don't corrupt the file
+  }
+
+  const profiles = settings?.profiles?.list;
+  if (!Array.isArray(profiles)) return;
+
+  let modified = false;
+
+  for (const profile of profiles) {
+    // Find any profile where commandline is set to bare "nexora-code"
+    if (
+      profile.name === 'Nexora Code' &&
+      profile.commandline === 'nexora-code'
+    ) {
+      const { shellExe, shellArgs } = detectBestShell();
+      profile.commandline = `${shellExe} ${shellArgs}`;
+      modified = true;
+
+      console.log('  ✓  Repaired corrupted Windows Terminal profile.');
+      console.log(`  ✓  Fixed commandline → ${profile.commandline}`);
+    }
+  }
+
+  if (modified) {
+    // Write back with 4-space indent to match WT's own format
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 4), 'utf-8');
+  }
+}
+
+module.exports = { repairWTProfile };

package/scripts/desktop/windows.cjs

@@ -8,36 +8,50 @@ const { execSync } = require('child_process');
 const path = require('path');
 const fs   = require('fs');
 
+const { repairWTProfile } = require('./windows-wt-profile.cjs');
+
 /**
  * Detect the best available terminal on Windows.
  * Priority: Windows Terminal > PowerShell 7 > PowerShell 5
  */
 function detectWindowsTerminal() {
-  // Windows Terminal (wt.exe) — best colour/font support
+  // Windows Terminal (wt.exe) — best experience
   try {
-    execSync('where wt.exe', { stdio: 'pipe' });
-    return {
-      exe:   'wt.exe',
-      args:  'nexora-code',
-      label: 'Windows Terminal',
-    };
-  } catch { /* not installed */ }
+    const wtPath = execSync('where wt.exe', { stdio: 'pipe' }).toString().trim();
+    if (wtPath) {
+      try {
+        execSync('where pwsh.exe', { stdio: 'pipe' });
+        return {
+          label:     'Windows Terminal + PowerShell 7',
+          shellExe:  wtPath,
+          shellArgs: 'pwsh.exe -NoExit -Command nexora-code',
+        };
+      } catch {
+        return {
+          label:     'Windows Terminal + PowerShell 5',
+          shellExe:  wtPath,
+          shellArgs: 'powershell.exe -NoExit -Command nexora-code',
+        };
+      }
+    }
+  } catch { /* wt not found */ }
 
   // PowerShell 7+ (pwsh.exe) — modern, cross-platform
   try {
-    execSync('where pwsh.exe', { stdio: 'pipe' });
-    return {
-      exe:   'pwsh.exe',
-      args:  '-NoExit -Command nexora-code',
-      label: 'PowerShell 7',
+    const pwsh7 = execSync('where pwsh.exe', { stdio: 'pipe' }).toString().trim();
+    if (pwsh7) return {
+      label:     'PowerShell 7',
+      shellExe:  pwsh7,
+      shellArgs: '-NoExit -Command nexora-code',
     };
   } catch { /* not installed */ }
 
   // PowerShell 5 (built into all Windows 10/11) — guaranteed fallback
+  const ps5 = `${process.env.SystemRoot}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
   return {
-    exe:   'powershell.exe',
-    args:  '-NoExit -Command nexora-code',
-    label: 'PowerShell 5 (built-in)',
+    label:     'PowerShell 5',
+    shellExe:  ps5,
+    shellArgs: '-NoExit -Command nexora-code',
   };
 }
 
@@ -45,25 +59,31 @@ function detectWindowsTerminal() {
  * Creates a Windows .lnk shortcut using PowerShell's WScript.Shell COM object.
  * No external libraries required.
  */
-function createWindowsShortcut(ctx) {
+async function createWindowsShortcut(ctx) {
+  // Repair any bad WT profile from a previous install attempt first
+  await repairWTProfile();
+
   const shortcutPath = path.join(ctx.desktopPath, 'Nexora Code.lnk');
   const iconPath     = path.join(ctx.iconDir, 'icon.ico');
   const iconExists   = fs.existsSync(iconPath);
   const terminal     = detectWindowsTerminal();
 
-  // Escape single-quotes in paths for PowerShell string literals
-  const safeShortcutPath = shortcutPath.replace(/'/g, "''");
-  const safeIconPath     = iconPath.replace(/'/g, "''");
-  const safeWorkingDir   = '%USERPROFILE%';
+  // Escape single quotes for PowerShell string embedding
+  const escapedShortcut = shortcutPath.replace(/'/g, "''");
+  const escapedShellExe = terminal.shellExe.replace(/'/g, "''");
+  const escapedArgs     = terminal.shellArgs.replace(/'/g, "''");
+  const iconLine        = iconExists
+    ? `$lnk.IconLocation = '${iconPath.replace(/'/g, "''")}'; `
+    : '';
 
   const psLines = [
     `$s = New-Object -ComObject WScript.Shell`,
-    `$lnk = $s.CreateShortcut('${safeShortcutPath}')`,
-    `$lnk.TargetPath = '${terminal.exe}'`,
-    `$lnk.Arguments = '${terminal.args}'`,
-    `$lnk.WorkingDirectory = '$env:USERPROFILE'`,
+    `$lnk = $s.CreateShortcut('${escapedShortcut}')`,
+    `$lnk.TargetPath = '${escapedShellExe}'`,
+    `$lnk.Arguments = '${escapedArgs}'`,
+    `$lnk.WorkingDirectory = $env:USERPROFILE`,
     `$lnk.Description = 'Launch Nexora Code AI Workspace'`,
-    iconExists ? `$lnk.IconLocation = '${safeIconPath}'` : '',
+    iconExists ? `$lnk.IconLocation = '${iconPath.replace(/'/g, "''")}'` : '',
     `$lnk.Save()`,
   ].filter(Boolean).join('; ');
 
@@ -73,7 +93,9 @@ function createWindowsShortcut(ctx) {
       { stdio: 'pipe', timeout: 20_000 }
     );
     console.log(`  ✓  Shortcut created:  ${shortcutPath}`);
-    console.log(`  ✓  Opens with:        ${terminal.label}`);
+    console.log(`  ✓  Shell target:      ${terminal.shellExe}`);
+    console.log(`  ✓  Launch command:    ${terminal.shellArgs}`);
+    console.log(`  ✓  Terminal:          ${terminal.label}`);
     if (iconExists) console.log(`  ✓  Icon applied:      Nexora Code logo`);
     console.log('');
     console.log('  → Double-click "Nexora Code" on your Desktop to launch!');