@planu/cli 0.43.1 → 0.45.0

package/dist/engine/living-spec/drift-watcher.js

@@ -0,0 +1,126 @@
+// engine/living-spec/drift-watcher.ts — AC-6: In-memory drift state cache
+// Provides a configurable TTL cache for drift detection results.
+const DEFAULT_TTL_SECONDS = 60;
+/**
+ * Simple glob-to-regex converter for exclude patterns.
+ * Supports *, **, and ? wildcards without external deps.
+ */
+export function globToRegex(pattern) {
+    let regex = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const ch = pattern.charAt(i);
+        if (ch === '*') {
+            const next = i + 1 < pattern.length ? pattern.charAt(i + 1) : '';
+            if (next === '*') {
+                regex += '.*';
+                i += 2;
+                if (i < pattern.length && pattern.charAt(i) === '/') {
+                    i++;
+                }
+                continue;
+            }
+            regex += '[^/]*';
+        }
+        else if (ch === '?') {
+            regex += '[^/]';
+        }
+        else if ('.+^${}()|[]\\'.includes(ch)) {
+            regex += `\\${ch}`;
+        }
+        else {
+            regex += ch;
+        }
+        i++;
+    }
+    return new RegExp(`^${regex}$`);
+}
+/**
+ * Check if a file path matches any exclude pattern.
+ */
+export function matchesExcludePattern(filePath, patterns) {
+    return patterns.some((p) => globToRegex(p).test(filePath));
+}
+/**
+ * Create a drift watcher with in-memory caching and configurable TTL.
+ */
+export function createDriftWatcher(options) {
+    const ttlSeconds = options.ttlSeconds ?? DEFAULT_TTL_SECONDS;
+    const excludePatterns = options.excludePatterns ?? [];
+    const cache = new Map();
+    let running = false;
+    let startedAt = null;
+    function isExpired(entry) {
+        return new Date(entry.expiresAt).getTime() < Date.now();
+    }
+    return {
+        start() {
+            if (running) {
+                return;
+            }
+            running = true;
+            startedAt = new Date().toISOString();
+        },
+        stop() {
+            running = false;
+            startedAt = null;
+            cache.clear();
+        },
+        status() {
+            for (const [key, entry] of cache) {
+                if (isExpired(entry)) {
+                    cache.delete(key);
+                }
+            }
+            return {
+                running,
+                startedAt,
+                cacheSize: cache.size,
+                projectId: options.projectId,
+            };
+        },
+        invalidate(specId) {
+            if (specId) {
+                cache.delete(specId);
+            }
+            else {
+                cache.clear();
+            }
+        },
+        getCachedDrift(specId) {
+            const entry = cache.get(specId);
+            if (!entry) {
+                return null;
+            }
+            if (isExpired(entry)) {
+                cache.delete(specId);
+                return null;
+            }
+            if (excludePatterns.length > 0) {
+                const filtered = {
+                    ...entry,
+                    data: {
+                        ...entry.data,
+                        changedFiles: entry.data.changedFiles.filter((f) => !matchesExcludePattern(f.file, excludePatterns)),
+                    },
+                };
+                return filtered;
+            }
+            return entry;
+        },
+        setCachedDrift(specId, data) {
+            if (!running) {
+                return;
+            }
+            const now = new Date();
+            const expiresAt = new Date(now.getTime() + ttlSeconds * 1000).toISOString();
+            cache.set(specId, {
+                specId,
+                data,
+                cachedAt: now.toISOString(),
+                expiresAt,
+            });
+        },
+    };
+}
+//# sourceMappingURL=drift-watcher.js.map

package/dist/engine/living-spec/drift-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-watcher.js","sourceRoot":"","sources":["../../../src/engine/living-spec/drift-watcher.ts"],"names":[],"mappings":"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"}

package/dist/engine/living-spec/hash-tracker.d.ts

