@mobiman/vector 1.1.0

package/core/bin/lib/phase.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Phase — Phase CRUD, query, and lifecycle operations
+ */
+interface PhasesListOptions {
+    type?: string | null;
+    phase?: string | null;
+    includeArchived?: boolean;
+}
+export declare function cmdPhasesList(cwd: string, options: PhasesListOptions, raw: boolean): void;
+export declare function cmdPhaseNextDecimal(cwd: string, basePhase: string, raw: boolean): void;
+export declare function cmdFindPhase(cwd: string, phase: string | undefined, raw: boolean): void;
+export declare function cmdPhasePlanIndex(cwd: string, phase: string | undefined, raw: boolean): void;
+export declare function cmdPhaseAdd(cwd: string, description: string, raw: boolean): void;
+export declare function cmdPhaseInsert(cwd: string, afterPhase: string, description: string, raw: boolean): void;
+interface PhaseRemoveOptions {
+    force?: boolean;
+}
+export declare function cmdPhaseRemove(cwd: string, targetPhase: string | undefined, options: PhaseRemoveOptions, raw: boolean): void;
+export declare function cmdPhaseComplete(cwd: string, phaseNum: string | undefined, raw: boolean): void;
+export {};
+//# sourceMappingURL=phase.d.cts.map

package/core/bin/lib/phase.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.cts","sourceRoot":"","sources":["phase.cts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA0EzF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA+DtF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA0CvF;AAOD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAoH5F;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAuDhF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAgFvG;AAED,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA2P5H;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAiM9F"}

