@sienklogic/plan-build-run 2.21.0 → 2.21.2

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

@@ -1,309 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-
-/**
- * Strip UTF-8 BOM from file content.
- * Duplicated from planning.repository.js 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/, '');
-}
-
-/**
- * Parse STATE.md to extract project status information.
- * Uses regex on raw markdown body text (not YAML frontmatter).
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<{projectName: string, currentPhase: object, lastActivity: object, progress: number}>}
- */
-export async function parseStateFile(projectDir) {
-  try {
-    const path = join(projectDir, '.planning', 'STATE.md');
-    const raw = await readFile(path, 'utf-8');
-    const content = stripBOM(raw).replace(/\r\n/g, '\n');
-
-    // Parse YAML frontmatter if present (STATE.md v2 format)
-    let frontmatter = {};
-    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-    if (fmMatch) {
-      for (const line of fmMatch[1].split('\n')) {
-        const kv = line.match(/^(\w+):\s*(.+)/);
-        if (kv) {
-          const val = kv[2].trim().replace(/^"(.*)"$/, '$1');
-          frontmatter[kv[1]] = val;
-        }
-      }
-    }
-
-    // Extract project name from **Current focus:** line
-    let projectName = 'Unknown Project';
-    const focusMatch = content.match(/\*\*Current focus:\*\*\s*(.+)/);
-    if (focusMatch) {
-      projectName = focusMatch[1].trim();
-    } else {
-      // Fallback: try H1 heading
-      const h1Match = content.match(/^# (.+)/m);
-      if (h1Match) {
-        projectName = h1Match[1].trim();
-      }
-    }
-
-    // Extract current phase: "Phase: 3 of 12 (UI Shell)"
-    let currentPhaseId = 0;
-    let totalPhases = 0;
-    let phaseName = 'Not Started';
-    const phaseMatch = content.match(/Phase:\s*(\d+)\s*of\s*(\d+)\s*\(([^)]+)\)/);
-    if (phaseMatch) {
-      currentPhaseId = parseInt(phaseMatch[1], 10);
-      totalPhases = parseInt(phaseMatch[2], 10);
-      phaseName = phaseMatch[3].trim();
-    }
-
-    // Extract plan status: "Plan: 2 of 2 complete"
-    let planStatus = 'N/A';
-    const planMatch = content.match(/Plan:\s*(.+)/);
-    if (planMatch) {
-      planStatus = planMatch[1].trim();
-    }
-
-    // Extract last activity: "Last activity: 2026-02-08 -- Phase 3 built (...)"
-    let activityDate = '';
-    let activityDescription = 'No activity recorded';
-    const activityMatch = content.match(/Last activity:\s*([\d-]+)\s*--\s*(.+)/);
-    if (activityMatch) {
-      activityDate = activityMatch[1].trim();
-      activityDescription = activityMatch[2].trim();
-    }
-
-    // Extract progress percentage: "Progress: [...] 25%"
-    let progress = 0;
-    const progressMatch = content.match(/Progress:.*?(\d+)%/);
-    if (progressMatch) {
-      progress = parseInt(progressMatch[1], 10);
-    } else if (totalPhases > 0) {
-      // Calculate from phase numbers if no explicit progress
-      progress = Math.ceil((currentPhaseId / totalPhases) * 100);
-    }
-
-    // Determine phase status from frontmatter or body text
-    // "built", "verified", "complete" all mean the current phase is done
-    const fmStatus = (frontmatter.status || '').toLowerCase();
-    const phaseStatus = ['built', 'verified', 'complete', 'reviewed'].includes(fmStatus)
-      ? 'complete'
-      : ['building', 'planning', 'planned', 'in-progress'].includes(fmStatus)
-        ? 'in-progress'
-        : fmStatus || 'unknown';
-
-    return {
-      projectName,
-      currentPhase: {
-        id: currentPhaseId,
-        total: totalPhases,
-        name: phaseName,
-        planStatus,
-        status: phaseStatus
-      },
-      lastActivity: {
-        date: activityDate,
-        description: activityDescription
-      },
-      progress
-    };
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      return {
-        projectName: 'Unknown Project',
-        currentPhase: { id: 0, total: 0, name: 'Not Started', planStatus: 'N/A', status: 'unknown' },
-        lastActivity: { date: '', description: 'No activity recorded' },
-        progress: 0
-      };
-    }
-    throw error;
-  }
-}
-
-/**
- * Parse ROADMAP.md to extract phase list from Progress table and checkbox list.
- * Uses the Progress table as primary source (contains ALL phases including those
- * added under milestone headings). Falls back to checkbox parsing for older
- * roadmaps that don't have a Progress table.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<{phases: Array<{id: number, name: string, description: string, status: string}>, progress: number}>}
- */
-export async function parseRoadmapFile(projectDir) {
-  try {
-    const filePath = join(projectDir, '.planning', 'ROADMAP.md');
-    const raw = await readFile(filePath, 'utf-8');
-    const content = stripBOM(raw).replace(/\r\n/g, '\n');
-
-    // 1. Parse descriptions from checkbox list: "- [x] Phase 01: Name -- Description"
-    const checkboxMap = new Map();
-    const checkboxRegex = /^- \[([ xX])\] Phase (\d+):\s*([^-]+?)\s*--\s*(.+)$/gm;
-    for (const match of content.matchAll(checkboxRegex)) {
-      const id = parseInt(match[2], 10);
-      checkboxMap.set(id, {
-        name: match[3].trim(),
-        description: match[4].trim(),
-        status: (match[1] === 'x' || match[1] === 'X') ? 'complete' : 'not-started'
-      });
-    }
-
-    // 2. Parse descriptions from Phase Details: "### Phase NN: Name\n**Goal**: ..."
-    const goalMap = new Map();
-    const goalRegex = /### Phase (\d+):\s*(.+)\n\*\*Goal:?\*\*:?\s*(.+)/g;
-    for (const match of content.matchAll(goalRegex)) {
-      goalMap.set(parseInt(match[1], 10), match[3].trim());
-    }
-
-    // 3. Parse Progress table: "| 01. Name | 2/2 | Complete | 2026-02-08 |"
-    const progressRegex = /^\|\s*(\d+)\.\s+(.+?)\s*\|\s*(\d+)\/([\d?]+)\s*\|\s*(.+?)\s*\|\s*(.+?)\s*\|$/gm;
-    const progressPhases = [];
-    for (const match of content.matchAll(progressRegex)) {
-      const id = parseInt(match[1], 10);
-      const name = match[2].trim();
-      const statusText = match[5].trim().toLowerCase();
-
-      // Get description: prefer checkbox description, fall back to Phase Details Goal
-      const cbInfo = checkboxMap.get(id);
-      const goalDesc = goalMap.get(id);
-      const description = cbInfo?.description || goalDesc || '';
-
-      let status;
-      if (statusText === 'complete') status = 'complete';
-      else if (statusText === 'in progress') status = 'in-progress';
-      else status = 'not-started';
-
-      progressPhases.push({ id, name, description, status });
-    }
-
-    // 4. Parse H3 Phase Details: "### Phase N: Name\n**Goal:** ..."
-    const h3Phases = [];
-    const h3Regex = /### Phase (\d+):\s*(.+)\n\*\*Goal\*?\*?:?\*?\*?\s*(.+)/g;
-    for (const match of content.matchAll(h3Regex)) {
-      const id = parseInt(match[1], 10);
-      const name = match[2].trim();
-      const description = match[3].trim();
-      // Check checkbox map for status, default to not-started
-      const cbInfo = checkboxMap.get(id);
-      h3Phases.push({
-        id,
-        name,
-        description,
-        status: cbInfo?.status || 'not-started'
-      });
-    }
-
-    // 5. Parse simple two-column table: "| 1. Name | Completed |"
-    //    Used in milestone-archived roadmaps
-    const simpleTableRegex = /^\|\s*(\d+)\.\s+(.+?)\s*\|\s*(.+?)\s*\|$/gm;
-    const simplePhases = [];
-    for (const match of content.matchAll(simpleTableRegex)) {
-      const id = parseInt(match[1], 10);
-      const name = match[2].trim();
-      const statusText = match[3].trim().toLowerCase();
-
-      let status;
-      if (statusText === 'completed' || statusText === 'complete') status = 'complete';
-      else if (statusText === 'in progress' || statusText === 'in-progress') status = 'in-progress';
-      else status = 'not-started';
-
-      const cbInfo = checkboxMap.get(id);
-      const goalDesc = goalMap.get(id);
-      const description = cbInfo?.description || goalDesc || '';
-
-      simplePhases.push({ id, name, description, status });
-    }
-
-    // Use Progress table if available, then simple table, then checkbox list, then H3 headings
-    let phases;
-    if (progressPhases.length > 0) {
-      phases = progressPhases;
-    } else if (simplePhases.length > 0) {
-      phases = simplePhases;
-    } else if (checkboxMap.size > 0) {
-      phases = [...checkboxMap.entries()]
-        .map(([id, info]) => ({
-          id,
-          name: info.name,
-          description: info.description,
-          status: info.status
-        }))
-        .sort((a, b) => a.id - b.id);
-    } else {
-      phases = h3Phases.sort((a, b) => a.id - b.id);
-    }
-
-    const completed = phases.filter(p => p.status === 'complete').length;
-    const total = phases.length;
-    const progress = total > 0 ? Math.ceil((completed / total) * 100) : 0;
-
-    return { phases, progress };
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      return { phases: [], progress: 0 };
-    }
-    throw error;
-  }
-}
-
-/**
- * Get combined dashboard data by parsing both STATE.md and ROADMAP.md.
- * Orchestrates both parsers in parallel and derives in-progress status.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<{projectName: string, currentPhase: object, lastActivity: object, progress: number, phases: Array}>}
- */
-/**
- * Derive phase statuses by combining roadmap phases with STATE.md context.
- * Phases before the current phase are marked complete.
- * The current phase gets its status from STATE.md.
- * Phases after the current phase keep their roadmap status (typically not-started).
- *
- * @param {Array} phases - Raw phases from parseRoadmapFile
- * @param {{id: number, status: string}} currentPhase - Current phase from parseStateFile
- * @returns {Array} Phases with derived statuses
- */
-export function derivePhaseStatuses(phases, currentPhase) {
-  const currentId = currentPhase.id;
-  const currentStatus = currentPhase.status || 'unknown';
-  return phases.map(phase => {
-    // If the roadmap already has explicit status (from progress table/checkboxes), keep it
-    if (phase.status === 'complete') return phase;
-
-    if (phase.id < currentId) {
-      return { ...phase, status: 'complete' };
-    }
-    if (phase.id === currentId) {
-      return { ...phase, status: currentStatus === 'complete' ? 'complete' : 'in-progress' };
-    }
-    return phase;
-  });
-}
-
-export async function getDashboardData(projectDir) {
-  const [stateData, roadmapData] = await Promise.all([
-    parseStateFile(projectDir),
-    parseRoadmapFile(projectDir)
-  ]);
-
-  const phases = derivePhaseStatuses(roadmapData.phases, stateData.currentPhase);
-
-  // Recalculate progress from derived phase statuses
-  const completedPhases = phases.filter(p => p.status === 'complete').length;
-  const progress = phases.length > 0
-    ? Math.ceil((completedPhases / phases.length) * 100)
-    : stateData.progress;
-
-  return {
-    projectName: stateData.projectName,
-    currentPhase: stateData.currentPhase,
-    lastActivity: stateData.lastActivity,
-    progress,
-    phases
-  };
-}

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

