@sienklogic/plan-build-run 2.27.2 → 2.29.0

package/dashboard/src/watcher-setup.ts

@@ -0,0 +1,25 @@
+import { createWatcher, type WatchEvent } from './services/watcher.service.js';
+import { broadcast } from './services/sse.service.js';
+import type { FSWatcher } from 'chokidar';
+
+/**
+ * Start the file watcher for the project's .planning/ directory.
+ *
+ * On every file-change event, optionally invalidates caches (via the
+ * onCacheInvalidate callback) and broadcasts an SSE 'file-change' event
+ * to all connected clients.
+ *
+ * @param projectDir - Absolute path to the project root directory
+ * @param onCacheInvalidate - Optional callback to clear service-level caches
+ * @returns The FSWatcher instance (call .close() for graceful shutdown)
+ */
+export function startWatcher(
+  projectDir: string,
+  onCacheInvalidate?: () => void
+): FSWatcher {
+  const watcher = createWatcher(projectDir, async (event: WatchEvent) => {
+    onCacheInvalidate?.();
+    await broadcast('file-change', event);
+  });
+  return watcher;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sienklogic/plan-build-run",
-  "version": "2.27.2",
+  "version": "2.29.0",
   "description": "Plan it, Build it, Run it — structured development workflow for Claude Code",
   "keywords": [
     "claude-code",

package/plugins/copilot-pbr/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pbr",
   "displayName": "Plan-Build-Run",
-  "version": "2.27.2",
+  "version": "2.29.0",
   "description": "Plan-Build-Run — Structured development workflow for GitHub Copilot CLI. Solves context rot through disciplined agent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/plugins/cursor-pbr/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pbr",
   "displayName": "Plan-Build-Run",
-  "version": "2.27.2",
+  "version": "2.29.0",
   "description": "Plan-Build-Run — Structured development workflow for Cursor. Solves context rot through disciplined subagent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/plugins/pbr/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pbr",
-  "version": "2.27.2",
+  "version": "2.29.0",
   "description": "Plan-Build-Run — Structured development workflow for Claude Code. Solves context rot through disciplined subagent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/dashboard/src/services/sse.service.js

@@ -1,58 +0,0 @@
-/**
- * SSE (Server-Sent Events) service.
- * Manages a Set of active client response objects and provides
- * broadcast functionality to send events to all connected browsers.
- */
-
-/** @type {Set<import('http').ServerResponse>} */
-const clients = new Set();
-
-/**
- * Register a client response object for SSE broadcasting.
- * @param {import('http').ServerResponse} res
- */
-export function addClient(res) {
-  clients.add(res);
-}
-
-/**
- * Remove a client response object (called on disconnect).
- * @param {import('http').ServerResponse} res
- */
-export function removeClient(res) {
-  clients.delete(res);
-}
-
-/**
- * Broadcast an SSE event to all connected clients.
- * Clients that throw on write are automatically removed.
- * @param {string} eventType - SSE event name (e.g. 'file-change')
- * @param {object} data - Payload to JSON-serialize in the data field
- */
-export function broadcast(eventType, data) {
-  const id = Date.now();
-  const message = `event: ${eventType}\ndata: ${JSON.stringify(data)}\nid: ${id}\n\n`;
-
-  for (const client of clients) {
-    try {
-      client.write(message);
-    } catch {
-      clients.delete(client);
-    }
-  }
-}
-
-/**
- * Return the number of currently connected clients.
- * @returns {number}
- */
-export function getClientCount() {
-  return clients.size;
-}
-
-/**
- * Remove all clients. Used in tests to reset state between test cases.
- */
-export function clearClients() {
-  clients.clear();
-}

package/dashboard/src/services/watcher.service.js

@@ -1,48 +0,0 @@
-import chokidar from 'chokidar';
-import { join, relative } from 'node:path';
-
-/**
- * Create a chokidar file watcher for the .planning/ directory.
- *
- * Watches **\/*.md files with awaitWriteFinish to debounce editor saves.
- * Calls onChange with a normalized event object on add, change, and unlink.
- *
- * @param {string} watchPath - Absolute path to the project directory
- * @param {(event: {path: string, type: string, timestamp: number}) => void} onChange
- * @returns {import('chokidar').FSWatcher}
- */
-export function createWatcher(watchPath, onChange) {
-  const planningDir = join(watchPath, '.planning');
-
-  const watcher = chokidar.watch(join(planningDir, '**/*.md'), {
-    ignored: [
-      '**/node_modules/**',
-      '**/.git/**'
-    ],
-    persistent: true,
-    ignoreInitial: true,
-    awaitWriteFinish: {
-      stabilityThreshold: 500,
-      pollInterval: 100
-    }
-  });
-
-  const handleEvent = (type) => (filePath) => {
-    const relativePath = relative(watchPath, filePath);
-    onChange({
-      path: relativePath,
-      type,
-      timestamp: Date.now()
-    });
-  };
-
-  watcher.on('add', handleEvent('add'));
-  watcher.on('change', handleEvent('change'));
-  watcher.on('unlink', handleEvent('unlink'));
-
-  watcher.on('error', (error) => {
-    console.error('Watcher error:', error.message);
-  });
-
-  return watcher;
-}