@kjerneverk/riotplan-verify 1.0.0-dev.0

package/dist/index.d.ts

@@ -0,0 +1,317 @@
+/**
+ * Error thrown when acceptance criteria are not met
+ */
+export declare class AcceptanceCriteriaError extends VerificationError {
+    constructor(uncheckedCriteria: AcceptanceCriterion[]);
+}
+
+/**
+ * Acceptance criterion from a step file
+ */
+export declare interface AcceptanceCriterion {
+    text: string;
+    checked: boolean;
+    stepNumber: number;
+}
+
+/**
+ * Error thrown when required artifacts are missing
+ */
+export declare class ArtifactVerificationError extends VerificationError {
+    constructor(missingArtifacts: string[]);
+}
+
+/**
+ * Check completion of plan execution
+ */
+export declare function checkCompletion(planPath: string): Promise<CompletionReport>;
+
+/**
+ * Check coverage of analysis criteria in plan steps
+ */
+export declare function checkCoverage(planPath: string, options?: CoverageOptions): Promise<CoverageReport>;
+
+/**
+ * Completion report for plan → execution verification
+ */
+export declare interface CompletionReport {
+    /** Total steps */
+    totalSteps: number;
+    /** Steps by completion status */
+    complete: StepCompletionResult[];
+    partial: StepCompletionResult[];
+    incomplete: StepCompletionResult[];
+    pending: StepCompletionResult[];
+    /** Overall completion percentage */
+    completionScore: number;
+    /** Outstanding items */
+    outstandingItems: string[];
+}
+
+export declare interface CoverageOptions {
+    /** Minimum keyword match score to consider "covered" */
+    coverageThreshold?: number;
+    /** Minimum keyword match score to consider "partial" */
+    partialThreshold?: number;
+}
+
+/**
+ * Coverage report for analysis → plan verification
+ */
+export declare interface CoverageReport {
+    /** Total criteria checked */
+    totalCriteria: number;
+    /** Fully covered criteria */
+    covered: CriterionResult[];
+    /** Partially covered criteria */
+    partial: CriterionResult[];
+    /** Missing criteria */
+    missing: CriterionResult[];
+    /** Coverage by priority */
+    byPriority: {
+        must: {
+            total: number;
+            covered: number;
+            partial: number;
+            missing: number;
+        };
+        should: {
+            total: number;
+            covered: number;
+            partial: number;
+            missing: number;
+        };
+        could: {
+            total: number;
+            covered: number;
+            partial: number;
+            missing: number;
+        };
+    };
+    /** Overall coverage percentage (weighted by priority) */
+    coverageScore: number;
+    /** Generated verification questions */
+    questions: string[];
+}
+
+/**
+ * Patterns for detecting criteria in markdown
+ */
+export declare const CRITERIA_PATTERNS: {
+    /** Checkbox item: - [ ] or - [x] */
+    readonly checkbox: RegExp;
+    /** Section headers for criteria */
+    readonly mustHaveHeader: RegExp;
+    readonly shouldHaveHeader: RegExp;
+    readonly couldHaveHeader: RegExp;
+    /** Verification criteria section */
+    readonly verificationSection: RegExp;
+};
+
+/**
+ * Priority level for verification criteria
+ */
+export declare type CriteriaPriority = "must" | "should" | "could";
+
+/**
+ * Status of a verification criterion
+ */
+export declare type CriteriaStatus = "covered" | "partial" | "missing" | "unknown";
+
+/**
+ * Result of checking a single criterion
+ */
+export declare interface CriterionResult {
+    criterion: VerificationCriterion;
+    status: CriteriaStatus;
+    matchedSteps: number[];
+    notes?: string;
+}
+
+/**
+ * Get criteria summary statistics
+ */
+export declare function getCriteriaSummary(criteria: VerificationCriterion[]): {
+    total: number;
+    must: number;
+    should: number;
+    could: number;
+};
+
+/**
+ * Minimum scores for "healthy" status
+ */
+export declare const HEALTH_THRESHOLDS: {
+    readonly coverage: {
+        readonly good: 80;
+        readonly warning: 60;
+        readonly critical: 40;
+    };
+    readonly completion: {
+        readonly good: 90;
+        readonly warning: 70;
+        readonly critical: 50;
+    };
+};
+
+/**
+ * Parse verification criteria from a plan's analysis
+ */
+export declare function parseCriteria(planPath: string): Promise<ParsedCriteria>;
+
+/**
+ * Parse criteria from markdown content
+ */
+export declare function parseCriteriaFromContent(content: string, source: string): ParsedCriteria;
+
+export declare interface ParsedCriteria {
+    criteria: VerificationCriterion[];
+    source: string;
+    parseErrors: string[];
+}
+
+declare interface Plan {
+    steps: PlanStep[];
+}
+
+declare interface PlanStep {
+    number: number;
+    filePath: string;
+}
+
+/**
+ * Weight multipliers for coverage scoring by priority
+ */
+export declare const PRIORITY_WEIGHTS: {
+    readonly must: 1;
+    readonly should: 0.7;
+    readonly could: 0.3;
+};
+
+/**
+ * Result of checking step completion
+ */
+export declare interface StepCompletionResult {
+    stepNumber: number;
+    stepTitle: string;
+    status: StepCompletionStatus;
+    acceptanceCriteria: AcceptanceCriterion[];
+    markedStatus: string;
+    notes?: string;
+}
+
+/**
+ * Step completion status
+ */
+export declare type StepCompletionStatus = "complete" | "partial" | "incomplete" | "pending" | "skipped";
+
+/**
+ * A single verification criterion extracted from analysis
+ */
+export declare interface VerificationCriterion {
+    id: string;
+    text: string;
+    priority: CriteriaPriority;
+    source: string;
+    lineNumber?: number;
+}
+
+/**
+ * Verification engine for step completion
+ */
+export declare class VerificationEngine {
+    /**
+     * Verify that a step is ready to be marked complete
+     *
+     * @param plan - The plan containing the step
+     * @param stepNumber - The step number to verify
+     * @param options - Verification options
+     * @returns Verification result with details
+     */
+    verifyStepCompletion(plan: Plan, stepNumber: number, options: VerificationOptions): Promise<VerificationResult>;
+    /**
+     * Check acceptance criteria in step file
+     *
+     * Parses markdown checkboxes from the step file and returns
+     * a list of criteria with their checked status.
+     *
+     * @param step - The step to check
+     * @returns List of acceptance criteria
+     */
+    private checkAcceptanceCriteria;
+    /**
+     * Check that artifacts mentioned in step file exist
+     *
+     * Parses the "Files Changed" section and verifies files exist.
+     *
+     * @param step - The step to check
+     * @returns List of missing artifacts
+     */
+    private checkArtifacts;
+    /**
+     * Determine if verification failure should block completion
+     *
+     * @param result - The verification result
+     * @param options - Verification options
+     * @returns True if completion should be blocked
+     */
+    shouldBlock(result: VerificationResult, options: VerificationOptions): boolean;
+}
+
+/**
+ * Base error for verification failures
+ */
+export declare class VerificationError extends Error {
+    details: VerificationResult;
+    constructor(message: string, details: VerificationResult);
+}
+
+/**
+ * Options for verification
+ */
+export declare interface VerificationOptions {
+    /** Enforcement level */
+    enforcement: 'advisory' | 'interactive' | 'strict';
+    /** Whether to check acceptance criteria */
+    checkAcceptanceCriteria: boolean;
+    /** Whether to check artifacts */
+    checkArtifacts: boolean;
+    /** Force flag to bypass verification */
+    force?: boolean;
+}
+
+/**
+ * Full verification report
+ */
+export declare interface VerificationReport {
+    planPath: string;
+    timestamp: Date;
+    /** Analysis → Plan coverage (if analysis exists) */
+    coverage?: CoverageReport;
+    /** Plan → Execution completion */
+    completion?: CompletionReport;
+    /** Overall health score (0-100) */
+    healthScore: number;
+    /** Summary messages */
+    summary: string[];
+    /** Recommendations */
+    recommendations: string[];
+}
+
+/**
+ * Result of verification check
+ */
+export declare interface VerificationResult {
+    /** Whether verification passed */
+    isValid: boolean;
+    /** Severity level of issues found */
+    level: 'passed' | 'warning' | 'error';
+    /** Human-readable messages about verification results */
+    messages: string[];
+    /** Acceptance criteria that were checked */
+    acceptanceCriteria?: AcceptanceCriterion[];
+    /** Artifacts that were verified */
+    artifacts?: string[];
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,650 @@
+import { readFile, readdir, access } from "node:fs/promises";
+import { join, resolve, dirname } from "node:path";
+const PRIORITY_WEIGHTS = {
+  must: 1,
+  should: 0.7,
+  could: 0.3
+};
+const CRITERIA_PATTERNS = {
+  /** Checkbox item: - [ ] or - [x] */
+  checkbox: /^[-*]\s*\[([x ])\]\s*(.+)$/gm,
+  /** Section headers for criteria */
+  mustHaveHeader: /^###?\s*Must\s+Have/i,
+  shouldHaveHeader: /^###?\s*Should\s+Have/i,
+  couldHaveHeader: /^###?\s*Could\s+Have/i,
+  /** Verification criteria section */
+  verificationSection: /^##\s*Verification\s+Criteria/im
+};
+const HEALTH_THRESHOLDS = {
+  coverage: {
+    good: 80,
+    warning: 60,
+    critical: 40
+  },
+  completion: {
+    good: 90,
+    warning: 70,
+    critical: 50
+  }
+};
+async function parseCriteria(planPath) {
+  const reqPath = join(planPath, "analysis", "REQUIREMENTS.md");
+  try {
+    const content = await readFile(reqPath, "utf-8");
+    return parseCriteriaFromContent(content, reqPath);
+  } catch (error) {
+    return {
+      criteria: [],
+      source: reqPath,
+      parseErrors: [`Could not read ${reqPath}: ${error.message}`]
+    };
+  }
+}
+function parseCriteriaFromContent(content, source) {
+  const criteria = [];
+  const parseErrors = [];
+  const sectionMatch = content.match(CRITERIA_PATTERNS.verificationSection);
+  if (!sectionMatch) {
+    return {
+      criteria: [],
+      source,
+      parseErrors: ["No 'Verification Criteria' section found"]
+    };
+  }
+  const sectionStart = sectionMatch.index + sectionMatch[0].length;
+  const nextSectionMatch = content.slice(sectionStart).match(/^##\s+[^#]/m);
+  const sectionEnd = nextSectionMatch ? sectionStart + nextSectionMatch.index : content.length;
+  const sectionContent = content.slice(sectionStart, sectionEnd);
+  const lines = sectionContent.split("\n");
+  let currentPriority = "should";
+  let lineNumber = content.slice(0, sectionStart).split("\n").length;
+  for (const line of lines) {
+    lineNumber++;
+    if (CRITERIA_PATTERNS.mustHaveHeader.test(line)) {
+      currentPriority = "must";
+      continue;
+    }
+    if (CRITERIA_PATTERNS.shouldHaveHeader.test(line)) {
+      currentPriority = "should";
+      continue;
+    }
+    if (CRITERIA_PATTERNS.couldHaveHeader.test(line)) {
+      currentPriority = "could";
+      continue;
+    }
+    const checkboxMatch = line.match(/^[-*]\s*\[([x ])\]\s*(.+)$/i);
+    if (checkboxMatch) {
+      const text = checkboxMatch[2].trim();
+      const id = generateCriterionId(text, criteria.length);
+      criteria.push({
+        id,
+        text,
+        priority: currentPriority,
+        source,
+        lineNumber
+      });
+    }
+  }
+  if (criteria.length === 0) {
+    parseErrors.push("No checkbox criteria found in Verification Criteria section");
+  }
+  return { criteria, source, parseErrors };
+}
+function generateCriterionId(text, index) {
+  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 30);
+  return `${String(index + 1).padStart(3, "0")}-${slug}`;
+}
+function getCriteriaSummary(criteria) {
+  return {
+    total: criteria.length,
+    must: criteria.filter((c) => c.priority === "must").length,
+    should: criteria.filter((c) => c.priority === "should").length,
+    could: criteria.filter((c) => c.priority === "could").length
+  };
+}
+const DEFAULT_OPTIONS = {
+  coverageThreshold: 0.6,
+  partialThreshold: 0.3
+};
+async function checkCoverage(planPath, options = {}) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  const { criteria, parseErrors } = await parseCriteria(planPath);
+  if (criteria.length === 0) {
+    return createEmptyReport(parseErrors);
+  }
+  const steps = await loadStepFiles(planPath);
+  const results = [];
+  for (const criterion of criteria) {
+    const result = checkCriterionCoverage(criterion, steps, opts);
+    results.push(result);
+  }
+  return buildCoverageReport(results);
+}
+async function loadStepFiles(planPath) {
+  const steps = /* @__PURE__ */ new Map();
+  const planDir = join(planPath, "plan");
+  try {
+    const files = await readdir(planDir);
+    const stepFiles = files.filter((f) => /^\d{2}-/.test(f) && f.endsWith(".md"));
+    for (const file of stepFiles) {
+      const stepNum = parseInt(file.slice(0, 2));
+      const content = await readFile(join(planDir, file), "utf-8");
+      steps.set(stepNum, content);
+    }
+  } catch {
+  }
+  return steps;
+}
+function checkCriterionCoverage(criterion, steps, options) {
+  const keywords = extractKeywords(criterion.text);
+  const matchedSteps = [];
+  let bestScore = 0;
+  for (const [stepNum, content] of steps) {
+    const score = calculateMatchScore(keywords, content);
+    if (score > bestScore) {
+      bestScore = score;
+    }
+    if (score >= options.partialThreshold) {
+      matchedSteps.push(stepNum);
+    }
+  }
+  let status;
+  if (bestScore >= options.coverageThreshold) {
+    status = "covered";
+  } else if (bestScore >= options.partialThreshold) {
+    status = "partial";
+  } else {
+    status = "missing";
+  }
+  return {
+    criterion,
+    status,
+    matchedSteps,
+    notes: matchedSteps.length > 0 ? `Best match in step(s): ${matchedSteps.join(", ")}` : void 0
+  };
+}
+function extractKeywords(text) {
+  const stopWords = /* @__PURE__ */ new Set([
+    "a",
+    "an",
+    "the",
+    "is",
+    "are",
+    "was",
+    "were",
+    "be",
+    "been",
+    "being",
+    "have",
+    "has",
+    "had",
+    "do",
+    "does",
+    "did",
+    "will",
+    "would",
+    "could",
+    "should",
+    "may",
+    "might",
+    "must",
+    "shall",
+    "can",
+    "need",
+    "to",
+    "of",
+    "in",
+    "for",
+    "on",
+    "with",
+    "at",
+    "by",
+    "from",
+    "as",
+    "or",
+    "and",
+    "but",
+    "if",
+    "then",
+    "so",
+    "that",
+    "this",
+    "it",
+    "its",
+    "all",
+    "any",
+    "each",
+    "every"
+  ]);
+  return text.toLowerCase().replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((word) => word.length > 2 && !stopWords.has(word));
+}
+function calculateMatchScore(keywords, content) {
+  if (keywords.length === 0) return 0;
+  const contentLower = content.toLowerCase();
+  let matches = 0;
+  for (const keyword of keywords) {
+    if (contentLower.includes(keyword)) {
+      matches++;
+    }
+  }
+  return matches / keywords.length;
+}
+function buildCoverageReport(results) {
+  const covered = results.filter((r) => r.status === "covered");
+  const partial = results.filter((r) => r.status === "partial");
+  const missing = results.filter((r) => r.status === "missing");
+  const byPriority = {
+    must: calculatePriorityStats(results, "must"),
+    should: calculatePriorityStats(results, "should"),
+    could: calculatePriorityStats(results, "could")
+  };
+  const coverageScore = calculateWeightedScore(byPriority);
+  const questions = generateVerificationQuestions(partial, missing);
+  return {
+    totalCriteria: results.length,
+    covered,
+    partial,
+    missing,
+    byPriority,
+    coverageScore,
+    questions
+  };
+}
+function calculatePriorityStats(results, priority) {
+  const forPriority = results.filter((r) => r.criterion.priority === priority);
+  return {
+    total: forPriority.length,
+    covered: forPriority.filter((r) => r.status === "covered").length,
+    partial: forPriority.filter((r) => r.status === "partial").length,
+    missing: forPriority.filter((r) => r.status === "missing").length
+  };
+}
+function calculateWeightedScore(byPriority) {
+  let totalWeight = 0;
+  let weightedCovered = 0;
+  for (const [priority, stats] of Object.entries(byPriority)) {
+    const weight = PRIORITY_WEIGHTS[priority];
+    totalWeight += stats.total * weight;
+    weightedCovered += (stats.covered + stats.partial * 0.5) * weight;
+  }
+  if (totalWeight === 0) return 100;
+  return Math.round(weightedCovered / totalWeight * 100);
+}
+function generateVerificationQuestions(partial, missing) {
+  const questions = [];
+  for (const result of missing.slice(0, 3)) {
+    questions.push(`Where is "${result.criterion.text}" addressed in the plan?`);
+  }
+  for (const result of partial.slice(0, 2)) {
+    questions.push(
+      `Is "${result.criterion.text}" fully covered in step(s) ${result.matchedSteps.join(", ")}?`
+    );
+  }
+  return questions;
+}
+function createEmptyReport(errors) {
+  return {
+    totalCriteria: 0,
+    covered: [],
+    partial: [],
+    missing: [],
+    byPriority: {
+      must: { total: 0, covered: 0, partial: 0, missing: 0 },
+      should: { total: 0, covered: 0, partial: 0, missing: 0 },
+      could: { total: 0, covered: 0, partial: 0, missing: 0 }
+    },
+    coverageScore: 100,
+    questions: errors
+  };
+}
+async function checkCompletion(planPath) {
+  const statusMap = await loadStatusMap(planPath);
+  const stepResults = await loadStepResults(planPath, statusMap);
+  return buildCompletionReport(stepResults);
+}
+async function loadStatusMap(planPath) {
+  const statusMap = /* @__PURE__ */ new Map();
+  try {
+    const statusPath = join(planPath, "STATUS.md");
+    const content = await readFile(statusPath, "utf-8");
+    const lines = content.split("\n");
+    let inTable = false;
+    for (const line of lines) {
+      if (/\|\s*Step\s*\|\s*Name\s*\|\s*Status/i.test(line)) {
+        inTable = true;
+        continue;
+      }
+      if (inTable && (/^##/.test(line) || line.trim() === "")) {
+        break;
+      }
+      if (inTable && line.includes("|")) {
+        const match = line.match(/\|\s*(\d+)\s*\|[^|]+\|\s*([^|]+)\|/);
+        if (match) {
+          const stepNum = parseInt(match[1]);
+          const status = match[2].trim();
+          statusMap.set(stepNum, status);
+        }
+      }
+    }
+  } catch {
+  }
+  return statusMap;
+}
+async function loadStepResults(planPath, statusMap) {
+  const results = [];
+  const planDir = join(planPath, "plan");
+  try {
+    const files = await readdir(planDir);
+    const stepFiles = files.filter((f) => /^\d{2}-/.test(f) && f.endsWith(".md")).sort();
+    for (const file of stepFiles) {
+      const stepNum = parseInt(file.slice(0, 2));
+      const content = await readFile(join(planDir, file), "utf-8");
+      const result = analyzeStep(stepNum, content, statusMap.get(stepNum) || "⬜ Pending");
+      results.push(result);
+    }
+  } catch {
+  }
+  return results;
+}
+function analyzeStep(stepNum, content, markedStatus) {
+  const titleMatch = content.match(/^#\s+(.+)$/m);
+  const stepTitle = titleMatch ? titleMatch[1] : `Step ${stepNum}`;
+  const criteria = extractAcceptanceCriteria(content, stepNum);
+  const status = determineCompletionStatus(criteria, markedStatus);
+  return {
+    stepNumber: stepNum,
+    stepTitle,
+    status,
+    acceptanceCriteria: criteria,
+    markedStatus
+  };
+}
+function extractAcceptanceCriteria(content, stepNum) {
+  const criteria = [];
+  const lines = content.split("\n");
+  const sectionLines = [];
+  let inSection = false;
+  for (const line of lines) {
+    if (/^##\s*Acceptance\s+Criteria$/i.test(line)) {
+      inSection = true;
+      continue;
+    }
+    if (inSection && /^##/.test(line)) {
+      break;
+    }
+    if (inSection) {
+      sectionLines.push(line);
+    }
+  }
+  if (sectionLines.length === 0) {
+    return criteria;
+  }
+  const sectionContent = sectionLines.join("\n");
+  const checkboxRegex = /^[-*]\s*\[([x ])\]\s*(.+)$/gim;
+  let match;
+  while ((match = checkboxRegex.exec(sectionContent)) !== null) {
+    criteria.push({
+      text: match[2].trim(),
+      checked: match[1].toLowerCase() === "x",
+      stepNumber: stepNum
+    });
+  }
+  return criteria;
+}
+function determineCompletionStatus(criteria, markedStatus) {
+  const isMarkedComplete = markedStatus.includes("✅") || markedStatus.toLowerCase().includes("complete");
+  const isMarkedPending = markedStatus.includes("⬜") || markedStatus.toLowerCase().includes("pending");
+  const isMarkedInProgress = markedStatus.includes("🔄") || markedStatus.toLowerCase().includes("progress");
+  const isMarkedSkipped = markedStatus.includes("⏭️") || markedStatus.toLowerCase().includes("skip");
+  if (isMarkedSkipped) {
+    return "skipped";
+  }
+  if (criteria.length === 0) {
+    if (isMarkedComplete) return "complete";
+    if (isMarkedPending) return "pending";
+    return "partial";
+  }
+  const checkedCount = criteria.filter((c) => c.checked).length;
+  const allChecked = checkedCount === criteria.length;
+  const noneChecked = checkedCount === 0;
+  if (isMarkedComplete) {
+    if (allChecked) return "complete";
+    if (noneChecked) return "incomplete";
+    return "partial";
+  }
+  if (isMarkedInProgress) {
+    return "partial";
+  }
+  return "pending";
+}
+function buildCompletionReport(results) {
+  const complete = results.filter((r) => r.status === "complete");
+  const partial = results.filter((r) => r.status === "partial");
+  const incomplete = results.filter((r) => r.status === "incomplete");
+  const pending = results.filter((r) => r.status === "pending" || r.status === "skipped");
+  const totalSteps = results.length;
+  const completedSteps = complete.length + partial.length * 0.5;
+  const completionScore = totalSteps > 0 ? Math.round(completedSteps / totalSteps * 100) : 100;
+  const outstandingItems = [];
+  for (const result of [...incomplete, ...partial]) {
+    const unchecked = result.acceptanceCriteria.filter((c) => !c.checked);
+    for (const criterion of unchecked) {
+      outstandingItems.push(`Step ${result.stepNumber}: ${criterion.text}`);
+    }
+  }
+  return {
+    totalSteps,
+    complete,
+    partial,
+    incomplete,
+    pending,
+    completionScore,
+    outstandingItems
+  };
+}
+class VerificationEngine {
+  /**
+   * Verify that a step is ready to be marked complete
+   *
+   * @param plan - The plan containing the step
+   * @param stepNumber - The step number to verify
+   * @param options - Verification options
+   * @returns Verification result with details
+   */
+  async verifyStepCompletion(plan, stepNumber, options) {
+    const step = plan.steps.find((s) => s.number === stepNumber);
+    if (!step) {
+      return {
+        isValid: false,
+        level: "error",
+        messages: [`Step ${stepNumber} not found in plan`]
+      };
+    }
+    const messages = [];
+    let level = "passed";
+    let acceptanceCriteria;
+    let artifacts;
+    if (options.checkAcceptanceCriteria) {
+      acceptanceCriteria = await this.checkAcceptanceCriteria(step);
+      const unchecked = acceptanceCriteria.filter((c) => !c.checked);
+      if (unchecked.length > 0) {
+        level = "error";
+        messages.push(
+          `${unchecked.length} acceptance criteria not checked:`
+        );
+        for (const criterion of unchecked) {
+          messages.push(`  - [ ] ${criterion.text}`);
+        }
+      } else if (acceptanceCriteria.length === 0) {
+        level = "warning";
+        messages.push("No acceptance criteria found in step file");
+      } else {
+        messages.push(
+          `✓ All ${acceptanceCriteria.length} acceptance criteria checked`
+        );
+      }
+    }
+    if (options.checkArtifacts) {
+      artifacts = await this.checkArtifacts(step);
+      if (artifacts.length > 0) {
+        level = level === "error" ? "error" : "warning";
+        messages.push(`${artifacts.length} artifacts not found:`);
+        for (const artifact of artifacts) {
+          messages.push(`  - ${artifact}`);
+        }
+      }
+    }
+    const isValid = level === "passed" || level === "warning";
+    return {
+      isValid,
+      level,
+      messages,
+      acceptanceCriteria,
+      artifacts
+    };
+  }
+  /**
+   * Check acceptance criteria in step file
+   *
+   * Parses markdown checkboxes from the step file and returns
+   * a list of criteria with their checked status.
+   *
+   * @param step - The step to check
+   * @returns List of acceptance criteria
+   */
+  async checkAcceptanceCriteria(step) {
+    try {
+      const content = await readFile(step.filePath, "utf-8");
+      const criteria = [];
+      const sectionMatch = content.match(
+        /##\s+Acceptance Criteria\s*\n([\s\S]*?)(?=\n##|$)/i
+      );
+      if (!sectionMatch) {
+        return criteria;
+      }
+      const section = sectionMatch[1];
+      const checkboxRegex = /^\s*-\s*\[([ xX])\]\s*(.+)$/gm;
+      let match;
+      while ((match = checkboxRegex.exec(section)) !== null) {
+        criteria.push({
+          text: match[2].trim(),
+          checked: match[1].toLowerCase() === "x",
+          stepNumber: step.number
+        });
+      }
+      return criteria;
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Check that artifacts mentioned in step file exist
+   *
+   * Parses the "Files Changed" section and verifies files exist.
+   *
+   * @param step - The step to check
+   * @returns List of missing artifacts
+   */
+  async checkArtifacts(step) {
+    try {
+      const content = await readFile(step.filePath, "utf-8");
+      const missing = [];
+      const sectionMatch = content.match(
+        /##\s+Files Changed\s*\n([\s\S]*?)(?=\n##|$)/i
+      );
+      if (!sectionMatch) {
+        return missing;
+      }
+      const section = sectionMatch[1];
+      const fileRegex = /^\s*-\s+`?([^\s`]+\.[a-zA-Z0-9]+)`?/gm;
+      let match;
+      while ((match = fileRegex.exec(section)) !== null) {
+        const filePath = match[1].trim();
+        const planRoot = resolve(dirname(step.filePath), "../..");
+        const fullPath = resolve(planRoot, filePath);
+        try {
+          await access(fullPath);
+        } catch {
+          missing.push(filePath);
+        }
+      }
+      return missing;
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Determine if verification failure should block completion
+   *
+   * @param result - The verification result
+   * @param options - Verification options
+   * @returns True if completion should be blocked
+   */
+  shouldBlock(result, options) {
+    if (options.force) {
+      return false;
+    }
+    if (options.enforcement === "advisory") {
+      return false;
+    }
+    if (options.enforcement === "strict" && result.level === "error") {
+      return true;
+    }
+    return false;
+  }
+}
+class VerificationError extends Error {
+  constructor(message, details) {
+    super(message);
+    this.details = details;
+    this.name = "VerificationError";
+    Error.captureStackTrace(this, this.constructor);
+  }
+}
+class AcceptanceCriteriaError extends VerificationError {
+  constructor(uncheckedCriteria) {
+    const message = `Step has ${uncheckedCriteria.length} unchecked acceptance criteria`;
+    const details = {
+      isValid: false,
+      level: "error",
+      messages: [
+        message,
+        ...uncheckedCriteria.map((c) => `  - [ ] ${c.text}`)
+      ],
+      acceptanceCriteria: uncheckedCriteria
+    };
+    super(message, details);
+    this.name = "AcceptanceCriteriaError";
+  }
+}
+class ArtifactVerificationError extends VerificationError {
+  constructor(missingArtifacts) {
+    const message = `Step has ${missingArtifacts.length} missing artifacts`;
+    const details = {
+      isValid: false,
+      level: "error",
+      messages: [
+        message,
+        ...missingArtifacts.map((a) => `  - ${a}`)
+      ],
+      artifacts: missingArtifacts
+    };
+    super(message, details);
+    this.name = "ArtifactVerificationError";
+  }
+}
+export {
+  AcceptanceCriteriaError,
+  ArtifactVerificationError,
+  CRITERIA_PATTERNS,
+  HEALTH_THRESHOLDS,
+  PRIORITY_WEIGHTS,
+  VerificationEngine,
+  VerificationError,
+  checkCompletion,
+  checkCoverage,
+  getCriteriaSummary,
+  parseCriteria,
+  parseCriteriaFromContent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/constants.ts","../src/criteria-parser.ts","../src/coverage-checker.ts","../src/completion-checker.ts","../src/engine.ts","../src/errors.ts"],"sourcesContent":["/**\n * Weight multipliers for coverage scoring by priority\n */\nexport const PRIORITY_WEIGHTS = {\n    must: 1.0,\n    should: 0.7,\n    could: 0.3,\n} as const;\n\n/**\n * Patterns for detecting criteria in markdown\n */\nexport const CRITERIA_PATTERNS = {\n    /** Checkbox item: - [ ] or - [x] */\n    checkbox: /^[-*]\\s*\\[([x ])\\]\\s*(.+)$/gm,\n    \n    /** Section headers for criteria */\n    mustHaveHeader: /^###?\\s*Must\\s+Have/i,\n    shouldHaveHeader: /^###?\\s*Should\\s+Have/i,\n    couldHaveHeader: /^###?\\s*Could\\s+Have/i,\n    \n    /** Verification criteria section */\n    verificationSection: /^##\\s*Verification\\s+Criteria/im,\n} as const;\n\n/**\n * Minimum scores for \"healthy\" status\n */\nexport const HEALTH_THRESHOLDS = {\n    coverage: {\n        good: 80,\n        warning: 60,\n        critical: 40,\n    },\n    completion: {\n        good: 90,\n        warning: 70,\n        critical: 50,\n    },\n} as const;\n","import { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { VerificationCriterion, CriteriaPriority } from \"./types.js\";\nimport { CRITERIA_PATTERNS } from \"./constants.js\";\n\nexport interface ParsedCriteria {\n    criteria: VerificationCriterion[];\n    source: string;\n    parseErrors: string[];\n}\n\n/**\n * Parse verification criteria from a plan's analysis\n */\nexport async function parseCriteria(planPath: string): Promise<ParsedCriteria> {\n    const reqPath = join(planPath, \"analysis\", \"REQUIREMENTS.md\");\n    \n    try {\n        const content = await readFile(reqPath, \"utf-8\");\n        return parseCriteriaFromContent(content, reqPath);\n    } catch (error) {\n        return {\n            criteria: [],\n            source: reqPath,\n            parseErrors: [`Could not read ${reqPath}: ${(error as Error).message}`],\n        };\n    }\n}\n\n/**\n * Parse criteria from markdown content\n */\nexport function parseCriteriaFromContent(\n    content: string,\n    source: string\n): ParsedCriteria {\n    const criteria: VerificationCriterion[] = [];\n    const parseErrors: string[] = [];\n    \n    // Find the Verification Criteria section\n    const sectionMatch = content.match(CRITERIA_PATTERNS.verificationSection);\n    if (!sectionMatch) {\n        return {\n            criteria: [],\n            source,\n            parseErrors: [\"No 'Verification Criteria' section found\"],\n        };\n    }\n    \n    // Extract content after the section header until next ## header\n    const sectionStart = sectionMatch.index! + sectionMatch[0].length;\n    const nextSectionMatch = content.slice(sectionStart).match(/^##\\s+[^#]/m);\n    const sectionEnd = nextSectionMatch \n        ? sectionStart + nextSectionMatch.index! \n        : content.length;\n    const sectionContent = content.slice(sectionStart, sectionEnd);\n    \n    // Split into priority sections\n    const lines = sectionContent.split(\"\\n\");\n    let currentPriority: CriteriaPriority = \"should\";  // default\n    let lineNumber = content.slice(0, sectionStart).split(\"\\n\").length;\n    \n    for (const line of lines) {\n        lineNumber++;\n        \n        // Check for priority headers\n        if (CRITERIA_PATTERNS.mustHaveHeader.test(line)) {\n            currentPriority = \"must\";\n            continue;\n        }\n        if (CRITERIA_PATTERNS.shouldHaveHeader.test(line)) {\n            currentPriority = \"should\";\n            continue;\n        }\n        if (CRITERIA_PATTERNS.couldHaveHeader.test(line)) {\n            currentPriority = \"could\";\n            continue;\n        }\n        \n        // Check for checkbox items\n        const checkboxMatch = line.match(/^[-*]\\s*\\[([x ])\\]\\s*(.+)$/i);\n        if (checkboxMatch) {\n            const text = checkboxMatch[2].trim();\n            const id = generateCriterionId(text, criteria.length);\n            \n            criteria.push({\n                id,\n                text,\n                priority: currentPriority,\n                source,\n                lineNumber,\n            });\n        }\n    }\n    \n    if (criteria.length === 0) {\n        parseErrors.push(\"No checkbox criteria found in Verification Criteria section\");\n    }\n    \n    return { criteria, source, parseErrors };\n}\n\n/**\n * Generate a unique ID for a criterion\n */\nfunction generateCriterionId(text: string, index: number): string {\n    const slug = text\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"-\")\n        .replace(/^-|-$/g, \"\")\n        .slice(0, 30);\n    return `${String(index + 1).padStart(3, \"0\")}-${slug}`;\n}\n\n/**\n * Get criteria summary statistics\n */\nexport function getCriteriaSummary(criteria: VerificationCriterion[]): {\n    total: number;\n    must: number;\n    should: number;\n    could: number;\n} {\n    return {\n        total: criteria.length,\n        must: criteria.filter(c => c.priority === \"must\").length,\n        should: criteria.filter(c => c.priority === \"should\").length,\n        could: criteria.filter(c => c.priority === \"could\").length,\n    };\n}\n","import { readFile, readdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { \n    VerificationCriterion, \n    CriterionResult, \n    CoverageReport,\n    CriteriaStatus \n} from \"./types.js\";\nimport { PRIORITY_WEIGHTS } from \"./constants.js\";\nimport { parseCriteria } from \"./criteria-parser.js\";\n\nexport interface CoverageOptions {\n    /** Minimum keyword match score to consider \"covered\" */\n    coverageThreshold?: number;\n    /** Minimum keyword match score to consider \"partial\" */\n    partialThreshold?: number;\n}\n\nconst DEFAULT_OPTIONS: Required<CoverageOptions> = {\n    coverageThreshold: 0.6,\n    partialThreshold: 0.3,\n};\n\n/**\n * Check coverage of analysis criteria in plan steps\n */\nexport async function checkCoverage(\n    planPath: string,\n    options: CoverageOptions = {}\n): Promise<CoverageReport> {\n    const opts = { ...DEFAULT_OPTIONS, ...options };\n    \n    // Parse criteria from analysis\n    const { criteria, parseErrors } = await parseCriteria(planPath);\n    \n    if (criteria.length === 0) {\n        return createEmptyReport(parseErrors);\n    }\n    \n    // Load all step files\n    const steps = await loadStepFiles(planPath);\n    \n    // Check each criterion against steps\n    const results: CriterionResult[] = [];\n    \n    for (const criterion of criteria) {\n        const result = checkCriterionCoverage(criterion, steps, opts);\n        results.push(result);\n    }\n    \n    // Build report\n    return buildCoverageReport(results);\n}\n\n/**\n * Load all step file contents\n */\nasync function loadStepFiles(planPath: string): Promise<Map<number, string>> {\n    const steps = new Map<number, string>();\n    const planDir = join(planPath, \"plan\");\n    \n    try {\n        const files = await readdir(planDir);\n        const stepFiles = files.filter(f => /^\\d{2}-/.test(f) && f.endsWith(\".md\"));\n        \n        for (const file of stepFiles) {\n            const stepNum = parseInt(file.slice(0, 2));\n            const content = await readFile(join(planDir, file), \"utf-8\");\n            steps.set(stepNum, content);\n        }\n    } catch {\n        // Plan directory doesn't exist or is empty\n    }\n    \n    return steps;\n}\n\n/**\n * Check if a single criterion is covered by any step\n */\nfunction checkCriterionCoverage(\n    criterion: VerificationCriterion,\n    steps: Map<number, string>,\n    options: Required<CoverageOptions>\n): CriterionResult {\n    const keywords = extractKeywords(criterion.text);\n    \n    const matchedSteps: number[] = [];\n    let bestScore = 0;\n    \n    for (const [stepNum, content] of steps) {\n        const score = calculateMatchScore(keywords, content);\n        if (score > bestScore) {\n            bestScore = score;\n        }\n        if (score >= options.partialThreshold) {\n            matchedSteps.push(stepNum);\n        }\n    }\n    \n    let status: CriteriaStatus;\n    if (bestScore >= options.coverageThreshold) {\n        status = \"covered\";\n    } else if (bestScore >= options.partialThreshold) {\n        status = \"partial\";\n    } else {\n        status = \"missing\";\n    }\n    \n    return {\n        criterion,\n        status,\n        matchedSteps,\n        notes: matchedSteps.length > 0 \n            ? `Best match in step(s): ${matchedSteps.join(\", \")}` \n            : undefined,\n    };\n}\n\n/**\n * Extract significant keywords from text\n */\nfunction extractKeywords(text: string): string[] {\n    const stopWords = new Set([\n        \"a\", \"an\", \"the\", \"is\", \"are\", \"was\", \"were\", \"be\", \"been\",\n        \"being\", \"have\", \"has\", \"had\", \"do\", \"does\", \"did\", \"will\",\n        \"would\", \"could\", \"should\", \"may\", \"might\", \"must\", \"shall\",\n        \"can\", \"need\", \"to\", \"of\", \"in\", \"for\", \"on\", \"with\", \"at\",\n        \"by\", \"from\", \"as\", \"or\", \"and\", \"but\", \"if\", \"then\", \"so\",\n        \"that\", \"this\", \"it\", \"its\", \"all\", \"any\", \"each\", \"every\",\n    ]);\n    \n    return text\n        .toLowerCase()\n        .replace(/[^a-z0-9\\s]/g, \" \")\n        .split(/\\s+/)\n        .filter(word => word.length > 2 && !stopWords.has(word));\n}\n\n/**\n * Calculate match score between keywords and content\n */\nfunction calculateMatchScore(keywords: string[], content: string): number {\n    if (keywords.length === 0) return 0;\n    \n    const contentLower = content.toLowerCase();\n    let matches = 0;\n    \n    for (const keyword of keywords) {\n        if (contentLower.includes(keyword)) {\n            matches++;\n        }\n    }\n    \n    return matches / keywords.length;\n}\n\n/**\n * Build the full coverage report\n */\nfunction buildCoverageReport(results: CriterionResult[]): CoverageReport {\n    const covered = results.filter(r => r.status === \"covered\");\n    const partial = results.filter(r => r.status === \"partial\");\n    const missing = results.filter(r => r.status === \"missing\");\n    \n    const byPriority = {\n        must: calculatePriorityStats(results, \"must\"),\n        should: calculatePriorityStats(results, \"should\"),\n        could: calculatePriorityStats(results, \"could\"),\n    };\n    \n    const coverageScore = calculateWeightedScore(byPriority);\n    const questions = generateVerificationQuestions(partial, missing);\n    \n    return {\n        totalCriteria: results.length,\n        covered,\n        partial,\n        missing,\n        byPriority,\n        coverageScore,\n        questions,\n    };\n}\n\nfunction calculatePriorityStats(\n    results: CriterionResult[],\n    priority: string\n): { total: number; covered: number; partial: number; missing: number } {\n    const forPriority = results.filter(r => r.criterion.priority === priority);\n    return {\n        total: forPriority.length,\n        covered: forPriority.filter(r => r.status === \"covered\").length,\n        partial: forPriority.filter(r => r.status === \"partial\").length,\n        missing: forPriority.filter(r => r.status === \"missing\").length,\n    };\n}\n\nfunction calculateWeightedScore(byPriority: CoverageReport[\"byPriority\"]): number {\n    let totalWeight = 0;\n    let weightedCovered = 0;\n    \n    for (const [priority, stats] of Object.entries(byPriority)) {\n        const weight = PRIORITY_WEIGHTS[priority as keyof typeof PRIORITY_WEIGHTS];\n        totalWeight += stats.total * weight;\n        weightedCovered += (stats.covered + stats.partial * 0.5) * weight;\n    }\n    \n    if (totalWeight === 0) return 100;\n    return Math.round((weightedCovered / totalWeight) * 100);\n}\n\nfunction generateVerificationQuestions(\n    partial: CriterionResult[],\n    missing: CriterionResult[]\n): string[] {\n    const questions: string[] = [];\n    \n    for (const result of missing.slice(0, 3)) {\n        questions.push(`Where is \"${result.criterion.text}\" addressed in the plan?`);\n    }\n    \n    for (const result of partial.slice(0, 2)) {\n        questions.push(\n            `Is \"${result.criterion.text}\" fully covered in step(s) ${result.matchedSteps.join(\", \")}?`\n        );\n    }\n    \n    return questions;\n}\n\nfunction createEmptyReport(errors: string[]): CoverageReport {\n    return {\n        totalCriteria: 0,\n        covered: [],\n        partial: [],\n        missing: [],\n        byPriority: {\n            must: { total: 0, covered: 0, partial: 0, missing: 0 },\n            should: { total: 0, covered: 0, partial: 0, missing: 0 },\n            could: { total: 0, covered: 0, partial: 0, missing: 0 },\n        },\n        coverageScore: 100,\n        questions: errors,\n    };\n}\n","import { readFile, readdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type {\n    StepCompletionResult,\n    StepCompletionStatus,\n    AcceptanceCriterion,\n    CompletionReport,\n} from \"./types.js\";\n\n/**\n * Check completion of plan execution\n */\nexport async function checkCompletion(planPath: string): Promise<CompletionReport> {\n    // Load STATUS.md\n    const statusMap = await loadStatusMap(planPath);\n    \n    // Load step files and extract acceptance criteria\n    const stepResults = await loadStepResults(planPath, statusMap);\n    \n    // Build report\n    return buildCompletionReport(stepResults);\n}\n\n/**\n * Load step status from STATUS.md\n */\nasync function loadStatusMap(planPath: string): Promise<Map<number, string>> {\n    const statusMap = new Map<number, string>();\n    \n    try {\n        const statusPath = join(planPath, \"STATUS.md\");\n        const content = await readFile(statusPath, \"utf-8\");\n        \n        // Parse the step progress table\n        // Format: | 01 | Step Name | ✅ Completed | ... |\n        // Use line-by-line parsing to avoid polynomial regex\n        const lines = content.split('\\n');\n        let inTable = false;\n        \n        for (const line of lines) {\n            // Look for table header\n            if (/\\|\\s*Step\\s*\\|\\s*Name\\s*\\|\\s*Status/i.test(line)) {\n                inTable = true;\n                continue;\n            }\n            \n            // Stop at section headers or double newlines\n            if (inTable && (/^##/.test(line) || line.trim() === '')) {\n                break;\n            }\n            \n            // Parse table rows\n            if (inTable && line.includes('|')) {\n                const match = line.match(/\\|\\s*(\\d+)\\s*\\|[^|]+\\|\\s*([^|]+)\\|/);\n                if (match) {\n                    const stepNum = parseInt(match[1]);\n                    const status = match[2].trim();\n                    statusMap.set(stepNum, status);\n                }\n            }\n        }\n    } catch {\n        // STATUS.md doesn't exist\n    }\n    \n    return statusMap;\n}\n\n/**\n * Load step files and extract acceptance criteria\n */\nasync function loadStepResults(\n    planPath: string,\n    statusMap: Map<number, string>\n): Promise<StepCompletionResult[]> {\n    const results: StepCompletionResult[] = [];\n    const planDir = join(planPath, \"plan\");\n    \n    try {\n        const files = await readdir(planDir);\n        const stepFiles = files.filter(f => /^\\d{2}-/.test(f) && f.endsWith(\".md\")).sort();\n        \n        for (const file of stepFiles) {\n            const stepNum = parseInt(file.slice(0, 2));\n            const content = await readFile(join(planDir, file), \"utf-8\");\n            \n            const result = analyzeStep(stepNum, content, statusMap.get(stepNum) || \"⬜ Pending\");\n            results.push(result);\n        }\n    } catch {\n        // Plan directory doesn't exist\n    }\n    \n    return results;\n}\n\n/**\n * Analyze a single step for completion\n */\nfunction analyzeStep(\n    stepNum: number,\n    content: string,\n    markedStatus: string\n): StepCompletionResult {\n    const titleMatch = content.match(/^#\\s+(.+)$/m);\n    const stepTitle = titleMatch ? titleMatch[1] : `Step ${stepNum}`;\n    \n    const criteria = extractAcceptanceCriteria(content, stepNum);\n    \n    const status = determineCompletionStatus(criteria, markedStatus);\n    \n    return {\n        stepNumber: stepNum,\n        stepTitle,\n        status,\n        acceptanceCriteria: criteria,\n        markedStatus,\n    };\n}\n\n/**\n * Extract acceptance criteria from step content\n */\nfunction extractAcceptanceCriteria(content: string, stepNum: number): AcceptanceCriterion[] {\n    const criteria: AcceptanceCriterion[] = [];\n    \n    // Find Acceptance Criteria section\n    // Use line-by-line parsing to avoid polynomial regex\n    const lines = content.split('\\n');\n    const sectionLines: string[] = [];\n    let inSection = false;\n    \n    for (const line of lines) {\n        if (/^##\\s*Acceptance\\s+Criteria$/i.test(line)) {\n            inSection = true;\n            continue;\n        }\n        if (inSection && /^##/.test(line)) {\n            break;\n        }\n        if (inSection) {\n            sectionLines.push(line);\n        }\n    }\n    \n    if (sectionLines.length === 0) {\n        return criteria;\n    }\n    \n    const sectionContent = sectionLines.join('\\n');\n    \n    const checkboxRegex = /^[-*]\\s*\\[([x ])\\]\\s*(.+)$/gim;\n    let match;\n    \n    while ((match = checkboxRegex.exec(sectionContent)) !== null) {\n        criteria.push({\n            text: match[2].trim(),\n            checked: match[1].toLowerCase() === \"x\",\n            stepNumber: stepNum,\n        });\n    }\n    \n    return criteria;\n}\n\n/**\n * Determine actual completion status based on criteria and marked status\n */\nfunction determineCompletionStatus(\n    criteria: AcceptanceCriterion[],\n    markedStatus: string\n): StepCompletionStatus {\n    const isMarkedComplete = markedStatus.includes(\"✅\") || markedStatus.toLowerCase().includes(\"complete\");\n    const isMarkedPending = markedStatus.includes(\"⬜\") || markedStatus.toLowerCase().includes(\"pending\");\n    const isMarkedInProgress = markedStatus.includes(\"🔄\") || markedStatus.toLowerCase().includes(\"progress\");\n    const isMarkedSkipped = markedStatus.includes(\"⏭️\") || markedStatus.toLowerCase().includes(\"skip\");\n    \n    if (isMarkedSkipped) {\n        return \"skipped\";\n    }\n    \n    if (criteria.length === 0) {\n        if (isMarkedComplete) return \"complete\";\n        if (isMarkedPending) return \"pending\";\n        return \"partial\";\n    }\n    \n    const checkedCount = criteria.filter(c => c.checked).length;\n    const allChecked = checkedCount === criteria.length;\n    const noneChecked = checkedCount === 0;\n    \n    if (isMarkedComplete) {\n        if (allChecked) return \"complete\";\n        if (noneChecked) return \"incomplete\";\n        return \"partial\";\n    }\n    \n    if (isMarkedInProgress) {\n        return \"partial\";\n    }\n    \n    return \"pending\";\n}\n\n/**\n * Build the completion report\n */\nfunction buildCompletionReport(results: StepCompletionResult[]): CompletionReport {\n    const complete = results.filter(r => r.status === \"complete\");\n    const partial = results.filter(r => r.status === \"partial\");\n    const incomplete = results.filter(r => r.status === \"incomplete\");\n    const pending = results.filter(r => r.status === \"pending\" || r.status === \"skipped\");\n    \n    const totalSteps = results.length;\n    const completedSteps = complete.length + partial.length * 0.5;\n    const completionScore = totalSteps > 0 \n        ? Math.round((completedSteps / totalSteps) * 100) \n        : 100;\n    \n    const outstandingItems: string[] = [];\n    \n    for (const result of [...incomplete, ...partial]) {\n        const unchecked = result.acceptanceCriteria.filter(c => !c.checked);\n        for (const criterion of unchecked) {\n            outstandingItems.push(`Step ${result.stepNumber}: ${criterion.text}`);\n        }\n    }\n    \n    return {\n        totalSteps,\n        complete,\n        partial,\n        incomplete,\n        pending,\n        completionScore,\n        outstandingItems,\n    };\n}\n","/**\n * Verification Engine for RiotPlan\n *\n * Core engine that checks acceptance criteria and enforces completion rules\n * based on configuration settings.\n */\n\nimport { readFile, access } from 'node:fs/promises';\nimport { resolve, dirname } from 'node:path';\nimport type { AcceptanceCriterion } from './types.js';\n\ninterface PlanStep {\n    number: number;\n    filePath: string;\n}\n\ninterface Plan {\n    steps: PlanStep[];\n}\n\n/**\n * Result of verification check\n */\nexport interface VerificationResult {\n    /** Whether verification passed */\n    isValid: boolean;\n    /** Severity level of issues found */\n    level: 'passed' | 'warning' | 'error';\n    /** Human-readable messages about verification results */\n    messages: string[];\n    /** Acceptance criteria that were checked */\n    acceptanceCriteria?: AcceptanceCriterion[];\n    /** Artifacts that were verified */\n    artifacts?: string[];\n}\n\n/**\n * Options for verification\n */\nexport interface VerificationOptions {\n    /** Enforcement level */\n    enforcement: 'advisory' | 'interactive' | 'strict';\n    /** Whether to check acceptance criteria */\n    checkAcceptanceCriteria: boolean;\n    /** Whether to check artifacts */\n    checkArtifacts: boolean;\n    /** Force flag to bypass verification */\n    force?: boolean;\n}\n\n/**\n * Verification engine for step completion\n */\nexport class VerificationEngine {\n    /**\n     * Verify that a step is ready to be marked complete\n     *\n     * @param plan - The plan containing the step\n     * @param stepNumber - The step number to verify\n     * @param options - Verification options\n     * @returns Verification result with details\n     */\n    async verifyStepCompletion(\n        plan: Plan,\n        stepNumber: number,\n        options: VerificationOptions\n    ): Promise<VerificationResult> {\n        const step = plan.steps.find((s) => s.number === stepNumber);\n        if (!step) {\n            return {\n                isValid: false,\n                level: 'error',\n                messages: [`Step ${stepNumber} not found in plan`],\n            };\n        }\n\n        const messages: string[] = [];\n        let level: 'passed' | 'warning' | 'error' = 'passed';\n        let acceptanceCriteria: AcceptanceCriterion[] | undefined;\n        let artifacts: string[] | undefined;\n\n        // Check acceptance criteria if enabled\n        if (options.checkAcceptanceCriteria) {\n            acceptanceCriteria = await this.checkAcceptanceCriteria(step);\n            const unchecked = acceptanceCriteria.filter((c) => !c.checked);\n\n            if (unchecked.length > 0) {\n                level = 'error';\n                messages.push(\n                    `${unchecked.length} acceptance criteria not checked:`\n                );\n                for (const criterion of unchecked) {\n                    messages.push(`  - [ ] ${criterion.text}`);\n                }\n            } else if (acceptanceCriteria.length === 0) {\n                level = 'warning';\n                messages.push('No acceptance criteria found in step file');\n            } else {\n                messages.push(\n                    `✓ All ${acceptanceCriteria.length} acceptance criteria checked`\n                );\n            }\n        }\n\n        // Check artifacts if enabled\n        if (options.checkArtifacts) {\n            artifacts = await this.checkArtifacts(step);\n            if (artifacts.length > 0) {\n                level = level === 'error' ? 'error' : 'warning';\n                messages.push(`${artifacts.length} artifacts not found:`);\n                for (const artifact of artifacts) {\n                    messages.push(`  - ${artifact}`);\n                }\n            }\n        }\n\n        // Determine if verification passed\n        const isValid = level === 'passed' || level === 'warning';\n\n        return {\n            isValid,\n            level,\n            messages,\n            acceptanceCriteria,\n            artifacts,\n        };\n    }\n\n    /**\n     * Check acceptance criteria in step file\n     *\n     * Parses markdown checkboxes from the step file and returns\n     * a list of criteria with their checked status.\n     *\n     * @param step - The step to check\n     * @returns List of acceptance criteria\n     */\n    private async checkAcceptanceCriteria(\n        step: PlanStep\n    ): Promise<AcceptanceCriterion[]> {\n        try {\n            const content = await readFile(step.filePath, 'utf-8');\n            const criteria: AcceptanceCriterion[] = [];\n\n            // Find the Acceptance Criteria section\n            const sectionMatch = content.match(\n                /##\\s+Acceptance Criteria\\s*\\n([\\s\\S]*?)(?=\\n##|$)/i\n            );\n\n            if (!sectionMatch) {\n                return criteria;\n            }\n\n            const section = sectionMatch[1];\n\n            // Parse markdown checkboxes: - [x] completed, - [ ] pending\n            const checkboxRegex = /^\\s*-\\s*\\[([ xX])\\]\\s*(.+)$/gm;\n            let match;\n\n            while ((match = checkboxRegex.exec(section)) !== null) {\n                criteria.push({\n                    text: match[2].trim(),\n                    checked: match[1].toLowerCase() === 'x',\n                    stepNumber: step.number,\n                });\n            }\n\n            return criteria;\n        } catch {\n            // If we can't read the file, return empty array\n            return [];\n        }\n    }\n\n    /**\n     * Check that artifacts mentioned in step file exist\n     *\n     * Parses the \"Files Changed\" section and verifies files exist.\n     *\n     * @param step - The step to check\n     * @returns List of missing artifacts\n     */\n    private async checkArtifacts(step: PlanStep): Promise<string[]> {\n        try {\n            const content = await readFile(step.filePath, 'utf-8');\n            const missing: string[] = [];\n\n            // Find the \"Files Changed\" section\n            const sectionMatch = content.match(\n                /##\\s+Files Changed\\s*\\n([\\s\\S]*?)(?=\\n##|$)/i\n            );\n\n            if (!sectionMatch) {\n                return missing;\n            }\n\n            const section = sectionMatch[1];\n\n            // Extract file paths from list items\n            // Matches: - path/to/file.ts or - `path/to/file.ts`\n            const fileRegex = /^\\s*-\\s+`?([^\\s`]+\\.[a-zA-Z0-9]+)`?/gm;\n            let match;\n\n            while ((match = fileRegex.exec(section)) !== null) {\n                const filePath = match[1].trim();\n                \n                // Resolve path relative to plan directory (go up from plan/ to root)\n                const planRoot = resolve(dirname(step.filePath), '../..');\n                const fullPath = resolve(planRoot, filePath);\n\n                try {\n                    await access(fullPath);\n                } catch {\n                    missing.push(filePath);\n                }\n            }\n\n            return missing;\n        } catch {\n            // If we can't read the file, return empty array\n            return [];\n        }\n    }\n\n    /**\n     * Determine if verification failure should block completion\n     *\n     * @param result - The verification result\n     * @param options - Verification options\n     * @returns True if completion should be blocked\n     */\n    shouldBlock(\n        result: VerificationResult,\n        options: VerificationOptions\n    ): boolean {\n        // Force flag always bypasses\n        if (options.force) {\n            return false;\n        }\n\n        // Advisory mode never blocks\n        if (options.enforcement === 'advisory') {\n            return false;\n        }\n\n        // Strict mode blocks on any error\n        if (options.enforcement === 'strict' && result.level === 'error') {\n            return true;\n        }\n\n        // Interactive mode doesn't block - caller handles prompting\n        return false;\n    }\n}\n","/**\n * Custom error types for verification failures\n */\n\nimport type { VerificationResult } from './engine.js';\nimport type { AcceptanceCriterion } from './types.js';\n\n/**\n * Base error for verification failures\n */\nexport class VerificationError extends Error {\n    constructor(\n        message: string,\n        public details: VerificationResult\n    ) {\n        super(message);\n        this.name = 'VerificationError';\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n\n/**\n * Error thrown when acceptance criteria are not met\n */\nexport class AcceptanceCriteriaError extends VerificationError {\n    constructor(uncheckedCriteria: AcceptanceCriterion[]) {\n        const message = `Step has ${uncheckedCriteria.length} unchecked acceptance criteria`;\n        const details: VerificationResult = {\n            isValid: false,\n            level: 'error',\n            messages: [\n                message,\n                ...uncheckedCriteria.map((c) => `  - [ ] ${c.text}`),\n            ],\n            acceptanceCriteria: uncheckedCriteria,\n        };\n        super(message, details);\n        this.name = 'AcceptanceCriteriaError';\n    }\n}\n\n/**\n * Error thrown when required artifacts are missing\n */\nexport class ArtifactVerificationError extends VerificationError {\n    constructor(missingArtifacts: string[]) {\n        const message = `Step has ${missingArtifacts.length} missing artifacts`;\n        const details: VerificationResult = {\n            isValid: false,\n            level: 'error',\n            messages: [\n                message,\n                ...missingArtifacts.map((a) => `  - ${a}`),\n            ],\n            artifacts: missingArtifacts,\n        };\n        super(message, details);\n        this.name = 'ArtifactVerificationError';\n    }\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@kjerneverk/riotplan-verify",
+  "version": "1.0.0-dev.0",
+  "description": "Step verification and coverage checking for RiotPlan",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run lint && vite build",
+    "test": "npm run test:coverage",
+    "test:coverage": "vitest run --coverage",
+    "test:debug": "vitest --run --coverage --reporter verbose",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "precommit": "npm run build && npm run lint && npm run test",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": ["riotplan", "verification", "coverage", "acceptance-criteria"],
+  "author": "Tim O'Brien <tobrien@discursive.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kjerneverk/riotplan-verify"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.28.0",
+    "@types/node": "^24.10.9",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.28.0",
+    "eslint-plugin-import": "^2.31.0",
+    "globals": "^17.0.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.0.4",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.17"
+  }
+}