@@ -1,222 +0,0 @@
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { readMarkdownFile } from '../repositories/planning.repository.js';
-import { getRoadmapData } from './roadmap.service.js';
-import { TTLCache } from '../utils/cache.js';
-
-export const cache = new TTLCache(300_000); // 300s TTL
-
-/**
- * Scan .planning/milestones/ for archived milestone files.
- * Supports two formats:
- * - Directory: v{version}/ containing ROADMAP.md, STATS.md, etc.
- * - Flat file: v{version}-{TYPE}.md (legacy)
- * Directory format takes precedence if both exist for the same version.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<Array<{version: string, name: string, date: string, duration: string, files: string[]}>>}
- */
-export async function listArchivedMilestones(projectDir) {
-  const cacheKey = `milestones:${projectDir}`;
-  const cached = cache.get(cacheKey);
-  if (cached) return cached;
-
-  const milestonesDir = join(projectDir, '.planning', 'milestones');
-
-  let entries;
-  try {
-    entries = await readdir(milestonesDir, { withFileTypes: true });
-  } catch (err) {
-    if (err.code === 'ENOENT') return [];
-    throw err;
-  }
-
-  const versionMap = new Map();
-
-  // Pass 1: Detect directory-format milestones (v1.0/, v2.0/, etc.)
-  const dirPattern = /^v([\w.-]+)$/;
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const match = entry.name.match(dirPattern);
-    if (!match) continue;
-
-    const version = match[1];
-    // Read files inside the version directory
-    let dirFiles;
-    try {
-      dirFiles = await readdir(join(milestonesDir, entry.name));
-    } catch (_e) {
-      continue;
-    }
-    const mdFiles = dirFiles.filter(f => f.endsWith('.md'));
-    if (mdFiles.length === 0) continue;
-
-    versionMap.set(version, { version, name: '', date: '', duration: '', files: mdFiles, format: 'directory' });
-  }
-
-  // Pass 2: Detect flat-file milestones (v1.0-ROADMAP.md, etc.) — skip versions already found as directories
-  const filePattern = /^v([\w.-]+)-(\w+)\.md$/;
-  for (const entry of entries) {
-    if (entry.isDirectory()) continue;
-    const match = entry.name.match(filePattern);
-    if (!match) continue;
-
-    const version = match[1];
-    // Skip if this version was already found as a directory
-    if (versionMap.has(version) && versionMap.get(version).format === 'directory') continue;
-
-    if (!versionMap.has(version)) {
-      versionMap.set(version, { version, name: '', date: '', duration: '', files: [], format: 'flat' });
-    }
-    versionMap.get(version).files.push(entry.name);
-  }
-
-  // Try to parse STATS.md for each version to get name/date/duration/stats
-  for (const [version, milestone] of versionMap) {
-    milestone.stats = { phaseCount: 0, commitCount: 0, deliverables: [] };
-    let statsPath;
-    if (milestone.format === 'directory') {
-      if (milestone.files.includes('STATS.md')) {
-        statsPath = join(milestonesDir, `v${version}`, 'STATS.md');
-      }
-    } else {
-      const statsFile = `v${version}-STATS.md`;
-      if (milestone.files.includes(statsFile)) {
-        statsPath = join(milestonesDir, statsFile);
-      }
-    }
-
-    if (statsPath) {
-      try {
-        const { frontmatter, html, rawContent } = await readMarkdownFile(statsPath);
-        milestone.name = frontmatter.milestone || frontmatter.name || `v${version}`;
-        milestone.date = frontmatter.completed || frontmatter.date || '';
-        milestone.duration = frontmatter.duration || '';
-        milestone.stats.phaseCount = frontmatter.phases_completed || frontmatter.phase_count || 0;
-        milestone.stats.commitCount = frontmatter.total_commits || frontmatter.commit_count || 0;
-        milestone.stats.statsHtml = html || '';
-
-        // Fallback: parse markdown content if frontmatter is empty
-        if (milestone.name === `v${version}` && rawContent) {
-          const nameMatch = rawContent.match(/\*\*Name:\*\*\s*(.+)/);
-          if (nameMatch) milestone.name = nameMatch[1].trim();
-          else {
-            const titleMatch = rawContent.match(/^#\s+.*?:\s*(.+?)(?:\s*\(v[\d.]+\))?$/m);
-            if (titleMatch) milestone.name = titleMatch[1].trim();
-          }
-        }
-        if (!milestone.date && rawContent) {
-          const dateMatch = rawContent.match(/\*\*Completed:\*\*\s*(.+)/);
-          if (dateMatch) milestone.date = dateMatch[1].trim();
-        }
-        if (!milestone.duration && rawContent) {
-          const durMatch = rawContent.match(/\*\*Duration:\*\*\s*(.+)/);
-          if (durMatch) milestone.duration = durMatch[1].trim();
-        }
-        if (!milestone.stats.commitCount && rawContent) {
-          const commitMatch = rawContent.match(/Total commits:\s*(\d+)/i) || rawContent.match(/\*\*Plans\*\*:\s*(\d+)/);
-          if (commitMatch) milestone.stats.commitCount = parseInt(commitMatch[1], 10);
-        }
-      } catch (_e) {
-        milestone.name = `v${version}`;
-      }
-    } else {
-      milestone.name = `v${version}`;
-    }
-
-    // Try to read deliverables from archived ROADMAP.md
-    if (milestone.format === 'directory' && milestone.files.includes('ROADMAP.md')) {
-      try {
-        const { frontmatter: rmFm } = await readMarkdownFile(join(milestonesDir, `v${version}`, 'ROADMAP.md'));
-        if (Array.isArray(rmFm.phases)) {
-          milestone.stats.deliverables = rmFm.phases.map(p => typeof p === 'string' ? p : (p.name || p.title || ''));
-        }
-      } catch (_e) { /* ignore */ }
-    }
-
-    // Try phases/ subdirectory for deliverables if none found yet
-    if (milestone.format === 'directory' && milestone.stats.deliverables.length === 0) {
-      try {
-        const phasesDir = join(milestonesDir, `v${version}`, 'phases');
-        const phaseDirs = await readdir(phasesDir, { withFileTypes: true });
-        milestone.stats.deliverables = phaseDirs
-          .filter(d => d.isDirectory())
-          .map(d => d.name)
-          .sort();
-        if (milestone.stats.phaseCount === 0) {
-          milestone.stats.phaseCount = milestone.stats.deliverables.length;
-        }
-      } catch (_e) { /* no phases dir */ }
-    }
-  }
-
-  // Sort by version descending (newest first) — strip internal format field
-  const result = [...versionMap.values()]
-    .sort((a, b) => b.version.localeCompare(a.version, undefined, { numeric: true }))
-    .map(({ format: _f, ...rest }) => rest);
-
-  cache.set(cacheKey, result);
-  return result;
-}
-
-/**
- * Combine active milestones from ROADMAP.md with archived milestones.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<{active: Array, archived: Array}>}
- */
-export async function getAllMilestones(projectDir) {
-  const allCacheKey = `all-milestones:${projectDir}`;
-  const allCached = cache.get(allCacheKey);
-  if (allCached) return allCached;
-
-  const [roadmapData, archived] = await Promise.all([
-    getRoadmapData(projectDir),
-    listArchivedMilestones(projectDir)
-  ]);
-
-  const allResult = {
-    active: roadmapData.milestones || [],
-    archived
-  };
-
-  cache.set(allCacheKey, allResult);
-  return allResult;
-}
-
-/**
- * Read all archived files for a specific milestone version.
- * Returns rendered HTML for each file type (ROADMAP, STATS, REQUIREMENTS).
- *
- * @param {string} projectDir - Absolute path to the project root
- * @param {string} version - Milestone version (e.g., "1.0")
- * @returns {Promise<{version: string, sections: Array<{type: string, frontmatter: object, html: string}>}>}
- */
-export async function getMilestoneDetail(projectDir, version) {
-  const milestonesDir = join(projectDir, '.planning', 'milestones');
-  const fileTypes = ['ROADMAP', 'STATS', 'REQUIREMENTS'];
-
-  const sections = [];
-  for (const type of fileTypes) {
-    // Try directory format first, then fall back to flat file
-    const dirPath = join(milestonesDir, `v${version}`, `${type}.md`);
-    const flatPath = join(milestonesDir, `v${version}-${type}.md`);
-
-    let result;
-    try {
-      result = await readMarkdownFile(dirPath);
-    } catch (err) {
-      if (err.code !== 'ENOENT') throw err;
-      try {
-        result = await readMarkdownFile(flatPath);
-      } catch (err2) {
-        if (err2.code !== 'ENOENT') throw err2;
-        // Neither format exists for this type — skip
-        continue;
-      }
-    }
-    sections.push({ type, frontmatter: result.frontmatter, html: result.html });
-  }
-
-  return { version, sections };
-}

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

