@sienklogic/plan-build-run 2.21.0 → 2.21.2

package/dashboard/src/routes/events.routes.js

@@ -1,45 +0,0 @@
-import { Router } from 'express';
-import { addClient, removeClient } from '../services/sse.service.js';
-
-const router = Router();
-
-/**
- * GET /stream - Server-Sent Events endpoint.
- * Establishes a long-lived SSE connection. Events are pushed by the SSE service
- * when the file watcher detects changes. Heartbeat comments every 30s keep the
- * connection alive.
- */
-router.get('/stream', (req, res) => {
-  // Set SSE headers
-  res.writeHead(200, {
-    'Content-Type': 'text/event-stream',
-    'Cache-Control': 'no-cache',
-    'Connection': 'keep-alive',
-    'X-Accel-Buffering': 'no'
-  });
-  res.flushHeaders();
-
-  // Send initial connection confirmation
-  res.write(': connected\n\n');
-
-  // If client reconnected with a lastEventId, send state-recovery event
-  if (req.query.lastEventId) {
-    res.write(`event: state-recovery\ndata: {"action":"refresh"}\nid: ${Date.now()}\n\n`);
-  }
-
-  // Register this client for broadcasts
-  addClient(res);
-
-  // Heartbeat every 30 seconds to keep connection alive
-  const heartbeat = setInterval(() => {
-    res.write(': heartbeat\n\n');
-  }, 30000);
-
-  // Clean up on client disconnect
-  req.on('close', () => {
-    clearInterval(heartbeat);
-    removeClient(res);
-  });
-});
-
-export default router;

package/dashboard/src/routes/index.routes.js

@@ -1,35 +0,0 @@
-import { Router } from 'express';
-import { getHomepage } from '../services/project.service.js';
-import { getDashboardData } from '../services/dashboard.service.js';
-import { listPendingTodos } from '../services/todo.service.js';
-
-const router = Router();
-
-router.get('/', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-
-  const [homepageData, dashboardData, pendingTodos] = await Promise.all([
-    getHomepage(projectDir),
-    getDashboardData(projectDir),
-    listPendingTodos(projectDir).catch(() => [])
-  ]);
-
-  const templateData = {
-    ...homepageData,
-    ...dashboardData,
-    pendingTodoCount: pendingTodos.length,
-    activePage: 'dashboard',
-    currentPath: '/',
-    breadcrumbs: []
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/dashboard-content', templateData);
-  } else {
-    res.render('index', templateData);
-  }
-});
-
-export default router;

package/dashboard/src/routes/pages.routes.js

