paneful 0.8.7 → 0.8.9

package/README.md

@@ -26,17 +26,17 @@ paneful --install-app          # Install as a native macOS app
 
 ## Features
 
-### Drag & Drop Projects
+### Split Pane Layouts
 
-Drag a folder from Finder into the sidebar to create a new project with the path pre-filled.
+Five layout presets — columns, rows, main + stack, main + row, and grid. Cycle through them with `Cmd+T` or auto-reorganize with `Cmd+R`.
 
-### Drag Files into Terminals
+### Project Sidebar
 
-Drag files from Finder or your editor (VS Code, Cursor) into a terminal pane to paste their paths as shell-escaped arguments.
+Organize terminals by project. Each project gets its own layout, panes, and working directory. Switch instantly from the sidebar. Drag the right edge to resize — width persists across sessions.
 
-### Favourites
+### Drag & Drop
 
-Save a workspace layout as a favourite — name, layout preset, and per-pane commands. Launch any favourite with a click to instantly recreate the setup. Managed from the star icon in the toolbar and the favourites section in the sidebar.
+Drag folders from Finder into the sidebar to create projects with the path pre-filled. Drag files into terminal panes to paste their paths as shell-escaped arguments.
 
 ### Editor Sync
 
@@ -47,9 +47,13 @@ Requires:
 1. **Paneful** (native app) or **Terminal** (CLI) added to **System Settings > Privacy & Security > Accessibility**
 2. Editor window title includes the folder name (default in VS Code/Cursor)
 
-### Resizable Sidebar
+### Favourites
+
+Save a workspace layout as a favourite — name, layout preset, and per-pane commands. Launch any favourite with a click to instantly recreate the setup.
+
+### Dev Server Detection
 
-Drag the right edge of the sidebar to resize it. Width persists across sessions.
+Automatically detects when a dev server starts in a terminal (Vite, Next.js, Angular, etc.). A green dot appears next to the project name in the sidebar while the port is alive, and disappears when it stops. Tracks ports per-terminal so the same port across different projects is handled correctly.
 
 ### Auto-Reorganize
 

package/dist/server/claude-monitor.js

@@ -0,0 +1,67 @@
+// Terminal had output within this window → Claude is actively working
+const ACTIVE_THRESHOLD = 3_000;
+export class ClaudeMonitor {
+    ptyManager;
+    onChange;
+    lastOutput = new Map(); // terminalId → timestamp
+    prevStatuses = {};
+    pollTimer = null;
+    destroyed = false;
+    constructor(ptyManager, onChange) {
+        this.ptyManager = ptyManager;
+        this.onChange = onChange;
+    }
+    start() {
+        this.pollTimer = setInterval(() => this.poll(), 3000);
+    }
+    /** Call from the PTY output path to record activity. */
+    recordOutput(terminalId) {
+        this.lastOutput.set(terminalId, Date.now());
+    }
+    /** Clean up when a terminal is removed. */
+    removeTerminal(terminalId) {
+        this.lastOutput.delete(terminalId);
+    }
+    destroy() {
+        this.destroyed = true;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.lastOutput.clear();
+    }
+    poll() {
+        if (this.destroyed)
+            return;
+        const now = Date.now();
+        // Which projects have claude running, and what's the latest output time per project?
+        const claudeProjects = this.ptyManager.getClaudeProjects();
+        const statuses = {};
+        for (const [projectId, terminalIds] of claudeProjects) {
+            let latestOutput = 0;
+            for (const tid of terminalIds) {
+                const ts = this.lastOutput.get(tid) ?? 0;
+                if (ts > latestOutput)
+                    latestOutput = ts;
+            }
+            statuses[projectId] = (latestOutput > 0 && (now - latestOutput) < ACTIVE_THRESHOLD)
+                ? 'active'
+                : 'idle';
+        }
+        if (!this.statusesEqual(statuses)) {
+            this.prevStatuses = statuses;
+            this.onChange(statuses);
+        }
+    }
+    statusesEqual(next) {
+        const prevKeys = Object.keys(this.prevStatuses);
+        const nextKeys = Object.keys(next);
+        if (prevKeys.length !== nextKeys.length)
+            return false;
+        for (const key of nextKeys) {
+            if (this.prevStatuses[key] !== next[key])
+                return false;
+        }
+        return true;
+    }
+}

package/dist/server/pty-manager.js

@@ -72,4 +72,23 @@ export class PtyManager {
     terminalExists(terminalId) {
         return this.sessions.has(terminalId);
     }
+    /** Returns projectId → terminalIds[] for terminals with `claude` as foreground process. */
+    getClaudeProjects() {
+        const result = new Map();
+        for (const [terminalId, managed] of this.sessions) {
+            try {
+                if (managed.process.process === 'claude') {
+                    const list = result.get(managed.projectId);
+                    if (list)
+                        list.push(terminalId);
+                    else
+                        result.set(managed.projectId, [terminalId]);
+                }
+            }
+            catch {
+                // PTY may have been killed
+            }
+        }
+        return result;
+    }
 }

package/dist/server/ws-handler.js

@@ -1,12 +1,14 @@
 import { WebSocket, WebSocketServer } from 'ws';
 import { newProject } from './project-store.js';
 import { PortMonitor } from './port-monitor.js';
+import { ClaudeMonitor } from './claude-monitor.js';
 export class WsHandler {
     wss;
     client = null;
     ptyManager;
     projectStore;
     portMonitor;
+    claudeMonitor;
     idleTimer = null;
     onIdle;
     constructor(server, ptyManager, projectStore, options) {
@@ -16,6 +18,10 @@ export class WsHandler {
         this.portMonitor = new PortMonitor((ports) => {
             this.send({ type: 'port:status', ports });
         });
+        this.claudeMonitor = new ClaudeMonitor(ptyManager, (statuses) => {
+            this.send({ type: 'claude:status', statuses });
+        });
+        this.claudeMonitor.start();
         this.wss = new WebSocketServer({ noServer: true });
         server.on('upgrade', (req, socket, head) => {
             if (req.url === '/ws') {
@@ -86,6 +92,7 @@ export class WsHandler {
                 break;
             case 'pty:kill': {
                 this.portMonitor.removeTerminal(msg.terminalId);
+                this.claudeMonitor.removeTerminal(msg.terminalId);
                 const projectId = this.ptyManager.kill(msg.terminalId);
                 if (projectId) {
                     this.projectStore.removeTerminal(projectId, msg.terminalId);
@@ -119,14 +126,17 @@ export class WsHandler {
     }
     destroy() {
         this.portMonitor.destroy();
+        this.claudeMonitor.destroy();
     }
     handlePtySpawn(terminalId, projectId, cwd) {
         try {
             this.ptyManager.spawn(terminalId, projectId, cwd, (tid, data) => {
                 this.send({ type: 'pty:output', terminalId: tid, data });
                 this.portMonitor.scanOutput(tid, projectId, data);
+                this.claudeMonitor.recordOutput(tid);
             }, (tid, exitCode) => {
                 this.portMonitor.removeTerminal(tid);
+                this.claudeMonitor.removeTerminal(tid);
                 this.send({ type: 'pty:exit', terminalId: tid, exitCode });
             });
             this.projectStore.addTerminal(projectId, terminalId);