package/core/bin/lib/roadmap.cjs

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Roadmap — Roadmap parsing and update operations
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdRoadmapGetPhase = cmdRoadmapGetPhase;
+exports.cmdRoadmapAnalyze = cmdRoadmapAnalyze;
+exports.cmdRoadmapUpdatePlanProgress = cmdRoadmapUpdatePlanProgress;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const core_cjs_1 = require("./core.cjs");
+function cmdRoadmapGetPhase(cwd, phaseNum, raw) {
+    const roadmapPath = path_1.default.join(cwd, '.planning', 'ROADMAP.md');
+    if (!fs_1.default.existsSync(roadmapPath)) {
+        (0, core_cjs_1.output)({ found: false, error: 'ROADMAP.md not found' }, raw, '');
+        return;
+    }
+    try {
+        const content = (0, core_cjs_1.stripShippedMilestones)(fs_1.default.readFileSync(roadmapPath, 'utf-8'));
+        // Escape special regex chars in phase number, handle decimal
+        const escapedPhase = (0, core_cjs_1.escapeRegex)(phaseNum);
+        // Match "## Phase X:", "### Phase X:", or "#### Phase X:" with optional name
+        const phasePattern = new RegExp(`#{2,4}\\s*Phase\\s+${escapedPhase}:\\s*([^\\n]+)`, 'i');
+        const headerMatch = content.match(phasePattern);
+        if (!headerMatch) {
+            // Fallback: check if phase exists in summary list but missing detail section
+            const checklistPattern = new RegExp(`-\\s*\\[[ x]\\]\\s*\\*\\*Phase\\s+${escapedPhase}:\\s*([^*]+)\\*\\*`, 'i');
+            const checklistMatch = content.match(checklistPattern);
+            if (checklistMatch) {
+                // Phase exists in summary but missing detail section - malformed ROADMAP
+                (0, core_cjs_1.output)({
+                    found: false,
+                    phase_number: phaseNum,
+                    phase_name: checklistMatch[1].trim(),
+                    error: 'malformed_roadmap',
+                    message: `Phase ${phaseNum} exists in summary list but missing "### Phase ${phaseNum}:" detail section. ROADMAP.md needs both formats.`
+                }, raw, '');
+                return;
+            }
+            (0, core_cjs_1.output)({ found: false, phase_number: phaseNum }, raw, '');
+            return;
+        }
+        const phaseName = headerMatch[1].trim();
+        const headerIndex = headerMatch.index;
+        // Find the end of this section (next ## or ### phase header, or end of file)
+        const restOfContent = content.slice(headerIndex);
+        const nextHeaderMatch = restOfContent.match(/\n#{2,4}\s+Phase\s+\d/i);
+        const sectionEnd = nextHeaderMatch
+            ? headerIndex + nextHeaderMatch.index
+            : content.length;
+        const section = content.slice(headerIndex, sectionEnd).trim();
+        // Extract goal if present (supports both **Goal:** and **Goal**: formats)
+        const goalMatch = section.match(/\*\*Goal(?::\*\*|\*\*:)\s*([^\n]+)/i);
+        const goal = goalMatch ? goalMatch[1].trim() : null;
+        // Extract success criteria as structured array
+        const criteriaMatch = section.match(/\*\*Success Criteria\*\*[^\n]*:\s*\n((?:\s*\d+\.\s*[^\n]+\n?)+)/i);
+        const success_criteria = criteriaMatch
+            ? criteriaMatch[1].trim().split('\n').map(line => line.replace(/^\s*\d+\.\s*/, '').trim()).filter(Boolean)
+            : [];
+        (0, core_cjs_1.output)({
+            found: true,
+            phase_number: phaseNum,
+            phase_name: phaseName,
+            goal,
+            success_criteria,
+            section,
+        }, raw, section);
+    }
+    catch (e) {
+        (0, core_cjs_1.error)('Failed to read ROADMAP.md: ' + e.message);
+    }
+}
+function cmdRoadmapAnalyze(cwd, raw) {
+    const roadmapPath = path_1.default.join(cwd, '.planning', 'ROADMAP.md');
+    if (!fs_1.default.existsSync(roadmapPath)) {
+        (0, core_cjs_1.output)({ error: 'ROADMAP.md not found', milestones: [], phases: [], current_phase: null }, raw);
+        return;
+    }
+    const rawContent = fs_1.default.readFileSync(roadmapPath, 'utf-8');
+    const content = (0, core_cjs_1.stripShippedMilestones)(rawContent);
+    const phasesDir = path_1.default.join(cwd, '.planning', 'phases');
+    // Extract all phase headings: ## Phase N: Name or ### Phase N: Name
+    const phasePattern = /#{2,4}\s*Phase\s+(\d+[A-Z]?(?:\.\d+)*)\s*:\s*([^\n]+)/gi;
+    const phases = [];
+    let match;
+    while ((match = phasePattern.exec(content)) !== null) {
+        const phaseNum = match[1];
+        const phaseName = match[2].replace(/\(INSERTED\)/i, '').trim();
+        // Extract goal from the section
+        const sectionStart = match.index;
+        const restOfContent = content.slice(sectionStart);
+        const nextHeader = restOfContent.match(/\n#{2,4}\s+Phase\s+\d/i);
+        const sectionEnd = nextHeader ? sectionStart + nextHeader.index : content.length;
+        const section = content.slice(sectionStart, sectionEnd);
+        const goalMatch = section.match(/\*\*Goal(?::\*\*|\*\*:)\s*([^\n]+)/i);
+        const goal = goalMatch ? goalMatch[1].trim() : null;
+        const dependsMatch = section.match(/\*\*Depends on(?::\*\*|\*\*:)\s*([^\n]+)/i);
+        const depends_on = dependsMatch ? dependsMatch[1].trim() : null;
+        // Check completion on disk
+        const normalized = (0, core_cjs_1.normalizePhaseName)(phaseNum);
+        let diskStatus = 'no_directory';
+        let planCount = 0;
+        let summaryCount = 0;
+        let hasContext = false;
+        let hasResearch = false;
+        try {
+            const entries = fs_1.default.readdirSync(phasesDir, { withFileTypes: true });
+            const dirs = entries.filter(e => e.isDirectory()).map(e => e.name);
+            const dirMatch = dirs.find(d => d.startsWith(normalized + '-') || d === normalized);
+            if (dirMatch) {
+                const phaseFiles = fs_1.default.readdirSync(path_1.default.join(phasesDir, dirMatch));
+                planCount = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md').length;
+                summaryCount = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md').length;
+                hasContext = phaseFiles.some(f => f.endsWith('-CONTEXT.md') || f === 'CONTEXT.md');
+                hasResearch = phaseFiles.some(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
+                if (summaryCount >= planCount && planCount > 0)
+                    diskStatus = 'complete';
+                else if (summaryCount > 0)
+                    diskStatus = 'partial';
+                else if (planCount > 0)
+                    diskStatus = 'planned';
+                else if (hasResearch)
+                    diskStatus = 'researched';
+                else if (hasContext)
+                    diskStatus = 'discussed';
+                else
+                    diskStatus = 'empty';
+            }
+        }
+        catch { }
+        // Check ROADMAP checkbox status
+        const checkboxPattern = new RegExp(`-\\s*\\[(x| )\\]\\s*.*Phase\\s+${(0, core_cjs_1.escapeRegex)(phaseNum)}[:\\s]`, 'i');
+        const checkboxMatch = content.match(checkboxPattern);
+        const roadmapComplete = checkboxMatch ? checkboxMatch[1] === 'x' : false;
+        // If roadmap marks phase complete, trust that over disk file structure.
+        // Phases completed before Vector tracking (or via external tools) may lack
+        // the standard PLAN/SUMMARY pairs but are still done.
+        if (roadmapComplete && diskStatus !== 'complete') {
+            diskStatus = 'complete';
+        }
+        phases.push({
+            number: phaseNum,
+            name: phaseName,
+            goal,
+            depends_on,
+            plan_count: planCount,
+            summary_count: summaryCount,
+            has_context: hasContext,
+            has_research: hasResearch,
+            disk_status: diskStatus,
+            roadmap_complete: roadmapComplete,
+        });
+    }
+    // Extract milestone info
+    const milestones = [];
+    const milestonePattern = /##\s*(.*v(\d+\.\d+)[^(\n]*)/gi;
+    let mMatch;
+    while ((mMatch = milestonePattern.exec(content)) !== null) {
+        milestones.push({
+            heading: mMatch[1].trim(),
+            version: 'v' + mMatch[2],
+        });
+    }
+    // Find current and next phase
+    const currentPhase = phases.find(p => p.disk_status === 'planned' || p.disk_status === 'partial') || null;
+    const nextPhase = phases.find(p => p.disk_status === 'empty' || p.disk_status === 'no_directory' || p.disk_status === 'discussed' || p.disk_status === 'researched') || null;
+    // Aggregated stats
+    const totalPlans = phases.reduce((sum, p) => sum + p.plan_count, 0);
+    const totalSummaries = phases.reduce((sum, p) => sum + p.summary_count, 0);
+    const completedPhases = phases.filter(p => p.disk_status === 'complete').length;
+    // Detect phases in summary list without detail sections (malformed ROADMAP)
+    const checklistPattern = /-\s*\[[ x]\]\s*\*\*Phase\s+(\d+[A-Z]?(?:\.\d+)*)/gi;
+    const checklistPhases = new Set();
+    let checklistMatch;
+    while ((checklistMatch = checklistPattern.exec(content)) !== null) {
+        checklistPhases.add(checklistMatch[1]);
+    }
+    const detailPhases = new Set(phases.map(p => p.number));
+    const missingDetails = [...checklistPhases].filter(p => !detailPhases.has(p));
+    const result = {
+        milestones,
+        phases,
+        phase_count: phases.length,
+        completed_phases: completedPhases,
+        total_plans: totalPlans,
+        total_summaries: totalSummaries,
+        progress_percent: totalPlans > 0 ? Math.min(100, Math.round((totalSummaries / totalPlans) * 100)) : 0,
+        current_phase: currentPhase ? currentPhase.number : null,
+        next_phase: nextPhase ? nextPhase.number : null,
+        missing_phase_details: missingDetails.length > 0 ? missingDetails : null,
+    };
+    (0, core_cjs_1.output)(result, raw);
+}
+function cmdRoadmapUpdatePlanProgress(cwd, phaseNum, raw) {
+    if (!phaseNum) {
+        (0, core_cjs_1.error)('phase number required for roadmap update-plan-progress');
+    }
+    const roadmapPath = path_1.default.join(cwd, '.planning', 'ROADMAP.md');
+    const phaseInfo = (0, core_cjs_1.findPhaseInternal)(cwd, phaseNum);
+    if (!phaseInfo) {
+        (0, core_cjs_1.error)(`Phase ${phaseNum} not found`);
+    }
+    const planCount = phaseInfo.plans.length;
+    const summaryCount = phaseInfo.summaries.length;
+    if (planCount === 0) {
+        (0, core_cjs_1.output)({ updated: false, reason: 'No plans found', plan_count: 0, summary_count: 0 }, raw, 'no plans');
+        return;
+    }
+    const isComplete = summaryCount >= planCount;
+    const status = isComplete ? 'Complete' : summaryCount > 0 ? 'In Progress' : 'Planned';
+    const today = new Date().toISOString().split('T')[0];
+    if (!fs_1.default.existsSync(roadmapPath)) {
+        (0, core_cjs_1.output)({ updated: false, reason: 'ROADMAP.md not found', plan_count: planCount, summary_count: summaryCount }, raw, 'no roadmap');
+        return;
+    }
+    let roadmapContent = fs_1.default.readFileSync(roadmapPath, 'utf-8');
+    const phaseEscaped = (0, core_cjs_1.escapeRegex)(phaseNum);
+    // Progress table row: update Plans column (summaries/plans) and Status column
+    const tablePattern = new RegExp(`(\\|\\s*${phaseEscaped}\\.?\\s[^|]*\\|)[^|]*(\\|)\\s*[^|]*(\\|)\\s*[^|]*(\\|)`, 'i');
+    const dateField = isComplete ? ` ${today} ` : '  ';
+    roadmapContent = (0, core_cjs_1.replaceInCurrentMilestone)(roadmapContent, tablePattern, `$1 ${summaryCount}/${planCount} $2 ${status.padEnd(11)}$3${dateField}$4`);
+    // Update plan count in phase detail section
+    const planCountPattern = new RegExp(`(#{2,4}\\s*Phase\\s+${phaseEscaped}[\\s\\S]*?\\*\\*Plans:\\*\\*\\s*)[^\\n]+`, 'i');
+    const planCountText = isComplete
+        ? `${summaryCount}/${planCount} plans complete`
+        : `${summaryCount}/${planCount} plans executed`;
+    roadmapContent = (0, core_cjs_1.replaceInCurrentMilestone)(roadmapContent, planCountPattern, `$1${planCountText}`);
+    // If complete: check checkbox
+    if (isComplete) {
+        const checkboxPattern = new RegExp(`(-\\s*\\[)[ ](\\]\\s*.*Phase\\s+${phaseEscaped}[:\\s][^\\n]*)`, 'i');
+        roadmapContent = (0, core_cjs_1.replaceInCurrentMilestone)(roadmapContent, checkboxPattern, `$1x$2 (completed ${today})`);
+    }
+    fs_1.default.writeFileSync(roadmapPath, roadmapContent, 'utf-8');
+    (0, core_cjs_1.output)({
+        updated: true,
+        phase: phaseNum,
+        plan_count: planCount,
+        summary_count: summaryCount,
+        status,
+        complete: isComplete,
+    }, raw, `${summaryCount}/${planCount} ${status}`);
+}
+//# sourceMappingURL=roadmap.cjs.map

package/core/bin/lib/roadmap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.cjs","sourceRoot":"","sources":["roadmap.cts"],"names":[],"mappings":"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"}

package/core/bin/lib/roadmap.cts

@@ -0,0 +1,311 @@
+/**
+ * Roadmap — Roadmap parsing and update operations
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { escapeRegex, normalizePhaseName, output, error, findPhaseInternal, stripShippedMilestones, replaceInCurrentMilestone } from './core.cjs';
+
+export function cmdRoadmapGetPhase(cwd: string, phaseNum: string, raw: boolean): void {
+  const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+
+  if (!fs.existsSync(roadmapPath)) {
+    output({ found: false, error: 'ROADMAP.md not found' }, raw, '');
+    return;
+  }
+
+  try {
+    const content = stripShippedMilestones(fs.readFileSync(roadmapPath, 'utf-8'));
+
+    // Escape special regex chars in phase number, handle decimal
+    const escapedPhase = escapeRegex(phaseNum);
+
+    // Match "## Phase X:", "### Phase X:", or "#### Phase X:" with optional name
+    const phasePattern = new RegExp(
+      `#{2,4}\\s*Phase\\s+${escapedPhase}:\\s*([^\\n]+)`,
+      'i'
+    );
+    const headerMatch = content.match(phasePattern);
+
+    if (!headerMatch) {
+      // Fallback: check if phase exists in summary list but missing detail section
+      const checklistPattern = new RegExp(
+        `-\\s*\\[[ x]\\]\\s*\\*\\*Phase\\s+${escapedPhase}:\\s*([^*]+)\\*\\*`,
+        'i'
+      );
+      const checklistMatch = content.match(checklistPattern);
+
+      if (checklistMatch) {
+        // Phase exists in summary but missing detail section - malformed ROADMAP
+        output({
+          found: false,
+          phase_number: phaseNum,
+          phase_name: checklistMatch[1].trim(),
+          error: 'malformed_roadmap',
+          message: `Phase ${phaseNum} exists in summary list but missing "### Phase ${phaseNum}:" detail section. ROADMAP.md needs both formats.`
+        }, raw, '');
+        return;
+      }
+
+      output({ found: false, phase_number: phaseNum }, raw, '');
+      return;
+    }
+
+    const phaseName = headerMatch[1].trim();
+    const headerIndex = headerMatch.index!;
+
+    // Find the end of this section (next ## or ### phase header, or end of file)
+    const restOfContent = content.slice(headerIndex);
+    const nextHeaderMatch = restOfContent.match(/\n#{2,4}\s+Phase\s+\d/i);
+    const sectionEnd = nextHeaderMatch
+      ? headerIndex + nextHeaderMatch.index!
+      : content.length;
+
+    const section = content.slice(headerIndex, sectionEnd).trim();
+
+    // Extract goal if present (supports both **Goal:** and **Goal**: formats)
+    const goalMatch = section.match(/\*\*Goal(?::\*\*|\*\*:)\s*([^\n]+)/i);
+    const goal = goalMatch ? goalMatch[1].trim() : null;
+
+    // Extract success criteria as structured array
+    const criteriaMatch = section.match(/\*\*Success Criteria\*\*[^\n]*:\s*\n((?:\s*\d+\.\s*[^\n]+\n?)+)/i);
+    const success_criteria = criteriaMatch
+      ? criteriaMatch[1].trim().split('\n').map(line => line.replace(/^\s*\d+\.\s*/, '').trim()).filter(Boolean)
+      : [];
+
+    output(
+      {
+        found: true,
+        phase_number: phaseNum,
+        phase_name: phaseName,
+        goal,
+        success_criteria,
+        section,
+      },
+      raw,
+      section
+    );
+  } catch (e) {
+    error('Failed to read ROADMAP.md: ' + (e as Error).message);
+  }
+}
+
+export function cmdRoadmapAnalyze(cwd: string, raw: boolean): void {
+  const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+
+  if (!fs.existsSync(roadmapPath)) {
+    output({ error: 'ROADMAP.md not found', milestones: [], phases: [], current_phase: null }, raw);
+    return;
+  }
+
+  const rawContent = fs.readFileSync(roadmapPath, 'utf-8');
+  const content = stripShippedMilestones(rawContent);
+  const phasesDir = path.join(cwd, '.planning', 'phases');
+
+  // Extract all phase headings: ## Phase N: Name or ### Phase N: Name
+  const phasePattern = /#{2,4}\s*Phase\s+(\d+[A-Z]?(?:\.\d+)*)\s*:\s*([^\n]+)/gi;
+  const phases: Array<{
+    number: string;
+    name: string;
+    goal: string | null;
+    depends_on: string | null;
+    plan_count: number;
+    summary_count: number;
+    has_context: boolean;
+    has_research: boolean;
+    disk_status: string;
+    roadmap_complete: boolean;
+  }> = [];
+  let match: RegExpExecArray | null;
+
+  while ((match = phasePattern.exec(content)) !== null) {
+    const phaseNum = match[1];
+    const phaseName = match[2].replace(/\(INSERTED\)/i, '').trim();
+
+    // Extract goal from the section
+    const sectionStart = match.index;
+    const restOfContent = content.slice(sectionStart);
+    const nextHeader = restOfContent.match(/\n#{2,4}\s+Phase\s+\d/i);
+    const sectionEnd = nextHeader ? sectionStart + nextHeader.index! : content.length;
+    const section = content.slice(sectionStart, sectionEnd);
+
+    const goalMatch = section.match(/\*\*Goal(?::\*\*|\*\*:)\s*([^\n]+)/i);
+    const goal = goalMatch ? goalMatch[1].trim() : null;
+
+    const dependsMatch = section.match(/\*\*Depends on(?::\*\*|\*\*:)\s*([^\n]+)/i);
+    const depends_on = dependsMatch ? dependsMatch[1].trim() : null;
+
+    // Check completion on disk
+    const normalized = normalizePhaseName(phaseNum);
+    let diskStatus = 'no_directory';
+    let planCount = 0;
+    let summaryCount = 0;
+    let hasContext = false;
+    let hasResearch = false;
+
+    try {
+      const entries = fs.readdirSync(phasesDir, { withFileTypes: true });
+      const dirs = entries.filter(e => e.isDirectory()).map(e => e.name);
+      const dirMatch = dirs.find(d => d.startsWith(normalized + '-') || d === normalized);
+
+      if (dirMatch) {
+        const phaseFiles = fs.readdirSync(path.join(phasesDir, dirMatch));
+        planCount = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md').length;
+        summaryCount = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md').length;
+        hasContext = phaseFiles.some(f => f.endsWith('-CONTEXT.md') || f === 'CONTEXT.md');
+        hasResearch = phaseFiles.some(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
+
+        if (summaryCount >= planCount && planCount > 0) diskStatus = 'complete';
+        else if (summaryCount > 0) diskStatus = 'partial';
+        else if (planCount > 0) diskStatus = 'planned';
+        else if (hasResearch) diskStatus = 'researched';
+        else if (hasContext) diskStatus = 'discussed';
+        else diskStatus = 'empty';
+      }
+    } catch {}
+
+    // Check ROADMAP checkbox status
+    const checkboxPattern = new RegExp(`-\\s*\\[(x| )\\]\\s*.*Phase\\s+${escapeRegex(phaseNum)}[:\\s]`, 'i');
+    const checkboxMatch = content.match(checkboxPattern);
+    const roadmapComplete = checkboxMatch ? checkboxMatch[1] === 'x' : false;
+
+    // If roadmap marks phase complete, trust that over disk file structure.
+    // Phases completed before Vector tracking (or via external tools) may lack
+    // the standard PLAN/SUMMARY pairs but are still done.
+    if (roadmapComplete && diskStatus !== 'complete') {
+      diskStatus = 'complete';
+    }
+
+    phases.push({
+      number: phaseNum,
+      name: phaseName,
+      goal,
+      depends_on,
+      plan_count: planCount,
+      summary_count: summaryCount,
+      has_context: hasContext,
+      has_research: hasResearch,
+      disk_status: diskStatus,
+      roadmap_complete: roadmapComplete,
+    });
+  }
+
+  // Extract milestone info
+  const milestones: Array<{ heading: string; version: string }> = [];
+  const milestonePattern = /##\s*(.*v(\d+\.\d+)[^(\n]*)/gi;
+  let mMatch: RegExpExecArray | null;
+  while ((mMatch = milestonePattern.exec(content)) !== null) {
+    milestones.push({
+      heading: mMatch[1].trim(),
+      version: 'v' + mMatch[2],
+    });
+  }
+
+  // Find current and next phase
+  const currentPhase = phases.find(p => p.disk_status === 'planned' || p.disk_status === 'partial') || null;
+  const nextPhase = phases.find(p => p.disk_status === 'empty' || p.disk_status === 'no_directory' || p.disk_status === 'discussed' || p.disk_status === 'researched') || null;
+
+  // Aggregated stats
+  const totalPlans = phases.reduce((sum, p) => sum + p.plan_count, 0);
+  const totalSummaries = phases.reduce((sum, p) => sum + p.summary_count, 0);
+  const completedPhases = phases.filter(p => p.disk_status === 'complete').length;
+
+  // Detect phases in summary list without detail sections (malformed ROADMAP)
+  const checklistPattern = /-\s*\[[ x]\]\s*\*\*Phase\s+(\d+[A-Z]?(?:\.\d+)*)/gi;
+  const checklistPhases = new Set<string>();
+  let checklistMatch: RegExpExecArray | null;
+  while ((checklistMatch = checklistPattern.exec(content)) !== null) {
+    checklistPhases.add(checklistMatch[1]);
+  }
+  const detailPhases = new Set(phases.map(p => p.number));
+  const missingDetails = [...checklistPhases].filter(p => !detailPhases.has(p));
+
+  const result = {
+    milestones,
+    phases,
+    phase_count: phases.length,
+    completed_phases: completedPhases,
+    total_plans: totalPlans,
+    total_summaries: totalSummaries,
+    progress_percent: totalPlans > 0 ? Math.min(100, Math.round((totalSummaries / totalPlans) * 100)) : 0,
+    current_phase: currentPhase ? currentPhase.number : null,
+    next_phase: nextPhase ? nextPhase.number : null,
+    missing_phase_details: missingDetails.length > 0 ? missingDetails : null,
+  };
+
+  output(result, raw);
+}
+
+export function cmdRoadmapUpdatePlanProgress(cwd: string, phaseNum: string | undefined, raw: boolean): void {
+  if (!phaseNum) {
+    error('phase number required for roadmap update-plan-progress');
+  }
+
+  const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+
+  const phaseInfo = findPhaseInternal(cwd, phaseNum!);
+  if (!phaseInfo) {
+    error(`Phase ${phaseNum} not found`);
+  }
+
+  const planCount = phaseInfo!.plans.length;
+  const summaryCount = phaseInfo!.summaries.length;
+
+  if (planCount === 0) {
+    output({ updated: false, reason: 'No plans found', plan_count: 0, summary_count: 0 }, raw, 'no plans');
+    return;
+  }
+
+  const isComplete = summaryCount >= planCount;
+  const status = isComplete ? 'Complete' : summaryCount > 0 ? 'In Progress' : 'Planned';
+  const today = new Date().toISOString().split('T')[0];
+
+  if (!fs.existsSync(roadmapPath)) {
+    output({ updated: false, reason: 'ROADMAP.md not found', plan_count: planCount, summary_count: summaryCount }, raw, 'no roadmap');
+    return;
+  }
+
+  let roadmapContent = fs.readFileSync(roadmapPath, 'utf-8');
+  const phaseEscaped = escapeRegex(phaseNum!);
+
+  // Progress table row: update Plans column (summaries/plans) and Status column
+  const tablePattern = new RegExp(
+    `(\\|\\s*${phaseEscaped}\\.?\\s[^|]*\\|)[^|]*(\\|)\\s*[^|]*(\\|)\\s*[^|]*(\\|)`,
+    'i'
+  );
+  const dateField = isComplete ? ` ${today} ` : '  ';
+  roadmapContent = replaceInCurrentMilestone(
+    roadmapContent, tablePattern,
+    `$1 ${summaryCount}/${planCount} $2 ${status.padEnd(11)}$3${dateField}$4`
+  );
+
+  // Update plan count in phase detail section
+  const planCountPattern = new RegExp(
+    `(#{2,4}\\s*Phase\\s+${phaseEscaped}[\\s\\S]*?\\*\\*Plans:\\*\\*\\s*)[^\\n]+`,
+    'i'
+  );
+  const planCountText = isComplete
+    ? `${summaryCount}/${planCount} plans complete`
+    : `${summaryCount}/${planCount} plans executed`;
+  roadmapContent = replaceInCurrentMilestone(roadmapContent, planCountPattern, `$1${planCountText}`);
+
+  // If complete: check checkbox
+  if (isComplete) {
+    const checkboxPattern = new RegExp(
+      `(-\\s*\\[)[ ](\\]\\s*.*Phase\\s+${phaseEscaped}[:\\s][^\\n]*)`,
+      'i'
+    );
+    roadmapContent = replaceInCurrentMilestone(roadmapContent, checkboxPattern, `$1x$2 (completed ${today})`);
+  }
+
+  fs.writeFileSync(roadmapPath, roadmapContent, 'utf-8');
+
+  output({
+    updated: true,
+    phase: phaseNum,
+    plan_count: planCount,
+    summary_count: summaryCount,
+    status,
+    complete: isComplete,
+  }, raw, `${summaryCount}/${planCount} ${status}`);
+}

package/core/bin/lib/roadmap.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Roadmap — Roadmap parsing and update operations
+ */
+export declare function cmdRoadmapGetPhase(cwd: string, phaseNum: string, raw: boolean): void;
+export declare function cmdRoadmapAnalyze(cwd: string, raw: boolean): void;
+export declare function cmdRoadmapUpdatePlanProgress(cwd: string, phaseNum: string | undefined, raw: boolean): void;
+//# sourceMappingURL=roadmap.d.cts.map

package/core/bin/lib/roadmap.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.d.cts","sourceRoot":"","sources":["roadmap.cts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAkFpF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAgJjE;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAwE1G"}