@planu/cli 1.11.0 → 1.12.0

package/dist/engine/context-profile/profile-catalog.js

@@ -0,0 +1,145 @@
+export const PROFILE_CATALOG = {
+    brainstorm: {
+        phase: 'brainstorm',
+        name: 'Brainstorm Mode',
+        description: 'Explore ideas, capture requirements, define scope',
+        focusTools: [
+            'capture_idea',
+            'clarify_requirements',
+            'elicit_requirements',
+            'suggest_stack',
+            'create_spec',
+            'list_backlog',
+            'promote_idea',
+            'discard_idea',
+            'search_suggestions',
+            'suggest_criteria',
+        ],
+        avoidTools: ['validate', 'lock_spec', 'approve_spec', 'create_release', 'generate_changelog'],
+        tips: [
+            'Use capture_idea for rough thoughts before formalizing',
+            'Use clarify_requirements to interview stakeholders',
+            'Use elicit_requirements for structured requirement gathering',
+            'Use create_spec only when ready to commit to a feature',
+        ],
+        estimatedTokensSaved: 85,
+    },
+    plan: {
+        phase: 'plan',
+        name: 'Planning Mode',
+        description: 'Design specs, estimate effort, check readiness',
+        focusTools: [
+            'create_spec',
+            'decompose_spec',
+            'estimate',
+            'check_readiness',
+            'challenge_spec',
+            'inject_quality_gates',
+            'suggest_criteria',
+            'clarify_requirements',
+            'analyze_spec_dependencies',
+            'critical_path_analyzer',
+        ],
+        avoidTools: ['lock_spec', 'create_release', 'generate_changelog', 'tdd_scaffold'],
+        tips: [
+            'Use challenge_spec to stress-test before approving',
+            'Use check_readiness to verify sufficient detail',
+            'Use inject_quality_gates to add quality checklist automatically',
+            'Use decompose_spec for large specs that should be split',
+        ],
+        estimatedTokensSaved: 82,
+    },
+    implement: {
+        phase: 'implement',
+        name: 'Implementation Mode',
+        description: 'Build features, track progress, manage sessions',
+        focusTools: [
+            'list_specs',
+            'update_status',
+            'lock_spec',
+            'unlock_spec',
+            'tdd_scaffold',
+            'validate',
+            'session_checkpoint',
+            'session_handoff',
+            'planu_status',
+            'generate_tests',
+            'verify_spec_compliance',
+        ],
+        avoidTools: [
+            'create_spec',
+            'elicit_requirements',
+            'create_release',
+            'generate_changelog',
+            'team_analytics',
+        ],
+        tips: [
+            'Use lock_spec before starting to prevent conflicts',
+            'Use session_checkpoint before context resets',
+            'Use validate after implementing to check compliance',
+            'Use update_status to track progress through lifecycle',
+        ],
+        estimatedTokensSaved: 88,
+    },
+    review: {
+        phase: 'review',
+        name: 'Review Mode',
+        description: 'Validate, approve, request changes, verify quality',
+        focusTools: [
+            'validate',
+            'verify_spec_compliance',
+            'spec_quality_score',
+            'approve_spec',
+            'request_changes',
+            'challenge_spec',
+            'check_readiness',
+            'review_pr',
+            'ears_lint',
+            'validate_criteria_quality',
+        ],
+        avoidTools: ['lock_spec', 'create_release', 'tdd_scaffold', 'capture_idea'],
+        tips: [
+            'Use validate to check acceptance criteria compliance',
+            'Use verify_spec_compliance to score code coverage',
+            'Use ears_lint to check criteria quality',
+            'Use approve_spec only when all criteria are verified',
+        ],
+        estimatedTokensSaved: 87,
+    },
+    release: {
+        phase: 'release',
+        name: 'Release Mode',
+        description: 'Prepare releases, generate changelogs, version specs',
+        focusTools: [
+            'generate_changelog',
+            'create_release',
+            'version_spec',
+            'export_specs_markdown',
+            'generate_docs_site',
+            'spec_usage_report',
+            'velocity_report',
+            'update_status',
+        ],
+        avoidTools: [
+            'create_spec',
+            'lock_spec',
+            'tdd_scaffold',
+            'capture_idea',
+            'clarify_requirements',
+        ],
+        tips: [
+            'Use generate_changelog to compile release notes from done specs',
+            'Use create_release to tag and publish the version',
+            'Use velocity_report to measure team performance this cycle',
+            'Mark all specs done before creating the release',
+        ],
+        estimatedTokensSaved: 90,
+    },
+};
+export function getProfile(phase) {
+    return PROFILE_CATALOG[phase];
+}
+export function getAllProfiles() {
+    return Object.values(PROFILE_CATALOG);
+}
+//# sourceMappingURL=profile-catalog.js.map

package/dist/engine/context-profile/profile-catalog.js.map

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

package/dist/engine/critical-path/path-analyzer.d.ts

@@ -0,0 +1,3 @@
+import type { Spec405CriticalPathResult } from '../../types/index.js';
+export declare function analyzeCriticalPath(projectPath: string): Promise<Spec405CriticalPathResult>;
+//# sourceMappingURL=path-analyzer.d.ts.map

package/dist/engine/critical-path/path-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/critical-path/path-analyzer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,yBAAyB,EAAmB,MAAM,sBAAsB,CAAC;AA8FvF,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAyEjG"}

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":"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"}

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"}