@@ -0,0 +1,24 @@
+import type { FileHashEntry, FileHashDiff, SpecHashSnapshot } from '../../types/index.js';
+/**
+ * Compute SHA-256 hash of a file's content.
+ */
+export declare function computeFileHash(filePath: string): Promise<string>;
+/**
+ * Create a hash entry for a single file.
+ */
+export declare function createFileHashEntry(projectPath: string, relativePath: string): Promise<FileHashEntry | null>;
+/**
+ * Create hash entries for multiple files.
+ */
+export declare function createFileHashEntries(projectPath: string, relativePaths: string[]): Promise<FileHashEntry[]>;
+/**
+ * Compare current file hashes against a stored snapshot.
+ * Returns a list of changed, added, and removed files.
+ */
+export declare function diffFileHashes(projectPath: string, previousSnapshot: SpecHashSnapshot, currentFiles: string[]): Promise<FileHashDiff[]>;
+/**
+ * Extract file paths from a technical.md File Plan section.
+ * Looks for markdown table rows or list items with file path patterns.
+ */
+export declare function extractFilePlanPaths(technicalContent: string): string[];
+//# sourceMappingURL=hash-tracker.d.ts.map

package/dist/engine/living-spec/hash-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-tracker.d.ts","sourceRoot":"","sources":["../../../src/engine/living-spec/hash-tracker.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAc/B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CAS1B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAgDzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BvE"}

package/dist/engine/living-spec/hash-tracker.js

