@sienklogic/plan-build-run 2.1.0 → 2.1.1

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

@@ -1,171 +0,0 @@
-import { readFile, readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { parseRoadmapFile } from './dashboard.service.js';
-
-/**
- * Strip UTF-8 BOM from file content.
- * Duplicated intentionally -- this service reads raw text, not via the repository layer.
- *
- * @param {string} content - Raw file content
- * @returns {string} Content without BOM
- */
-function stripBOM(content) {
-  return content.replace(/^\uFEFF/, '');
-}
-
-/**
- * Count the number of PLAN.md files in a phase directory.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @param {number} phaseId - Numeric phase ID (e.g., 1, 5, 12)
- * @returns {Promise<number>} Number of NN-NN-PLAN.md files found
- */
-async function countPlansForPhase(projectDir, phaseId) {
-  const phaseIdPadded = String(phaseId).padStart(2, '0');
-  const phasesDir = join(projectDir, '.planning', 'phases');
-
-  try {
-    const entries = await readdir(phasesDir, { withFileTypes: true });
-    // When multiple directories match (e.g. stale rename leftover), prefer the longest name
-    const matchingDirs = entries
-      .filter(e => e.isDirectory() && e.name.startsWith(`${phaseIdPadded}-`))
-      .sort((a, b) => b.name.length - a.name.length);
-    const phaseDir = matchingDirs[0];
-
-    if (!phaseDir) return 0;
-
-    const phaseFiles = await readdir(join(phasesDir, phaseDir.name));
-    return phaseFiles.filter(f => /^(?:\d{2}-\d{2}-)?PLAN\.md$/.test(f)).length;
-  } catch (err) {
-    if (err.code === 'ENOENT') return 0;
-    throw err;
-  }
-}
-
-/**
- * Extract dependency information from all Phase Details sections in ROADMAP.md.
- *
- * @param {string} roadmapContent - Raw ROADMAP.md content
- * @returns {Map<number, number[]>} Map of phaseId -> array of dependency phase IDs
- */
-function extractAllDependencies(roadmapContent) {
-  const dependencyMap = new Map();
-
-  // Match Phase Details sections: "### Phase NN: ..." followed by "**Depends on**: ..."
-  const sectionRegex = /### Phase (\d+):[\s\S]*?\*\*Depends on:?\*\*:?\s*([^\n]+)/g;
-  let match;
-
-  while ((match = sectionRegex.exec(roadmapContent)) !== null) {
-    const phaseId = parseInt(match[1], 10);
-    const depText = match[2].trim();
-
-    if (depText.toLowerCase().includes('none')) {
-      dependencyMap.set(phaseId, []);
-      continue;
-    }
-
-    // Extract phase numbers from "Phase 01, Phase 02" format
-    const deps = [];
-    const depMatches = depText.matchAll(/Phase (\d+)/g);
-    for (const dm of depMatches) {
-      deps.push(parseInt(dm[1], 10));
-    }
-    dependencyMap.set(phaseId, deps);
-  }
-
-  return dependencyMap;
-}
-
-/**
- * Extract milestone information from ROADMAP.md.
- * Parses explicit "## Milestone:" sections and infers the implicit first milestone
- * from the roadmap title (phases before the first explicit milestone).
- *
- * @param {string} roadmapContent - Raw ROADMAP.md content (newlines normalized)
- * @returns {Array<{name: string, goal: string, startPhase: number, endPhase: number}>}
- */
-function extractMilestones(roadmapContent) {
-  const milestones = [];
-
-  // Get project title from H1: "# Roadmap: PBR Dashboard"
-  const titleMatch = roadmapContent.match(/^# Roadmap:\s*(.+)$/m);
-  const projectTitle = titleMatch ? titleMatch[1].trim() : 'Project';
-
-  // Parse explicit milestones: "## Milestone: Name\n\n**Goal:** ...\n**Phases:** N - M"
-  const milestoneRegex = /## Milestone:\s*(.+)\n+\*\*Goal:?\*\*:?\s*(.+)\n\*\*Phases:?\*\*:?\s*(\d+)\s*-\s*(\d+)/g;
-  const explicit = [];
-  for (const match of roadmapContent.matchAll(milestoneRegex)) {
-    explicit.push({
-      name: match[1].trim(),
-      goal: match[2].trim(),
-      startPhase: parseInt(match[3], 10),
-      endPhase: parseInt(match[4], 10)
-    });
-  }
-
-  // Sort explicit milestones by start phase
-  explicit.sort((a, b) => a.startPhase - b.startPhase);
-
-  // Infer implicit first milestone (phases before first explicit milestone)
-  if (explicit.length > 0) {
-    const firstStart = explicit[0].startPhase;
-    if (firstStart > 1) {
-      milestones.push({
-        name: projectTitle,
-        goal: '',
-        startPhase: 1,
-        endPhase: firstStart - 1
-      });
-    }
-  } else {
-    // No explicit milestones — all phases belong to the project
-    milestones.push({
-      name: projectTitle,
-      goal: '',
-      startPhase: 1,
-      endPhase: 9999
-    });
-  }
-
-  milestones.push(...explicit);
-  return milestones;
-}
-
-/**
- * Get enhanced roadmap data with plan counts, dependencies, and milestones.
- * Combines parseRoadmapFile with raw ROADMAP.md reading for dependency
- * extraction, milestone parsing, and directory scanning for plan counts.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<{phases: Array, milestones: Array}>}
- */
-export async function getRoadmapData(projectDir) {
-  const { phases: basePhases } = await parseRoadmapFile(projectDir);
-
-  if (basePhases.length === 0) {
-    return { phases: [], milestones: [] };
-  }
-
-  // Read raw ROADMAP.md for dependencies and milestones
-  let dependencyMap = new Map();
-  let milestones = [];
-  try {
-    const roadmapPath = join(projectDir, '.planning', 'ROADMAP.md');
-    const rawContent = stripBOM(await readFile(roadmapPath, 'utf-8')).replace(/\r\n/g, '\n');
-    dependencyMap = extractAllDependencies(rawContent);
-    milestones = extractMilestones(rawContent);
-  } catch (err) {
-    if (err.code !== 'ENOENT') throw err;
-  }
-
-  // Enhance each phase with plan count and dependencies in parallel
-  const enhancedPhases = await Promise.all(
-    basePhases.map(async (phase) => {
-      const planCount = await countPlansForPhase(projectDir, phase.id);
-      const dependencies = dependencyMap.get(phase.id) || [];
-      return { ...phase, planCount, dependencies };
-    })
-  );
-
-  return { phases: enhancedPhases, milestones };
-}

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/todo.service.js

@@ -1,254 +0,0 @@
-import { readdir, readFile, writeFile, rename, mkdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import matter from 'gray-matter';
-import { readMarkdownFile } from '../repositories/planning.repository.js';
-
-const PRIORITY_ORDER = { P0: 0, P1: 1, P2: 2, PX: 3 };
-
-class WriteQueue {
-  constructor() {
-    this.tail = Promise.resolve();
-  }
-
-  enqueue(fn) {
-    const task = this.tail.then(fn, fn);
-    this.tail = task.catch(() => {});
-    return task;
-  }
-}
-
-const writeQueue = new WriteQueue();
-
-function titleToSlug(title) {
-  return title
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-|-$/g, '')
-    .slice(0, 50);
-}
-
-async function getNextTodoId(projectDir) {
-  const pendingDir = join(projectDir, '.planning', 'todos', 'pending');
-  const doneDir = join(projectDir, '.planning', 'todos', 'done');
-
-  let highestId = 0;
-
-  for (const dir of [pendingDir, doneDir]) {
-    try {
-      const files = await readdir(dir);
-      for (const filename of files) {
-        const match = filename.match(/^(\d{3})-/);
-        if (match) {
-          const id = parseInt(match[1], 10);
-          if (id > highestId) highestId = id;
-        }
-      }
-    } catch (err) {
-      if (err.code !== 'ENOENT') throw err;
-    }
-  }
-
-  return String(highestId + 1).padStart(3, '0');
-}
-
-/**
- * Sort todos by priority (P0 first) then alphabetically by title.
- * Unknown priorities sort after PX.
- * @param {Array} todos - Array of todo objects with priority and title fields
- * @returns {Array} Sorted array (mutates and returns the input)
- */
-function sortTodosByPriority(todos) {
-  return todos.sort((a, b) => {
-    const aPriority = PRIORITY_ORDER[a.priority] ?? 99;
-    const bPriority = PRIORITY_ORDER[b.priority] ?? 99;
-    const priorityDiff = aPriority - bPriority;
-    if (priorityDiff !== 0) return priorityDiff;
-    return a.title.localeCompare(b.title);
-  });
-}
-
-/**
- * List all pending todos from .planning/todos/pending/ directory.
- * Reads each markdown file, parses frontmatter, filters invalid entries,
- * and returns sorted by priority then title.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<Array<{id: string, title: string, priority: string, phase: string, status: string, created: string, filename: string}>>}
- */
-export async function listPendingTodos(projectDir) {
-  const pendingDir = join(projectDir, '.planning', 'todos', 'pending');
-
-  let entries;
-  try {
-    entries = await readdir(pendingDir, { withFileTypes: true });
-  } catch (err) {
-    if (err.code === 'ENOENT') return [];
-    throw err;
-  }
-
-  // Filter for .md files and extract ID from filename prefix
-  const mdFiles = entries
-    .filter(entry => entry.isFile() && entry.name.endsWith('.md'))
-    .map(entry => ({
-      filename: entry.name,
-      filePath: join(pendingDir, entry.name),
-      fileId: entry.name.match(/^(\d{3})-/)?.[1] || null
-    }))
-    .filter(f => f.fileId !== null);
-
-  // Read all todo files in parallel with partial failure tolerance
-  const results = await Promise.allSettled(
-    mdFiles.map(f => readMarkdownFile(f.filePath))
-  );
-
-  const todos = [];
-  for (let i = 0; i < results.length; i++) {
-    if (results[i].status !== 'fulfilled') continue;
-
-    const { frontmatter } = results[i].value;
-    const { filename, fileId } = mdFiles[i];
-
-    // Skip todos missing required frontmatter fields
-    const title = frontmatter.title;
-    const priority = frontmatter.priority;
-    if (!title || !priority) continue;
-
-    todos.push({
-      id: frontmatter.id || fileId,
-      title,
-      priority,
-      phase: frontmatter.phase || '',
-      status: frontmatter.status || 'pending',
-      created: frontmatter.created ? String(frontmatter.created) : '',
-      filename
-    });
-  }
-
-  return sortTodosByPriority(todos);
-}
-
-/**
- * Get a single todo by ID with full markdown content.
- * Searches .planning/todos/pending/ for a file whose name starts with the given ID.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @param {string} todoId - Three-digit todo ID (e.g., "001", "042")
- * @returns {Promise<{id: string, title: string, priority: string, phase: string, status: string, created: string, html: string, filename: string}>}
- * @throws {Error} With status 404 if no todo matches the given ID
- */
-export async function getTodoDetail(projectDir, todoId) {
-  const pendingDir = join(projectDir, '.planning', 'todos', 'pending');
-
-  let entries;
-  try {
-    entries = await readdir(pendingDir);
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      const notFound = new Error(`Todo ${todoId} not found`);
-      notFound.status = 404;
-      throw notFound;
-    }
-    throw err;
-  }
-
-  // Find the file whose name starts with the todoId prefix
-  const matchingFile = entries.find(name =>
-    name.startsWith(`${todoId}-`) && name.endsWith('.md')
-  );
-
-  if (!matchingFile) {
-    const notFound = new Error(`Todo ${todoId} not found`);
-    notFound.status = 404;
-    throw notFound;
-  }
-
-  const filePath = join(pendingDir, matchingFile);
-  const { frontmatter, html } = await readMarkdownFile(filePath);
-
-  return {
-    id: frontmatter.id || todoId,
-    title: frontmatter.title || 'Untitled',
-    priority: frontmatter.priority || 'PX',
-    phase: frontmatter.phase || '',
-    status: frontmatter.status || 'pending',
-    created: frontmatter.created ? String(frontmatter.created) : '',
-    html,
-    filename: matchingFile
-  };
-}
-
-export async function createTodo(projectDir, todoData) {
-  const { title, priority, description } = todoData;
-  const phase = todoData.phase || '';
-
-  if (!title || !priority || !description) {
-    const err = new Error('Missing required fields: title, priority, and description are required');
-    err.status = 400;
-    throw err;
-  }
-
-  return writeQueue.enqueue(async () => {
-    const todoId = await getNextTodoId(projectDir);
-    const slug = titleToSlug(title);
-    const filename = `${todoId}-${slug}.md`;
-    const pendingDir = join(projectDir, '.planning', 'todos', 'pending');
-
-    await mkdir(pendingDir, { recursive: true });
-
-    const frontmatter = {
-      id: todoId,
-      title,
-      priority,
-      phase,
-      status: 'pending',
-      created: new Date().toISOString().split('T')[0]
-    };
-
-    const fileContent = matter.stringify(description, frontmatter);
-    const filePath = join(pendingDir, filename);
-    await writeFile(filePath, fileContent, 'utf-8');
-
-    return todoId;
-  });
-}
-
-export async function completeTodo(projectDir, todoId) {
-  return writeQueue.enqueue(async () => {
-    const pendingDir = join(projectDir, '.planning', 'todos', 'pending');
-    const doneDir = join(projectDir, '.planning', 'todos', 'done');
-
-    let entries;
-    try {
-      entries = await readdir(pendingDir);
-    } catch (err) {
-      if (err.code === 'ENOENT') {
-        const notFound = new Error(`Todo ${todoId} not found`);
-        notFound.status = 404;
-        throw notFound;
-      }
-      throw err;
-    }
-
-    const matchingFile = entries.find(name =>
-      name.startsWith(`${todoId}-`) && name.endsWith('.md')
-    );
-
-    if (!matchingFile) {
-      const notFound = new Error(`Todo ${todoId} not found`);
-      notFound.status = 404;
-      throw notFound;
-    }
-
-    const pendingPath = join(pendingDir, matchingFile);
-    const raw = await readFile(pendingPath, 'utf-8');
-    const parsed = matter(raw, { engines: { javascript: false } });
-
-    parsed.data.status = 'done';
-    const updatedContent = matter.stringify(parsed.content, parsed.data);
-    await writeFile(pendingPath, updatedContent, 'utf-8');
-
-    await mkdir(doneDir, { recursive: true });
-    const donePath = join(doneDir, matchingFile);
-    await rename(pendingPath, donePath);
-  });
-}

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: 2000,
-      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;
-}

