@mobiman/vector 1.1.0

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

@@ -0,0 +1,16 @@
+/**
+ * Init — Compound init commands for workflow bootstrapping
+ */
+export declare function cmdInitExecutePhase(cwd: string, phase: string | undefined, raw: boolean): void;
+export declare function cmdInitPlanPhase(cwd: string, phase: string | undefined, raw: boolean): void;
+export declare function cmdInitNewProject(cwd: string, raw: boolean): void;
+export declare function cmdInitNewMilestone(cwd: string, raw: boolean): void;
+export declare function cmdInitQuick(cwd: string, description: string | undefined, raw: boolean): void;
+export declare function cmdInitResume(cwd: string, raw: boolean): void;
+export declare function cmdInitVerifyWork(cwd: string, phase: string | undefined, raw: boolean): void;
+export declare function cmdInitPhaseOp(cwd: string, phase: string | undefined, raw: boolean): void;
+export declare function cmdInitTodos(cwd: string, area: string | undefined, raw: boolean): void;
+export declare function cmdInitMilestoneOp(cwd: string, raw: boolean): void;
+export declare function cmdInitMapCodebase(cwd: string, raw: boolean): void;
+export declare function cmdInitProgress(cwd: string, raw: boolean): void;
+//# sourceMappingURL=init.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.cts","sourceRoot":"","sources":["init.cts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAuE9F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6E3F;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAyDjE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA8BnE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA+C7F;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA8B7D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA2B5F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAsGzF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAyDtF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA2DlE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAgClE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAyJ/D"}

