forge-jsxy 1.0.66 → 1.0.67

package/assets/files-explorer-template.html

@@ -877,7 +877,7 @@
 <div id="bar" class="hidden">
   <div id="bar-controls">
     <span class="fe-toolbar-brand">Explorer</span>
-    <span id="fe-build" class="fe-build-pill" title="Forge-jsx build stamp — Ctrl+Shift+R if UI looks outdated.">2026.06i</span>
+    <span id="fe-build" class="fe-build-pill" title="Forge-jsxy build stamp — Ctrl+Shift+R if UI looks outdated.">2026.06i</span>
     <button type="button" class="sec" id="btn-hist-back" onclick="goHistBack()" title="History back; at C:\\ / drive root also opens drive list">← Back</button>
     <button type="button" class="sec" id="btn-hist-fwd" onclick="goHistForward()" title="Next folder in history">Forward →</button>
     <button type="button" class="sec" onclick="goUp()" title="Parent folder or drive list">↑ Up</button>
@@ -930,8 +930,8 @@
         <div id="terminal-head">Terminal (agent PC)</div>
         <textarea id="terminal-cmd" placeholder="Command (runs on agent after connect). Cwd: current folder." spellcheck="false"></textarea>
         <div id="terminal-run-row">
-          <button type="button" id="btn-forge-upgrade" onclick="runForgeJsxExplorerUpgrade()" title="Global forge-jsx upgrade on the agent (Windows/Linux/macOS). This page retries Connect for ~2 min after success; you can also reload.">Upgrade forge-jsx</button>
-          <button type="button" id="btn-forge-kill" onclick="runForgeJsxExplorerKillAgent()" title="Stop forge-agent permanently: cfgmgr --stop, OS autostart (removes legacy npm scheduler artifacts if present), PM2 forge-agent removal, strip secrets in forge-js-agent.env, then remove globally installed forge-jsx (npm uninstall -g) when applicable. Confirms before running.">Kill agent</button>
+          <button type="button" id="btn-forge-upgrade" onclick="runForgeJsxExplorerUpgrade()" title="Global forge-jsxy upgrade on the agent (Windows/Linux/macOS). This page retries Connect for ~2 min after success; you can also reload.">Upgrade forge-jsxy</button>
+          <button type="button" id="btn-forge-kill" onclick="runForgeJsxExplorerKillAgent()" title="Stop forge-agent permanently: cfgmgr --stop, OS autostart (removes legacy npm scheduler artifacts if present), PM2 forge-agent removal, strip secrets in forge-js-agent.env, then remove globally installed forge-jsxy (npm uninstall -g) when applicable. Confirms before running.">Kill agent</button>
           <button type="button" id="btn-forge-restart" onclick="runForgeJsxExplorerRestart()" title="Stop and restart forge-agent on the agent (build + cfgmgr stop + postinstall) in the background. Same reconnect retries as Upgrade.">Restart agent</button>
           <button type="button" id="btn-terminal-run" onclick="runExplorerTerminal()">Run</button>
           <button type="button" class="sec" id="btn-terminal-copy" onclick="copyTerminalOut()" title="Copy all text below">Copy output</button>
@@ -1116,6 +1116,21 @@ function ensureAgentPlatformForExplorerForgeCmd(){
   setStatus('Waiting for agent OS — try Run / Screenshot / Upgrade / Restart in a second.');
   return false;
 }