@@ -1,50 +0,0 @@
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { readMarkdownFile } from '../repositories/planning.repository.js';
-
-/**
- * List all notes from .planning/notes/*.md, sorted by date descending.
- *
- * @param {string} projectDir - Absolute path to the project root
- * @returns {Promise<Array<{filename: string, title: string, date: string|null, promoted: boolean, html: string}>>}
- */
-export async function listNotes(projectDir) {
-  const notesDir = join(projectDir, '.planning', 'notes');
-
-  let entries;
-  try {
-    entries = await readdir(notesDir);
-  } catch (err) {
-    if (err.code === 'ENOENT') return [];
-    throw err;
-  }
-
-  const mdFiles = entries.filter(f => f.endsWith('.md')).sort().reverse();
-
-  const results = await Promise.allSettled(
-    mdFiles.map(f => readMarkdownFile(join(notesDir, f)))
-  );
-
-  const notes = [];
-  for (let i = 0; i < mdFiles.length; i++) {
-    const result = results[i];
-    if (result.status !== 'fulfilled') continue;
-
-    const { frontmatter, html } = result.value;
-    const filename = mdFiles[i];
-
-    // Derive title from filename: strip date prefix and extension, title-case
-    const slug = filename.replace(/^\d{4}-\d{2}-\d{2}-/, '').replace(/\.md$/, '');
-    const title = slug.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
-
-    notes.push({
-      filename,
-      title,
-      date: frontmatter.date || null,
-      promoted: !!frontmatter.promoted,
-      html
-    });
-  }
-
-  return notes;
-}