@sienklogic/plan-build-run 2.11.0 → 2.12.1

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/milestone-detail.ejs

@@ -1,5 +0,0 @@
-<%- include('partials/layout-top', { title: 'Milestone v' + version, activePage: 'milestones' }) %>
-
-<%- include('partials/milestone-detail-content') %>
-
-<%- include('partials/layout-bottom') %>

package/dashboard/src/views/milestones.ejs

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

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,27 +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" media="print" onload="this.media='all'">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-600-normal.min.css" media="print" onload="this.media='all'">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-700-normal.min.css" media="print" onload="this.media='all'">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/fontsource/fonts/jetbrains-mono@latest/latin-400-normal.min.css" media="print" onload="this.media='all'">
-  <noscript>
-    <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">
-  </noscript>
-  <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>

package/dashboard/src/views/partials/layout-bottom.ejs

@@ -1,15 +0,0 @@
-    </main>
-    <%- include('footer') %>
-  </div>
-  <div hx-ext="sse"
-       sse-connect="/api/events/stream"
-       sse-close="close">
-    <div hx-trigger="sse:file-change"
-         hx-get="<%= typeof currentPath !== 'undefined' ? currentPath : '/' %>"
-         hx-target="#main-content"
-         hx-swap="innerHTML"
-         style="display:none;">
-    </div>
-  </div>
-</body>
-</html>

package/dashboard/src/views/partials/layout-top.ejs

@@ -1,8 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<%- include('head', { title: typeof title !== 'undefined' ? title : 'PBR Dashboard' }) %>
-<body>
-  <div class="page-wrapper">
-    <%- include('header') %>
-    <%- include('sidebar', { activePage: typeof activePage !== 'undefined' ? activePage : '' }) %>
-    <main id="main-content">

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

@@ -1,19 +0,0 @@
-<h1>Milestone v<%= version %></h1>
-
-<p>
-  <a href="/milestones"
-     hx-get="/milestones"
-     hx-target="#main-content"
-     hx-push-url="true">&larr; Back to Milestones</a>
-</p>
-
-<% sections.forEach(function(section) { %>
-<article>
-  <header>
-    <strong><%= section.type %></strong>
-  </header>
-  <div class="markdown-body">
-    <%- section.html %>
-  </div>
-</article>
-<% }); %>

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

@@ -1,44 +0,0 @@
-<h1>Milestones</h1>
-
-<% if (active.length > 0) { %>
-<h2>Active</h2>
-<% active.forEach(function(m) { %>
-<article>
-  <header>
-    <strong><%= m.name %></strong>
-    <% if (m.goal) { %><small> &mdash; <%= m.goal %></small><% } %>
-  </header>
-  <p>
-    Phases <%= m.startPhase %> &ndash; <%= m.endPhase %>
-  </p>
-</article>
-<% }); %>
-<% } %>
-
-<% if (archived.length > 0) { %>
-<h2>Archived</h2>
-<% archived.forEach(function(m) { %>
-<article>
-  <header>
-    <strong>
-      <a href="/milestones/<%= m.version %>"
-         hx-get="/milestones/<%= m.version %>"
-         hx-target="#main-content"
-         hx-push-url="true">
-        v<%= m.version %> &mdash; <%= m.name %>
-      </a>
-    </strong>
-  </header>
-  <p>
-    <% if (m.date) { %><small>Completed: <%= m.date %></small><% } %>
-    <% if (m.duration) { %><small> &bull; Duration: <%= m.duration %></small><% } %>
-    <br>
-    <small><%= m.files.length %> archived file<%= m.files.length !== 1 ? 's' : '' %></small>
-  </p>
-</article>
-<% }); %>
-<% } %>
-
-<% if (active.length === 0 && archived.length === 0) { %>
-<p>No milestones found. Use <code>/pbr:milestone new</code> to create one.</p>
-<% } %>