buddy-workbench 0.1.0 → 0.1.2

package/README.md

@@ -12,6 +12,38 @@ 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.
 
+## Running on macOS
+
+### Double-click Launcher (Terminal)
+A pre-configured macOS launcher `Start Buddy.command` is available in the root directory.
+1. Simply double-click `Start Buddy.command` in Finder to start the workbench.
+2. A terminal window will open showing the server logs.
+3. Close the terminal window to stop the workbench and all of its running service processes.
+
+### Background App (Automator)
+To run the workbench in the background without leaving a terminal window open:
+1. Open the **Automator** app on your Mac.
+2. Create a new document and choose **Application**.
+3. Search for the **Run Shell Script** action and drag it into the workflow.
+4. Set the **Shell** option to `/bin/bash` (or `/bin/zsh`).
+5. Paste the following script:
+   ```bash
+    # Load user shell profile to inherit full terminal PATH (like nvm, fnm, npm-global, etc.)
+    if [ -f "$HOME/.zprofile" ]; then source "$HOME/.zprofile"; fi
+    if [ -f "$HOME/.zshrc" ]; then source "$HOME/.zshrc"; fi
+    
+    # Fallbacks for standard paths and npm global binaries
+    export PATH="$HOME/.npm-global/bin:/usr/local/bin:/opt/homebrew/bin:$PATH"
+    
+    cd "/Users/lynan/Documents/GitHub/buddy"
+    npm start
+   ```
+   *(Note: Adjust the path if the directory moves.)*
+6. Save (`Cmd + S`) the document as `Buddy.app` in your Applications folder or Desktop.
+7. **Custom Icon**:
+   - Copy the icon file `ui/public/devbuddy.icns` (`Cmd + C`).
+   - Select `Buddy.app`, press `Cmd + I` (Get Info), click the small icon at the top-left of the info panel, and press `Cmd + V`.
+
 ## UI development
 
 The UI is an independent React + Vite project in `ui/`, built with Ant Design. Run `npm run build` to build it, then run `npm start` to start Express. For UI development, use `npm run dev` in one terminal and `npm run dev:ui` in another; Vite proxies API and plugin requests to Express.

package/package.json

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

package/server/routes/clipboard.js

@@ -1,8 +1,31 @@
-import { Router } from 'express';
-import { clipboardDates, clipboardItems, clipboardOriginal, deleteClipboardItem } from '../services/clipboard-history.js';
+import express, { Router } from 'express';
+import { clipboardDates, clipboardItems, clipboardOriginal, deleteClipboardItem, saveClipboardImage, clipboardImagePath } from '../services/clipboard-history.js';
 
 const router = Router();
 router.get('/', (req, res) => res.json({ dates: clipboardDates(), items: clipboardItems(req.query.date) }));
+
+router.post('/image', express.raw({ type: 'image/*', limit: '10mb' }), (req, res) => {
+  try {
+    const buffer = req.body;
+    if (!buffer || buffer.length === 0) {
+      return res.status(400).json({ error: 'Image body is empty.' });
+    }
+    const item = saveClipboardImage(buffer);
+    res.json(item);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+});
+
+router.get('/image/:filename', (req, res) => {
+  try {
+    const filePath = clipboardImagePath(req.params.filename);
+    res.sendFile(filePath);
+  } catch (error) {
+    res.status(404).json({ error: 'Image not found.' });
+  }
+});
+
 router.get('/:date/:id', (req, res) => { const text = clipboardOriginal(req.params.date, req.params.id); if (text === null) return res.status(404).json({ error: 'Clipboard entry not found.' }); res.type('text/plain').send(text); });
 router.delete('/:date/:id', (req, res) => { if (!deleteClipboardItem(req.params.date, req.params.id)) return res.status(404).json({ error: 'Clipboard entry not found.' }); res.status(204).end(); });
 export default router;

package/server/services/clipboard-history.js

@@ -11,7 +11,7 @@ let lastValue = '';
 function today() { return new Intl.DateTimeFormat('en-CA').format(new Date()); }
 function dayFile(date) { const [year, month, day] = date.split('-'); return join(paths.clipboardDir, year, month, `${day}.json`); }
 function readJson(file, fallback) { try { return existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : fallback; } catch { return fallback; } }
-function writeJson(file, data) { mkdirSync(dirname(file), { recursive: true }); writeFileSync(file, JSON.stringify(data, null, 2)); }
+function writeJson(file, data) { mkdirSync(dirname(file), { recursive: true }); writeFileSync(file, JSON.stringify(data, null, 2), 'utf8'); }
 
 export function clipboardDates() {
   if (!existsSync(paths.clipboardDir)) return [];
@@ -29,6 +29,10 @@ export function deleteClipboardItem(date, id) {
     const contentPath = join(paths.clipboardDir, 'content', item.contentFile);
     if (existsSync(contentPath)) unlinkSync(contentPath);
   }
+  if (item.imageFile) {
+    const imagePath = join(paths.clipboardDir, 'content', item.imageFile);
+    if (existsSync(imagePath)) unlinkSync(imagePath);
+  }
   return true;
 }
 
@@ -83,3 +87,26 @@ export async function captureClipboard() {
 }
 
 export function startClipboardCapture() { captureClipboard(); const timer = setInterval(captureClipboard, 1000); timer.unref(); }
+
+export function saveClipboardImage(buffer) {
+  const date = today();
+  const id = crypto.randomUUID();
+  const filename = `${id}.png`;
+  
+  mkdirSync(join(paths.clipboardDir, 'content'), { recursive: true });
+  writeFileSync(join(paths.clipboardDir, 'content', filename), buffer);
+  
+  const item = {
+    id,
+    imageFile: filename,
+    createdAt: new Date().toISOString()
+  };
+  
+  const items = dayItems(date);
+  writeJson(dayFile(date), [item, ...items].slice(0, 200));
+  return item;
+}
+
+export function clipboardImagePath(filename) {
+  return join(paths.clipboardDir, 'content', filename);
+}

package/server.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+process.title = 'DevBuddy';
 import express from 'express';
 
 import { appendFileSync } from 'node:fs';