buddy-workbench 0.1.30 → 0.1.32

package/README.md

@@ -12,6 +12,20 @@ npm start
 
 Open `http://localhost:3100`. To use another port, run `PORT=4000 npm start`. Startup attempts to stop any process currently using the selected port.
 
+When using the `devbuddy` CLI, pass the port directly with `--port`:
+
+```bash
+devbuddy start --port 4000
+devbuddy restart --port 4000
+```
+
+Update the globally installed CLI from npm:
+
+```bash
+devbuddy self-update
+devbuddy self-update 0.1.32
+```
+
 ## Running on macOS
 
 ### Double-click Launcher (Terminal)

package/bin/devbuddy.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { execSync, spawn } from 'node:child_process';
+import { execFileSync, execSync, spawn } from 'node:child_process';
 import { existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -13,6 +13,85 @@ const dataDir = join(root, 'data');
 const pidFile = join(dataDir, 'devbuddy.pid');
 const logFile = join(dataDir, 'devbuddy.log');
 const serverJs = join(root, 'server.js');
+const packageJsonFile = join(root, 'package.json');
+const defaultPort = 3100;
+
+function parsePort(args) {
+  let port;
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === '--port') {
+      if (port !== undefined || args[index + 1] === undefined) {
+        throw new Error('Usage: --port <number>');
+      }
+      port = args[++index];
+    } else if (arg.startsWith('--port=')) {
+      if (port !== undefined) throw new Error('Port was specified more than once.');
+      port = arg.slice('--port='.length);
+    } else {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+  }
+
+  const value = port ?? process.env.PORT ?? defaultPort;
+  if (!/^\d+$/.test(String(value)) || Number(value) < 1 || Number(value) > 65535) {
+    throw new Error('Port must be a number between 1 and 65535.');
+  }
+  return Number(value);
+}
+
+function packageDetails() {
+  return JSON.parse(readFileSync(packageJsonFile, 'utf8'));
+}
+
+function npmCommand() {
+  return process.platform === 'win32' ? 'npm.cmd' : 'npm';
+}
+
+function parseUpdateVersion(args) {
+  if (args.length > 1) throw new Error('Usage: devbuddy self-update [version]');
+  if (!args[0]) return 'latest';
+  if (args[0].startsWith('-') || /\s/.test(args[0])) {
+    throw new Error('Version must be a package version, tag, or dist-tag.');
+  }
+  return args[0];
+}
+
+function latestPublishedVersion(packageName) {
+  try {
+    return execFileSync(npmCommand(), ['view', packageName, 'version'], {
+      cwd: root,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'pipe']
+    }).trim();
+  } catch {
+    throw new Error(`Unable to query the latest ${packageName} version from npm.`);
+  }
+}
+
+function selfUpdate(args) {
+  const details = packageDetails();
+  const version = parseUpdateVersion(args);
+  const currentVersion = details.version;
+  const targetVersion = version === 'latest' ? latestPublishedVersion(details.name) : version;
+
+  if (version === 'latest' && targetVersion === currentVersion) {
+    console.log(`${details.name} is already up to date (${currentVersion}).`);
+    return;
+  }
+
+  console.log(`Updating ${details.name} from ${currentVersion} to ${version}…`);
+  try {
+    execFileSync(npmCommand(), ['install', '--global', `${details.name}@${version}`], {
+      cwd: root,
+      stdio: 'inherit'
+    });
+  } catch {
+    throw new Error(`Unable to install ${details.name}@${version}. Check npm permissions and network access.`);
+  }
+  console.log(`Updated ${details.name} to ${targetVersion}.`);
+}
 
 function isProcessRunning(pid) {
   try {
@@ -58,11 +137,11 @@ function sendSignal(pid, signal) {
   }
 }
 
-async function start() {
+async function start(port) {
   const existingPid = getRunningPid();
   if (existingPid) {
     console.log(`DevBuddy is already running (PID ${existingPid}).`);
-    console.log(`URL: http://localhost:${process.env.PORT || 3100}`);
+    console.log(`URL: http://localhost:${port}`);
     return;
   }
 
@@ -75,7 +154,7 @@ async function start() {
     detached: true,
     stdio: ['ignore', out, err],
     cwd: root,
-    env: { ...process.env }
+    env: { ...process.env, PORT: String(port) }
   });
 
   if (!child.pid) {
@@ -90,7 +169,6 @@ async function start() {
   await new Promise((resolve) => setTimeout(resolve, 800));
 
   if (isProcessRunning(child.pid)) {
-    const port = process.env.PORT || 3100;
     console.log(`DevBuddy started successfully (PID ${child.pid}).`);
     console.log(`URL: http://localhost:${port}`);
     console.log(`Logs: ${logFile}`);
@@ -133,10 +211,9 @@ async function stop() {
   console.log('DevBuddy stopped.');
 }
 
-function status() {
+function status(port) {
   const pid = getRunningPid();
   if (pid) {
-    const port = process.env.PORT || 3100;
     console.log(`DevBuddy is running (PID ${pid}).`);
     console.log(`URL: http://localhost:${port}`);
   } else {
@@ -149,33 +226,47 @@ function help() {
 DevBuddy CLI
 
 Usage:
-  devbuddy <command>
+  devbuddy <command> [--port <number>]
 
 Commands:
   start     Start DevBuddy in the background
   stop      Stop the running DevBuddy instance
   status    Check the status of DevBuddy
   restart   Restart DevBuddy
+  self-update [version]
+            Update the globally installed DevBuddy CLI
   help      Display this help message
+
+Options:
+  --port <number>  Port to listen on (default: 3100)
+
+Examples:
+  devbuddy start --port 4000
 `);
 }
 
 async function main() {
   const command = process.argv[2] || 'help';
+  const args = process.argv.slice(3);
 
   switch (command.toLowerCase()) {
     case 'start':
-      await start();
+      await start(parsePort(args));
       break;
     case 'stop':
       await stop();
       break;
     case 'status':
-      status();
+      status(parsePort(args));
       break;
     case 'restart':
       await stop();
-      await start();
+      await start(parsePort(args));
+      break;
+    case 'self-update':
+    case 'selfupdate':
+    case 'selfupgrade':
+      selfUpdate(args);
       break;
     case 'help':
     case '-h':

package/package.json

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

package/server/config.js

@@ -14,6 +14,7 @@ export const paths = {
   errors: join(root, 'data', 'errors.json'),
   postman: join(root, 'data', 'postman.json'),
   branchSync: join(root, 'data', 'branch-sync.json'),
+  presentations: join(root, 'data', 'presentations.json'),
   shutdownLog: join(root, 'data', 'shutdown.log'),
   clipboardDir: join(root, 'data', 'clipboard'),
   plugins: join(root, 'plugins'),

package/server/repositories/presentations.js

@@ -0,0 +1,31 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { paths } from '../config.js';
+
+const EMPTY_DATA = { plans: [], activePlan: null };
+
+export function getPresentations() {
+  try {
+    if (!existsSync(paths.presentations)) return EMPTY_DATA;
+    const parsed = JSON.parse(readFileSync(paths.presentations, 'utf8'));
+    return {
+      plans: Array.isArray(parsed.plans) ? parsed.plans : [],
+      activePlan: parsed.activePlan || null
+    };
+  } catch {
+    return EMPTY_DATA;
+  }
+}
+
+export function savePresentations(data) {
+  mkdirSync(dirname(paths.presentations), { recursive: true });
+  const current = getPresentations();
+  const next = {
+    plans: Array.isArray(data.plans) ? data.plans : [],
+    activePlan: Object.prototype.hasOwnProperty.call(data, 'activePlan')
+      ? data.activePlan || null
+      : current.activePlan
+  };
+  writeFileSync(paths.presentations, JSON.stringify(next, null, 2), 'utf8');
+  return next;
+}

package/server/routes/presentations.js

@@ -0,0 +1,19 @@
+import { Router } from 'express';
+import { getPresentations, savePresentations } from '../repositories/presentations.js';
+
+const router = Router();
+
+router.get('/', (_req, res) => {
+  res.json(getPresentations());
+});
+
+router.put('/', (req, res) => {
+  res.json(savePresentations(req.body || {}));
+});
+
+router.put('/active', (req, res) => {
+  const current = getPresentations();
+  res.json(savePresentations({ ...current, activePlan: req.body?.plan || null }));
+});
+
+export default router;

package/server.js

@@ -23,6 +23,7 @@ import fileOrganizerRoutes from './server/routes/file-organizer.js';
 import branchSyncRoutes from './server/routes/branch-sync.js';
 import updateRoutes from './server/routes/updates.js';
 import dataBackupRoutes from './server/routes/data-backup.js';
+import presentationsRoutes from './server/routes/presentations.js';
 import { addErrorRecord } from './server/repositories/errors.js';
 import { startClipboardCapture } from './server/services/clipboard-history.js';
 
@@ -81,6 +82,7 @@ app.use('/api/file-organizer', fileOrganizerRoutes);
 app.use('/api/branch-sync', branchSyncRoutes);
 app.use('/api/updates', updateRoutes);
 app.use('/api/data-backup', dataBackupRoutes);
+app.use('/api/presentations', presentationsRoutes);
 
 app.use((err, req, res, _next) => {
   addErrorRecord({