buddy-workbench 0.1.53 → 0.1.55

package/bin/devbuddy.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { execFileSync, execSync, spawn } from 'node:child_process';
+import { execFileSync, spawn } from 'node:child_process';
 import { existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
@@ -46,10 +46,24 @@ function packageDetails() {
   return JSON.parse(readFileSync(packageJsonFile, 'utf8'));
 }
 
+function version() {
+  console.log(packageDetails().version);
+}
+
 function npmCommand() {
   return process.platform === 'win32' ? 'npm.cmd' : 'npm';
 }
 
+function npmExecOptions(options = {}) {
+  return {
+    ...options,
+    // npm is a .cmd shim on Windows and must be launched through cmd.exe.
+    // Keep that helper shell hidden so self-update does not flash a window.
+    shell: process.platform === 'win32',
+    windowsHide: process.platform === 'win32'
+  };
+}
+
 function parseUpdateVersion(args) {
   if (args.length > 1) throw new Error('Usage: devbuddy self-update [version]');
   if (!args[0]) return 'latest';
@@ -61,13 +75,14 @@ function parseUpdateVersion(args) {
 
 function latestPublishedVersion(packageName) {
   try {
-    return execFileSync(npmCommand(), ['view', packageName, 'version'], {
+    return execFileSync(npmCommand(), ['view', packageName, 'version'], npmExecOptions({
       cwd: root,
       encoding: 'utf8',
       stdio: ['ignore', 'pipe', 'pipe']
-    }).trim();
-  } catch {
-    throw new Error(`Unable to query the latest ${packageName} version from npm.`);
+    })).trim();
+  } catch (error) {
+    const details = String(error?.stderr || '').trim();
+    throw new Error(`Unable to query the latest ${packageName} version from npm.${details ? ` ${details}` : ''}`);
   }
 }
 
@@ -84,12 +99,13 @@ function selfUpdate(args) {
 
   console.log(`Updating ${details.name} from ${currentVersion} to ${version}…`);
   try {
-    execFileSync(npmCommand(), ['install', '--global', `${details.name}@${version}`], {
+    execFileSync(npmCommand(), ['install', '--global', `${details.name}@${version}`], npmExecOptions({
       cwd: root,
       stdio: 'inherit'
-    });
-  } catch {
-    throw new Error(`Unable to install ${details.name}@${version}. Check npm permissions and network access.`);
+    }));
+  } catch (error) {
+    const detailsText = String(error?.stderr || '').trim();
+    throw new Error(`Unable to install ${details.name}@${version}. ${detailsText || 'Check npm permissions and network access.'}`);
   }
   console.log(`Updated ${details.name} to ${targetVersion}.`);
 }
@@ -129,7 +145,10 @@ function sendSignal(pid, signal) {
       return true;
     } catch (err2) {
       try {
-        execSync(`kill -${signal === 'SIGTERM' ? '15' : '9'} ${pid}`);
+        execFileSync('kill', [`-${signal === 'SIGTERM' ? '15' : '9'}`, String(pid)], {
+          stdio: 'ignore',
+          windowsHide: process.platform === 'win32'
+        });
         return true;
       } catch {
         return false;
@@ -240,6 +259,7 @@ Commands:
   help      Display this help message
 
 Options:
+  -v, --version    Display the installed DevBuddy version
   --port <number>  Port to listen on (default: 3100)
 
 Examples:
@@ -252,6 +272,11 @@ async function main() {
   const args = process.argv.slice(3);
 
   switch (command.toLowerCase()) {
+    case '-v':
+    case '--version':
+      if (args.length) throw new Error('Usage: devbuddy --version');
+      version();
+      break;
     case 'start':
       await start(parsePort(args));
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buddy-workbench",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "private": false,
   "type": "module",
   "bin": {

package/server/lib/free-port.js

@@ -12,9 +12,9 @@ async function portPids(port) {
 export async function freePort(port) {
   try {
     if (process.platform === 'win32') {
-      const { stdout } = await execFileAsync('netstat', ['-ano', '-p', 'tcp']);
+      const { stdout } = await execFileAsync('netstat.exe', ['-ano', '-p', 'tcp'], { windowsHide: true });
       const pids = [...stdout.matchAll(new RegExp(`:${port}\\s+.*?LISTENING\\s+(\\d+)`, 'g'))].map((match) => match[1]);
-      await Promise.all([...new Set(pids)].map((pid) => execFileAsync('taskkill', ['/F', '/PID', pid])));
+      await Promise.all([...new Set(pids)].map((pid) => execFileAsync('taskkill.exe', ['/F', '/PID', pid], { windowsHide: true })));
     } else {
       const pids = await portPids(port);
       await Promise.all(pids.map((pid) => execFileAsync('kill', ['-TERM', pid])));

package/server/services/bookmark-sync.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import crypto from 'node:crypto';
-import { execSync } from 'node:child_process';
+import { execFileSync } from 'node:child_process';
 
 /**
  * Resolves standard bookmark file paths for Chrome and Edge based on OS.
@@ -37,11 +37,15 @@ export function checkBrowserRunning(browserName) {
   try {
     if (platform === 'win32') {
       const exeName = browserName === 'chrome' ? 'chrome.exe' : 'msedge.exe';
-      const output = execSync(`tasklist /FI "IMAGENAME eq ${exeName}"`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const output = execFileSync('tasklist.exe', ['/FI', `IMAGENAME eq ${exeName}`], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+        windowsHide: true
+      });
       return output.toLowerCase().includes(exeName.toLowerCase());
     } else {
       const processPattern = browserName === 'chrome' ? 'Google Chrome' : 'Microsoft Edge';
-      const output = execSync(`pgrep -f "${processPattern}"`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const output = execFileSync('pgrep', ['-f', processPattern], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
       return output.trim().length > 0;
     }
   } catch {

package/server/services/browser.js

@@ -24,7 +24,7 @@ export function openInSystemBrowser(url) {
       safari: 'msedge'
     };
     const cmd = winCmdMap[browser] || 'chrome';
-    execFile('cmd', ['/c', 'start', '', cmd, url]);
+    execFile('cmd.exe', ['/c', 'start', '', cmd, url], { windowsHide: true });
   } else {
     execFile('xdg-open', [url]);
   }
@@ -82,11 +82,11 @@ export function openInSystemEditor(path, location = '') {
     }
   } else if (process.platform === 'win32') {
     if (editor === 'vscode') {
-      execFile('cmd', ['/c', 'code', '-n', path]);
+      execFile('cmd.exe', ['/c', 'code', '-n', path], { windowsHide: true });
     } else if (editor === 'idea') {
-      execFile('cmd', ['/c', 'idea', path]);
+      execFile('cmd.exe', ['/c', 'idea', path], { windowsHide: true });
     } else {
-      execFile('cmd', ['/c', 'start', '', path]);
+      execFile('cmd.exe', ['/c', 'start', '', path], { windowsHide: true });
     }
   } else {
     if (editor === 'vscode') {
@@ -102,7 +102,7 @@ export function openInSystemFolder(targetPath) {
   if (process.platform === 'darwin') {
     execFile('open', [targetPath]);
   } else if (process.platform === 'win32') {
-    execFile('cmd', ['/c', 'start', '', targetPath]);
+    execFile('cmd.exe', ['/c', 'start', '', targetPath], { windowsHide: true });
   } else {
     execFile('xdg-open', [targetPath]);
   }
@@ -126,7 +126,7 @@ export async function openInSystemTerminal(targetPath) {
   }
 
   if (process.platform === 'win32') {
-    await execFileAsync('powershell.exe', ['-NoProfile', '-Command', 'Start-Process', 'cmd.exe', '-WorkingDirectory', targetPath]);
+    await execFileAsync('powershell.exe', ['-NoProfile', '-WindowStyle', 'Hidden', '-Command', 'Start-Process', 'cmd.exe', '-WorkingDirectory', targetPath], { windowsHide: true });
     return;
   }
 

package/server/services/clipboard-history.js

@@ -143,7 +143,7 @@ async function getClipboardText() {
   const commands = process.platform === 'darwin'
     ? [['pbpaste', []]]
     : process.platform === 'win32'
-      ? [['powershell.exe', ['-NoProfile', '-Command', 'Get-Clipboard -Format Text -Raw']]]
+      ? [['powershell.exe', ['-NoProfile', '-WindowStyle', 'Hidden', '-Command', 'Get-Clipboard -Format Text -Raw']]]
       : [
           ['wl-paste', ['--no-newline', '--type', 'text']],
           ['xclip', ['-selection', 'clipboard', '-o', '-t', 'UTF8_STRING']],

package/server/services/dev-configurations.js

@@ -32,7 +32,8 @@ function getEnrichedEnv() {
     } catch {}
   }
   const currentPath = process.env.PATH || '';
-  const mergedPath = [...new Set([...extraPaths, ...currentPath.split(':')])].filter(Boolean).join(':');
+  const pathSeparator = process.platform === 'win32' ? ';' : ':';
+  const mergedPath = [...new Set([...extraPaths, ...currentPath.split(pathSeparator)])].filter(Boolean).join(pathSeparator);
   return { ...process.env, PATH: mergedPath };
 }
 
@@ -56,8 +57,17 @@ function parseJsonOutput(text) {
 }
 
 async function run(command, args, timeout = 5000) {
+  const executable = process.platform === 'win32'
+    ? ({ npm: 'npm.cmd', node: 'node.exe', git: 'git.exe' }[command] || command)
+    : command;
   try {
-    const { stdout } = await execFileAsync(command, args, { timeout, maxBuffer: 8 * 1024 * 1024, env: getEnrichedEnv() });
+    const { stdout } = await execFileAsync(executable, args, {
+      timeout,
+      maxBuffer: 8 * 1024 * 1024,
+      env: getEnrichedEnv(),
+      shell: process.platform === 'win32' && executable.endsWith('.cmd'),
+      windowsHide: process.platform === 'win32'
+    });
     return stdout.trim();
   } catch (error) {
     if (['node', 'npm'].includes(command)) {
@@ -71,9 +81,12 @@ async function run(command, args, timeout = 5000) {
 }
 
 async function runNvm(script, timeout = 5000) {
+  if (process.platform === 'win32') {
+    throw new Error('Unix NVM shell is not supported on Windows.');
+  }
   for (const shell of ['zsh', 'bash']) {
     try {
-      const { stdout } = await execFileAsync(shell, ['-ilc', `${NVM_LOAD}${script}`], { timeout, maxBuffer: 4 * 1024 * 1024, env: getEnrichedEnv() });
+      const { stdout } = await execFileAsync(shell, ['-ilc', `${NVM_LOAD}${script}`], { timeout, maxBuffer: 4 * 1024 * 1024, env: getEnrichedEnv(), windowsHide: false });
       return stdout.trim();
     } catch {}
   }
@@ -267,4 +280,3 @@ export async function installNvmVersion(version) {
   await runNvm(`nvm install ${shellQuote(target)}`, 10 * 60 * 1000);
   return readNvmConfiguration();
 }
-

package/server/services/dialog.js

@@ -25,7 +25,7 @@ export async function selectDirectory() {
             Write-Output $dialog.SelectedPath
         }
       `;
-      const { stdout } = await execFileAsync('powershell', ['-NoProfile', '-Command', psScript]);
+      const { stdout } = await execFileAsync('powershell.exe', ['-NoProfile', '-WindowStyle', 'Hidden', '-Command', psScript], { windowsHide: true });
       const dirPath = stdout.trim();
       return dirPath ? { path: dirPath, canceled: false } : { path: null, canceled: true };
     } catch {
@@ -64,7 +64,7 @@ export async function selectFile() {
             Write-Output $dialog.FileName
         }
       `;
-      const { stdout } = await execFileAsync('powershell', ['-NoProfile', '-Command', psScript]);
+      const { stdout } = await execFileAsync('powershell.exe', ['-NoProfile', '-WindowStyle', 'Hidden', '-Command', psScript], { windowsHide: true });
       const filePath = stdout.trim();
       return filePath ? { path: filePath, canceled: false } : { path: null, canceled: true };
     } catch {

package/server/services/process-manager.js

@@ -114,7 +114,7 @@ export function clearScriptLogs(launcherId, scriptId) { logs.set(keyFor(launcher
 async function listeningProcesses() {
   if (process.platform === 'win32') {
     try {
-      const { stdout } = await execFileAsync('netstat', ['-ano', '-p', 'tcp']);
+      const { stdout } = await execFileAsync('netstat.exe', ['-ano', '-p', 'tcp'], { windowsHide: true });
       const rows = [];
       const matches = stdout.matchAll(/TCP\s+(?:\[::\]|[\d.]+):(\d+)\s+.*?LISTENING\s+(\d+)/gi);
       for (const m of matches) {
@@ -151,6 +151,9 @@ async function listeningProcesses() {
 }
 
 async function processGroupFor(pid) {
+  // Windows has no Unix process-group ID. Do not attempt to invoke `ps` here;
+  // on some installations that resolves through a visible shell window.
+  if (process.platform === 'win32') return null;
   try {
     const { stdout } = await execFileAsync('ps', ['-o', 'pgid=', '-p', String(pid)]);
     return Number(stdout.trim());
@@ -253,7 +256,7 @@ export function runScript(launcher, script) {
   if (running.has(key)) throw new Error('This script is already running.');
   if (!existsSync(launcher.folder)) throw new Error('The configured project folder does not exist.');
   logs.set(key, { output: `$ ${script.command}\n`, error: '', errorCount: 0 });
-  const child = spawn(process.execPath, [supervisorPath], { cwd: launcher.folder, detached: process.platform !== 'win32', stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env, ...(launcher.executor === 'pnpm' || /^\s*pnpm\b/.test(script.command) ? { CI: 'true' } : {}), BUDDY_PARENT_PID: String(process.pid), BUDDY_SCRIPT_COMMAND: script.command } });
+  const child = spawn(process.execPath, [supervisorPath], { cwd: launcher.folder, detached: process.platform !== 'win32', stdio: ['ignore', 'pipe', 'pipe'], windowsHide: process.platform === 'win32', env: { ...process.env, ...(launcher.executor === 'pnpm' || /^\s*pnpm\b/.test(script.command) ? { CI: 'true' } : {}), BUDDY_PARENT_PID: String(process.pid), BUDDY_SCRIPT_COMMAND: script.command } });
   child.stdout.on('data', (chunk) => appendLog(key, 'output', chunk.toString()));
   child.stderr.on('data', (chunk) => appendLog(key, 'error', chunk.toString()));
   running.set(key, child);

package/server/services/script-supervisor.js

@@ -4,7 +4,12 @@ import { promisify } from 'node:util';
 const execFileAsync = promisify(execFile);
 const parentPid = Number(process.env.BUDDY_PARENT_PID);
 const command = process.env.BUDDY_SCRIPT_COMMAND;
-const child = spawn(command, { cwd: process.cwd(), shell: true, stdio: 'inherit' });
+const child = spawn(command, {
+  cwd: process.cwd(),
+  shell: true,
+  stdio: 'inherit',
+  windowsHide: process.platform === 'win32'
+});
 
 function stopGroup() {
   if (process.platform === 'win32') { child.kill('SIGTERM'); return; }