@@ -1,426 +0,0 @@
-import { Router } from 'express';
-import { getPhaseDetail, getPhaseDocument } from '../services/phase.service.js';
-import { getRoadmapData, generateDependencyMermaid } from '../services/roadmap.service.js';
-import { parseStateFile, derivePhaseStatuses } from '../services/dashboard.service.js';
-import { listPendingTodos, getTodoDetail, createTodo, completeTodo } from '../services/todo.service.js';
-import { getAllMilestones, getMilestoneDetail } from '../services/milestone.service.js';
-import { getProjectAnalytics } from '../services/analytics.service.js';
-import { listNotes } from '../services/notes.service.js';
-
-const router = Router();
-
-router.get('/phases', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const [roadmapData, stateData] = await Promise.all([
-    getRoadmapData(projectDir),
-    parseStateFile(projectDir)
-  ]);
-
-  const templateData = {
-    title: 'Phases',
-    activePage: 'phases',
-    currentPath: '/phases',
-    phases: derivePhaseStatuses(roadmapData.phases, stateData.currentPhase),
-    milestones: roadmapData.milestones,
-    breadcrumbs: [{ label: 'Phases' }]
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/phases-content', templateData);
-  } else {
-    res.render('phases', templateData);
-  }
-});
-
-router.get('/phases/:phaseId', async (req, res) => {
-  const { phaseId } = req.params;
-
-  // Validate phaseId: two digits, optionally followed by decimal (e.g., 01, 05, 3.1)
-  if (!/^\d{1,2}(\.\d+)?$/.test(phaseId)) {
-    const err = new Error('Phase ID must be a number (e.g., 01, 05, 3.1)');
-    err.status = 404;
-    throw err;
-  }
-
-  const projectDir = req.app.locals.projectDir;
-  const phaseData = await getPhaseDetail(projectDir, phaseId);
-
-  const templateData = {
-    title: `Phase ${phaseId}: ${phaseData.phaseName}`,
-    activePage: 'phases',
-    currentPath: '/phases/' + phaseId,
-    breadcrumbs: [{ label: 'Phases', url: '/phases' }, { label: 'Phase ' + phaseId }],
-    ...phaseData
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/phase-content', templateData);
-  } else {
-    res.render('phase-detail', templateData);
-  }
-});
-
-router.get('/phases/:phaseId/:planId/:docType', async (req, res) => {
-  const { phaseId, planId, docType } = req.params;
-
-  // Validate phaseId
-  if (!/^\d{1,2}(\.\d+)?$/.test(phaseId)) {
-    const err = new Error('Phase ID must be a number (e.g., 01, 05, 3.1)');
-    err.status = 404;
-    throw err;
-  }
-
-  // Validate planId: NN-NN format
-  if (!/^\d{2}-\d{2}$/.test(planId)) {
-    const err = new Error('Plan ID must be in NN-NN format (e.g., 04-01)');
-    err.status = 404;
-    throw err;
-  }
-
-  // Validate docType
-  if (docType !== 'plan' && docType !== 'summary' && docType !== 'verification') {
-    const err = new Error('Document type must be "plan", "summary", or "verification"');
-    err.status = 404;
-    throw err;
-  }
-
-  const projectDir = req.app.locals.projectDir;
-  const doc = await getPhaseDocument(projectDir, phaseId, planId, docType);
-
-  if (!doc) {
-    const labels = { plan: 'Plan', summary: 'Summary', verification: 'Verification' };
-    const err = new Error(`${labels[docType] || docType} ${planId} not found for phase ${phaseId}`);
-    err.status = 404;
-    throw err;
-  }
-
-  const docLabel = docType === 'plan' ? 'Plan' : docType === 'verification' ? 'Verification' : 'Summary';
-  const templateData = {
-    title: `${docLabel} ${planId} — Phase ${phaseId}: ${doc.phaseName}`,
-    activePage: 'phases',
-    currentPath: `/phases/${phaseId}/${planId}/${docType}`,
-    breadcrumbs: [{ label: 'Phases', url: '/phases' }, { label: 'Phase ' + phaseId, url: '/phases/' + phaseId }, { label: docLabel + ' ' + planId }],
-    ...doc
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/phase-doc-content', templateData);
-  } else {
-    res.render('phase-doc', templateData);
-  }
-});
-
-router.get('/todos', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const { priority, status, q } = req.query;
-  const filters = {};
-  if (priority) filters.priority = priority;
-  if (status) filters.status = status;
-  if (q) filters.q = q;
-  const todos = await listPendingTodos(projectDir, filters);
-
-  const templateData = {
-    title: 'Todos',
-    activePage: 'todos',
-    currentPath: '/todos',
-    breadcrumbs: [{ label: 'Todos' }],
-    todos,
-    filters: { priority: priority || '', status: status || '', q: q || '' }
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/todos-content', templateData);
-  } else {
-    res.render('todos', templateData);
-  }
-});
-
-router.post('/todos/bulk-complete', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const { priority, status, q } = req.query;
-  const filters = {};
-  if (priority) filters.priority = priority;
-  if (status) filters.status = status;
-  if (q) filters.q = q;
-
-  const todos = await listPendingTodos(projectDir, filters);
-  for (const todo of todos) {
-    await completeTodo(projectDir, todo.id);
-  }
-
-  if (req.get('HX-Request') === 'true') {
-    const remaining = await listPendingTodos(projectDir);
-    res.render('partials/todos-content', {
-      title: 'Todos',
-      activePage: 'todos',
-      currentPath: '/todos',
-      breadcrumbs: [{ label: 'Todos' }],
-      todos: remaining,
-      filters: { priority: '', status: '', q: '' }
-    });
-  } else {
-    res.redirect('/todos');
-  }
-});
-
-router.get('/todos/new', (req, res) => {
-  const templateData = {
-    title: 'Create Todo',
-    activePage: 'todos',
-    currentPath: '/todos/new',
-    breadcrumbs: [{ label: 'Todos', url: '/todos' }, { label: 'Create' }]
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/todo-create-content', templateData);
-  } else {
-    res.render('todo-create', templateData);
-  }
-});
-
-router.get('/todos/:id', async (req, res) => {
-  const { id } = req.params;
-
-  // Validate ID format: must be exactly three digits
-  if (!/^\d{3}$/.test(id)) {
-    const err = new Error('Todo ID must be a three-digit number (e.g., 001, 005, 042)');
-    err.status = 404;
-    throw err;
-  }
-
-  const projectDir = req.app.locals.projectDir;
-  const todo = await getTodoDetail(projectDir, id);
-
-  const templateData = {
-    title: `Todo ${todo.id}: ${todo.title}`,
-    activePage: 'todos',
-    currentPath: '/todos/' + id,
-    breadcrumbs: [{ label: 'Todos', url: '/todos' }, { label: 'Todo ' + id }],
-    ...todo
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/todo-detail-content', templateData);
-  } else {
-    res.render('todo-detail', templateData);
-  }
-});
-
-router.post('/todos', async (req, res) => {
-  const { title, priority, phase, description } = req.body;
-  const projectDir = req.app.locals.projectDir;
-
-  const todoId = await createTodo(projectDir, {
-    title,
-    priority,
-    phase: phase || '',
-    description
-  });
-
-  if (req.get('HX-Request') === 'true') {
-    // For HTMX: fetch the new todo and render its detail as a fragment
-    const todo = await getTodoDetail(projectDir, todoId);
-    res.render('partials/todo-detail-content', {
-      title: `Todo ${todo.id}: ${todo.title}`,
-      activePage: 'todos',
-      currentPath: '/todos/' + todoId,
-      breadcrumbs: [{ label: 'Todos', url: '/todos' }, { label: 'Todo ' + todoId }],
-      ...todo
-    });
-  } else {
-    res.redirect(`/todos/${todoId}`);
-  }
-});
-
-router.post('/todos/:id/done', async (req, res) => {
-  const { id } = req.params;
-
-  if (!/^\d{3}$/.test(id)) {
-    const err = new Error('Todo ID must be a three-digit number');
-    err.status = 404;
-    throw err;
-  }
-
-  const projectDir = req.app.locals.projectDir;
-  await completeTodo(projectDir, id);
-
-  if (req.get('HX-Request') === 'true') {
-    // For HTMX: re-render the full todo list as a fragment
-    const todos = await listPendingTodos(projectDir);
-    res.render('partials/todos-content', {
-      title: 'Todos',
-      activePage: 'todos',
-      currentPath: '/todos',
-      breadcrumbs: [{ label: 'Todos' }],
-      todos
-    });
-  } else {
-    res.redirect('/todos');
-  }
-});
-
-router.get('/milestones', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const [milestoneData, roadmapData, stateData] = await Promise.all([
-    getAllMilestones(projectDir),
-    getRoadmapData(projectDir),
-    parseStateFile(projectDir)
-  ]);
-
-  const phases = derivePhaseStatuses(roadmapData.phases, stateData.currentPhase);
-
-  const templateData = {
-    title: 'Milestones',
-    activePage: 'milestones',
-    currentPath: '/milestones',
-    breadcrumbs: [{ label: 'Milestones' }],
-    phases,
-    ...milestoneData
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/milestones-content', templateData);
-  } else {
-    res.render('milestones', templateData);
-  }
-});
-
-router.get('/milestones/:version', async (req, res) => {
-  const { version } = req.params;
-
-  // Validate version: alphanumeric with dots and dashes
-  if (!/^[\w.-]+$/.test(version)) {
-    const err = new Error('Invalid milestone version format');
-    err.status = 404;
-    throw err;
-  }
-
-  const projectDir = req.app.locals.projectDir;
-  const detail = await getMilestoneDetail(projectDir, version);
-
-  if (detail.sections.length === 0) {
-    const err = new Error(`No archived files found for milestone v${version}`);
-    err.status = 404;
-    throw err;
-  }
-
-  const templateData = {
-    title: `Milestone v${version}`,
-    activePage: 'milestones',
-    currentPath: '/milestones/' + version,
-    breadcrumbs: [{ label: 'Milestones', url: '/milestones' }, { label: 'v' + version }],
-    ...detail
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/milestone-detail-content', templateData);
-  } else {
-    res.render('milestone-detail', templateData);
-  }
-});
-
-router.get('/dependencies', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const mermaidCode = await generateDependencyMermaid(projectDir);
-
-  const templateData = {
-    title: 'Dependencies',
-    activePage: 'dependencies',
-    currentPath: '/dependencies',
-    breadcrumbs: [{ label: 'Dependencies' }],
-    mermaidCode
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/dependencies-content', templateData);
-  } else {
-    res.render('dependencies', templateData);
-  }
-});
-
-router.get('/analytics', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const analytics = await getProjectAnalytics(projectDir);
-
-  const templateData = {
-    title: 'Analytics',
-    activePage: 'analytics',
-    currentPath: '/analytics',
-    breadcrumbs: [{ label: 'Analytics' }],
-    analytics
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/analytics-content', templateData);
-  } else {
-    res.render('analytics', templateData);
-  }
-});
-
-router.get('/notes', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const notes = await listNotes(projectDir);
-
-  const templateData = {
-    title: 'Notes',
-    activePage: 'notes',
-    currentPath: '/notes',
-    breadcrumbs: [{ label: 'Notes' }],
-    notes
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/notes-content', templateData);
-  } else {
-    res.render('notes', templateData);
-  }
-});
-
-router.get('/roadmap', async (req, res) => {
-  const projectDir = req.app.locals.projectDir;
-  const [roadmapData, stateData] = await Promise.all([
-    getRoadmapData(projectDir),
-    parseStateFile(projectDir)
-  ]);
-
-  const templateData = {
-    title: 'Roadmap',
-    activePage: 'roadmap',
-    currentPath: '/roadmap',
-    phases: derivePhaseStatuses(roadmapData.phases, stateData.currentPhase),
-    milestones: roadmapData.milestones,
-    breadcrumbs: [{ label: 'Roadmap' }]
-  };
-
-  res.setHeader('Vary', 'HX-Request');
-
-  if (req.get('HX-Request') === 'true') {
-    res.render('partials/roadmap-content', templateData);
-  } else {
-    res.render('roadmap', templateData);
-  }
-});
-
-export default router;

