buddy-workbench 0.1.39 → 0.1.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buddy-workbench",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "private": false,
   "type": "module",
   "bin": {
@@ -24,6 +24,17 @@
     "version": "node -e \"const v=process.env.npm_package_version; const fs=require('fs'); ['ui/package.json', 'ui/package-lock.json'].forEach(p=>{if(fs.existsSync(p)){const j=JSON.parse(fs.readFileSync(p)); j.version=v; if(j.packages&&j.packages['']){j.packages[''].version=v;} fs.writeFileSync(p, JSON.stringify(j,null,2)+'\\n');}});\" && git add ui/package.json ui/package-lock.json"
   },
   "devbuddyChangelog": [
+    {
+      "version": "0.1.41",
+      "name": "Workflow improvements and theme-aware demo pages",
+      "notes": [
+        "Added folder selection and system-folder opening for NPM Prefix and Cache settings, with loading feedback while system configuration loads.",
+        "Improved Package Upgrade tasks with repository-based dependency suggestions, npm version lookup with cascading release selection, multi-package-manager lockfile support, and clearer branch and task history workflows.",
+        "Added a Check all action to Branch Sync Status without automatically checking on page entry, and improved task detail viewing.",
+        "Added a one-click Static Pages test demo and made the Welcome demo page adapt to DevBuddy light and dark themes.",
+        "Improved Clipboard History keyboard focus behavior so date navigation remains available after interacting with category tabs."
+      ]
+    },
     {
       "version": "0.1.33",
       "name": "Developer configuration management",
@@ -32,32 +43,6 @@
         "Added NVM detection, Node.js version installation, download mirror configuration, and current runtime details.",
         "Added global NPM package search, version selection with publish dates, install confirmation, upgrade, and uninstall actions."
       ]
-    },
-    {
-      "version": "0.1.28",
-      "name": "Presentation planning and presenter tools",
-      "notes": [
-        "Added a Presentations library and Presentation Studio for planning, timing, and delivering presentations.",
-        "Added a configurable audience view with Markdown takeaways, themes, time boxes, branding, and full-screen support.",
-        "Added step-linked quick captures and Markdown export with clipboard copy and .md downloads."
-      ]
-    },
-    {
-      "version": "0.1.27",
-      "name": "Data backups and settings refinements",
-      "notes": [
-        "Added data directory size statistics and secure .tar.gz backup import and export.",
-        "Refined the Static Pages action column header alignment."
-      ]
-    },
-    {
-      "version": "0.1.26",
-      "name": "Light theme and update center",
-      "notes": [
-        "Added a switchable light theme with persistent appearance settings.",
-        "Refined the light theme window color, primary actions, and navigation styling.",
-        "Added an npm-based update indicator and in-app Change Log."
-      ]
     }
   ],
   "dependencies": {

package/pages/welcome/index.html

@@ -4,14 +4,47 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Welcome - DevBuddy Static Pages</title>
+  <script>
+    (() => {
+      const applyTheme = (theme) => {
+        document.documentElement.dataset.theme = theme;
+      };
+      let savedTheme = '';
+      try { savedTheme = localStorage.getItem('devbuddy-theme') || ''; } catch {}
+      applyTheme(savedTheme === 'dark' || savedTheme === 'light'
+        ? savedTheme
+        : (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'));
+      window.addEventListener('storage', (event) => {
+        if (event.key === 'devbuddy-theme' && (event.newValue === 'dark' || event.newValue === 'light')) {
+          applyTheme(event.newValue);
+        }
+      });
+    })();
+  </script>
   <style>
     :root {
-      --bg: #0f172a;
-      --card-bg: #1e293b;
-      --text: #f8fafc;
-      --text-muted: #94a3b8;
-      --accent: #38bdf8;
-      --border: #334155;
+      color-scheme: light;
+      --bg: #f7f8fc;
+      --card-bg: #ffffff;
+      --text: #172033;
+      --text-muted: #667085;
+      --accent: #5b50e0;
+      --border: #e5e8f0;
+      --code-bg: #f0f1f8;
+      --code-text: #cf3038;
+      --shadow: 0 18px 44px rgba(31, 42, 68, .085);
+    }
+    :root[data-theme="dark"] {
+      color-scheme: dark;
+      --bg: #0f1117;
+      --card-bg: #171a22;
+      --text: #e7eaf0;
+      --text-muted: #929aaa;
+      --accent: #7669ee;
+      --border: #2a3040;
+      --code-bg: #101522;
+      --code-text: #ff8f9a;
+      --shadow: 0 18px 44px rgba(0, 0, 0, .28);
     }
     body {
       font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
@@ -24,16 +57,18 @@
       margin: 0;
       padding: 24px;
       box-sizing: border-box;
+      transition: background-color .2s ease, color .2s ease;
     }
     .card {
       background: var(--card-bg);
       padding: 32px;
       border-radius: 16px;
-      box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.3), 0 10px 10px -5px rgba(0, 0, 0, 0.2);
+      box-shadow: var(--shadow);
       border: 1px solid var(--border);
       text-align: center;
       max-width: 520px;
       width: 100%;
+      transition: background-color .2s ease, border-color .2s ease, box-shadow .2s ease;
     }
     .icon {
       font-size: 48px;
@@ -51,10 +86,10 @@
       margin-bottom: 20px;
     }
     code {
-      background: rgba(15, 23, 42, 0.8);
+      background: var(--code-bg);
       padding: 4px 8px;
       border-radius: 6px;
-      color: #f43f5e;
+      color: var(--code-text);
       font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
       font-size: 0.9em;
       border: 1px solid var(--border);

package/server/routes/package-upgrade.js

@@ -29,6 +29,25 @@ function updateTask(taskId, updater) {
   const next = updater(task); data.tasks = data.tasks.map((item) => item.id === taskId ? next : item); savePackageUpgradeData(data);
 }
 async function git(folder, args) { return (await exec('git', args, { cwd: folder, timeout: 10 * 60 * 1000, maxBuffer: 2 * 1024 * 1024 })).stdout.trim(); }
+async function gitRefExists(folder, ref) {
+  try {
+    await exec('git', ['show-ref', '--verify', '--quiet', ref], { cwd: folder, timeout: 30 * 1000 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function updateDependencyLockfile(folder) {
+  const lockfile = existsSync(join(folder, 'pnpm-lock.yaml')) ? 'pnpm-lock.yaml' : existsSync(join(folder, 'yarn.lock')) ? 'yarn.lock' : 'package-lock.json';
+  const packageManager = lockfile === 'pnpm-lock.yaml' ? 'pnpm' : lockfile === 'yarn.lock' ? 'yarn' : 'npm';
+  const commands = packageManager === 'pnpm'
+    ? ['pnpm', ['install', '--lockfile-only', '--ignore-scripts']]
+    : packageManager === 'yarn'
+      ? ['yarn', ['install', '--ignore-scripts']]
+      : ['npm', ['install', '--legacy-peer-deps', '--package-lock-only', '--ignore-scripts']];
+  await exec(commands[0], commands[1], { cwd: folder, timeout: 20 * 60 * 1000, maxBuffer: 4 * 1024 * 1024 });
+  return lockfile;
+}
 async function runRepo(task, repo) {
   const data = readPackageUpgradeData(); const folder = repoPath(data, repo); const name = repo.name || repoName(repo.url);
   const result = { repoId: repo.id, name, status: 'running', message: '', prUrl: null };
@@ -37,7 +56,15 @@ async function runRepo(task, repo) {
     mkdirSync(data.workspaceDir, { recursive: true });
     if (!existsSync(join(folder, '.git'))) await exec('git', ['clone', repo.url, folder], { cwd: data.workspaceDir, timeout: 20 * 60 * 1000, maxBuffer: 2 * 1024 * 1024 });
     await git(folder, ['fetch', 'origin', '--prune']);
-    await git(folder, ['checkout', '-B', task.sourceBranch, `origin/${task.targetBranch}`]);
+    const remoteTargetRef = `refs/remotes/origin/${task.targetBranch}`;
+    const localTargetRef = `refs/heads/${task.targetBranch}`;
+    const targetRef = await gitRefExists(folder, remoteTargetRef)
+      ? `origin/${task.targetBranch}`
+      : await gitRefExists(folder, localTargetRef)
+        ? task.targetBranch
+        : null;
+    if (!targetRef) throw new Error(`Target branch "${task.targetBranch}" was not found in ${name}. Check the target branch name and confirm it exists on origin.`);
+    await git(folder, ['checkout', '-B', task.sourceBranch, targetRef]);
     const packageFile = join(folder, 'package.json');
     if (!existsSync(packageFile)) throw new Error('package.json not found');
     const pkg = JSON.parse(readFileSync(packageFile, 'utf8'));
@@ -46,8 +73,8 @@ async function runRepo(task, repo) {
     if (!section) throw new Error(`Package ${task.packageName} is not in package.json`);
     pkg[section][task.packageName] = task.version;
     writeFileSync(packageFile, `${JSON.stringify(pkg, null, 2)}\n`);
-    await exec('npm', ['install', '--legacy-peer-deps', '--package-lock-only'], { cwd: folder, timeout: 20 * 60 * 1000, maxBuffer: 4 * 1024 * 1024 });
-    await git(folder, ['add', 'package.json', 'package-lock.json']);
+    const lockfile = await updateDependencyLockfile(folder);
+    await git(folder, ['add', 'package.json', lockfile]);
     await git(folder, ['commit', '-m', task.commitMessage]);
     await git(folder, ['push', 'origin', task.sourceBranch]);
     const parsed = parseBitbucket(repo.url); const settings = readSettings();
@@ -70,6 +97,24 @@ async function execute(task) {
 router.get('/config', (_req, res) => { const data = readPackageUpgradeData(); res.json({ workspaceDir: data.workspaceDir, repos: data.repos.map((repo) => ({ ...repo, cloned: existsSync(join(repoPath(data, repo), '.git')) })), tasks: data.tasks }); });
 router.put('/config', (req, res) => { const data = readPackageUpgradeData(); data.workspaceDir = String(req.body?.workspaceDir || '').trim(); if (!data.workspaceDir) return res.status(400).json({ error: 'Workspace directory is required.' }); savePackageUpgradeData(data); res.json({ workspaceDir: data.workspaceDir, repos: data.repos }); });
 router.post('/repos', (req, res) => { const url = String(req.body?.url || '').trim(); if (!url) return res.status(400).json({ error: 'Repository URL is required.' }); const data = readPackageUpgradeData(); const repo = { id: `repo-${Date.now()}`, url, name: String(req.body?.name || repoName(url)), directory: String(req.body?.directory || repoName(url)) }; data.repos.push(repo); savePackageUpgradeData(data); res.status(201).json(repo); });
+router.post('/repos/packages', (req, res) => {
+  const data = readPackageUpgradeData();
+  const repoIds = Array.isArray(req.body?.repoIds) ? req.body.repoIds : [];
+  const packageNames = new Set();
+  repoIds.forEach((repoId) => {
+    const repo = data.repos.find((item) => item.id === repoId);
+    if (!repo) return;
+    const packageFile = join(repoPath(data, repo), 'package.json');
+    if (!existsSync(packageFile)) return;
+    try {
+      const packageJson = JSON.parse(readFileSync(packageFile, 'utf8'));
+      ['dependencies', 'devDependencies'].forEach((section) => {
+        Object.keys(packageJson[section] || {}).forEach((name) => packageNames.add(name));
+      });
+    } catch {}
+  });
+  res.json([...packageNames].sort((a, b) => a.localeCompare(b)));
+});
 router.post('/repos/:id/clone', async (req, res) => { const data = readPackageUpgradeData(); const repo = data.repos.find((item) => item.id === req.params.id); if (!repo) return res.status(404).json({ error: 'Repository not found.' }); if (!data.workspaceDir) return res.status(400).json({ error: 'Configure a workspace directory first.' }); const folder = repoPath(data, repo); try { mkdirSync(data.workspaceDir, { recursive: true }); if (!existsSync(join(folder, '.git'))) await exec('git', ['clone', repo.url, folder], { cwd: data.workspaceDir, timeout: 20 * 60 * 1000, maxBuffer: 2 * 1024 * 1024 }); res.json({ ...repo, cloned: true }); } catch (error) { res.status(400).json({ error: error.stderr || error.message }); } });
 router.delete('/repos/:id', (req, res) => { const data = readPackageUpgradeData(); data.repos = data.repos.filter((r) => r.id !== req.params.id); savePackageUpgradeData(data); res.status(204).end(); });
 router.post('/tasks', (req, res) => { const body = req.body || {}; const required = ['sourceBranch', 'targetBranch', 'packageName', 'version', 'commitMessage']; if (required.some((key) => !String(body[key] || '').trim()) || !Array.isArray(body.repoIds) || !body.repoIds.length) return res.status(400).json({ error: 'All fields and at least one repository are required.' }); const data = readPackageUpgradeData(); if (!data.workspaceDir) return res.status(400).json({ error: 'Configure a workspace directory first.' }); const repoIds = body.repoIds.filter((id) => data.repos.some((repo) => repo.id === id)); if (!repoIds.length) return res.status(400).json({ error: 'Select at least one configured repository.' }); const task = { id: `task-${Date.now()}`, ...Object.fromEntries(required.map((key) => [key, String(body[key]).trim()])), repoIds, repos: repoIds.map((repoId) => ({ repoId, status: 'queued' })), status: 'running', createdAt: new Date().toISOString() }; data.tasks.unshift(task); savePackageUpgradeData(data); void execute(task); res.status(201).json(task); });

package/server/routes/updates.js

@@ -14,6 +14,7 @@ const CACHE_TTL_MS = 15 * 60 * 1000;
 
 let cachedResult = null;
 let cachedAt = 0;
+let selfUpdateRunning = false;
 
 function versionParts(version) {
   return String(version || '')
@@ -137,4 +138,32 @@ router.get('/', async (req, res) => {
   return res.json(cachedResult);
 });
 
+router.post('/self-update', async (_req, res) => {
+  if (selfUpdateRunning) {
+    return res.status(409).json({ error: 'An update is already in progress.' });
+  }
+
+  selfUpdateRunning = true;
+  try {
+    const { stdout } = await execFileAsync(
+      process.execPath,
+      [join(root, 'bin', 'devbuddy.js'), 'self-update'],
+      {
+        cwd: root,
+        timeout: 120000,
+        maxBuffer: 1024 * 1024,
+        windowsHide: true
+      }
+    );
+    cachedResult = null;
+    cachedAt = 0;
+    return res.json({ success: true, message: stdout.trim() || 'DevBuddy was updated successfully.' });
+  } catch (error) {
+    const details = error?.stderr?.trim() || error?.stdout?.trim() || error?.message;
+    return res.status(500).json({ error: details || 'DevBuddy could not be updated.' });
+  } finally {
+    selfUpdateRunning = false;
+  }
+});
+
 export default router;

package/server/services/dev-configurations.js

@@ -1,5 +1,5 @@
 import { execFile } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 import { promisify } from 'node:util';
@@ -8,15 +8,72 @@ const execFileAsync = promisify(execFile);
 const NPM_KEYS = ['prefix', 'registry', 'strict-ssl', 'cache', 'proxy', 'https-proxy'];
 const NVM_LOAD = 'if [ -s "$NVM_DIR/nvm.sh" ]; then . "$NVM_DIR/nvm.sh"; elif [ -s "$HOME/.nvm/nvm.sh" ]; then . "$HOME/.nvm/nvm.sh"; fi; ';
 
-async function run(command, args) {
-  const { stdout } = await execFileAsync(command, args, { timeout: 5000, maxBuffer: 1024 * 1024 });
-  return stdout.trim();
+function getEnrichedEnv() {
+  const home = homedir();
+  const extraPaths = [
+    join(home, '.nvm', 'current', 'bin'),
+    join(home, '.npm-global', 'bin'),
+    '/opt/homebrew/bin',
+    '/usr/local/bin',
+    '/usr/bin',
+    '/bin',
+    '/usr/sbin',
+    '/sbin'
+  ];
+  const nvmDir = process.env.NVM_DIR || join(home, '.nvm');
+  if (existsSync(nvmDir)) {
+    try {
+      const versionsDir = join(nvmDir, 'versions', 'node');
+      if (existsSync(versionsDir)) {
+        for (const v of readdirSync(versionsDir)) {
+          extraPaths.unshift(join(versionsDir, v, 'bin'));
+        }
+      }
+    } catch {}
+  }
+  const currentPath = process.env.PATH || '';
+  const mergedPath = [...new Set([...extraPaths, ...currentPath.split(':')])].filter(Boolean).join(':');
+  return { ...process.env, PATH: mergedPath };
+}
+
+function parseJsonOutput(text) {
+  const str = String(text || '').trim();
+  const objStart = str.indexOf('{');
+  const arrStart = str.indexOf('[');
+  let start = -1;
+  let end = -1;
+  if (objStart !== -1 && (arrStart === -1 || objStart < arrStart)) {
+    start = objStart;
+    end = str.lastIndexOf('}');
+  } else if (arrStart !== -1) {
+    start = arrStart;
+    end = str.lastIndexOf(']');
+  }
+  if (start !== -1 && end !== -1 && end > start) {
+    return JSON.parse(str.slice(start, end + 1));
+  }
+  return JSON.parse(str);
+}
+
+async function run(command, args, timeout = 5000) {
+  try {
+    const { stdout } = await execFileAsync(command, args, { timeout, maxBuffer: 8 * 1024 * 1024, env: getEnrichedEnv() });
+    return stdout.trim();
+  } catch (error) {
+    if (['node', 'npm'].includes(command)) {
+      try {
+        const cmdStr = `${command} ${args.map(shellQuote).join(' ')}`;
+        return await runNvm(cmdStr, timeout);
+      } catch {}
+    }
+    throw error;
+  }
 }
 
 async function runNvm(script, timeout = 5000) {
   for (const shell of ['zsh', 'bash']) {
     try {
-      const { stdout } = await execFileAsync(shell, ['-ilc', `${NVM_LOAD}${script}`], { timeout, maxBuffer: 2 * 1024 * 1024 });
+      const { stdout } = await execFileAsync(shell, ['-ilc', `${NVM_LOAD}${script}`], { timeout, maxBuffer: 4 * 1024 * 1024, env: getEnrichedEnv() });
       return stdout.trim();
     } catch {}
   }
@@ -61,14 +118,20 @@ async function readGitConfig(key) {
 
 async function readGlobalNpmPackages() {
   try {
-    const { stdout } = await execFileAsync('npm', ['ls', '--global', '--depth=0', '--json'], { timeout: 10000, maxBuffer: 4 * 1024 * 1024 });
-    const packageJson = JSON.parse(stdout);
+    const stdout = await run('npm', ['ls', '--global', '--depth=0', '--json'], 10000);
+    const packageJson = parseJsonOutput(stdout);
     return Object.entries(packageJson.dependencies || {}).map(([name, info]) => ({ name, version: info.version || '' }));
   } catch (error) {
     try {
-      const packageJson = JSON.parse(error.stdout || '');
+      const packageJson = parseJsonOutput(error.stdout || '');
       return Object.entries(packageJson.dependencies || {}).map(([name, info]) => ({ name, version: info.version || '' }));
-    } catch { return []; }
+    } catch {
+      try {
+        const output = await runNvm('npm ls --global --depth=0 --json', 10000);
+        const packageJson = parseJsonOutput(output);
+        return Object.entries(packageJson.dependencies || {}).map(([name, info]) => ({ name, version: info.version || '' }));
+      } catch { return []; }
+    }
   }
 }
 
@@ -86,15 +149,15 @@ export async function manageGlobalNpmPackage(action, packageName) {
     ? ['update', '--global', name]
     : ['uninstall', '--global', name];
   if (!['install', 'upgrade', 'uninstall'].includes(action)) throw new Error('Unsupported npm package action.');
-  await execFileAsync('npm', args, { timeout: 10 * 60 * 1000, maxBuffer: 4 * 1024 * 1024 });
+  await run('npm', args, 10 * 60 * 1000);
   return readGlobalNpmPackages();
 }
 
 export async function searchNpmPackages(query) {
   const term = String(query || '').trim();
   if (!term || term.length > 100) throw new Error('Enter a package search term.');
-  const { stdout } = await execFileAsync('npm', ['search', term, '--json', '--long'], { timeout: 30 * 1000, maxBuffer: 8 * 1024 * 1024 });
-  const results = JSON.parse(stdout);
+  const stdout = await run('npm', ['search', term, '--json', '--long'], 30 * 1000);
+  const results = parseJsonOutput(stdout);
   return (Array.isArray(results) ? results : []).slice(0, 20).map((item) => ({
     name: item.name,
     version: item.version || '',
@@ -104,12 +167,12 @@ export async function searchNpmPackages(query) {
 
 export async function getNpmPackageVersions(packageName) {
   const name = validateNpmPackageName(packageName).replace(/@[^@]+$/, '');
-  const [{ stdout: versionsOutput }, { stdout: timeOutput }] = await Promise.all([
-    execFileAsync('npm', ['view', name, 'versions', '--json'], { timeout: 30 * 1000, maxBuffer: 4 * 1024 * 1024 }),
-    execFileAsync('npm', ['view', name, 'time', '--json'], { timeout: 30 * 1000, maxBuffer: 4 * 1024 * 1024 })
+  const [versionsOutput, timeOutput] = await Promise.all([
+    run('npm', ['view', name, 'versions', '--json'], 30 * 1000),
+    run('npm', ['view', name, 'time', '--json'], 30 * 1000)
   ]);
-  const versions = JSON.parse(versionsOutput);
-  const publishTimes = JSON.parse(timeOutput) || {};
+  const versions = parseJsonOutput(versionsOutput);
+  const publishTimes = parseJsonOutput(timeOutput) || {};
   return (Array.isArray(versions) ? versions : versions ? [versions] : []).slice(-100).reverse().map((version) => ({ version, publishedAt: publishTimes[version] || '' }));
 }
 
@@ -204,3 +267,4 @@ export async function installNvmVersion(version) {
   await runNvm(`nvm install ${shellQuote(target)}`, 10 * 60 * 1000);
   return readNvmConfiguration();
 }
+