@sienklogic/plan-build-run 2.18.1 → 2.19.1

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

@@ -1,263 +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, filters = {}) {
-  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
-    });
-  }
-
-  sortTodosByPriority(todos);
-
-  // Apply filters
-  const { priority, status, q } = filters;
-  return todos.filter(todo => {
-    if (priority && todo.priority !== priority) return false;
-    if (status && todo.status !== status) return false;
-    if (q && !todo.title.toLowerCase().includes(q.toLowerCase())) return false;
-    return true;
-  });
-}
-
-/**
- * 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: 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;
-}

package/dashboard/src/utils/cache.js

@@ -1,55 +0,0 @@
-/**
- * Simple TTL (Time-To-Live) cache backed by a Map.
- *
- * Each entry stores { value, expiry } where expiry is a Unix-ms timestamp.
- */
-export class TTLCache {
-  /**
-   * @param {number} [defaultTTL=60000] - Default time-to-live in milliseconds
-   */
-  constructor(defaultTTL = 60_000) {
-    this._store = new Map();
-    this._defaultTTL = defaultTTL;
-  }
-
-  /**
-   * Retrieve a cached value. Returns undefined if missing or expired.
-   * @param {string} key
-   * @returns {*}
-   */
-  get(key) {
-    const entry = this._store.get(key);
-    if (!entry) return undefined;
-    if (Date.now() > entry.expiry) {
-      this._store.delete(key);
-      return undefined;
-    }
-    return entry.value;
-  }
-
-  /**
-   * Store a value with an optional per-key TTL.
-   * @param {string} key
-   * @param {*} value
-   * @param {number} [ttlMs] - Override default TTL for this entry
-   */
-  set(key, value, ttlMs) {
-    const ttl = ttlMs ?? this._defaultTTL;
-    this._store.set(key, { value, expiry: Date.now() + ttl });
-  }
-
-  /**
-   * Remove a single key from the cache.
-   * @param {string} key
-   */
-  invalidate(key) {
-    this._store.delete(key);
-  }
-
-  /**
-   * Clear the entire cache.
-   */
-  invalidateAll() {
-    this._store.clear();
-  }
-}

package/dashboard/src/views/analytics.ejs

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

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/dependencies.ejs

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

package/dashboard/src/views/error.ejs

@@ -1,20 +0,0 @@
-<%- include('partials/layout-top', { title: typeof title !== 'undefined' ? title : 'Error', activePage: '' }) %>
-
-<div class="error-card">
-  <div class="error-card__icon">&#x26A0;</div>
-  <h2>Error <%= status %></h2>
-  <div class="error-card__message">
-    <p><%= message %></p>
-  </div>
-  <% if (typeof stack !== 'undefined' && stack) { %>
-  <details>
-    <summary>Stack Trace (Development Only)</summary>
-    <pre><code><%= stack %></code></pre>
-  </details>
-  <% } %>
-  <div class="error-card__action">
-    <button onclick="history.back()" class="outline">Go back</button> | <a href="/">Return to Dashboard</a>
-  </div>
-</div>
-
-<%- 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/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/notes.ejs

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

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