package/dashboard/src/views/coming-soon.ejs

@@ -1,11 +0,0 @@
-<%- include('partials/layout-top', { title: title, activePage: activePage }) %>
-
-<h1><%= featureName %></h1>
-<p>This feature is coming soon.</p>
-<p>
-  The <strong><%= featureName %></strong> view is planned but not yet implemented.
-  Check back in a future phase.
-</p>
-<p><a href="/">Back to Dashboard</a></p>
-
-<%- include('partials/layout-bottom') %>

package/dashboard/src/views/error.ejs

@@ -1,13 +0,0 @@
-<%- include('partials/layout-top', { title: typeof title !== 'undefined' ? title : 'Error', activePage: '' }) %>
-
-<h1>Error <%= status %></h1>
-<p><%= message %></p>
-<% if (typeof stack !== 'undefined' && stack) { %>
-<details>
-  <summary>Stack Trace (Development Only)</summary>
-  <pre><code><%= stack %></code></pre>
-</details>
-<% } %>
-<p><a href="/">Return to Dashboard</a></p>
-
-<%- include('partials/layout-bottom') %>

package/dashboard/src/views/index.ejs

@@ -1,5 +0,0 @@
-<%- include('partials/layout-top', { title: title, activePage: 'dashboard' }) %>
-
-<%- include('partials/dashboard-content') %>
-
-<%- include('partials/layout-bottom') %>

