@planu/cli 1.11.0 → 1.13.0

package/dist/engine/critical-path/path-analyzer.js

@@ -0,0 +1,145 @@
+// engine/critical-path/path-analyzer.ts — SPEC-405
+// Build a dependency graph from spec frontmatter and compute the critical path.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { parseFrontmatter } from '../frontmatter-parser.js';
+// ---------------------------------------------------------------------------
+// File reading helpers
+// ---------------------------------------------------------------------------
+async function readAllSpecMeta(projectPath) {
+    const pattern = join(projectPath, 'planu', 'specs', '*', 'spec.md');
+    const files = await glob(pattern, { nodir: true });
+    const results = [];
+    await Promise.all(files.map(async (filePath) => {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const { metadata } = parseFrontmatter(content);
+            const id = typeof metadata.id === 'string' ? metadata.id : '';
+            if (!id) {
+                return;
+            }
+            const estimatedHours = typeof metadata.estimatedHours === 'number' ? metadata.estimatedHours : 0;
+            const rawDeps = metadata.dependencies;
+            const dependencies = Array.isArray(rawDeps)
+                ? rawDeps.filter((d) => typeof d === 'string')
+                : [];
+            const status = typeof metadata.status === 'string' ? metadata.status : 'pending';
+            results.push({ id, estimatedHours, dependencies, status });
+        }
+        catch {
+            // skip unreadable files
+        }
+    }));
+    return results;
+}
+// ---------------------------------------------------------------------------
+// DAG critical path (longest path in hours)
+// ---------------------------------------------------------------------------
+/**
+ * Compute the longest-duration path through the spec dependency DAG.
+ * Uses memoized DFS. Returns the spec IDs in topological order.
+ */
+function longestPath(specId, adjacency, hours, memo) {
+    const cached = memo.get(specId);
+    if (cached) {
+        return cached;
+    }
+    const children = adjacency.get(specId) ?? [];
+    let best = {
+        length: hours.get(specId) ?? 0,
+        path: [specId],
+    };
+    for (const child of children) {
+        const sub = longestPath(child, adjacency, hours, memo);
+        const total = (hours.get(specId) ?? 0) + sub.length;
+        if (total > best.length) {
+            best = { length: total, path: [specId, ...sub.path] };
+        }
+    }
+    memo.set(specId, best);
+    return best;
+}
+/**
+ * Count how many specs depend on each spec (in-degree of reverse graph).
+ */
+function countDependents(specs) {
+    const count = new Map();
+    for (const spec of specs) {
+        if (!count.has(spec.id)) {
+            count.set(spec.id, 0);
+        }
+        for (const dep of spec.dependencies) {
+            count.set(dep, (count.get(dep) ?? 0) + 1);
+        }
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Public function
+// ---------------------------------------------------------------------------
+export async function analyzeCriticalPath(projectPath) {
+    const specs = await readAllSpecMeta(projectPath);
+    if (specs.length === 0) {
+        return { criticalPath: [], totalHours: 0, parallelizableSpecs: [], bottlenecks: [] };
+    }
+    // Build adjacency list (spec → its dependents, i.e. specs that depend on it)
+    const adjacency = new Map();
+    const hours = new Map();
+    const allIds = new Set(specs.map((s) => s.id));
+    for (const spec of specs) {
+        hours.set(spec.id, spec.estimatedHours);
+        if (!adjacency.has(spec.id)) {
+            adjacency.set(spec.id, []);
+        }
+        for (const dep of spec.dependencies) {
+            if (allIds.has(dep)) {
+                const list = adjacency.get(dep) ?? [];
+                list.push(spec.id);
+                adjacency.set(dep, list);
+            }
+        }
+    }
+    // Find root nodes (no dependencies pointing to them from known specs)
+    const hasIncoming = new Set();
+    for (const spec of specs) {
+        for (const dep of spec.dependencies) {
+            if (allIds.has(dep)) {
+                hasIncoming.add(spec.id);
+            }
+        }
+    }
+    const roots = specs.filter((s) => !hasIncoming.has(s.id));
+    // Compute longest path from each root
+    const memo = new Map();
+    let bestPath = [];
+    let bestLength = 0;
+    for (const root of roots) {
+        const result = longestPath(root.id, adjacency, hours, memo);
+        if (result.length > bestLength) {
+            bestLength = result.length;
+            bestPath = result.path;
+        }
+    }
+    const totalHours = specs.reduce((acc, s) => acc + s.estimatedHours, 0);
+    // Parallelizable: specs NOT on the critical path
+    const criticalSet = new Set(bestPath);
+    const parallelizableSpecs = specs
+        .filter((s) => !criticalSet.has(s.id))
+        .map((s) => s.id)
+        .slice(0, 20);
+    // Bottlenecks: top 3 specs with most dependents
+    const dependentCount = countDependents(specs);
+    const bottlenecks = [...dependentCount.entries()]
+        .filter(([, count]) => count > 0)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 3)
+        .map(([id]) => id);
+    return {
+        criticalPath: bestPath,
+        totalHours,
+        parallelizableSpecs,
+        bottlenecks,
+    };
+}
+//# sourceMappingURL=path-analyzer.js.map

package/dist/engine/critical-path/path-analyzer.js.map

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

package/dist/engine/drift/violation-resolver.d.ts

@@ -0,0 +1,9 @@
+import type { DriftResolutionResult } from '../../types/health.js';
+/**
+ * Resolves drift violations semi-automatically by inspecting cached drift
+ * entries and taking action based on the spec's current status.
+ *
+ * When dryRun=true, returns the planned resolutions without writing any files.
+ */
+export declare function resolveDriftViolations(projectPath: string, projectId: string, dryRun?: boolean): Promise<DriftResolutionResult>;
+//# sourceMappingURL=violation-resolver.d.ts.map

package/dist/engine/drift/violation-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/drift/violation-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,uBAAuB,CAAC;AAwFlF;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,UAAQ,GACb,OAAO,CAAC,qBAAqB,CAAC,CA+DhC"}

package/dist/engine/drift/violation-resolver.js

@@ -0,0 +1,128 @@
+// engine/drift/violation-resolver.ts — Semi-automatic drift violation resolution (SPEC-408)
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { specStore } from '../../storage/index.js';
+import { DriftCacheStore } from '../../storage/drift-cache-store.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function specDirExists(specDir) {
+    try {
+        await access(specDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function createFollowUpSpec(projectPath, parentSpecId, reason, dryRun) {
+    const timestamp = Date.now();
+    const specId = `SPEC-followup-${parentSpecId.toLowerCase()}-${timestamp}`;
+    if (!dryRun) {
+        const specDir = join(projectPath, 'planu', 'specs', specId);
+        await mkdir(specDir, { recursive: true });
+        const now = new Date().toISOString();
+        const specContent = [
+            '---',
+            `id: ${specId}`,
+            `title: "Follow-up: ${parentSpecId} drift resolution"`,
+            `status: draft`,
+            `tags: [drift, follow-up, auto-generated]`,
+            `createdAt: ${now}`,
+            '---',
+            '',
+            `# Follow-up for ${parentSpecId}`,
+            '',
+            reason,
+            '',
+            '## Acceptance Criteria',
+            '',
+            `- [ ] Review all criteria from ${parentSpecId} against current implementation`,
+            '- [ ] Update spec or implementation to re-align',
+            '- [ ] Run detect_drift to confirm score returns to 0',
+            '',
+        ].join('\n');
+        await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
+        await writeFile(join(specDir, 'progress.md'), `# ${specId} — Progress\n\nstatus: draft\n`, 'utf-8');
+    }
+    return specId;
+}
+// ---------------------------------------------------------------------------
+// Violation handlers per status
+// ---------------------------------------------------------------------------
+function buildDoneButDivergedResolution(specId) {
+    return {
+        specId,
+        action: 'follow-up-spec-queued',
+        description: 'Spec is done but code has diverged — follow-up spec created to track delta',
+    };
+}
+function buildInProgressAheadResolution(specId) {
+    return {
+        specId,
+        action: 'spec-note-added',
+        description: 'Spec is in-progress and code is ahead — criteria note added to flag untracked work',
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolves drift violations semi-automatically by inspecting cached drift
+ * entries and taking action based on the spec's current status.
+ *
+ * When dryRun=true, returns the planned resolutions without writing any files.
+ */
+export async function resolveDriftViolations(projectPath, projectId, dryRun = false) {
+    const cacheStore = new DriftCacheStore(projectId);
+    const cacheData = await cacheStore.load();
+    const cachedEntries = Object.values(cacheData.entries);
+    const specs = await specStore.listSpecs(projectId);
+    const specMap = new Map(specs.map((s) => [s.id, s]));
+    const resolved = [];
+    const followUpSpecsCreated = [];
+    const manualReview = [];
+    for (const entry of cachedEntries) {
+        const spec = specMap.get(entry.specId);
+        if (!spec) {
+            manualReview.push(`${entry.specId}: spec no longer exists — remove orphaned drift cache`);
+            continue;
+        }
+        if (spec.status === 'done') {
+            // Code diverged from a completed spec — create follow-up
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            const reason = `Drift detected (score: ${entry.driftScore.toFixed(2)}) in files: ${(entry.driftedFiles ?? []).join(', ') || 'unknown'}`;
+            const followUpId = await createFollowUpSpec(projectPath, spec.id, reason, dryRun);
+            followUpSpecsCreated.push(followUpId);
+            resolved.push(buildDoneButDivergedResolution(spec.id));
+        }
+        else if (spec.status === 'implementing') {
+            // In-progress spec with code ahead — annotate but don't block
+            resolved.push(buildInProgressAheadResolution(spec.id));
+        }
+        else if (spec.status === 'draft') {
+            // Draft spec but code already exists — flag for human review
+            manualReview.push(`${spec.id}: spec is in draft status but drift detected — review if implementation started`);
+        }
+        else {
+            manualReview.push(`${spec.id}: drift detected (status: ${spec.status}) — manual review needed`);
+        }
+    }
+    if (cachedEntries.length === 0) {
+        // Check all implementing/done specs without cached drift entries
+        const activeSpecs = specs.filter((s) => s.status === 'implementing' || s.status === 'done' || s.status === 'draft');
+        for (const spec of activeSpecs) {
+            const specDir = join(projectPath, 'planu', 'specs', spec.id);
+            const hasProgress = await specDirExists(join(specDir, 'progress.md'));
+            if (!hasProgress && spec.status === 'draft') {
+                manualReview.push(`${spec.id}: draft spec with no progress tracking — run auto_fix_health`);
+            }
+        }
+    }
+    return {
+        resolved,
+        followUpSpecsCreated,
+        manualReview,
+    };
+}
+//# sourceMappingURL=violation-resolver.js.map

package/dist/engine/drift/violation-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-resolver.js","sourceRoot":"","sources":["../../../src/engine/drift/violation-resolver.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,KAAK,UAAU,aAAa,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,WAAmB,EACnB,YAAoB,EACpB,MAAc,EACd,MAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,iBAAiB,YAAY,CAAC,WAAW,EAAE,IAAI,SAAS,EAAE,CAAC;IAE1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,OAAO,MAAM,EAAE;YACf,sBAAsB,YAAY,oBAAoB;YACtD,eAAe;YACf,0CAA0C;YAC1C,cAAc,GAAG,EAAE;YACnB,KAAK;YACL,EAAE;YACF,mBAAmB,YAAY,EAAE;YACjC,EAAE;YACF,MAAM;YACN,EAAE;YACF,wBAAwB;YACxB,EAAE;YACF,kCAAkC,YAAY,iCAAiC;YAC/E,iDAAiD;YACjD,sDAAsD;YACtD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,KAAK,MAAM,gCAAgC,EAC3C,OAAO,CACR,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,SAAS,8BAA8B,CAAC,MAAc;IACpD,OAAO;QACL,MAAM;QACN,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,4EAA4E;KAC1F,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,MAAc;IACpD,OAAO;QACL,MAAM;QACN,MAAM,EAAE,iBAAiB;QACzB,WAAW,EACT,oFAAoF;KACvF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,SAAiB,EACjB,MAAM,GAAG,KAAK;IAEd,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,uDAAuD,CAAC,CAAC;YAC1F,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,yDAAyD;YACzD,uEAAuE;YACvE,MAAM,MAAM,GAAG,0BAA0B,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YACxI,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAClF,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAC1C,8DAA8D;YAC9D,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YACnC,6DAA6D;YAC7D,YAAY,CAAC,IAAI,CACf,GAAG,IAAI,CAAC,EAAE,iFAAiF,CAC5F,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CACf,GAAG,IAAI,CAAC,EAAE,6BAA6B,IAAI,CAAC,MAAM,0BAA0B,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,iEAAiE;QACjE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,CAClF,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;YAEtE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC5C,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,8DAA8D,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,oBAAoB;QACpB,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/engine/ears/criterion-scorer.d.ts

@@ -0,0 +1,7 @@
+import type { CriterionQuality } from '../../types/ears.js';
+/**
+ * Score a single acceptance criterion using EARS and testability heuristics.
+ */
+export declare function scoreCriterion(text: string): CriterionQuality;
+export declare function gradeSpec(avgScore: number): 'A' | 'B' | 'C' | 'D' | 'F';
+//# sourceMappingURL=criterion-scorer.d.ts.map

package/dist/engine/ears/criterion-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criterion-scorer.d.ts","sourceRoot":"","sources":["../../../src/engine/ears/criterion-scorer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA8B5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAyD7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAcvE"}

package/dist/engine/ears/criterion-scorer.js

@@ -0,0 +1,87 @@
+// engine/ears/criterion-scorer.ts — EARS criterion scoring (SPEC-410)
+import { detectEarsPattern, detectVaguenessFlags, isEarsCompliant } from './pattern-matcher.js';
+import { generateRewrites } from './rewriter.js';
+// Patterns that indicate a measurable numeric threshold
+const NUMERIC_VALUE_REGEX = /\d+\s*(?:ms|milliseconds?|seconds?|minutes?|hours?|items?|%|percent|kb|mb|gb|px|requests?|users?|calls?|retries?)/i;
+// Patterns for specific API routes/endpoints
+const ENDPOINT_REGEX = /(?:\/api\/|GET\s+|POST\s+|PUT\s+|DELETE\s+|PATCH\s+)/i;
+// Patterns for clear success conditions
+const SUCCESS_CONDITION_REGEX = /\b(?:returns?|displays?|shows?|navigates?\s+to|renders?|saves?|stores?|loads?|creates?|sends?|emits?)\b/i;
+// Patterns for a measurable threshold (numeric value with unit or comparison)
+const MEASURABLE_THRESHOLD_REGEX = /\b(?:at (?:most|least)|no more than|within|fewer than|greater than|more than|\d+\s*(?:ms|seconds?|items?|%|kb|mb))\b/i;
+// Patterns for named components/features
+const COMPONENT_REGEX = /\b(?:[A-Z][a-zA-Z]+(?:Component|Page|Modal|Service|Store|API|Endpoint|Handler|Manager|Controller|View|Form|Button|Panel|Screen)|\w+[-_]\w+)\b/;
+// Patterns for trigger conditions
+const TRIGGER_REGEX = /\b(?:when|if|while|where|after|before|on(?:ce)?)\b/i;
+// Patterns for actors
+const ACTOR_REGEX = /\b(?:user|admin|system|operator|manager|client|server|guest|subscriber|owner)\b/i;
+/**
+ * Score a single acceptance criterion using EARS and testability heuristics.
+ */
+export function scoreCriterion(text) {
+    const earsPattern = detectEarsPattern(text);
+    const earsCompliant = isEarsCompliant(text);
+    const vaguenessFlagsFound = detectVaguenessFlags(text);
+    const vaguenessDeduction = Math.min(vaguenessFlagsFound.length * 2, 10);
+    // --- Testability Score (0-10) ---
+    let testabilityScore = 0;
+    if (NUMERIC_VALUE_REGEX.test(text)) {
+        testabilityScore += 3;
+    }
+    if (earsCompliant) {
+        testabilityScore += 3;
+    }
+    if (ENDPOINT_REGEX.test(text)) {
+        testabilityScore += 2;
+    }
+    if (SUCCESS_CONDITION_REGEX.test(text)) {
+        testabilityScore += 2;
+    }
+    testabilityScore = Math.max(0, testabilityScore - vaguenessDeduction);
+    testabilityScore = Math.min(10, testabilityScore);
+    // --- Specificity Score (0-10) ---
+    let specificityScore = 0;
+    if (MEASURABLE_THRESHOLD_REGEX.test(text) || NUMERIC_VALUE_REGEX.test(text)) {
+        specificityScore += 4;
+    }
+    if (COMPONENT_REGEX.test(text)) {
+        specificityScore += 3;
+    }
+    if (TRIGGER_REGEX.test(text)) {
+        specificityScore += 2;
+    }
+    if (ACTOR_REGEX.test(text)) {
+        specificityScore += 1;
+    }
+    specificityScore = Math.max(0, specificityScore - vaguenessDeduction);
+    specificityScore = Math.min(10, specificityScore);
+    const overallScore = Math.round(((testabilityScore + specificityScore) / 2) * 10) / 10;
+    // Generate rewrite suggestions only when score is below threshold
+    const rewriteSuggestions = overallScore < 7 ? generateRewrites(text, earsPattern) : [];
+    return {
+        text,
+        testabilityScore,
+        specificityScore,
+        earsPattern,
+        earsCompliant,
+        vaguenessFlagsFound,
+        overallScore,
+        rewriteSuggestions,
+    };
+}
+export function gradeSpec(avgScore) {
+    if (avgScore >= 9) {
+        return 'A';
+    }
+    if (avgScore >= 7) {
+        return 'B';
+    }
+    if (avgScore >= 5) {
+        return 'C';
+    }
+    if (avgScore >= 3) {
+        return 'D';
+    }
+    return 'F';
+}
+//# sourceMappingURL=criterion-scorer.js.map

package/dist/engine/ears/criterion-scorer.js.map

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

package/dist/engine/ears/pattern-matcher.d.ts

@@ -0,0 +1,5 @@
+import type { EarsPattern } from '../../types/ears.js';
+export declare function detectEarsPattern(criterion: string): EarsPattern;
+export declare function detectVaguenessFlags(criterion: string): string[];
+export declare function isEarsCompliant(criterion: string): boolean;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/engine/ears/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../../src/engine/ears/pattern-matcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA+BvD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAOhE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/engine/ears/pattern-matcher.js

@@ -0,0 +1,48 @@
+// engine/ears/pattern-matcher.ts — EARS pattern detection (SPEC-410)
+// EARS pattern regexes (case-insensitive).
+// Order matters: more specific patterns are tested before generic ones.
+const EARS_PATTERN_CHECKS = [
+    { pattern: 'conditional', regex: /\bif\b.+\bthen\b.+\bthe system shall\b/i },
+    { pattern: 'event-driven', regex: /\bwhen\b.+\bthe system shall\b/i },
+    { pattern: 'state-driven', regex: /\bwhile\b.+\bthe system shall\b/i },
+    { pattern: 'optional', regex: /\bwhere\b.+\bthe system shall\b/i },
+    { pattern: 'ubiquitous', regex: /\bthe system shall\b/i },
+];
+// Vagueness words that make criteria hard to test
+const VAGUENESS_FLAGS = [
+    'should',
+    'easy',
+    'fast',
+    'user-friendly',
+    'intuitive',
+    'simple',
+    'quickly',
+    'efficiently',
+    'nice',
+    'good',
+    'better',
+    'appropriate',
+    'suitable',
+    'seamlessly',
+    'ideally',
+];
+export function detectEarsPattern(criterion) {
+    for (const { pattern, regex } of EARS_PATTERN_CHECKS) {
+        if (regex.test(criterion)) {
+            return pattern;
+        }
+    }
+    return 'none';
+}
+export function detectVaguenessFlags(criterion) {
+    const lower = criterion.toLowerCase();
+    return VAGUENESS_FLAGS.filter((flag) => {
+        // Match whole word to avoid false positives (e.g., "easily" vs "easy")
+        const wordBoundary = new RegExp(`\\b${flag.replace('-', '[- ]')}\\b`, 'i');
+        return wordBoundary.test(lower);
+    });
+}
+export function isEarsCompliant(criterion) {
+    return detectEarsPattern(criterion) !== 'none';
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/dist/engine/ears/pattern-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.js","sourceRoot":"","sources":["../../../src/engine/ears/pattern-matcher.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAIrE,2CAA2C;AAC3C,wEAAwE;AACxE,MAAM,mBAAmB,GAA8C;IACrE,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,yCAAyC,EAAE;IAC5E,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,iCAAiC,EAAE;IACrE,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,kCAAkC,EAAE;IACtE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,kCAAkC,EAAE;IAClE,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,uBAAuB,EAAE;CAC1D,CAAC;AAEF,kDAAkD;AAClD,MAAM,eAAe,GAAsB;IACzC,QAAQ;IACR,MAAM;IACN,MAAM;IACN,eAAe;IACf,WAAW;IACX,QAAQ;IACR,SAAS;IACT,aAAa;IACb,MAAM;IACN,MAAM;IACN,QAAQ;IACR,aAAa;IACb,UAAU;IACV,YAAY;IACZ,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,mBAAmB,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,uEAAuE;QACvE,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3E,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,iBAAiB,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC;AACjD,CAAC"}

package/dist/engine/ears/rewriter.d.ts

@@ -0,0 +1,7 @@
+import type { EarsPattern } from '../../types/ears.js';
+/**
+ * Generate 2 EARS-format rewrite suggestions using templates.
+ * Template-driven only — no LLM calls.
+ */
+export declare function generateRewrites(criterion: string, _pattern: EarsPattern): string[];
+//# sourceMappingURL=rewriter.d.ts.map

package/dist/engine/ears/rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.d.ts","sourceRoot":"","sources":["../../../src/engine/ears/rewriter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA2CvD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,EAAE,CAQnF"}

package/dist/engine/ears/rewriter.js

@@ -0,0 +1,45 @@
+// engine/ears/rewriter.ts — Template-driven EARS rewrite suggestions (SPEC-410)
+// Simple regex-based extraction helpers
+function extractNounPhrase(text) {
+    // Strip leading action words and extract a subject noun phrase
+    const stripped = text.replace(/^(the system shall|when|while|if|then|where)\s+/i, '').trim();
+    // Take the first clause up to a comma, period, or conjunction
+    const match = /^([^,.(]+?)(?:\s+(?:should|must|shall|will|can|is|are|has|have)|[,.(]|$)/i.exec(stripped);
+    const raw = match?.[1]?.trim() ?? stripped.slice(0, 60).trim();
+    return raw.length > 0 ? raw : 'the user performs an action';
+}
+function extractVerbPhrase(text) {
+    // Look for a verb phrase after common trigger words
+    const patterns = [
+        /the system shall\s+(.+?)(?:\s+within\s+\d+|\s*$)/i,
+        /(?:should|must|will)\s+(?:be able to\s+)?(.+?)(?:\s+within\s+\d+|\s*$)/i,
+        /(?:displays?|shows?|returns?|navigates?\s+to|validates?|saves?|loads?|creates?|updates?|deletes?)\s+.+/i,
+    ];
+    for (const pattern of patterns) {
+        const match = pattern.exec(text);
+        if (match?.[1] !== undefined) {
+            return match[1].trim().slice(0, 80);
+        }
+        if (match?.[0] !== undefined && pattern === patterns[2]) {
+            return match[0].trim().slice(0, 80);
+        }
+    }
+    // Fallback: strip leading qualifiers
+    const stripped = text
+        .replace(/^(the system shall|when|while|if|then|where|the user|user)\s+/i, '')
+        .replace(/\s+(should|must|shall|will)\s+/, ' ')
+        .trim();
+    return stripped.slice(0, 80) || 'complete the requested operation';
+}
+/**
+ * Generate 2 EARS-format rewrite suggestions using templates.
+ * Template-driven only — no LLM calls.
+ */
+export function generateRewrites(criterion, _pattern) {
+    const nounPhrase = extractNounPhrase(criterion);
+    const verbPhrase = extractVerbPhrase(criterion);
+    const suggestion1 = `WHEN ${nounPhrase}, THE SYSTEM SHALL ${verbPhrase}`;
+    const suggestion2 = `WHEN ${nounPhrase}, THE SYSTEM SHALL ${verbPhrase} within 2 seconds`;
+    return [suggestion1, suggestion2];
+}
+//# sourceMappingURL=rewriter.js.map

package/dist/engine/ears/rewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.js","sourceRoot":"","sources":["../../../src/engine/ears/rewriter.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAIhF,wCAAwC;AACxC,SAAS,iBAAiB,CAAC,IAAY;IACrC,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kDAAkD,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE7F,8DAA8D;IAC9D,MAAM,KAAK,GAAG,2EAA2E,CAAC,IAAI,CAC5F,QAAQ,CACT,CAAC;IACF,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/D,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B,CAAC;AAC9D,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,oDAAoD;IACpD,MAAM,QAAQ,GAAG;QACf,mDAAmD;QACnD,yEAAyE;QACzE,yGAAyG;KAC1G,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,gEAAgE,EAAE,EAAE,CAAC;SAC7E,OAAO,CAAC,gCAAgC,EAAE,GAAG,CAAC;SAC9C,IAAI,EAAE,CAAC;IAEV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,kCAAkC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,QAAqB;IACvE,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEhD,MAAM,WAAW,GAAG,QAAQ,UAAU,sBAAsB,UAAU,EAAE,CAAC;IACzE,MAAM,WAAW,GAAG,QAAQ,UAAU,sBAAsB,UAAU,mBAAmB,CAAC;IAE1F,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/engine/ears/spec-linter.d.ts

@@ -0,0 +1,7 @@
+import type { EarsSpecReport, ProjectEarsReport } from '../../types/ears.js';
+/**
+ * Lint a single spec by ID — reads spec.md from the planu/specs directory.
+ */
+export declare function lintSpec(specId: string, projectPath: string): Promise<EarsSpecReport>;
+export declare function lintAllSpecs(projectPath: string): Promise<ProjectEarsReport>;
+//# sourceMappingURL=spec-linter.d.ts.map

package/dist/engine/ears/spec-linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-linter.d.ts","sourceRoot":"","sources":["../../../src/engine/ears/spec-linter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAuD/F;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAyB3F;AAGD,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkDlF"}