@@ -0,0 +1,123 @@
+// engine/living-spec/hash-tracker.ts — File hash tracking for spec drift detection
+// Stores SHA-256 hashes of files referenced in spec's technical.md File Plan section.
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Compute SHA-256 hash of a file's content.
+ */
+export async function computeFileHash(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Create a hash entry for a single file.
+ */
+export async function createFileHashEntry(projectPath, relativePath) {
+    const fullPath = join(projectPath, relativePath);
+    try {
+        const hash = await computeFileHash(fullPath);
+        const fileStat = await stat(fullPath);
+        return {
+            file: relativePath,
+            hash,
+            size: fileStat.size,
+            snapshotAt: new Date().toISOString(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create hash entries for multiple files.
+ */
+export async function createFileHashEntries(projectPath, relativePaths) {
+    const entries = [];
+    for (const relativePath of relativePaths) {
+        const entry = await createFileHashEntry(projectPath, relativePath);
+        if (entry) {
+            entries.push(entry);
+        }
+    }
+    return entries;
+}
+/**
+ * Compare current file hashes against a stored snapshot.
+ * Returns a list of changed, added, and removed files.
+ */
+export async function diffFileHashes(projectPath, previousSnapshot, currentFiles) {
+    const diffs = [];
+    const previousMap = new Map();
+    for (const entry of previousSnapshot.files) {
+        previousMap.set(entry.file, entry.hash);
+    }
+    const currentSet = new Set(currentFiles);
+    // Check current files against previous
+    for (const file of currentFiles) {
+        const previousHash = previousMap.get(file) ?? '';
+        try {
+            const currentHash = await computeFileHash(join(projectPath, file));
+            if (currentHash !== previousHash) {
+                diffs.push({
+                    file,
+                    previousHash,
+                    currentHash,
+                    linkedCriteria: [],
+                });
+            }
+        }
+        catch {
+            // File unreadable — treat as changed if it had a previous hash
+            if (previousHash) {
+                diffs.push({
+                    file,
+                    previousHash,
+                    currentHash: '',
+                    linkedCriteria: [],
+                });
+            }
+        }
+    }
+    // Check for removed files (in previous but not in current)
+    for (const [file, hash] of previousMap) {
+        if (!currentSet.has(file)) {
+            diffs.push({
+                file,
+                previousHash: hash,
+                currentHash: '',
+                linkedCriteria: [],
+            });
+        }
+    }
+    return diffs;
+}
+/**
+ * Extract file paths from a technical.md File Plan section.
+ * Looks for markdown table rows or list items with file path patterns.
+ */
+export function extractFilePlanPaths(technicalContent) {
+    const paths = [];
+    const seen = new Set();
+    // Match paths in table cells: | src/foo/bar.ts | or | `src/foo/bar.ts` |
+    const tablePattern = /\|\s*`?([a-zA-Z][\w/.\\-]+\.\w{1,10})`?\s*\|/g;
+    let match;
+    while ((match = tablePattern.exec(technicalContent)) !== null) {
+        const path = match[1];
+        if (path && !seen.has(path)) {
+            seen.add(path);
+            paths.push(path);
+        }
+    }
+    // Match paths in list items: - src/foo/bar.ts or - `src/foo/bar.ts`
+    const listPattern = /[-*]\s+`?([a-zA-Z][\w/.\\-]+\.\w{1,10})`?/g;
+    while ((match = listPattern.exec(technicalContent)) !== null) {
+        const path = match[1];
+        if (path && !seen.has(path)) {
+            seen.add(path);
+            paths.push(path);
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=hash-tracker.js.map

package/dist/engine/living-spec/hash-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-tracker.js","sourceRoot":"","sources":["../../../src/engine/living-spec/hash-tracker.ts"],"names":[],"mappings":"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"}

package/dist/engine/living-spec/index.d.ts

@@ -0,0 +1,9 @@
+export { parseAnnotationLine, parseCriteriaList, parseAnnotationsFromContent, parseAnnotationsFromProject, } from './annotation-parser.js';
+export { computeFileHash, createFileHashEntry, createFileHashEntries, diffFileHashes, extractFilePlanPaths, } from './hash-tracker.js';
+export { extractSignaturesFromContent, extractSignaturesFromFile, extractSignaturesFromFiles, diffSignatures, } from './signature-tracker.js';
+export { isRateLimited, recordReconcile, clearRateLimit, classifyChange, createLogEntry, buildAutoReconcileResult, } from './auto-reconciler.js';
+export { createDriftWatcher, globToRegex, matchesExcludePattern } from './drift-watcher.js';
+export { collectSpecEntries, collectSummary, collectTrends, buildSpecDiffRows, formatMarkdownDiff, } from './dashboard-collector.js';
+export { parseVitestJson, parseJUnitXml, groupByAnnotation, determineCriterionStatus, buildCoverageReport, } from './test-coverage-correlator.js';
+export { generateTodoComments, generateProgressUpdates, detectConflicts, createSyncLogEntry, buildSpecToCodeResult, buildCodeToSpecResult, } from './bidirectional-sync.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/living-spec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/living-spec/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/engine/living-spec/index.js

@@ -0,0 +1,10 @@
+// engine/living-spec/ — Barrel export for living spec engine modules
+export { parseAnnotationLine, parseCriteriaList, parseAnnotationsFromContent, parseAnnotationsFromProject, } from './annotation-parser.js';
+export { computeFileHash, createFileHashEntry, createFileHashEntries, diffFileHashes, extractFilePlanPaths, } from './hash-tracker.js';
+export { extractSignaturesFromContent, extractSignaturesFromFile, extractSignaturesFromFiles, diffSignatures, } from './signature-tracker.js';
+export { isRateLimited, recordReconcile, clearRateLimit, classifyChange, createLogEntry, buildAutoReconcileResult, } from './auto-reconciler.js';
+export { createDriftWatcher, globToRegex, matchesExcludePattern } from './drift-watcher.js';
+export { collectSpecEntries, collectSummary, collectTrends, buildSpecDiffRows, formatMarkdownDiff, } from './dashboard-collector.js';
+export { parseVitestJson, parseJUnitXml, groupByAnnotation, determineCriterionStatus, buildCoverageReport, } from './test-coverage-correlator.js';
+export { generateTodoComments, generateProgressUpdates, detectConflicts, createSyncLogEntry, buildSpecToCodeResult, buildCodeToSpecResult, } from './bidirectional-sync.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/living-spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/living-spec/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/engine/living-spec/signature-tracker.d.ts

@@ -0,0 +1,18 @@
+import type { FunctionSignature, SignatureChange } from '../../types/index.js';
+/**
+ * Extract exported function signatures from a TypeScript file content.
+ */
+export declare function extractSignaturesFromContent(content: string, file: string): FunctionSignature[];
+/**
+ * Extract exported function signatures from a file on disk.
+ */
+export declare function extractSignaturesFromFile(projectPath: string, relativePath: string): Promise<FunctionSignature[]>;
+/**
+ * Extract signatures from multiple files.
+ */
+export declare function extractSignaturesFromFiles(projectPath: string, relativePaths: string[]): Promise<FunctionSignature[]>;
+/**
+ * Compare two sets of signatures to find added, modified, and removed.
+ */
+export declare function diffSignatures(previous: FunctionSignature[], current: FunctionSignature[]): SignatureChange[];
+//# sourceMappingURL=signature-tracker.d.ts.map

package/dist/engine/living-spec/signature-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-tracker.d.ts","sourceRoot":"","sources":["../../../src/engine/living-spec/signature-tracker.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAe/E;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,iBAAiB,EAAE,CA8BrB;AASD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO9B;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,EAAE,iBAAiB,EAAE,GAC3B,eAAe,EAAE,CA+CnB"}

package/dist/engine/living-spec/signature-tracker.js

@@ -0,0 +1,136 @@
+// engine/living-spec/signature-tracker.ts — Extract and track exported function signatures
+// AST-free: uses regex-based extraction from TypeScript source files.
+// Supports: export function, export const arrow, export async function, export default
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Regex patterns for exported function signatures in TypeScript.
+ * Each pattern captures: name, params, returnType
+ */
+const EXPORT_PATTERNS = [
+    // export function foo(params): ReturnType
+    /^export\s+(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)\s*:\s*([^{]+)/,
+    // export const foo = (params): ReturnType =>
+    /^export\s+const\s+(\w+)\s*=\s*(?:async\s+)?\(([^)]*)\)\s*:\s*([^=>{]+)/,
+    // export default function foo(params): ReturnType
+    /^export\s+default\s+(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)\s*:\s*([^{]+)/,
+];
+/**
+ * Extract exported function signatures from a TypeScript file content.
+ */
+export function extractSignaturesFromContent(content, file) {
+    const signatures = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined) {
+            continue;
+        }
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('export')) {
+            continue;
+        }
+        for (const pattern of EXPORT_PATTERNS) {
+            const match = pattern.exec(trimmed);
+            if (match?.[1]) {
+                signatures.push({
+                    name: match[1],
+                    params: normalizeWhitespace(match[2] ?? ''),
+                    returnType: normalizeWhitespace(match[3] ?? 'unknown'),
+                    file,
+                    line: i + 1,
+                });
+                break;
+            }
+        }
+    }
+    return signatures;
+}
+/**
+ * Normalize whitespace in type strings for consistent comparison.
+ */
+function normalizeWhitespace(str) {
+    return str.trim().replace(/\s+/g, ' ');
+}
+/**
+ * Extract exported function signatures from a file on disk.
+ */
+export async function extractSignaturesFromFile(projectPath, relativePath) {
+    try {
+        const content = await readFile(join(projectPath, relativePath), 'utf-8');
+        return extractSignaturesFromContent(content, relativePath);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract signatures from multiple files.
+ */
+export async function extractSignaturesFromFiles(projectPath, relativePaths) {
+    const all = [];
+    for (const path of relativePaths) {
+        // Only process TypeScript/JavaScript files
+        if (/\.[tj]sx?$/.test(path)) {
+            const sigs = await extractSignaturesFromFile(projectPath, path);
+            all.push(...sigs);
+        }
+    }
+    return all;
+}
+/**
+ * Compare two sets of signatures to find added, modified, and removed.
+ */
+export function diffSignatures(previous, current) {
+    const changes = [];
+    const prevMap = new Map();
+    for (const sig of previous) {
+        prevMap.set(`${sig.file}::${sig.name}`, sig);
+    }
+    const currMap = new Map();
+    for (const sig of current) {
+        currMap.set(`${sig.file}::${sig.name}`, sig);
+    }
+    // Check for added and modified
+    for (const [key, curr] of currMap) {
+        const prev = prevMap.get(key);
+        if (!prev) {
+            changes.push({
+                name: curr.name,
+                file: curr.file,
+                changeType: 'added',
+                before: '',
+                after: formatSignature(curr),
+            });
+        }
+        else if (prev.params !== curr.params || prev.returnType !== curr.returnType) {
+            changes.push({
+                name: curr.name,
+                file: curr.file,
+                changeType: 'modified',
+                before: formatSignature(prev),
+                after: formatSignature(curr),
+            });
+        }
+    }
+    // Check for removed
+    for (const [key, prev] of prevMap) {
+        if (!currMap.has(key)) {
+            changes.push({
+                name: prev.name,
+                file: prev.file,
+                changeType: 'removed',
+                before: formatSignature(prev),
+                after: '',
+            });
+        }
+    }
+    return changes;
+}
+/**
+ * Format a signature as a human-readable string.
+ */
+function formatSignature(sig) {
+    return `${sig.name}(${sig.params}): ${sig.returnType}`;
+}
+//# sourceMappingURL=signature-tracker.js.map

package/dist/engine/living-spec/signature-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-tracker.js","sourceRoot":"","sources":["../../../src/engine/living-spec/signature-tracker.ts"],"names":[],"mappings":"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"}

package/dist/engine/living-spec/test-coverage-correlator.d.ts

@@ -0,0 +1,22 @@
+import type { AnnotationCoverageGroup, LivingSpecCoverageReport, CriterionCoverageStatus, SpecAnnotation, VitestFileResult, JUnitTestCase, NormalizedTestResult } from '../../types/index.js';
+/**
+ * Parse a Vitest JSON report string into structured results.
+ */
+export declare function parseVitestJson(json: string): VitestFileResult[];
+/**
+ * Parse JUnit XML string into test cases (simple regex-based parser).
+ */
+export declare function parseJUnitXml(xml: string): JUnitTestCase[];
+/**
+ * Group test results by spec annotation, matching test file paths to annotations.
+ */
+export declare function groupByAnnotation(tests: NormalizedTestResult[], annotations: SpecAnnotation[]): AnnotationCoverageGroup[];
+/**
+ * Determine criterion status based on test results.
+ */
+export declare function determineCriterionStatus(group: AnnotationCoverageGroup): CriterionCoverageStatus;
+/**
+ * Build a full test coverage report from grouped results.
+ */
+export declare function buildCoverageReport(projectId: string, groups: AnnotationCoverageGroup[], totalTests: number, passedTests: number, failedTests: number): LivingSpecCoverageReport;
+//# sourceMappingURL=test-coverage-correlator.d.ts.map

package/dist/engine/living-spec/test-coverage-correlator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-coverage-correlator.d.ts","sourceRoot":"","sources":["../../../src/engine/living-spec/test-coverage-correlator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACb,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAM9B;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAGhE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAkB1D;AAYD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,oBAAoB,EAAE,EAC7B,WAAW,EAAE,cAAc,EAAE,GAC5B,uBAAuB,EAAE,CA+C3B;AAsBD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,uBAAuB,CAQhG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,uBAAuB,EAAE,EACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,wBAAwB,CAe1B"}

package/dist/engine/living-spec/test-coverage-correlator.js

@@ -0,0 +1,130 @@
+// engine/living-spec/test-coverage-correlator.ts — AC-8: Test coverage correlation
+// Parses Vitest JSON and JUnit XML outputs, groups by spec/criteria annotations,
+// determines criterion status, and builds coverage reports.
+// ---------------------------------------------------------------------------
+// Vitest JSON parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a Vitest JSON report string into structured results.
+ */
+export function parseVitestJson(json) {
+    const report = JSON.parse(json);
+    return report.testResults ?? [];
+}
+// ---------------------------------------------------------------------------
+// JUnit XML parsing (simple, no external deps)
+// ---------------------------------------------------------------------------
+/**
+ * Parse JUnit XML string into test cases (simple regex-based parser).
+ */
+export function parseJUnitXml(xml) {
+    const cases = [];
+    const testCaseRegex = /<testcase\s+([^>]*)>([\s\S]*?)<\/testcase>|<testcase\s+([^>]*)\/>/g;
+    let match;
+    while ((match = testCaseRegex.exec(xml)) !== null) {
+        const attrs = match[1] ?? match[3] ?? '';
+        const body = match[2] ?? '';
+        const name = extractAttr(attrs, 'name') ?? 'unknown';
+        const classname = extractAttr(attrs, 'classname') ?? '';
+        const file = extractAttr(attrs, 'file') ?? classname;
+        const hasFailure = body.includes('<failure') || body.includes('<error');
+        cases.push({ name, classname, file, passed: !hasFailure });
+    }
+    return cases;
+}
+function extractAttr(attrs, name) {
+    const regex = new RegExp(`${name}="([^"]*)"`, 'i');
+    const match = regex.exec(attrs);
+    return match?.[1] ?? null;
+}
+// ---------------------------------------------------------------------------
+// Annotation grouping
+// ---------------------------------------------------------------------------
+/**
+ * Group test results by spec annotation, matching test file paths to annotations.
+ */
+export function groupByAnnotation(tests, annotations) {
+    const fileAnnotations = new Map();
+    for (const ann of annotations) {
+        const existing = fileAnnotations.get(ann.file) ?? [];
+        existing.push(ann);
+        fileAnnotations.set(ann.file, existing);
+    }
+    const groupMap = new Map();
+    for (const test of tests) {
+        const matchedAnnotations = findMatchingAnnotations(test.file, fileAnnotations);
+        for (const ann of matchedAnnotations) {
+            for (const criterion of ann.criteria) {
+                const key = `${ann.specId}:AC-${criterion}`;
+                const group = groupMap.get(key) ?? {
+                    specId: ann.specId,
+                    criterion,
+                    status: 'untested',
+                    testCount: 0,
+                    passCount: 0,
+                    failCount: 0,
+                    files: [],
+                };
+                group.testCount++;
+                if (test.passed) {
+                    group.passCount++;
+                }
+                else {
+                    group.failCount++;
+                }
+                if (!group.files.includes(test.file)) {
+                    group.files.push(test.file);
+                }
+                groupMap.set(key, group);
+            }
+        }
+    }
+    for (const group of groupMap.values()) {
+        group.status = determineCriterionStatus(group);
+    }
+    return Array.from(groupMap.values());
+}
+/**
+ * Find annotations matching a test file path.
+ */
+function findMatchingAnnotations(testFile, fileAnnotations) {
+    const results = [];
+    for (const [annotatedFile, anns] of fileAnnotations) {
+        if (testFile === annotatedFile ||
+            testFile.includes(annotatedFile) ||
+            annotatedFile.includes(testFile)) {
+            results.push(...anns);
+        }
+    }
+    return results;
+}
+/**
+ * Determine criterion status based on test results.
+ */
+export function determineCriterionStatus(group) {
+    if (group.testCount === 0) {
+        return 'untested';
+    }
+    if (group.failCount > 0) {
+        return 'regression';
+    }
+    return 'verified';
+}
+/**
+ * Build a full test coverage report from grouped results.
+ */
+export function buildCoverageReport(projectId, groups, totalTests, passedTests, failedTests) {
+    const coveredCriteria = groups.filter((g) => g.status !== 'untested').length;
+    const totalCriteria = groups.length;
+    const coveragePercentage = totalCriteria > 0 ? Math.round((coveredCriteria / totalCriteria) * 100) : 0;
+    return {
+        projectId,
+        groups,
+        totalTests,
+        passedTests,
+        failedTests,
+        coveragePercentage,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=test-coverage-correlator.js.map