package/dashboard/src/views/layout.ejs

@@ -1 +0,0 @@
-<%# This file is deprecated. See partials/layout-top.ejs and partials/layout-bottom.ejs %>

package/dashboard/src/views/partials/dashboard-content.ejs

@@ -1,77 +0,0 @@
-<h1><%= projectName %></h1>
-
-<!-- Project Overview Card -->
-<article>
-  <header>
-    <strong>Current Phase</strong>
-  </header>
-  <% if (currentPhase.id > 0) { %>
-    <p>
-      <span class="status-badge" data-status="in-progress">Phase <%= currentPhase.id %></span>
-      <%= currentPhase.name %>
-    </p>
-    <p><small><%= currentPhase.planStatus %></small></p>
-  <% } else { %>
-    <p>No active phase. Project has not started yet.</p>
-  <% } %>
-
-  <% if (lastActivity.date) { %>
-    <p><small>Last activity: <%= lastActivity.date %> &mdash; <%= lastActivity.description %></small></p>
-  <% } %>
-</article>
-
-<!-- Overall Progress -->
-<article>
-  <header>
-    <strong>Overall Progress</strong>
-  </header>
-  <progress value="<%= progress %>" max="100"></progress>
-  <p><%= progress %>% complete (<%= phases.filter(p => p.status === 'complete').length %> of <%= phases.length %> phases)</p>
-</article>
-
-<!-- Phase List -->
-<article>
-  <header>
-    <strong>All Phases</strong>
-  </header>
-  <% if (phases.length > 0) { %>
-    <div class="table-wrap">
-    <table>
-      <thead>
-        <tr>
-          <th scope="col">Phase</th>
-          <th scope="col">Name</th>
-          <th scope="col">Description</th>
-          <th scope="col">Status</th>
-        </tr>
-      </thead>
-      <tbody>
-        <% phases.forEach(function(phase) { %>
-        <tr>
-          <td><%= String(phase.id).padStart(2, '0') %></td>
-          <td><a href="/phases/<%= String(phase.id).padStart(2, '0') %>"><%= phase.name %></a></td>
-          <td><%= phase.description %></td>
-          <td>
-            <span class="status-badge" data-status="<%= phase.status %>">
-              <%= phase.status.replace('-', ' ') %>
-            </span>
-          </td>
-        </tr>
-        <% }); %>
-      </tbody>
-    </table>
-    </div>
-  <% } else { %>
-    <p>No phases found. Add a ROADMAP.md file to your .planning/ directory to see phases here.</p>
-  <% } %>
-</article>
-
-<!-- README Content (if available) -->
-<% if (content && content !== '<p>No project README found.</p>') { %>
-<article>
-  <header>
-    <strong>Project Notes</strong>
-  </header>
-  <%- content %>
-</article>
-<% } %>