package/dashboard/src/server.js

@@ -1,42 +0,0 @@
-import { createApp } from './app.js';
-import { createWatcher } from './services/watcher.service.js';
-import { broadcast } from './services/sse.service.js';
-
-export function startServer(config) {
-  const app = createApp(config);
-  const { port, projectDir } = config;
-
-  // Start file watcher for live updates
-  const watcher = createWatcher(projectDir, (event) => {
-    broadcast('file-change', event);
-  });
-
-  const server = app.listen(port, '127.0.0.1', () => {
-    console.log(`PBR Dashboard running at http://127.0.0.1:${port}`);
-    console.log(`Project directory: ${projectDir}`);
-    console.log('File watcher active on .planning/**/*.md');
-  });
-
-  const shutdown = async (signal) => {
-    console.log(`${signal} received. Shutting down PBR Dashboard...`);
-
-    // Close watcher first (stops generating events)
-    try {
-      await watcher.close();
-      console.log('File watcher closed.');
-    } catch (err) {
-      console.error('Error closing watcher:', err.message);
-    }
-
-    // Then close the HTTP server
-    server.close(() => {
-      console.log('Server closed.');
-      process.exit(0);
-    });
-  };
-
-  process.on('SIGTERM', () => shutdown('SIGTERM'));
-  process.on('SIGINT', () => shutdown('SIGINT'));
-
-  return server;
-}

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

