iranti-control-plane 0.5.4 → 0.5.6

package/README.md

@@ -1,15 +1,17 @@
 # Iranti Control Plane
 
-Local-first operator dashboard for [Iranti](https://github.com/nfemmanuel/iranti) - inspect memory, watch Staff activity, manage instances, and diagnose your setup without raw SQL.
+Local-first operator dashboard for [Iranti](https://github.com/nfemmanuel/iranti) — inspect memory, watch Staff activity, manage instances, and diagnose your setup without raw SQL.
 
 ## Status
 
-Current package version: `0.4.3`.
-The operator surface is live and under active UX hardening.
+Current package version: `0.5.5`.
+The operator surface is live and under active development.
 
-## Install
+Available on npm and mirrored by jsDelivr:
+- npm: `npm install -g iranti-control-plane`
+- jsDelivr CDN: `https://cdn.jsdelivr.net/npm/iranti-control-plane/`
 
-For the packaged control-plane CLI path (after npm publish, or from a locally packed tarball):
+## Install
 
 ```bash
 npm install -g iranti-control-plane

package/bin/iranti-cp.js

@@ -309,6 +309,38 @@ function spawnControlPlane({ port, openBrowser, detached }) {
   if (port) env.CONTROL_PLANE_PORT = String(port);
   if (!openBrowser) env.IRANTI_CP_NO_OPEN = '1';
 
+  // On Windows, spawning node.exe directly causes Windows Terminal (wt.exe)
+  // to intercept the new console process and flash a tab, even with
+  // windowsHide:true. windowsHide suppresses a standalone console window but
+  // does not prevent Windows Terminal from attaching.
+  //
+  // Routing through `cmd /c start "" /b node bundle.cjs` creates the child
+  // with the DETACHED_PROCESS flag implicitly, so no console is allocated and
+  // Windows Terminal never attaches.  This is only needed for the detached
+  // (background) case; foreground start keeps stdio:inherit as usual.
+  if (process.platform === 'win32' && detached) {
+    // On Windows, spawning node.exe directly causes Windows Terminal (wt.exe)
+    // to attach and flash a tab.  Routing through a hidden cmd process (via
+    // windowsHide:true + detached:true) prevents attachment because cmd gets
+    // CREATE_NO_WINDOW, and node.exe — run as cmd's synchronous child (no
+    // start /b) — inherits that no-console state.
+    //
+    // We also cannot pass env vars via spawn({env}) because the env block on
+    // the outer cmd is not forwarded to node by the OS process-creation chain.
+    // A temp batch file with explicit SET commands is the reliable workaround.
+    const batPath = require('path').join(require('os').tmpdir(), `iranti-cp-${Date.now()}.bat`);
+    const batLines = ['@echo off'];
+    if (port) batLines.push(`SET CONTROL_PLANE_PORT=${String(port)}`);
+    if (!openBrowser) batLines.push('SET IRANTI_CP_NO_OPEN=1');
+    batLines.push(`"${process.execPath}" "${BUNDLE}"`);
+    require('fs').writeFileSync(batPath, batLines.join('\r\n') + '\r\n');
+    const child = spawn('cmd', ['/d', '/s', '/c', batPath], {
+      detached: true, stdio: 'ignore', windowsHide: true,
+    });
+    child.unref();
+    return child;
+  }
+
   const child = spawn(process.execPath, [BUNDLE], {
     env,
     stdio: detached ? 'ignore' : 'inherit',