package/dashboard/src/views/partials/footer.ejs

@@ -1,3 +0,0 @@
-<footer>
-  <small>PBR Dashboard v0.1.0</small>
-</footer>

package/dashboard/src/views/partials/head.ejs

@@ -1,21 +0,0 @@
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title><%= typeof title !== 'undefined' ? title : 'Plan-Build-Run' %> - Plan-Build-Run</title>
-  <link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin>
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-400-normal.min.css">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-600-normal.min.css">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-700-normal.min.css">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/jetbrains-mono@latest/latin-400-normal.min.css">
-  <link rel="stylesheet" href="/css/layout.css">
-  <link rel="stylesheet" href="/css/status-colors.css">
-  <script
-    src="https://cdn.jsdelivr.net/npm/htmx.org@2.0.8/dist/htmx.min.js"
-    integrity="sha384-/TgkGk7p307TH7EXJDuUlgG3Ce1UVolAOFopFekQkkXihi5u/6OCvVKyz1W+idaz"
-    crossorigin="anonymous">
-  </script>
-  <script src="https://cdn.jsdelivr.net/npm/htmx-ext-sse@2.2.2/sse.js"></script>
-  <script src="/js/htmx-title.js"></script>
-  <script src="/js/sidebar-toggle.js"></script>
-</head>

package/dashboard/src/views/partials/header.ejs

@@ -1,12 +0,0 @@
-<header>
-  <nav>
-    <ul>
-      <li><strong>PBR Dashboard</strong></li>
-    </ul>
-    <ul>
-      <li>
-        <button class="sidebar-toggle" aria-label="Toggle navigation">&#9776;</button>
-      </li>
-    </ul>
-  </nav>
-</header>