openlore 2.0.0

package/dist/core/test-generator/scenario-parser.js

@@ -0,0 +1,244 @@
+/**
+ * Scenario Parser
+ *
+ * Reads OpenSpec spec files and extracts ParsedScenario objects.
+ * Extends openloreGetSpecRequirements to also parse the full G/W/T structure
+ * from each "#### Scenario:" block within requirement sections.
+ *
+ * Mapping enrichment:
+ *   If .openlore/analysis/mapping.json exists, each scenario is enriched with
+ *   FunctionRef[] for the matching requirement (confidence ≥ heuristic).
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, ARTIFACT_MAPPING, OPENSPEC_DIR, OPENSPEC_SPECS_SUBDIR, } from '../../constants.js';
+import { fileExists } from '../../utils/command-helpers.js';
+const DEFAULT_ANNOTATION = {
+    skip: false,
+    tags: [],
+    priority: 'normal',
+};
+/**
+ * Parse a `<!-- openlore-test: ... -->` comment immediately following a
+ * `#### Scenario:` heading. Returns default values if no annotation present.
+ *
+ * Supported keys:
+ *   skip              flag (presence = true)
+ *   skip=true|false
+ *   reason="…"        skip reason (only meaningful when skip is set)
+ *   tags=smoke,regression
+ *   priority=high|normal|low
+ */
+function parseAnnotation(lines) {
+    // Look at the first few non-empty body lines for an HTML comment annotation
+    for (const line of lines.slice(0, 3)) {
+        const trimmed = line.trim();
+        const m = trimmed.match(/^<!--\s*openlore-test:\s*(.*?)\s*-->$/i);
+        if (!m)
+            continue;
+        const raw = m[1];
+        const result = { skip: false, tags: [], priority: 'normal' };
+        // key=value pairs (value may be quoted)
+        const pairs = raw.matchAll(/(\w+)(?:=(?:"([^"]*?)"|([^\s"]+)))?/g);
+        for (const pair of pairs) {
+            const key = pair[1].toLowerCase();
+            const value = (pair[2] ?? pair[3] ?? '').trim();
+            switch (key) {
+                case 'skip':
+                    result.skip = value === '' || value.toLowerCase() !== 'false';
+                    break;
+                case 'reason':
+                    result.skipReason = value;
+                    break;
+                case 'tags':
+                    result.tags = value.split(',').map((t) => t.trim()).filter(Boolean);
+                    break;
+                case 'priority':
+                    if (value === 'high' || value === 'low')
+                        result.priority = value;
+                    break;
+            }
+        }
+        return result;
+    }
+    return { ...DEFAULT_ANNOTATION };
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+/** Slugify a string to kebab-case for file names */
+export function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-zA-Z0-9-]/g, '')
+        .toLowerCase();
+}
+/** Extract bullet text from lines like "- **GIVEN** ..." or "- **given** ..." */
+function extractBullets(lines, keyword) {
+    const upper = keyword.toUpperCase();
+    const results = [];
+    for (const line of lines) {
+        // Match: - **GIVEN** text  OR  - **given** text  OR  - GIVEN: text
+        const m = line.match(new RegExp(`^\\s*[-*]\\s*\\*{0,2}${upper}\\*{0,2}:?\\s*(.+)`, 'i'));
+        if (m) {
+            results.push(m[1].trim());
+        }
+    }
+    return results;
+}
+/** Check if a scenario block has a complete G/W/T */
+function isComplete(given, when, then) {
+    return given.length > 0 && when.length > 0 && then.length > 0;
+}
+// ============================================================================
+// MAPPING LOADER
+// ============================================================================
+async function loadMapping(rootPath) {
+    const map = new Map();
+    const mappingPath = join(rootPath, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, ARTIFACT_MAPPING);
+    if (!(await fileExists(mappingPath)))
+        return map;
+    try {
+        const raw = JSON.parse(await readFile(mappingPath, 'utf-8'));
+        const entries = raw?.mappings ?? [];
+        for (const entry of entries) {
+            if (!entry.requirement || !Array.isArray(entry.functions))
+                continue;
+            const refs = entry.functions.map((f) => ({
+                name: f.name,
+                file: f.file,
+                line: f.line,
+                confidence: f.confidence ?? 'heuristic',
+            }));
+            map.set(entry.requirement.toLowerCase(), refs);
+        }
+    }
+    catch {
+        // Silently ignore malformed mapping
+    }
+    return map;
+}
+// ============================================================================
+// SPEC FILE WALKER
+// ============================================================================
+async function findSpecFiles(specsDir, domains) {
+    const results = [];
+    if (!(await fileExists(specsDir)))
+        return results;
+    let entries;
+    try {
+        entries = await readdir(specsDir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        // Each entry is a domain directory (or overview, architecture, etc.)
+        if (domains && domains.length > 0) {
+            const domainLower = entry.toLowerCase();
+            const filtered = domains.map((d) => d.toLowerCase());
+            if (!filtered.includes(domainLower))
+                continue;
+        }
+        const specFile = join(specsDir, entry, 'spec.md');
+        if (await fileExists(specFile)) {
+            results.push({ domain: entry, path: specFile });
+        }
+    }
+    return results;
+}
+// ============================================================================
+// CORE PARSER
+// ============================================================================
+/**
+ * Parse all scenarios from OpenSpec spec files.
+ *
+ * @param opts.rootPath        Project root (default: process.cwd())
+ * @param opts.domains         If set, only parse these domains
+ * @param opts.excludeDomains  Skip these domains even if included above
+ * @param opts.tags            If set, only include scenarios that carry ALL these tags
+ * @param opts.limit           Maximum number of scenarios to return (applied after filters)
+ * @param opts.includeSkipped  If true, include scenarios marked skip=true (default: false)
+ */
+export async function parseScenarios(opts) {
+    const rootPath = opts.rootPath ?? process.cwd();
+    const specsDir = join(rootPath, OPENSPEC_DIR, OPENSPEC_SPECS_SUBDIR);
+    const excludeSet = new Set((opts.excludeDomains ?? []).map((d) => d.toLowerCase()));
+    const requiredTags = opts.tags ?? [];
+    const [specFiles, mappingMap] = await Promise.all([
+        findSpecFiles(specsDir, opts.domains),
+        loadMapping(rootPath),
+    ]);
+    const scenarios = [];
+    for (const { domain, path: specPath } of specFiles) {
+        // Domain-level exclusion
+        if (excludeSet.has(domain.toLowerCase()))
+            continue;
+        let content;
+        try {
+            content = await readFile(specPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const specFileRel = specPath.replace(resolve(rootPath) + '/', '');
+        // Split into requirement sections (### Requirement: <name>)
+        const reqSections = content.split(/^###\s+Requirement:\s*/m);
+        for (let ri = 1; ri < reqSections.length; ri++) {
+            const reqBlock = reqSections[ri];
+            const reqLines = reqBlock.split('\n');
+            const requirement = reqLines[0].trim();
+            if (!requirement)
+                continue;
+            const functions = mappingMap.get(requirement.toLowerCase()) ?? [];
+            // Split into scenario sections (#### Scenario: <name>)
+            const scenarioSections = reqBlock.split(/^####\s+Scenario:\s*/m);
+            for (let si = 1; si < scenarioSections.length; si++) {
+                const scenBlock = scenarioSections[si];
+                const scenLines = scenBlock.split('\n');
+                const scenarioName = scenLines[0].trim();
+                if (!scenarioName)
+                    continue;
+                const bodyLines = scenLines.slice(1);
+                const given = extractBullets(bodyLines, 'given');
+                const when = extractBullets(bodyLines, 'when');
+                const then = extractBullets(bodyLines, 'then');
+                if (!isComplete(given, when, then)) {
+                    // Incomplete G/W/T — skip silently (caller may log)
+                    continue;
+                }
+                // Parse inline annotation (<!-- openlore-test: ... -->)
+                const annotation = parseAnnotation(bodyLines);
+                // Filter: skipped scenarios (unless caller explicitly wants them)
+                if (annotation.skip && !opts.includeSkipped)
+                    continue;
+                // Filter: tag-based inclusion
+                if (requiredTags.length > 0) {
+                    const hasAll = requiredTags.every((t) => annotation.tags.includes(t));
+                    if (!hasAll)
+                        continue;
+                }
+                scenarios.push({
+                    domain,
+                    specFile: specFileRel,
+                    requirement,
+                    scenarioName,
+                    given,
+                    when,
+                    then,
+                    mappedFunctions: functions,
+                    skip: annotation.skip,
+                    skipReason: annotation.skipReason,
+                    tags: annotation.tags,
+                    priority: annotation.priority,
+                });
+                if (opts.limit && scenarios.length >= opts.limit) {
+                    return scenarios;
+                }
+            }
+        }
+    }
+    return scenarios;
+}
+//# sourceMappingURL=scenario-parser.js.map

package/dist/core/test-generator/scenario-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-parser.js","sourceRoot":"","sources":["../../../src/core/test-generator/scenario-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAc5D,MAAM,kBAAkB,GAAuB;IAC7C,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAS,eAAe,CAAC,KAAe;IACtC,4EAA4E;IAC5E,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC;YAAE,SAAS;QAEjB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjB,MAAM,MAAM,GAAuB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAEjF,wCAAwC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,QAAQ,GAAG,EAAE,CAAC;gBACZ,KAAK,MAAM;oBACT,MAAM,CAAC,IAAI,GAAG,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC;oBAC9D,MAAM;gBACR,KAAK,QAAQ;oBACX,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;oBAC1B,MAAM;gBACR,KAAK,MAAM;oBACT,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACpE,MAAM;gBACR,KAAK,UAAU;oBACb,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK;wBAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;oBACjE,MAAM;YACV,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;AACnC,CAAC;AAkBD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,iFAAiF;AACjF,SAAS,cAAc,CAAC,KAAe,EAAE,OAAe;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mEAAmE;QACnE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAClB,IAAI,MAAM,CAAC,wBAAwB,KAAK,oBAAoB,EAAE,GAAG,CAAC,CACnE,CAAC;QACF,IAAI,CAAC,EAAE,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qDAAqD;AACrD,SAAS,UAAU,CAAC,KAAe,EAAE,IAAc,EAAE,IAAc;IACjE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,KAAK,UAAU,WAAW,CACxB,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CACtB,QAAQ,EACR,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,CACjB,CAAC;IAEF,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAmB,GAAG,EAAE,QAAQ,IAAI,EAAE,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;gBAAE,SAAS;YACpE,MAAM,IAAI,GAAkB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtD,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAG,CAAC,CAAC,UAAwC,IAAI,WAAW;aACvE,CAAC,CAAC,CAAC;YACJ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,KAAK,UAAU,aAAa,CAC1B,QAAgB,EAChB,OAAkB;IAElB,MAAM,OAAO,GAA4C,EAAE,CAAC;IAE5D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAElD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,qEAAqE;QACrE,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,SAAS;QAChD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAOpC;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACxD,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAErC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC;QACrC,WAAW,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC;QACnD,yBAAyB;QACzB,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QACnD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;QAElE,4DAA4D;QAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAE7D,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAElE,uDAAuD;YACvD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAEjE,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBACpD,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBACvC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzC,IAAI,CAAC,YAAY;oBAAE,SAAS;gBAE5B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAErC,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAE/C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;oBACnC,oDAAoD;oBACpD,SAAS;gBACX,CAAC;gBAED,wDAAwD;gBACxD,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;gBAE9C,kEAAkE;gBAClE,IAAI,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;oBAAE,SAAS;gBAEtD,8BAA8B;gBAC9B,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;oBACtE,IAAI,CAAC,MAAM;wBAAE,SAAS;gBACxB,CAAC;gBAED,SAAS,CAAC,IAAI,CAAC;oBACb,MAAM;oBACN,QAAQ,EAAE,WAAW;oBACrB,WAAW;oBACX,YAAY;oBACZ,KAAK;oBACL,IAAI;oBACJ,IAAI;oBACJ,eAAe,EAAE,SAAS;oBAC1B,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,UAAU,EAAE,UAAU,CAAC,UAAU;oBACjC,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;iBAC9B,CAAC,CAAC;gBAEH,IAAI,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACjD,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/test-generator/test-generator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Test Generator Orchestrator
+ *
+ * Groups ParsedScenarios by (domain, requirement) → calls matchThenClauses
+ * → renders test file content via framework renderers.
+ *
+ * Two modes:
+ *   - Default: THEN pattern engine only (no LLM, instant)
+ *   - --use-llm: Pattern engine first; LLM fills in unmatched THEN clauses
+ *     by reading mapped function source code.
+ */
+import type { ParsedScenario, GeneratedTestFile, TestFramework } from '../../types/test-generator.js';
+import type { LLMService } from '../services/llm-service.js';
+export interface GenerateTestsOptions {
+    scenarios: ParsedScenario[];
+    framework: TestFramework;
+    outputDir: string;
+    rootPath: string;
+    useLlm?: boolean;
+    llm?: LLMService;
+}
+/**
+ * Generate test files from parsed scenarios.
+ * Groups by (domain, requirement) → one file per requirement.
+ * Scenarios are sorted by priority (high → normal → low) before grouping
+ * so that high-priority groups appear first and consume LLM budget first
+ * when --limit is in effect upstream.
+ */
+export declare function generateTests(opts: GenerateTestsOptions): Promise<GeneratedTestFile[]>;
+//# sourceMappingURL=test-generator.d.ts.map

package/dist/core/test-generator/test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-generator.d.ts","sourceRoot":"","sources":["../../../src/core/test-generator/test-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAe,MAAM,+BAA+B,CAAC;AACnH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAY7D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AA+ID;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyD9B"}

package/dist/core/test-generator/test-generator.js

@@ -0,0 +1,174 @@
+/**
+ * Test Generator Orchestrator
+ *
+ * Groups ParsedScenarios by (domain, requirement) → calls matchThenClauses
+ * → renders test file content via framework renderers.
+ *
+ * Two modes:
+ *   - Default: THEN pattern engine only (no LLM, instant)
+ *   - --use-llm: Pattern engine first; LLM fills in unmatched THEN clauses
+ *     by reading mapped function source code.
+ */
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { fileExists } from '../../utils/command-helpers.js';
+import { matchThenClauses } from './then-matchers.js';
+import { renderTests } from './renderers/index.js';
+import { toKebabCase } from './scenario-parser.js';
+import { toSnakeCase } from './renderers/shared.js';
+import { FRAMEWORK_EXTENSIONS } from '../../types/test-generator.js';
+// ============================================================================
+// LLM ASSERTION ENRICHMENT
+// ============================================================================
+/** Read up to maxFunctions mapped function source snippets */
+async function readFunctionSnippets(rootPath, functions, maxFunctions = 3) {
+    const eligible = functions
+        .filter((f) => f.confidence === 'llm' || f.confidence === 'semantic')
+        .slice(0, maxFunctions);
+    const snippets = [];
+    for (const fn of eligible) {
+        const absPath = resolve(rootPath, fn.file);
+        if (!(await fileExists(absPath)))
+            continue;
+        try {
+            const source = await readFile(absPath, 'utf-8');
+            const lines = source.split('\n');
+            const start = Math.max(0, (fn.line ?? 1) - 1);
+            const end = Math.min(lines.length, start + 40);
+            const snippet = lines.slice(start, end).join('\n');
+            snippets.push(`// ${fn.file}: ${fn.name}()\n${snippet}`);
+        }
+        catch {
+            // ignore unreadable files
+        }
+    }
+    return snippets.join('\n\n---\n\n');
+}
+/**
+ * Use LLM to fill in assertions for THEN clauses that the pattern engine
+ * could not match (fromPattern === false).
+ */
+async function enrichWithLlm(scenario, currentMatches, framework, llm, rootPath) {
+    const unmatched = currentMatches.filter((m) => !m.fromPattern);
+    if (unmatched.length === 0)
+        return currentMatches;
+    const snippets = await readFunctionSnippets(rootPath, scenario.mappedFunctions);
+    const unmatchedClauses = unmatched.map((m) => scenario.then[m.thenIndex]);
+    const frameworkHint = {
+        vitest: 'Vitest (TypeScript) — use expect(...).toBe/toEqual/toHaveProperty etc.',
+        playwright: 'Playwright (TypeScript) — use expect(response.status()).toBe() etc.',
+        pytest: 'pytest (Python) — use assert statements',
+        gtest: 'Google Test (C++) — use EXPECT_EQ, EXPECT_TRUE, EXPECT_EQ etc.',
+        catch2: 'Catch2 (C++) — use REQUIRE, CHECK macros',
+    };
+    const systemPrompt = `You are a test engineer. Generate assertion lines for spec scenarios. ` +
+        `Framework: ${frameworkHint[framework]}. ` +
+        `Return ONLY valid assertion lines, one per line, no prose, no backticks.`;
+    const userPrompt = `Scenario: ${scenario.domain} / ${scenario.requirement} / ${scenario.scenarioName}\n\n` +
+        `GIVEN:\n${scenario.given.map((g) => `  - ${g}`).join('\n')}\n\n` +
+        `WHEN:\n${scenario.when.map((w) => `  - ${w}`).join('\n')}\n\n` +
+        `Generate assertions for these THEN clauses:\n` +
+        unmatchedClauses.map((t, i) => `  ${i + 1}. ${t}`).join('\n') +
+        (snippets
+            ? `\n\nRelated implementation:\n\`\`\`\n${snippets}\n\`\`\``
+            : '');
+    try {
+        const response = await llm.complete({
+            systemPrompt,
+            userPrompt,
+            maxTokens: 512,
+        });
+        const generatedLines = response.content
+            .split('\n')
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && !l.startsWith('```'));
+        if (generatedLines.length === 0)
+            return currentMatches;
+        // Replace placeholder matches with LLM-generated ones
+        const result = [...currentMatches];
+        let lineOffset = 0;
+        for (const match of unmatched) {
+            const idx = result.findIndex((m) => m.thenIndex === match.thenIndex);
+            if (idx === -1)
+                continue;
+            // Take a slice of generatedLines for this match (rough heuristic: divide evenly)
+            const linesPerClause = Math.ceil(generatedLines.length / unmatched.length);
+            const assignedLines = generatedLines.slice(lineOffset, lineOffset + linesPerClause);
+            lineOffset += linesPerClause;
+            result[idx] = {
+                lines: assignedLines.length > 0 ? assignedLines : match.lines,
+                thenIndex: match.thenIndex,
+                fromPattern: false,
+            };
+        }
+        return result;
+    }
+    catch {
+        // LLM failure → keep pattern engine placeholders
+        return currentMatches;
+    }
+}
+// ============================================================================
+// FILE NAMING
+// ============================================================================
+function outputFilename(domain, requirement, framework) {
+    const ext = FRAMEWORK_EXTENSIONS[framework];
+    if (framework === 'pytest') {
+        return `${toSnakeCase(domain)}/${toSnakeCase(requirement)}_test.py`;
+    }
+    if (framework === 'gtest' || framework === 'catch2') {
+        return `${toSnakeCase(domain)}/${toSnakeCase(requirement)}_test.cpp`;
+    }
+    return `${toKebabCase(domain)}/${toKebabCase(requirement)}${ext}`;
+}
+// ============================================================================
+// MAIN
+// ============================================================================
+/**
+ * Generate test files from parsed scenarios.
+ * Groups by (domain, requirement) → one file per requirement.
+ */
+const PRIORITY_ORDER = { high: 0, normal: 1, low: 2 };
+/**
+ * Generate test files from parsed scenarios.
+ * Groups by (domain, requirement) → one file per requirement.
+ * Scenarios are sorted by priority (high → normal → low) before grouping
+ * so that high-priority groups appear first and consume LLM budget first
+ * when --limit is in effect upstream.
+ */
+export async function generateTests(opts) {
+    const { scenarios, framework, outputDir, rootPath, useLlm, llm } = opts;
+    // Sort by priority so high-priority scenarios / requirements come first
+    const sorted = [...scenarios].sort((a, b) => (PRIORITY_ORDER[a.priority] ?? 1) - (PRIORITY_ORDER[b.priority] ?? 1));
+    // Group scenarios by domain + requirement (preserving sorted order)
+    const groups = new Map();
+    for (const s of sorted) {
+        const key = `${s.domain}::${s.requirement}`;
+        if (!groups.has(key))
+            groups.set(key, []);
+        groups.get(key).push(s);
+    }
+    const files = [];
+    for (const [, groupScenarios] of groups) {
+        const { domain, requirement } = groupScenarios[0];
+        // Match THEN clauses for each scenario
+        let matchesByScenario = groupScenarios.map((s) => matchThenClauses(s.then, framework));
+        // Optionally enrich unmatched clauses with LLM
+        if (useLlm && llm) {
+            matchesByScenario = await Promise.all(groupScenarios.map((s, i) => enrichWithLlm(s, matchesByScenario[i], framework, llm, rootPath)));
+        }
+        const content = renderTests(framework, domain, requirement, groupScenarios, matchesByScenario);
+        const relPath = outputFilename(domain, requirement, framework);
+        const outputPath = join(outputDir, relPath);
+        files.push({
+            outputPath,
+            domain,
+            framework,
+            scenarios: groupScenarios,
+            content,
+            isNew: true, // test-writer will update this based on disk state
+        });
+    }
+    return files;
+}
+//# sourceMappingURL=test-generator.js.map

package/dist/core/test-generator/test-generator.js.map

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

package/dist/core/test-generator/test-writer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Test Writer
+ *
+ * Writes GeneratedTestFile objects to disk.
+ * Respects --dry-run (preview only) and --merge (append new scenarios).
+ *
+ * Merge logic:
+ *   When --merge is set, the writer reads the existing file and checks which
+ *   scenario metadata tags are already present. New scenarios are appended;
+ *   existing ones are skipped (no duplicate detection by content hash).
+ */
+import type { GeneratedTestFile } from '../../types/test-generator.js';
+export interface WriteResult {
+    written: number;
+    skipped: number;
+    merged: number;
+    dryRunPreview?: string[];
+}
+export declare function writeTestFiles(opts: {
+    files: GeneratedTestFile[];
+    rootPath: string;
+    dryRun: boolean;
+    merge: boolean;
+}): Promise<WriteResult>;
+//# sourceMappingURL=test-writer.d.ts.map

package/dist/core/test-generator/test-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-writer.d.ts","sourceRoot":"","sources":["../../../src/core/test-generator/test-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAMvE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAwED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8DvB"}

package/dist/core/test-generator/test-writer.js

@@ -0,0 +1,128 @@
+/**
+ * Test Writer
+ *
+ * Writes GeneratedTestFile objects to disk.
+ * Respects --dry-run (preview only) and --merge (append new scenarios).
+ *
+ * Merge logic:
+ *   When --merge is set, the writer reads the existing file and checks which
+ *   scenario metadata tags are already present. New scenarios are appended;
+ *   existing ones are skipped (no duplicate detection by content hash).
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileExists } from '../../utils/command-helpers.js';
+// ============================================================================
+// MERGE HELPERS
+// ============================================================================
+/** Extract scenario keys already present in a file via openlore: tags */
+function extractExistingScenarioKeys(content) {
+    const keys = new Set();
+    const tagRegex = /(?:\/\/|#)\s*openlore:\s*(\{[^\n]+\})/g;
+    let m;
+    while ((m = tagRegex.exec(content)) !== null) {
+        try {
+            const tag = JSON.parse(m[1]);
+            if (tag.domain && tag.requirement && tag.scenario) {
+                keys.add(`${tag.domain}::${tag.requirement}::${tag.scenario}`);
+            }
+        }
+        catch {
+            // malformed tag, ignore
+        }
+    }
+    return keys;
+}
+/**
+ * Extract the "blocks" (one per scenario) from generated content.
+ * Each block starts with a openlore: tag comment line.
+ */
+function splitIntoBlocks(content) {
+    // Split on openlore: tag lines, keeping the delimiter
+    const parts = content.split(/(?=(?:\/\/|#)\s*openlore:\s*\{)/);
+    // First part is the import header (before any tags)
+    return parts;
+}
+function buildMergedContent(existing, newContent, existingKeys) {
+    const blocks = splitIntoBlocks(newContent);
+    const scenarioBlocks = blocks.slice(1);
+    let added = 0;
+    const newBlocks = [];
+    for (const block of scenarioBlocks) {
+        const tagMatch = block.match(/(?:\/\/|#)\s*openlore:\s*(\{[^\n]+\})/);
+        if (!tagMatch)
+            continue;
+        try {
+            const tag = JSON.parse(tagMatch[1]);
+            const key = `${tag.domain}::${tag.requirement}::${tag.scenario}`;
+            if (!existingKeys.has(key)) {
+                newBlocks.push(block);
+                added++;
+            }
+        }
+        catch {
+            newBlocks.push(block); // keep unparseable blocks
+            added++;
+        }
+    }
+    if (newBlocks.length === 0)
+        return { content: existing, added: 0 };
+    const merged = existing.trimEnd() + '\n\n' + newBlocks.join('\n').trimStart();
+    return { content: merged, added };
+}
+// ============================================================================
+// PUBLIC API
+// ============================================================================
+export async function writeTestFiles(opts) {
+    const { files, rootPath, dryRun, merge } = opts;
+    const result = { written: 0, skipped: 0, merged: 0 };
+    if (dryRun) {
+        result.dryRunPreview = [];
+    }
+    for (const file of files) {
+        const absPath = resolve(rootPath, file.outputPath);
+        const exists = await fileExists(absPath);
+        if (dryRun) {
+            result.dryRunPreview.push(`  ${exists ? (merge ? '[merge]' : '[skip]') : '[new]'} ${file.outputPath} (${file.scenarios.length} scenario${file.scenarios.length > 1 ? 's' : ''})`);
+            // Show assertion preview for the first scenario
+            const firstScenario = file.scenarios[0];
+            if (firstScenario) {
+                const preview = file.content
+                    .split('\n')
+                    .filter((l) => l.trim() && !l.startsWith('import') && !l.includes('openlore:'))
+                    .slice(0, 8)
+                    .map((l) => `      ${l}`)
+                    .join('\n');
+                if (preview)
+                    result.dryRunPreview.push(preview);
+            }
+            continue;
+        }
+        if (exists && !merge) {
+            file.isNew = false;
+            result.skipped++;
+            continue;
+        }
+        if (exists && merge) {
+            const existing = await readFile(absPath, 'utf-8');
+            const existingKeys = extractExistingScenarioKeys(existing);
+            const { content, added } = buildMergedContent(existing, file.content, existingKeys);
+            if (added === 0) {
+                file.isNew = false;
+                result.skipped++;
+                continue;
+            }
+            await writeFile(absPath, content, 'utf-8');
+            file.isNew = false;
+            result.merged++;
+            continue;
+        }
+        // New file
+        await mkdir(dirname(absPath), { recursive: true });
+        await writeFile(absPath, file.content, 'utf-8');
+        file.isNew = true;
+        result.written++;
+    }
+    return result;
+}
+//# sourceMappingURL=test-writer.js.map

package/dist/core/test-generator/test-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-writer.js","sourceRoot":"","sources":["../../../src/core/test-generator/test-writer.ts"],"names":[],"mappings":"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"}