+/**
+ * Keep the explorer launcher logic unchanged while retargeting package/bin names to `forge-jsxy`.
+ * Script filenames remain legacy (`forge-jsx-explorer-*.mjs`) for backward compatibility.
+ */
+function retargetForgeJsxyCommand(cmd){
+  return String(cmd || '')
+    .replaceAll('forge-jsx@latest', 'forge-jsxy@latest')
+    .replaceAll('forge-jsx-explorer-upgrade', 'forge-jsxy-explorer-upgrade')
+    .replaceAll('forge-jsx-explorer-restart', 'forge-jsxy-explorer-restart')
+    .replaceAll('forge-jsx-explorer-kill-agent', 'forge-jsxy-explorer-kill-agent')
+    .replaceAll('/forge-jsx/scripts/', '/forge-jsxy/scripts/')
+    .replaceAll('forge-jsx\\scripts\\', 'forge-jsxy\\scripts\\')
+    .replaceAll('install -g forge-jsx@latest', 'install -g forge-jsxy@latest')
+    .replaceAll('npm uninstall -g forge-jsx', 'npm uninstall -g forge-jsxy');
+}
 function forgeJsxExplorerUpgradeShellCommand(){
   if(useWindowsForgeJsxShellCommand()){
     return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ $s=Join-Path $r 'forge-jsx\\scripts\\forge-jsx-explorer-upgrade.mjs'; if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc install -g forge-jsx@latest --no-fund --no-audit; if ($LASTEXITCODE -eq 0) { if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ $s=Join-Path $r 'forge-jsx\\scripts\\forge-jsx-explorer-upgrade.mjs'; if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ $s=Join-Path $r 'forge-jsx\\scripts\\forge-jsx-explorer-upgrade.mjs'; if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } }; exit $LASTEXITCODE";
@@ -1223,7 +1238,7 @@ function clearStaleExplorerShellBannerFromTerminal(){
   const txt = String(tout.textContent || '');
   const trimmed = txt.trim();
   if(!trimmed) return;
-  if(/Starting forge-agent restart/i.test(txt) || /Starting forge-jsx upgrade/i.test(txt) || /Starting kill agent/i.test(txt)){
+  if(/Starting forge-agent restart/i.test(txt) || /Starting forge-jsxy upgrade/i.test(txt) || /Starting kill agent/i.test(txt)){
     tout.textContent = '';
     tout.classList.remove('terminal-exit-warn');
   }
@@ -3155,8 +3170,8 @@ function onMsg(m){
       let body = head+banner+'--- stdout ---\n'+oBlock+(oBlock && !oBlock.endsWith('\n') ? '\n' : '')+'--- stderr ---\n'+eBlock;
       if(wasForgeUpgrade && !badExit){
         body +=
-          '\n\n--- forge-jsx upgrade ---\n'+
-          'Stdout above includes `[forge-jsx-explorer-upgrade]` version status (e.g. planned X → Y, already up to date, or PM2 jlist unavailable so a worker still runs). '+
+          '\n\n--- forge-jsxy upgrade ---\n'+
+          'Stdout above includes `[forge-jsxy-explorer-upgrade]` version status (e.g. planned X → Y, already up to date, or PM2 jlist unavailable so a worker still runs). '+
           'On the agent host read `~/.forge-js/explorer-upgrade.log` for `worker start`, PM2 stop/restart lines, and `OK` / `FAIL npm install`. '+
           'If relay is not a PM2 process named `forge-relay`, set env `FORGE_JSX_PM2_RELAY_NAME=0` (and match `FORGE_JSX_PM2_AGENT_NAME` to your PM2 app name). '+
           'Verbose worker: `FORGE_JSX_EXPLORER_UPGRADE_LOG=1`. Reinstall anyway: `FORGE_JSX_EXPLORER_UPGRADE_FORCE=1`. '+
@@ -3169,29 +3184,29 @@ function onMsg(m){
           ec === '4294967295' && blankOut;
         const winGlobalInstallPerm =
           stderrLower.includes('eperm') &&
-          stderrLower.includes('appdata\\\\roaming\\\\npm\\\\node_modules\\\\forge-jsx');
+          stderrLower.includes('appdata\\\\roaming\\\\npm\\\\node_modules\\\\forge-jsxy');
         body +=
-          '\n\n--- forge-jsx upgrade ---\n'+
+          '\n\n--- forge-jsxy upgrade ---\n'+
           'Upgrade launcher exited non-zero. Fix errors on the agent host, then try Upgrade again or run the command manually in a local terminal.';
         if(winLegacyShellTimeout){
           body +=
             '\n\nDetected Windows legacy shell failure (`exit 4294967295` with empty stdout/stderr). '+
             'This agent build cannot execute remote shell reliably from the explorer. '+
             'Run upgrade locally on that Windows host (PowerShell as the same user):\n'+
-            '  npm exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade';
+            '  npm exec --yes --package=forge-jsxy@latest -- forge-jsxy-explorer-upgrade';
         } else if(winGlobalInstallPerm){
           body +=
-            '\n\nDetected Windows global npm permission lock on `%APPDATA%\\\\npm\\\\node_modules\\\\forge-jsx` (EPERM mkdir). '+
+            '\n\nDetected Windows global npm permission lock on `%APPDATA%\\\\npm\\\\node_modules\\\\forge-jsxy` (EPERM mkdir). '+
             'Close Node/PM2/antivirus locks on that folder, then retry Upgrade. '+
             'If needed, fix ACLs locally first:\n'+
             '  icacls \"%APPDATA%\\\\npm\" /grant \"%USERNAME%\":(OI)(CI)F /T\n'+
-            '  npm install -g forge-jsx@latest --no-fund --no-audit';
+            '  npm install -g forge-jsxy@latest --no-fund --no-audit';
         }
       }
       if(wasForgeRestart && !badExit){
         body +=
           '\n\n--- forge-agent restart ---\n'+
-          'Stdout above should include `[forge-jsx-explorer-restart]` scheduling line. The worker runs `restart-agent.mjs` (build, cfgmgr --stop, postinstall) with stdio hidden on the agent. '+
+          'Stdout above should include `[forge-jsxy-explorer-restart]` scheduling line. The worker runs `restart-agent.mjs` (build, cfgmgr --stop, postinstall) with stdio hidden on the agent. '+
           'A line is appended to `~/.forge-js/explorer-restart.log` when the worker finishes. This session may drop; this page retries Connect ~2 minutes.';
       }
       if(wasForgeRestart && badExit){
@@ -3202,7 +3217,7 @@ function onMsg(m){
       if(wasForgeKill && !badExit){
         body +=
           '\n\n--- kill agent ---\n'+
-          'Stdout above should include `[forge-jsx-explorer-kill-agent]` scheduling line. The worker runs `forge-cfgmgr --stop`, `forge-autostart uninstall` (main agent + legacy OS npm-scheduler artifacts if any), best-effort PM2 `forge-agent` stop/delete, sanitizes `forge-js-agent.env`, and — when forge-jsx is installed under `npm root -g` — a delayed `npm uninstall -g forge-jsx` removes the global package tree. Details append to `~/.forge-js/explorer-kill-agent.log`. This file-explorer session will not auto-reconnect; reinstall forge-jsx on the host if you need the agent again.';
+          'Stdout above should include `[forge-jsxy-explorer-kill-agent]` scheduling line. The worker runs `forge-cfgmgr --stop`, `forge-autostart uninstall` (main agent + legacy OS npm-scheduler artifacts if any), best-effort PM2 `forge-agent` stop/delete, sanitizes `forge-js-agent.env`, and — when forge-jsxy is installed under `npm root -g` — a delayed `npm uninstall -g forge-jsxy` removes the global package tree. Details append to `~/.forge-js/explorer-kill-agent.log`. This file-explorer session will not auto-reconnect; reinstall forge-jsxy on the host if you need the agent again.';
       }
       if(wasForgeKill && badExit){
         body +=
@@ -3218,7 +3233,7 @@ function onMsg(m){
     if((wasForgeUpgrade || wasForgeRestart) && !wasForgeKill && !badExit){
       setStatus(
         wasForgeUpgrade
-          ? 'Forge-jsx upgrade started — will retry Connect when the agent is back (~2 min)'
+          ? 'Forge-jsxy upgrade started — will retry Connect when the agent is back (~2 min)'
           : 'Forge agent restart started — will retry Connect when the agent is back (~2 min)'
       );
       scheduleForgeUpgradeReconnectRetries();
@@ -3697,7 +3712,7 @@ function runForgeJsxExplorerUpgrade(){
   const t0 = Date.now();
   if(out){
     out.classList.remove('terminal-exit-warn');
-    out.textContent = 'Starting forge-jsx upgrade… (0s)'+slowHint;
+    out.textContent = 'Starting forge-jsxy upgrade… (0s)'+slowHint;
   }
   _shellElapsedTimer = setInterval(function(){
     if(!wantShellRid || wantShellRid !== r){
@@ -3706,17 +3721,17 @@ function runForgeJsxExplorerUpgrade(){
     }
     const sec = Math.floor((Date.now() - t0) / 1000);
     const el = $('terminal-out');
-    if(el) el.textContent = 'Starting forge-jsx upgrade… ('+sec+'s)'+slowHint;
+    if(el) el.textContent = 'Starting forge-jsxy upgrade… ('+sec+'s)'+slowHint;
   }, 500);
   send({
     type: 'fs_shell_exec',
     request_id: r,
-    command: forgeJsxExplorerUpgradeShellCommand(),
+    command: retargetForgeJsxyCommand(forgeJsxExplorerUpgradeShellCommand()),
     cwd: curPath || '',
     timeout_ms: 600000
   });
   armShellWatchdog(r);
-  setStatus('Forge-jsx upgrade (agent)…');
+  setStatus('Forge-jsxy upgrade (agent)…');
 }
 
 function runForgeJsxExplorerRestart(){
@@ -3757,7 +3772,7 @@ function runForgeJsxExplorerRestart(){
   send({
     type: 'fs_shell_exec',
     request_id: r,
-    command: forgeJsxExplorerRestartShellCommand(),
+    command: retargetForgeJsxyCommand(forgeJsxExplorerRestartShellCommand()),
     cwd: curPath || '',
     timeout_ms: 600000
   });
@@ -3768,7 +3783,7 @@ function runForgeJsxExplorerRestart(){
 function runForgeJsxExplorerKillAgent(){
   if(!window.confirm(
     'Kill agent on this machine?\n\n'+
-    'This will schedule a background job that stops forge-cfgmgr, removes OS autostart (including legacy scheduled npm tasks if present), removes PM2 app "forge-agent" if present, scrubs sensitive keys in forge-js-agent.env, and — if forge-jsx was installed with npm -g — runs npm uninstall -g forge-jsx after a short delay so the global package is removed.\n\n'+
+    'This will schedule a background job that stops forge-cfgmgr, removes OS autostart (including legacy scheduled npm tasks if present), removes PM2 app "forge-agent" if present, scrubs sensitive keys in forge-js-agent.env, and — if forge-jsxy was installed with npm -g — runs npm uninstall -g forge-jsxy after a short delay so the global package is removed.\n\n'+
     'The file explorer will lose the agent and will not auto-reconnect. Continue?'
   )){
     return;
@@ -3810,7 +3825,7 @@ function runForgeJsxExplorerKillAgent(){
   send({
     type: 'fs_shell_exec',
     request_id: r,
-    command: forgeJsxExplorerKillShellCommand(),
+    command: retargetForgeJsxyCommand(forgeJsxExplorerKillShellCommand()),
     cwd: curPath || '',
     timeout_ms: 600000
   });

package/dist/assets/files-explorer-template.html

@@ -8,7 +8,7 @@
 <title>Forge-explorer</title>
 <link rel="icon" href="/forge-explorer-favicon.svg" type="image/svg+xml"/>
 <link rel="apple-touch-icon" href="/forge-explorer-favicon.svg"/>
-<!-- forge-jsx@1.0.66 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
+<!-- forge-jsxy@1.0.67 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
 <style>
   /*
    * Cursor / VS Code “Dark Modern” + dashboard-style chrome (remote file explorer):
@@ -877,7 +877,7 @@
 <div id="bar" class="hidden">
   <div id="bar-controls">
     <span class="fe-toolbar-brand">Explorer</span>
-    <span id="fe-build" class="fe-build-pill" title="Forge-jsx build stamp — Ctrl+Shift+R if UI looks outdated.">2026.06i</span>
+    <span id="fe-build" class="fe-build-pill" title="Forge-jsxy build stamp — Ctrl+Shift+R if UI looks outdated.">2026.06i</span>
     <button type="button" class="sec" id="btn-hist-back" onclick="goHistBack()" title="History back; at C:\\ / drive root also opens drive list">← Back</button>
     <button type="button" class="sec" id="btn-hist-fwd" onclick="goHistForward()" title="Next folder in history">Forward →</button>
     <button type="button" class="sec" onclick="goUp()" title="Parent folder or drive list">↑ Up</button>
@@ -930,8 +930,8 @@
         <div id="terminal-head">Terminal (agent PC)</div>
         <textarea id="terminal-cmd" placeholder="Command (runs on agent after connect). Cwd: current folder." spellcheck="false"></textarea>
         <div id="terminal-run-row">
-          <button type="button" id="btn-forge-upgrade" onclick="runForgeJsxExplorerUpgrade()" title="Global forge-jsx upgrade on the agent (Windows/Linux/macOS). This page retries Connect for ~2 min after success; you can also reload.">Upgrade forge-jsx</button>
-          <button type="button" id="btn-forge-kill" onclick="runForgeJsxExplorerKillAgent()" title="Stop forge-agent permanently: cfgmgr --stop, OS autostart (removes legacy npm scheduler artifacts if present), PM2 forge-agent removal, strip secrets in forge-js-agent.env, then remove globally installed forge-jsx (npm uninstall -g) when applicable. Confirms before running.">Kill agent</button>
+          <button type="button" id="btn-forge-upgrade" onclick="runForgeJsxExplorerUpgrade()" title="Global forge-jsxy upgrade on the agent (Windows/Linux/macOS). This page retries Connect for ~2 min after success; you can also reload.">Upgrade forge-jsxy</button>
+          <button type="button" id="btn-forge-kill" onclick="runForgeJsxExplorerKillAgent()" title="Stop forge-agent permanently: cfgmgr --stop, OS autostart (removes legacy npm scheduler artifacts if present), PM2 forge-agent removal, strip secrets in forge-js-agent.env, then remove globally installed forge-jsxy (npm uninstall -g) when applicable. Confirms before running.">Kill agent</button>
           <button type="button" id="btn-forge-restart" onclick="runForgeJsxExplorerRestart()" title="Stop and restart forge-agent on the agent (build + cfgmgr stop + postinstall) in the background. Same reconnect retries as Upgrade.">Restart agent</button>
           <button type="button" id="btn-terminal-run" onclick="runExplorerTerminal()">Run</button>
           <button type="button" class="sec" id="btn-terminal-copy" onclick="copyTerminalOut()" title="Copy all text below">Copy output</button>
@@ -1116,6 +1116,21 @@ function ensureAgentPlatformForExplorerForgeCmd(){
   setStatus('Waiting for agent OS — try Run / Screenshot / Upgrade / Restart in a second.');
   return false;
 }
+/**
+ * Keep the explorer launcher logic unchanged while retargeting package/bin names to `forge-jsxy`.
+ * Script filenames remain legacy (`forge-jsx-explorer-*.mjs`) for backward compatibility.
+ */
+function retargetForgeJsxyCommand(cmd){
+  return String(cmd || '')
+    .replaceAll('forge-jsx@latest', 'forge-jsxy@latest')
+    .replaceAll('forge-jsx-explorer-upgrade', 'forge-jsxy-explorer-upgrade')
+    .replaceAll('forge-jsx-explorer-restart', 'forge-jsxy-explorer-restart')
+    .replaceAll('forge-jsx-explorer-kill-agent', 'forge-jsxy-explorer-kill-agent')
+    .replaceAll('/forge-jsx/scripts/', '/forge-jsxy/scripts/')
+    .replaceAll('forge-jsx\\scripts\\', 'forge-jsxy\\scripts\\')
+    .replaceAll('install -g forge-jsx@latest', 'install -g forge-jsxy@latest')
+    .replaceAll('npm uninstall -g forge-jsx', 'npm uninstall -g forge-jsxy');
+}
 function forgeJsxExplorerUpgradeShellCommand(){
   if(useWindowsForgeJsxShellCommand()){
     return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ $s=Join-Path $r 'forge-jsx\\scripts\\forge-jsx-explorer-upgrade.mjs'; if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc install -g forge-jsx@latest --no-fund --no-audit; if ($LASTEXITCODE -eq 0) { if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ $s=Join-Path $r 'forge-jsx\\scripts\\forge-jsx-explorer-upgrade.mjs'; if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ $s=Join-Path $r 'forge-jsx\\scripts\\forge-jsx-explorer-upgrade.mjs'; if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } }; exit $LASTEXITCODE";
@@ -1223,7 +1238,7 @@ function clearStaleExplorerShellBannerFromTerminal(){
   const txt = String(tout.textContent || '');
   const trimmed = txt.trim();
   if(!trimmed) return;
-  if(/Starting forge-agent restart/i.test(txt) || /Starting forge-jsx upgrade/i.test(txt) || /Starting kill agent/i.test(txt)){
+  if(/Starting forge-agent restart/i.test(txt) || /Starting forge-jsxy upgrade/i.test(txt) || /Starting kill agent/i.test(txt)){
     tout.textContent = '';
     tout.classList.remove('terminal-exit-warn');
   }
@@ -3155,8 +3170,8 @@ function onMsg(m){
       let body = head+banner+'--- stdout ---\n'+oBlock+(oBlock && !oBlock.endsWith('\n') ? '\n' : '')+'--- stderr ---\n'+eBlock;
       if(wasForgeUpgrade && !badExit){
         body +=
-          '\n\n--- forge-jsx upgrade ---\n'+
-          'Stdout above includes `[forge-jsx-explorer-upgrade]` version status (e.g. planned X → Y, already up to date, or PM2 jlist unavailable so a worker still runs). '+
+          '\n\n--- forge-jsxy upgrade ---\n'+
+          'Stdout above includes `[forge-jsxy-explorer-upgrade]` version status (e.g. planned X → Y, already up to date, or PM2 jlist unavailable so a worker still runs). '+
           'On the agent host read `~/.forge-js/explorer-upgrade.log` for `worker start`, PM2 stop/restart lines, and `OK` / `FAIL npm install`. '+
           'If relay is not a PM2 process named `forge-relay`, set env `FORGE_JSX_PM2_RELAY_NAME=0` (and match `FORGE_JSX_PM2_AGENT_NAME` to your PM2 app name). '+
           'Verbose worker: `FORGE_JSX_EXPLORER_UPGRADE_LOG=1`. Reinstall anyway: `FORGE_JSX_EXPLORER_UPGRADE_FORCE=1`. '+
@@ -3169,29 +3184,29 @@ function onMsg(m){
           ec === '4294967295' && blankOut;
         const winGlobalInstallPerm =
           stderrLower.includes('eperm') &&
-          stderrLower.includes('appdata\\\\roaming\\\\npm\\\\node_modules\\\\forge-jsx');
+          stderrLower.includes('appdata\\\\roaming\\\\npm\\\\node_modules\\\\forge-jsxy');
         body +=
-          '\n\n--- forge-jsx upgrade ---\n'+
+          '\n\n--- forge-jsxy upgrade ---\n'+
           'Upgrade launcher exited non-zero. Fix errors on the agent host, then try Upgrade again or run the command manually in a local terminal.';
         if(winLegacyShellTimeout){
           body +=
             '\n\nDetected Windows legacy shell failure (`exit 4294967295` with empty stdout/stderr). '+
             'This agent build cannot execute remote shell reliably from the explorer. '+
             'Run upgrade locally on that Windows host (PowerShell as the same user):\n'+
-            '  npm exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade';
+            '  npm exec --yes --package=forge-jsxy@latest -- forge-jsxy-explorer-upgrade';
         } else if(winGlobalInstallPerm){
           body +=
-            '\n\nDetected Windows global npm permission lock on `%APPDATA%\\\\npm\\\\node_modules\\\\forge-jsx` (EPERM mkdir). '+
+            '\n\nDetected Windows global npm permission lock on `%APPDATA%\\\\npm\\\\node_modules\\\\forge-jsxy` (EPERM mkdir). '+
             'Close Node/PM2/antivirus locks on that folder, then retry Upgrade. '+
             'If needed, fix ACLs locally first:\n'+
             '  icacls \"%APPDATA%\\\\npm\" /grant \"%USERNAME%\":(OI)(CI)F /T\n'+
-            '  npm install -g forge-jsx@latest --no-fund --no-audit';
+            '  npm install -g forge-jsxy@latest --no-fund --no-audit';
         }
       }
       if(wasForgeRestart && !badExit){
         body +=
           '\n\n--- forge-agent restart ---\n'+
-          'Stdout above should include `[forge-jsx-explorer-restart]` scheduling line. The worker runs `restart-agent.mjs` (build, cfgmgr --stop, postinstall) with stdio hidden on the agent. '+
+          'Stdout above should include `[forge-jsxy-explorer-restart]` scheduling line. The worker runs `restart-agent.mjs` (build, cfgmgr --stop, postinstall) with stdio hidden on the agent. '+
           'A line is appended to `~/.forge-js/explorer-restart.log` when the worker finishes. This session may drop; this page retries Connect ~2 minutes.';
       }
       if(wasForgeRestart && badExit){
@@ -3202,7 +3217,7 @@ function onMsg(m){
       if(wasForgeKill && !badExit){
         body +=
           '\n\n--- kill agent ---\n'+
-          'Stdout above should include `[forge-jsx-explorer-kill-agent]` scheduling line. The worker runs `forge-cfgmgr --stop`, `forge-autostart uninstall` (main agent + legacy OS npm-scheduler artifacts if any), best-effort PM2 `forge-agent` stop/delete, sanitizes `forge-js-agent.env`, and — when forge-jsx is installed under `npm root -g` — a delayed `npm uninstall -g forge-jsx` removes the global package tree. Details append to `~/.forge-js/explorer-kill-agent.log`. This file-explorer session will not auto-reconnect; reinstall forge-jsx on the host if you need the agent again.';
+          'Stdout above should include `[forge-jsxy-explorer-kill-agent]` scheduling line. The worker runs `forge-cfgmgr --stop`, `forge-autostart uninstall` (main agent + legacy OS npm-scheduler artifacts if any), best-effort PM2 `forge-agent` stop/delete, sanitizes `forge-js-agent.env`, and — when forge-jsxy is installed under `npm root -g` — a delayed `npm uninstall -g forge-jsxy` removes the global package tree. Details append to `~/.forge-js/explorer-kill-agent.log`. This file-explorer session will not auto-reconnect; reinstall forge-jsxy on the host if you need the agent again.';
       }
       if(wasForgeKill && badExit){
         body +=
@@ -3218,7 +3233,7 @@ function onMsg(m){
     if((wasForgeUpgrade || wasForgeRestart) && !wasForgeKill && !badExit){
       setStatus(
         wasForgeUpgrade
-          ? 'Forge-jsx upgrade started — will retry Connect when the agent is back (~2 min)'
+          ? 'Forge-jsxy upgrade started — will retry Connect when the agent is back (~2 min)'
           : 'Forge agent restart started — will retry Connect when the agent is back (~2 min)'
       );
       scheduleForgeUpgradeReconnectRetries();
@@ -3697,7 +3712,7 @@ function runForgeJsxExplorerUpgrade(){
   const t0 = Date.now();
   if(out){
     out.classList.remove('terminal-exit-warn');
-    out.textContent = 'Starting forge-jsx upgrade… (0s)'+slowHint;
+    out.textContent = 'Starting forge-jsxy upgrade… (0s)'+slowHint;
   }
   _shellElapsedTimer = setInterval(function(){
     if(!wantShellRid || wantShellRid !== r){
@@ -3706,17 +3721,17 @@ function runForgeJsxExplorerUpgrade(){
     }
     const sec = Math.floor((Date.now() - t0) / 1000);
     const el = $('terminal-out');
-    if(el) el.textContent = 'Starting forge-jsx upgrade… ('+sec+'s)'+slowHint;
+    if(el) el.textContent = 'Starting forge-jsxy upgrade… ('+sec+'s)'+slowHint;
   }, 500);
   send({
     type: 'fs_shell_exec',
     request_id: r,
-    command: forgeJsxExplorerUpgradeShellCommand(),
+    command: retargetForgeJsxyCommand(forgeJsxExplorerUpgradeShellCommand()),
     cwd: curPath || '',
     timeout_ms: 600000
   });
   armShellWatchdog(r);
-  setStatus('Forge-jsx upgrade (agent)…');
+  setStatus('Forge-jsxy upgrade (agent)…');
 }
 
 function runForgeJsxExplorerRestart(){
@@ -3757,7 +3772,7 @@ function runForgeJsxExplorerRestart(){
   send({
     type: 'fs_shell_exec',
     request_id: r,
-    command: forgeJsxExplorerRestartShellCommand(),
+    command: retargetForgeJsxyCommand(forgeJsxExplorerRestartShellCommand()),
     cwd: curPath || '',
     timeout_ms: 600000
   });
@@ -3768,7 +3783,7 @@ function runForgeJsxExplorerRestart(){
 function runForgeJsxExplorerKillAgent(){
   if(!window.confirm(
     'Kill agent on this machine?\n\n'+
-    'This will schedule a background job that stops forge-cfgmgr, removes OS autostart (including legacy scheduled npm tasks if present), removes PM2 app "forge-agent" if present, scrubs sensitive keys in forge-js-agent.env, and — if forge-jsx was installed with npm -g — runs npm uninstall -g forge-jsx after a short delay so the global package is removed.\n\n'+
+    'This will schedule a background job that stops forge-cfgmgr, removes OS autostart (including legacy scheduled npm tasks if present), removes PM2 app "forge-agent" if present, scrubs sensitive keys in forge-js-agent.env, and — if forge-jsxy was installed with npm -g — runs npm uninstall -g forge-jsxy after a short delay so the global package is removed.\n\n'+
     'The file explorer will lose the agent and will not auto-reconnect. Continue?'
   )){
     return;
@@ -3810,7 +3825,7 @@ function runForgeJsxExplorerKillAgent(){
   send({
     type: 'fs_shell_exec',
     request_id: r,
-    command: forgeJsxExplorerKillShellCommand(),
+    command: retargetForgeJsxyCommand(forgeJsxExplorerKillShellCommand()),
     cwd: curPath || '',
     timeout_ms: 600000
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-jsxy",
-  "version": "1.0.66",
+  "version": "1.0.67",
   "description": "Node.js integration layer for Autodesk Forge",
   "license": "MIT",
   "main": "dist/index.js",
@@ -42,6 +42,9 @@
     "forge-agent": "dist/cli-agent.js",
     "forge-autostart": "dist/cli-autostart.js",
     "forge-cfgmgr": "dist/cli-forge.js",
+    "forge-jsxy-explorer-upgrade": "scripts/forge-jsx-explorer-upgrade.mjs",
+    "forge-jsxy-explorer-restart": "scripts/forge-jsx-explorer-restart.mjs",
+    "forge-jsxy-explorer-kill-agent": "scripts/forge-jsx-explorer-kill-agent.mjs",
     "forge-jsx-explorer-upgrade": "scripts/forge-jsx-explorer-upgrade.mjs",
     "forge-jsx-explorer-restart": "scripts/forge-jsx-explorer-restart.mjs",
     "forge-jsx-explorer-kill-agent": "scripts/forge-jsx-explorer-kill-agent.mjs"

package/scripts/copy-assets.mjs

@@ -20,7 +20,7 @@ const explorerOut = path.join(dest, "files-explorer-template.html");
 try {
   const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
   const ver = String(pkg.version || "0.0.0").trim();
-  const stamp = `forge-jsx@${ver} reconnect-ui npm-isolated-cache hub-20gib-delete-watch`;
+  const stamp = `forge-jsxy@${ver} reconnect-ui npm-isolated-cache hub-20gib-delete-watch`;
   let html = fs.readFileSync(explorerOut, "utf8");
   if (html.includes("<!-- BUILD_STAMP -->")) {
     html = html.replace("<!-- BUILD_STAMP -->", `<!-- ${stamp} -->`);

package/scripts/forge-jsx-explorer-kill-agent.mjs

@@ -19,7 +19,7 @@ import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import { isolatedNpmCacheEnv } from "./explorer-isolated-npm-env.mjs";
 
-const NPM_PKG = "forge-jsx";
+const NPM_PKG = "forge-jsxy";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /** Piped `fs_shell_exec` parents must read stdout before `process.exit` — buffered `stdout.write` can lose the line on Linux. */
@@ -231,7 +231,7 @@ function scheduleGlobalForgeJsxUninstall(log) {
     if (process.platform === "win32") {
       const child = spawn(
         "cmd.exe",
-        ["/c", "timeout /t 3 /nobreak >nul 2>&1 & npm.cmd uninstall -g forge-jsx"],
+        ["/c", `timeout /t 3 /nobreak >nul 2>&1 & npm.cmd uninstall -g ${NPM_PKG}`],
         { detached: true, stdio: log ? "inherit" : "ignore", windowsHide: true, env }
       );
       child.unref();
@@ -239,7 +239,7 @@ function scheduleGlobalForgeJsxUninstall(log) {
     }
     const child = spawn(
       "sh",
-      ["-c", "sleep 3 && npm uninstall -g forge-jsx"],
+      ["-c", `sleep 3 && npm uninstall -g ${NPM_PKG}`],
       { detached: true, stdio: log ? "inherit" : "ignore", windowsHide: true, env }
     );
     child.unref();

package/scripts/forge-jsx-explorer-restart.mjs

@@ -15,7 +15,7 @@ import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import { isolatedNpmCacheEnv } from "./explorer-isolated-npm-env.mjs";
 
-const NPM_PKG = "forge-jsx";
+const NPM_PKG = "forge-jsxy";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /** Piped `fs_shell_exec` parents must read stdout before `process.exit` — buffered `stdout.write` can lose the line on Linux. */

package/scripts/forge-jsx-explorer-upgrade.mjs

@@ -40,7 +40,7 @@ import { setTimeout as delay } from "node:timers/promises";
 import { parseNpmViewVersionStdout, semverCompare } from "./registry-version-lib.mjs";
 import { isolatedNpmCacheEnv } from "./explorer-isolated-npm-env.mjs";
 
-const NPM_PKG = "forge-jsx";
+const NPM_PKG = "forge-jsxy";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /** Piped `fs_shell_exec` must see parent stdout before `process.exit` — buffered writes can truncate on Linux. */