@@ -1,141 +0,0 @@
-import { execFile as execFileCb } from 'node:child_process';
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { TTLCache } from '../utils/cache.js';
-
-const execFile = promisify(execFileCb);
-
-export const cache = new TTLCache(60_000); // 60s TTL
-
-/**
- * Run a git command in the given directory, returning stdout.
- * Returns empty string on failure.
- */
-async function git(projectDir, args) {
-  try {
-    const { stdout } = await execFile('git', args, {
-      cwd: projectDir,
-      maxBuffer: 10 * 1024 * 1024
-    });
-    return stdout;
-  } catch {
-    return '';
-  }
-}
-
-/**
- * Compute project analytics from git history and .planning/ files.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<{phases: Array, summary: object, warning?: string}>}
- */
-export async function getProjectAnalytics(projectDir) {
-  const cacheKey = `analytics:${projectDir}`;
-  const cached = cache.get(cacheKey);
-  if (cached) return cached;
-
-  const phasesDir = join(projectDir, '.planning', 'phases');
-  let phaseDirs = [];
-  let warning = null;
-
-  try {
-    const entries = await readdir(phasesDir, { withFileTypes: true });
-    phaseDirs = entries
-      .filter(e => e.isDirectory() && /^\d{2}-/.test(e.name))
-      .sort((a, b) => a.name.localeCompare(b.name));
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      warning = 'No .planning/phases/ directory found';
-    } else {
-      warning = `Failed to read phases directory: ${err.message}`;
-    }
-  }
-
-  // Get all commit log lines once
-  const allLog = await git(projectDir, ['log', '--oneline', '--all']);
-  const allLogLines = allLog ? allLog.trim().split('\n').filter(Boolean) : [];
-
-  // Get numstat for lines changed
-  const numstatRaw = await git(projectDir, ['log', '--numstat', '--all', '--format=COMMIT:%s']);
-
-  const phases = [];
-
-  for (const dir of phaseDirs) {
-    const phaseNum = dir.name.split('-')[0];
-    const phaseName = dir.name.split('-').slice(1).map(
-      w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()
-    ).join(' ');
-
-    // Commit count: match scope pattern (NN-
-    const scopePattern = new RegExp(`\\(${phaseNum}-`);
-    const commitCount = allLogLines.filter(line => scopePattern.test(line)).length;
-
-    // Phase duration from git dates (match commits by scope pattern in message)
-    const dateOutput = await git(projectDir, [
-      'log', '--all', `--format=%aI`, `--grep=(${phaseNum}-`
-    ]);
-    const dates = dateOutput.trim().split('\n').filter(Boolean).map(d => new Date(d));
-    let duration = null;
-    if (dates.length >= 2) {
-      const earliest = new Date(Math.min(...dates));
-      const latest = new Date(Math.max(...dates));
-      const days = Math.round((latest - earliest) / (1000 * 60 * 60 * 24));
-      duration = `${days}d`;
-    }
-
-    // Plan count
-    let planCount = 0;
-    try {
-      const files = await readdir(join(phasesDir, dir.name));
-      planCount = files.filter(f => /^(?:\d{2}-\d{2}-)?PLAN.*\.md$/i.test(f)).length;
-    } catch {
-      // ignore
-    }
-
-    // Lines changed: parse numstat output for commits matching this phase scope
-    let linesChanged = 0;
-    if (numstatRaw) {
-      let currentCommitMatches = false;
-      for (const line of numstatRaw.split('\n')) {
-        if (line.startsWith('COMMIT:')) {
-          currentCommitMatches = scopePattern.test(line);
-        } else if (currentCommitMatches && line.trim()) {
-          const parts = line.split('\t');
-          if (parts.length >= 2) {
-            const added = parseInt(parts[0], 10) || 0;
-            const deleted = parseInt(parts[1], 10) || 0;
-            linesChanged += added + deleted;
-          }
-        }
-      }
-    }
-
-    phases.push({
-      phaseId: phaseNum,
-      phaseName,
-      commitCount,
-      duration,
-      planCount,
-      linesChanged
-    });
-  }
-
-  // Aggregate summary
-  const totalCommits = phases.reduce((s, p) => s + p.commitCount, 0);
-  const totalPhases = phases.length;
-  const durations = phases.filter(p => p.duration).map(p => parseInt(p.duration, 10));
-  const avgDuration = durations.length
-    ? `${Math.round(durations.reduce((s, d) => s + d, 0) / durations.length)}d`
-    : 'N/A';
-  const totalLinesChanged = phases.reduce((s, p) => s + p.linesChanged, 0);
-
-  const result = {
-    phases,
-    summary: { totalCommits, totalPhases, avgDuration, totalLinesChanged },
-    ...(warning ? { warning } : {})
-  };
-
-  cache.set(cacheKey, result);
-  return result;
-}