@@ -1,90 +0,0 @@
-<%- include('breadcrumbs', { breadcrumbs: typeof breadcrumbs !== 'undefined' ? breadcrumbs : [] }) %>
-
-<h1>Project Analytics</h1>
-
-<% if (typeof analytics !== 'undefined' && analytics.warning) { %>
-<article aria-label="warning" class="pico-background-yellow-100">
-  <strong>Warning:</strong> <%= analytics.warning %>
-</article>
-<% } %>
-
-<% if (typeof analytics !== 'undefined' && analytics.summary) { %>
-<div class="grid">
-  <article>
-    <header>Total Commits</header>
-    <strong class="stat-value"><%= analytics.summary.totalCommits %></strong>
-    <span class="stat-unit">commits</span>
-  </article>
-  <article>
-    <header>Total Phases</header>
-    <strong class="stat-value"><%= analytics.summary.totalPhases %></strong>
-    <span class="stat-unit">phases</span>
-  </article>
-  <article>
-    <header>Avg Duration</header>
-    <strong class="stat-value"><%= analytics.summary.avgDuration %></strong>
-    <span class="stat-unit">days</span>
-  </article>
-  <article>
-    <header>Lines Changed</header>
-    <strong class="stat-value"><%= analytics.summary.totalLinesChanged.toLocaleString() %></strong>
-    <span class="stat-unit">lines</span>
-  </article>
-</div>
-<% } %>
-
-<% if (typeof analytics !== 'undefined' && analytics.phases && analytics.phases.length > 0) { %>
-<article>
-  <header>Per-Phase Metrics</header>
-  <div class="overflow-auto">
-    <table>
-      <thead>
-        <tr>
-          <th>Phase</th>
-          <th>Commits</th>
-          <th>Duration</th>
-          <th>Plans</th>
-          <th>Lines Changed</th>
-        </tr>
-      </thead>
-      <tbody>
-        <% analytics.phases.sort((a, b) => a.phaseId.localeCompare(b.phaseId)).forEach(phase => { %>
-        <tr>
-          <td>
-            <a href="/phases/<%= phase.phaseId %>"
-               hx-get="/phases/<%= phase.phaseId %>"
-               hx-target="#main-content"
-               hx-push-url="true">
-              <%= phase.phaseId %> - <%= phase.phaseName %>
-            </a>
-          </td>
-          <td><%= phase.commitCount %></td>
-          <td><%= phase.duration || 'N/A' %></td>
-          <td><%= phase.planCount %></td>
-          <td><%= phase.linesChanged.toLocaleString() %></td>
-        </tr>
-        <% }) %>
-      </tbody>
-    </table>
-  </div>
-</article>
-
-<% const maxCommits = Math.max(...analytics.phases.map(p => p.commitCount), 1); %>
-<article>
-  <header>Commits by Phase</header>
-  <div style="padding: var(--space-md) var(--space-lg);">
-    <% analytics.phases.sort((a, b) => a.phaseId.localeCompare(b.phaseId)).forEach(phase => { %>
-    <div class="bar-chart-row">
-      <span class="bar-chart-label"><%= phase.phaseId %> - <%= phase.phaseName %></span>
-      <div class="bar-chart-bar" style="width: <%= (phase.commitCount / maxCommits * 100) %>%">
-        <%= phase.commitCount %>
-      </div>
-    </div>
-    <% }) %>
-  </div>
-</article>
-<% } else if (typeof analytics === 'undefined' || !analytics.summary) { %>
-<%- include('empty-state', { icon: '📊', title: 'No analytics data available', action: '' }) %>
-<% } else { %>
-<p>No phase data available.</p>
-<% } %>

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

@@ -1,14 +0,0 @@
-<% if (typeof breadcrumbs !== 'undefined' && breadcrumbs.length > 0) { %>
-<nav aria-label="Breadcrumb">
-  <ol class="breadcrumbs">
-    <li><a href="/" hx-get="/" hx-target="#main-content" hx-push-url="true">&#8962;</a></li>
-    <% breadcrumbs.forEach(function(item, index) { %>
-      <% if (index < breadcrumbs.length - 1) { %>
-        <li><a href="<%= item.url %>" hx-get="<%= item.url %>" hx-target="#main-content" hx-push-url="true"><%= item.label %></a></li>
-      <% } else { %>
-        <li aria-current="page"><%= item.label %></li>
-      <% } %>
-    <% }); %>
-  </ol>
-</nav>
-<% } %>

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