package/core/bin/lib/milestone.cjs

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Milestone — Milestone and requirements lifecycle operations
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdRequirementsMarkComplete = cmdRequirementsMarkComplete;
+exports.cmdMilestoneComplete = cmdMilestoneComplete;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const core_cjs_1 = require("./core.cjs");
+const frontmatter_cjs_1 = require("./frontmatter.cjs");
+const state_cjs_1 = require("./state.cjs");
+function cmdRequirementsMarkComplete(cwd, reqIdsRaw, raw) {
+    if (!reqIdsRaw || reqIdsRaw.length === 0) {
+        (0, core_cjs_1.error)('requirement IDs required. Usage: requirements mark-complete REQ-01,REQ-02 or REQ-01 REQ-02');
+    }
+    // Accept comma-separated, space-separated, or bracket-wrapped: [REQ-01, REQ-02]
+    const reqIds = reqIdsRaw
+        .join(' ')
+        .replace(/[\[\]]/g, '')
+        .split(/[,\s]+/)
+        .map(r => r.trim())
+        .filter(Boolean);
+    if (reqIds.length === 0) {
+        (0, core_cjs_1.error)('no valid requirement IDs found');
+    }
+    const reqPath = path_1.default.join(cwd, '.planning', 'REQUIREMENTS.md');
+    if (!fs_1.default.existsSync(reqPath)) {
+        (0, core_cjs_1.output)({ updated: false, reason: 'REQUIREMENTS.md not found', ids: reqIds }, raw, 'no requirements file');
+        return;
+    }
+    let reqContent = fs_1.default.readFileSync(reqPath, 'utf-8');
+    const updated = [];
+    const notFound = [];
+    for (const reqId of reqIds) {
+        let found = false;
+        const reqEscaped = (0, core_cjs_1.escapeRegex)(reqId);
+        // Update checkbox: - [ ] **REQ-ID** → - [x] **REQ-ID**
+        const checkboxPattern = new RegExp(`(-\\s*\\[)[ ](\\]\\s*\\*\\*${reqEscaped}\\*\\*)`, 'gi');
+        if (checkboxPattern.test(reqContent)) {
+            reqContent = reqContent.replace(new RegExp(`(-\\s*\\[)[ ](\\]\\s*\\*\\*${reqEscaped}\\*\\*)`, 'gi'), '$1x$2');
+            found = true;
+        }
+        // Update traceability table: | REQ-ID | Phase N | Pending | → | REQ-ID | Phase N | Complete |
+        const tablePattern = new RegExp(`(\\|\\s*${reqEscaped}\\s*\\|[^|]+\\|)\\s*Pending\\s*(\\|)`, 'gi');
+        if (tablePattern.test(reqContent)) {
+            // Re-read since test() advances lastIndex for global regex
+            reqContent = reqContent.replace(new RegExp(`(\\|\\s*${reqEscaped}\\s*\\|[^|]+\\|)\\s*Pending\\s*(\\|)`, 'gi'), '$1 Complete $2');
+            found = true;
+        }
+        if (found) {
+            updated.push(reqId);
+        }
+        else {
+            notFound.push(reqId);
+        }
+    }
+    if (updated.length > 0) {
+        fs_1.default.writeFileSync(reqPath, reqContent, 'utf-8');
+    }
+    (0, core_cjs_1.output)({
+        updated: updated.length > 0,
+        marked_complete: updated,
+        not_found: notFound,
+        total: reqIds.length,
+    }, raw, `${updated.length}/${reqIds.length} requirements marked complete`);
+}
+function cmdMilestoneComplete(cwd, version, options, raw) {
+    if (!version) {
+        (0, core_cjs_1.error)('version required for milestone complete (e.g., v1.0)');
+    }
+    const roadmapPath = path_1.default.join(cwd, '.planning', 'ROADMAP.md');
+    const reqPath = path_1.default.join(cwd, '.planning', 'REQUIREMENTS.md');
+    const statePath = path_1.default.join(cwd, '.planning', 'STATE.md');
+    const milestonesPath = path_1.default.join(cwd, '.planning', 'MILESTONES.md');
+    const archiveDir = path_1.default.join(cwd, '.planning', 'milestones');
+    const phasesDir = path_1.default.join(cwd, '.planning', 'phases');
+    const today = new Date().toISOString().split('T')[0];
+    const milestoneName = options.name || version;
+    // Ensure archive directory exists
+    fs_1.default.mkdirSync(archiveDir, { recursive: true });
+    // Scope stats and accomplishments to only the phases belonging to the
+    // current milestone's ROADMAP.  Uses the shared filter from core.cjs
+    // (same logic used by cmdPhasesList and other callers).
+    const isDirInMilestone = (0, core_cjs_1.getMilestonePhaseFilter)(cwd);
+    // Gather stats from phases (scoped to current milestone only)
+    let phaseCount = 0;
+    let totalPlans = 0;
+    let totalTasks = 0;
+    const accomplishments = [];
+    try {
+        const entries = fs_1.default.readdirSync(phasesDir, { withFileTypes: true });
+        const dirs = entries.filter(e => e.isDirectory()).map(e => e.name).sort();
+        for (const dir of dirs) {
+            if (!isDirInMilestone(dir))
+                continue;
+            phaseCount++;
+            const phaseFiles = fs_1.default.readdirSync(path_1.default.join(phasesDir, dir));
+            const plans = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md');
+            const summaries = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md');
+            totalPlans += plans.length;
+            // Extract one-liners from summaries
+            for (const s of summaries) {
+                try {
+                    const content = fs_1.default.readFileSync(path_1.default.join(phasesDir, dir, s), 'utf-8');
+                    const fm = (0, frontmatter_cjs_1.extractFrontmatter)(content);
+                    if (fm['one-liner']) {
+                        accomplishments.push(fm['one-liner']);
+                    }
+                    // Count tasks
+                    const taskMatches = content.match(/##\s*Task\s*\d+/gi) || [];
+                    totalTasks += taskMatches.length;
+                }
+                catch { }
+            }
+        }
+    }
+    catch { }
+    // Archive ROADMAP.md
+    if (fs_1.default.existsSync(roadmapPath)) {
+        const roadmapContent = fs_1.default.readFileSync(roadmapPath, 'utf-8');
+        fs_1.default.writeFileSync(path_1.default.join(archiveDir, `${version}-ROADMAP.md`), roadmapContent, 'utf-8');
+    }
+    // Archive REQUIREMENTS.md
+    if (fs_1.default.existsSync(reqPath)) {
+        const reqContent = fs_1.default.readFileSync(reqPath, 'utf-8');
+        const archiveHeader = `# Requirements Archive: ${version} ${milestoneName}\n\n**Archived:** ${today}\n**Status:** SHIPPED\n\nFor current requirements, see \`.planning/REQUIREMENTS.md\`.\n\n---\n\n`;
+        fs_1.default.writeFileSync(path_1.default.join(archiveDir, `${version}-REQUIREMENTS.md`), archiveHeader + reqContent, 'utf-8');
+    }
+    // Archive audit file if exists
+    const auditFile = path_1.default.join(cwd, '.planning', `${version}-MILESTONE-AUDIT.md`);
+    if (fs_1.default.existsSync(auditFile)) {
+        fs_1.default.renameSync(auditFile, path_1.default.join(archiveDir, `${version}-MILESTONE-AUDIT.md`));
+    }
+    // Create/append MILESTONES.md entry
+    const accomplishmentsList = accomplishments.map(a => `- ${a}`).join('\n');
+    const milestoneEntry = `## ${version} ${milestoneName} (Shipped: ${today})\n\n**Phases completed:** ${phaseCount} phases, ${totalPlans} plans, ${totalTasks} tasks\n\n**Key accomplishments:**\n${accomplishmentsList || '- (none recorded)'}\n\n---\n\n`;
+    if (fs_1.default.existsSync(milestonesPath)) {
+        const existing = fs_1.default.readFileSync(milestonesPath, 'utf-8');
+        if (!existing.trim()) {
+            // Empty file — treat like new
+            fs_1.default.writeFileSync(milestonesPath, `# Milestones\n\n${milestoneEntry}`, 'utf-8');
+        }
+        else {
+            // Insert after the header line(s) for reverse chronological order (newest first)
+            const headerMatch = existing.match(/^(#{1,3}\s+[^\n]*\n\n?)/);
+            if (headerMatch) {
+                const header = headerMatch[1];
+                const rest = existing.slice(header.length);
+                fs_1.default.writeFileSync(milestonesPath, header + milestoneEntry + rest, 'utf-8');
+            }
+            else {
+                // No recognizable header — prepend the entry
+                fs_1.default.writeFileSync(milestonesPath, milestoneEntry + existing, 'utf-8');
+            }
+        }
+    }
+    else {
+        fs_1.default.writeFileSync(milestonesPath, `# Milestones\n\n${milestoneEntry}`, 'utf-8');
+    }
+    // Update STATE.md
+    if (fs_1.default.existsSync(statePath)) {
+        let stateContent = fs_1.default.readFileSync(statePath, 'utf-8');
+        stateContent = stateContent.replace(/(\*\*Status:\*\*\s*).*/, `$1${version} milestone complete`);
+        stateContent = stateContent.replace(/(\*\*Last Activity:\*\*\s*).*/, `$1${today}`);
+        stateContent = stateContent.replace(/(\*\*Last Activity Description:\*\*\s*).*/, `$1${version} milestone completed and archived`);
+        (0, state_cjs_1.writeStateMd)(statePath, stateContent, cwd);
+    }
+    // Archive phase directories if requested
+    let phasesArchived = false;
+    if (options.archivePhases) {
+        try {
+            const phaseArchiveDir = path_1.default.join(archiveDir, `${version}-phases`);
+            fs_1.default.mkdirSync(phaseArchiveDir, { recursive: true });
+            const phaseEntries = fs_1.default.readdirSync(phasesDir, { withFileTypes: true });
+            const phaseDirNames = phaseEntries.filter(e => e.isDirectory()).map(e => e.name);
+            let archivedCount = 0;
+            for (const dir of phaseDirNames) {
+                if (!isDirInMilestone(dir))
+                    continue;
+                fs_1.default.renameSync(path_1.default.join(phasesDir, dir), path_1.default.join(phaseArchiveDir, dir));
+                archivedCount++;
+            }
+            phasesArchived = archivedCount > 0;
+        }
+        catch { }
+    }
+    const result = {
+        version,
+        name: milestoneName,
+        date: today,
+        phases: phaseCount,
+        plans: totalPlans,
+        tasks: totalTasks,
+        accomplishments,
+        archived: {
+            roadmap: fs_1.default.existsSync(path_1.default.join(archiveDir, `${version}-ROADMAP.md`)),
+            requirements: fs_1.default.existsSync(path_1.default.join(archiveDir, `${version}-REQUIREMENTS.md`)),
+            audit: fs_1.default.existsSync(path_1.default.join(archiveDir, `${version}-MILESTONE-AUDIT.md`)),
+            phases: phasesArchived,
+        },
+        milestones_updated: true,
+        state_updated: fs_1.default.existsSync(statePath),
+    };
+    (0, core_cjs_1.output)(result, raw);
+}
+//# sourceMappingURL=milestone.cjs.map

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

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

package/core/bin/lib/milestone.cts

@@ -0,0 +1,241 @@
+/**
+ * Milestone — Milestone and requirements lifecycle operations
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { escapeRegex, getMilestonePhaseFilter, output, error } from './core.cjs';
+import { extractFrontmatter } from './frontmatter.cjs';
+import { writeStateMd } from './state.cjs';
+
+export function cmdRequirementsMarkComplete(cwd: string, reqIdsRaw: string[], raw: boolean): void {
+  if (!reqIdsRaw || reqIdsRaw.length === 0) {
+    error('requirement IDs required. Usage: requirements mark-complete REQ-01,REQ-02 or REQ-01 REQ-02');
+  }
+
+  // Accept comma-separated, space-separated, or bracket-wrapped: [REQ-01, REQ-02]
+  const reqIds = reqIdsRaw
+    .join(' ')
+    .replace(/[\[\]]/g, '')
+    .split(/[,\s]+/)
+    .map(r => r.trim())
+    .filter(Boolean);
+
+  if (reqIds.length === 0) {
+    error('no valid requirement IDs found');
+  }
+
+  const reqPath = path.join(cwd, '.planning', 'REQUIREMENTS.md');
+  if (!fs.existsSync(reqPath)) {
+    output({ updated: false, reason: 'REQUIREMENTS.md not found', ids: reqIds }, raw, 'no requirements file');
+    return;
+  }
+
+  let reqContent = fs.readFileSync(reqPath, 'utf-8');
+  const updated: string[] = [];
+  const notFound: string[] = [];
+
+  for (const reqId of reqIds) {
+    let found = false;
+    const reqEscaped = escapeRegex(reqId);
+
+    // Update checkbox: - [ ] **REQ-ID** → - [x] **REQ-ID**
+    const checkboxPattern = new RegExp(`(-\\s*\\[)[ ](\\]\\s*\\*\\*${reqEscaped}\\*\\*)`, 'gi');
+    if (checkboxPattern.test(reqContent)) {
+      reqContent = reqContent.replace(new RegExp(`(-\\s*\\[)[ ](\\]\\s*\\*\\*${reqEscaped}\\*\\*)`, 'gi'), '$1x$2');
+      found = true;
+    }
+
+    // Update traceability table: | REQ-ID | Phase N | Pending | → | REQ-ID | Phase N | Complete |
+    const tablePattern = new RegExp(`(\\|\\s*${reqEscaped}\\s*\\|[^|]+\\|)\\s*Pending\\s*(\\|)`, 'gi');
+    if (tablePattern.test(reqContent)) {
+      // Re-read since test() advances lastIndex for global regex
+      reqContent = reqContent.replace(
+        new RegExp(`(\\|\\s*${reqEscaped}\\s*\\|[^|]+\\|)\\s*Pending\\s*(\\|)`, 'gi'),
+        '$1 Complete $2'
+      );
+      found = true;
+    }
+
+    if (found) {
+      updated.push(reqId);
+    } else {
+      notFound.push(reqId);
+    }
+  }
+
+  if (updated.length > 0) {
+    fs.writeFileSync(reqPath, reqContent, 'utf-8');
+  }
+
+  output({
+    updated: updated.length > 0,
+    marked_complete: updated,
+    not_found: notFound,
+    total: reqIds.length,
+  }, raw, `${updated.length}/${reqIds.length} requirements marked complete`);
+}
+
+interface MilestoneCompleteOptions {
+  name?: string;
+  archivePhases?: boolean;
+}
+
+export function cmdMilestoneComplete(cwd: string, version: string | undefined, options: MilestoneCompleteOptions, raw: boolean): void {
+  if (!version) {
+    error('version required for milestone complete (e.g., v1.0)');
+  }
+
+  const roadmapPath = path.join(cwd, '.planning', 'ROADMAP.md');
+  const reqPath = path.join(cwd, '.planning', 'REQUIREMENTS.md');
+  const statePath = path.join(cwd, '.planning', 'STATE.md');
+  const milestonesPath = path.join(cwd, '.planning', 'MILESTONES.md');
+  const archiveDir = path.join(cwd, '.planning', 'milestones');
+  const phasesDir = path.join(cwd, '.planning', 'phases');
+  const today = new Date().toISOString().split('T')[0];
+  const milestoneName = options.name || version!;
+
+  // Ensure archive directory exists
+  fs.mkdirSync(archiveDir, { recursive: true });
+
+  // Scope stats and accomplishments to only the phases belonging to the
+  // current milestone's ROADMAP.  Uses the shared filter from core.cjs
+  // (same logic used by cmdPhasesList and other callers).
+  const isDirInMilestone = getMilestonePhaseFilter(cwd);
+
+  // Gather stats from phases (scoped to current milestone only)
+  let phaseCount = 0;
+  let totalPlans = 0;
+  let totalTasks = 0;
+  const accomplishments: string[] = [];
+
+  try {
+    const entries = fs.readdirSync(phasesDir, { withFileTypes: true });
+    const dirs = entries.filter(e => e.isDirectory()).map(e => e.name).sort();
+
+    for (const dir of dirs) {
+      if (!isDirInMilestone(dir)) continue;
+
+      phaseCount++;
+      const phaseFiles = fs.readdirSync(path.join(phasesDir, dir));
+      const plans = phaseFiles.filter(f => f.endsWith('-PLAN.md') || f === 'PLAN.md');
+      const summaries = phaseFiles.filter(f => f.endsWith('-SUMMARY.md') || f === 'SUMMARY.md');
+      totalPlans += plans.length;
+
+      // Extract one-liners from summaries
+      for (const s of summaries) {
+        try {
+          const content = fs.readFileSync(path.join(phasesDir, dir, s), 'utf-8');
+          const fm = extractFrontmatter(content) as Record<string, unknown>;
+          if (fm['one-liner']) {
+            accomplishments.push(fm['one-liner'] as string);
+          }
+          // Count tasks
+          const taskMatches = content.match(/##\s*Task\s*\d+/gi) || [];
+          totalTasks += taskMatches.length;
+        } catch {}
+      }
+    }
+  } catch {}
+
+  // Archive ROADMAP.md
+  if (fs.existsSync(roadmapPath)) {
+    const roadmapContent = fs.readFileSync(roadmapPath, 'utf-8');
+    fs.writeFileSync(path.join(archiveDir, `${version}-ROADMAP.md`), roadmapContent, 'utf-8');
+  }
+
+  // Archive REQUIREMENTS.md
+  if (fs.existsSync(reqPath)) {
+    const reqContent = fs.readFileSync(reqPath, 'utf-8');
+    const archiveHeader = `# Requirements Archive: ${version} ${milestoneName}\n\n**Archived:** ${today}\n**Status:** SHIPPED\n\nFor current requirements, see \`.planning/REQUIREMENTS.md\`.\n\n---\n\n`;
+    fs.writeFileSync(path.join(archiveDir, `${version}-REQUIREMENTS.md`), archiveHeader + reqContent, 'utf-8');
+  }
+
+  // Archive audit file if exists
+  const auditFile = path.join(cwd, '.planning', `${version}-MILESTONE-AUDIT.md`);
+  if (fs.existsSync(auditFile)) {
+    fs.renameSync(auditFile, path.join(archiveDir, `${version}-MILESTONE-AUDIT.md`));
+  }
+
+  // Create/append MILESTONES.md entry
+  const accomplishmentsList = accomplishments.map(a => `- ${a}`).join('\n');
+  const milestoneEntry = `## ${version} ${milestoneName} (Shipped: ${today})\n\n**Phases completed:** ${phaseCount} phases, ${totalPlans} plans, ${totalTasks} tasks\n\n**Key accomplishments:**\n${accomplishmentsList || '- (none recorded)'}\n\n---\n\n`;
+
+  if (fs.existsSync(milestonesPath)) {
+    const existing = fs.readFileSync(milestonesPath, 'utf-8');
+    if (!existing.trim()) {
+      // Empty file — treat like new
+      fs.writeFileSync(milestonesPath, `# Milestones\n\n${milestoneEntry}`, 'utf-8');
+    } else {
+      // Insert after the header line(s) for reverse chronological order (newest first)
+      const headerMatch = existing.match(/^(#{1,3}\s+[^\n]*\n\n?)/);
+      if (headerMatch) {
+        const header = headerMatch[1];
+        const rest = existing.slice(header.length);
+        fs.writeFileSync(milestonesPath, header + milestoneEntry + rest, 'utf-8');
+      } else {
+        // No recognizable header — prepend the entry
+        fs.writeFileSync(milestonesPath, milestoneEntry + existing, 'utf-8');
+      }
+    }
+  } else {
+    fs.writeFileSync(milestonesPath, `# Milestones\n\n${milestoneEntry}`, 'utf-8');
+  }
+
+  // Update STATE.md
+  if (fs.existsSync(statePath)) {
+    let stateContent = fs.readFileSync(statePath, 'utf-8');
+    stateContent = stateContent.replace(
+      /(\*\*Status:\*\*\s*).*/,
+      `$1${version} milestone complete`
+    );
+    stateContent = stateContent.replace(
+      /(\*\*Last Activity:\*\*\s*).*/,
+      `$1${today}`
+    );
+    stateContent = stateContent.replace(
+      /(\*\*Last Activity Description:\*\*\s*).*/,
+      `$1${version} milestone completed and archived`
+    );
+    writeStateMd(statePath, stateContent, cwd);
+  }
+
+  // Archive phase directories if requested
+  let phasesArchived = false;
+  if (options.archivePhases) {
+    try {
+      const phaseArchiveDir = path.join(archiveDir, `${version}-phases`);
+      fs.mkdirSync(phaseArchiveDir, { recursive: true });
+
+      const phaseEntries = fs.readdirSync(phasesDir, { withFileTypes: true });
+      const phaseDirNames = phaseEntries.filter(e => e.isDirectory()).map(e => e.name);
+      let archivedCount = 0;
+      for (const dir of phaseDirNames) {
+        if (!isDirInMilestone(dir)) continue;
+        fs.renameSync(path.join(phasesDir, dir), path.join(phaseArchiveDir, dir));
+        archivedCount++;
+      }
+      phasesArchived = archivedCount > 0;
+    } catch {}
+  }
+
+  const result = {
+    version,
+    name: milestoneName,
+    date: today,
+    phases: phaseCount,
+    plans: totalPlans,
+    tasks: totalTasks,
+    accomplishments,
+    archived: {
+      roadmap: fs.existsSync(path.join(archiveDir, `${version}-ROADMAP.md`)),
+      requirements: fs.existsSync(path.join(archiveDir, `${version}-REQUIREMENTS.md`)),
+      audit: fs.existsSync(path.join(archiveDir, `${version}-MILESTONE-AUDIT.md`)),
+      phases: phasesArchived,
+    },
+    milestones_updated: true,
+    state_updated: fs.existsSync(statePath),
+  };
+
+  output(result, raw);
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Milestone — Milestone and requirements lifecycle operations
+ */
+export declare function cmdRequirementsMarkComplete(cwd: string, reqIdsRaw: string[], raw: boolean): void;
+interface MilestoneCompleteOptions {
+    name?: string;
+    archivePhases?: boolean;
+}
+export declare function cmdMilestoneComplete(cwd: string, version: string | undefined, options: MilestoneCompleteOptions, raw: boolean): void;
+export {};
+//# sourceMappingURL=milestone.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"milestone.d.cts","sourceRoot":"","sources":["milestone.cts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAkEhG;AAED,UAAU,wBAAwB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,wBAAwB,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6JpI"}

package/core/bin/lib/model-profiles.cjs

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Mapping of Vector agent to model for each profile.
+ *
+ * Should be in sync with the profiles table in `core/references/model-profiles.md`. But
+ * possibly worth making this the single source of truth at some point, and removing the markdown
+ * reference table in favor of programmatically determining the model to use for an agent (which
+ * would be faster, use fewer tokens, and be less error-prone).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_PROFILES = exports.MODEL_PROFILES = void 0;
+exports.formatAgentToModelMapAsTable = formatAgentToModelMapAsTable;
+exports.getAgentToModelMapForProfile = getAgentToModelMapForProfile;
+exports.MODEL_PROFILES = {
+    'vector-planner': { quality: 'opus', balanced: 'opus', budget: 'sonnet' },
+    'vector-roadmapper': { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+    'vector-executor': { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+    'vector-phase-researcher': { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
+    'vector-project-researcher': { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
+    'vector-research-synthesizer': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+    'vector-debugger': { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+    'vector-codebase-mapper': { quality: 'sonnet', balanced: 'haiku', budget: 'haiku' },
+    'vector-verifier': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+    'vector-plan-checker': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+    'vector-integration-checker': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+    'vector-nyquist-auditor': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+    'vector-ui-researcher': { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
+    'vector-ui-checker': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+    'vector-ui-auditor': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+};
+exports.VALID_PROFILES = Object.keys(exports.MODEL_PROFILES['vector-planner']);
+/**
+ * Formats the agent-to-model mapping as a human-readable table (in string format).
+ *
+ * @param agentToModelMap - A mapping from agent to model
+ * @returns A formatted table string
+ */
+function formatAgentToModelMapAsTable(agentToModelMap) {
+    const agentWidth = Math.max('Agent'.length, ...Object.keys(agentToModelMap).map((a) => a.length));
+    const modelWidth = Math.max('Model'.length, ...Object.values(agentToModelMap).map((m) => m.length));
+    const sep = '─'.repeat(agentWidth + 2) + '┼' + '─'.repeat(modelWidth + 2);
+    const header = ' ' + 'Agent'.padEnd(agentWidth) + ' │ ' + 'Model'.padEnd(modelWidth);
+    let agentToModelTable = header + '\n' + sep + '\n';
+    for (const [agent, model] of Object.entries(agentToModelMap)) {
+        agentToModelTable += ' ' + agent.padEnd(agentWidth) + ' │ ' + model.padEnd(modelWidth) + '\n';
+    }
+    return agentToModelTable;
+}
+/**
+ * Returns a mapping from agent to model for the given model profile.
+ *
+ * @param normalizedProfile - The normalized (lowercase and trimmed) profile name
+ * @returns A mapping from agent to model for the given profile
+ */
+function getAgentToModelMapForProfile(normalizedProfile) {
+    const agentToModelMap = {};
+    for (const [agent, profileToModelMap] of Object.entries(exports.MODEL_PROFILES)) {
+        agentToModelMap[agent] = profileToModelMap[normalizedProfile];
+    }
+    return agentToModelMap;
+}
+//# sourceMappingURL=model-profiles.cjs.map

package/core/bin/lib/model-profiles.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-profiles.cjs","sourceRoot":"","sources":["model-profiles.cts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA+BH,oEAaC;AAQD,oEAMC;AApDY,QAAA,cAAc,GAAkB;IAC3C,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;IACzE,mBAAmB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC9E,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC5E,yBAAyB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACnF,2BAA2B,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACrF,6BAA6B,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACzF,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC5E,wBAAwB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IACnF,iBAAiB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAC7E,qBAAqB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACjF,4BAA4B,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACxF,wBAAwB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IACpF,sBAAsB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAChF,mBAAmB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAC/E,mBAAmB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;CAChF,CAAC;AACW,QAAA,cAAc,GAAa,MAAM,CAAC,IAAI,CAAC,sBAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,SAAgB,4BAA4B,CAAC,eAAuC;IAClF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,OAAO,CAAC,MAAM,EACd,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CACvD,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrF,IAAI,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IACnD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7D,iBAAiB,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAChG,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,4BAA4B,CAAC,iBAAyB;IACpE,MAAM,eAAe,GAA2B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,KAAK,EAAE,iBAAiB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAc,CAAC,EAAE,CAAC;QACxE,eAAe,CAAC,KAAK,CAAC,GAAI,iBAA4C,CAAC,iBAAiB,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/core/bin/lib/model-profiles.cts

@@ -0,0 +1,66 @@
+/**
+ * Mapping of Vector agent to model for each profile.
+ *
+ * Should be in sync with the profiles table in `core/references/model-profiles.md`. But
+ * possibly worth making this the single source of truth at some point, and removing the markdown
+ * reference table in favor of programmatically determining the model to use for an agent (which
+ * would be faster, use fewer tokens, and be less error-prone).
+ */
+
+type ModelTier = 'opus' | 'sonnet' | 'haiku';
+type ProfileMap = { quality: ModelTier; balanced: ModelTier; budget: ModelTier };
+type ModelProfiles = Record<string, ProfileMap>;
+
+export const MODEL_PROFILES: ModelProfiles = {
+  'vector-planner': { quality: 'opus', balanced: 'opus', budget: 'sonnet' },
+  'vector-roadmapper': { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+  'vector-executor': { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+  'vector-phase-researcher': { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
+  'vector-project-researcher': { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
+  'vector-research-synthesizer': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'vector-debugger': { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+  'vector-codebase-mapper': { quality: 'sonnet', balanced: 'haiku', budget: 'haiku' },
+  'vector-verifier': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'vector-plan-checker': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'vector-integration-checker': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'vector-nyquist-auditor': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'vector-ui-researcher': { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
+  'vector-ui-checker': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'vector-ui-auditor': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+};
+export const VALID_PROFILES: string[] = Object.keys(MODEL_PROFILES['vector-planner']);
+
+/**
+ * Formats the agent-to-model mapping as a human-readable table (in string format).
+ *
+ * @param agentToModelMap - A mapping from agent to model
+ * @returns A formatted table string
+ */
+export function formatAgentToModelMapAsTable(agentToModelMap: Record<string, string>): string {
+  const agentWidth = Math.max('Agent'.length, ...Object.keys(agentToModelMap).map((a) => a.length));
+  const modelWidth = Math.max(
+    'Model'.length,
+    ...Object.values(agentToModelMap).map((m) => m.length)
+  );
+  const sep = '─'.repeat(agentWidth + 2) + '┼' + '─'.repeat(modelWidth + 2);
+  const header = ' ' + 'Agent'.padEnd(agentWidth) + ' │ ' + 'Model'.padEnd(modelWidth);
+  let agentToModelTable = header + '\n' + sep + '\n';
+  for (const [agent, model] of Object.entries(agentToModelMap)) {
+    agentToModelTable += ' ' + agent.padEnd(agentWidth) + ' │ ' + model.padEnd(modelWidth) + '\n';
+  }
+  return agentToModelTable;
+}
+
+/**
+ * Returns a mapping from agent to model for the given model profile.
+ *
+ * @param normalizedProfile - The normalized (lowercase and trimmed) profile name
+ * @returns A mapping from agent to model for the given profile
+ */
+export function getAgentToModelMapForProfile(normalizedProfile: string): Record<string, string> {
+  const agentToModelMap: Record<string, string> = {};
+  for (const [agent, profileToModelMap] of Object.entries(MODEL_PROFILES)) {
+    agentToModelMap[agent] = (profileToModelMap as Record<string, string>)[normalizedProfile];
+  }
+  return agentToModelMap;
+}