buddy-workbench 0.1.54 → 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.54",
+  "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/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/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());