@@ -1,84 +0,0 @@
-<%- include('breadcrumbs', { breadcrumbs: typeof breadcrumbs !== 'undefined' ? breadcrumbs : [] }) %>
-<h1><%= projectName %></h1>
-
-<!-- Hero Stat Row -->
-<div class="grid">
-  <!-- Current Phase -->
-  <article>
-    <header><strong>Current Phase</strong></header>
-    <% if (currentPhase.id > 0) { %>
-      <p class="stat-value">
-        <a href="/phases/<%= String(currentPhase.id).padStart(2, '0') %>"
-           hx-get="/phases/<%= String(currentPhase.id).padStart(2, '0') %>"
-           hx-target="#main-content"
-           hx-push-url="true">
-          <span class="status-badge" data-status="in-progress">Phase <%= currentPhase.id %></span>
-          <%= currentPhase.name %>
-        </a>
-      </p>
-    <% } else { %>
-      <p class="stat-value">No active phase</p>
-    <% } %>
-  </article>
-
-  <!-- Progress -->
-  <article>
-    <header><strong>Progress</strong></header>
-    <p class="stat-value"><%= progress %>%</p>
-    <progress value="<%= progress %>" max="100"></progress>
-  </article>
-
-  <!-- Pending Todos -->
-  <article>
-    <header><strong>Pending Todos</strong></header>
-    <p class="stat-value">
-      <a href="/todos"
-         hx-get="/todos"
-         hx-target="#main-content"
-         hx-push-url="true">
-        <%= typeof pendingTodoCount !== 'undefined' ? pendingTodoCount : 0 %>
-      </a>
-    </p>
-  </article>
-
-  <!-- Last Activity -->
-  <article>
-    <header><strong>Last Activity</strong></header>
-    <% if (lastActivity.date) { %>
-      <p class="stat-value"><%= lastActivity.date %></p>
-      <p><small><%= lastActivity.description %></small></p>
-    <% } else { %>
-      <p class="stat-value">None</p>
-    <% } %>
-  </article>
-</div>
-
-<!-- Quick Actions -->
-<div>
-  <% var phaseId = String(currentPhase.id).padStart(2, '0'); %>
-  <a role="button" class="outline"
-     href="/phases/<%= phaseId %>"
-     hx-get="/phases/<%= phaseId %>"
-     hx-target="#main-content"
-     hx-push-url="true">Current Phase</a>
-  <a role="button" class="outline"
-     href="/roadmap"
-     hx-get="/roadmap"
-     hx-target="#main-content"
-     hx-push-url="true">Roadmap</a>
-  <a role="button" class="outline"
-     href="/todos/new"
-     hx-get="/todos/new"
-     hx-target="#main-content"
-     hx-push-url="true">Create Todo</a>
-</div>
-
-<!-- Project Notes (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/dependencies-content.ejs

@@ -1,48 +0,0 @@
-<%- include('breadcrumbs', { breadcrumbs: typeof breadcrumbs !== 'undefined' ? breadcrumbs : [] }) %>
-
-<h1>Phase Dependencies</h1>
-
-<% if (typeof mermaidCode !== 'undefined' && mermaidCode && mermaidCode.trim()) { %>
-<article>
-  <pre class="mermaid"><%= mermaidCode %></pre>
-</article>
-<% } else { %>
-<%- include('empty-state', { icon: '🔗', title: 'No dependency data available', action: '' }) %>
-<% } %>
-
-<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
-<script>
-  (function() {
-    function detectDark() {
-      var explicit = document.documentElement.dataset.theme;
-      if (explicit) return explicit === 'dark';
-      return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
-    }
-    var mermaidTheme = detectDark() ? 'dark' : 'default';
-
-    // Store original source before mermaid processes it
-    document.querySelectorAll('.mermaid').forEach(function(el) {
-      el.dataset.source = el.textContent;
-    });
-
-    mermaid.initialize({ startOnLoad: true, theme: mermaidTheme, securityLevel: 'loose' });
-
-    // Watch for theme changes and re-render
-    var observer = new MutationObserver(function(mutations) {
-      mutations.forEach(function(mutation) {
-        if (mutation.attributeName === 'data-theme') {
-          var newTheme = detectDark() ? 'dark' : 'default';
-          mermaid.initialize({ startOnLoad: false, theme: newTheme, securityLevel: 'loose' });
-          document.querySelectorAll('.mermaid').forEach(function(el) {
-            if (el.dataset.source) {
-              el.removeAttribute('data-processed');
-              el.innerHTML = el.dataset.source;
-            }
-          });
-          mermaid.run();
-        }
-      });
-    });
-    observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });
-  })();
-</script>