gherkin-ai 2.2.0 → 2.3.1

package/dist/core/step-indexer.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepIndexer = exports.RegexStepParser = exports.TypeScriptStepParser = void 0;
+const ts_morph_1 = require("ts-morph");
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("../utils/logger");
+class TypeScriptStepParser {
+    parse(workspaceRoot) {
+        const steps = [];
+        const project = new ts_morph_1.Project();
+        // Look in common TS/JS E2E directories
+        const searchGlobs = [
+            path_1.default.join(workspaceRoot, 'cypress/support/**/*.ts'),
+            path_1.default.join(workspaceRoot, 'cypress/support/**/*.js'),
+            path_1.default.join(workspaceRoot, 'e2e/steps/**/*.ts'),
+            path_1.default.join(workspaceRoot, 'tests/steps/**/*.ts'),
+            path_1.default.join(workspaceRoot, 'features/step_definitions/**/*.ts')
+        ];
+        project.addSourceFilesAtPaths(searchGlobs);
+        const sourceFiles = project.getSourceFiles();
+        for (const sf of sourceFiles) {
+            // Find all call expressions like Given('...', () => {})
+            const callExpressions = sf.getDescendantsOfKind(ts_morph_1.SyntaxKind.CallExpression);
+            for (const callExpr of callExpressions) {
+                const expression = callExpr.getExpression();
+                const funcName = expression.getText();
+                if (['Given', 'When', 'Then', 'step', 'dado', 'cuando', 'entonces'].includes(funcName)) {
+                    const args = callExpr.getArguments();
+                    if (args.length > 0) {
+                        const firstArg = args[0];
+                        let pattern = '';
+                        // If it's a string literal: Given("I login", ...)
+                        if (firstArg.getKindName() === 'StringLiteral' || firstArg.getKindName() === 'NoSubstitutionTemplateLiteral') {
+                            pattern = firstArg.getText().replace(/^['"`]/, '').replace(/['"`]$/, '');
+                        }
+                        // If it's a regex: Given(/^I login$/, ...)
+                        else if (firstArg.getKindName() === 'RegularExpressionLiteral') {
+                            pattern = firstArg.getText();
+                        }
+                        if (pattern) {
+                            steps.push({
+                                keyword: funcName,
+                                pattern,
+                                filePath: sf.getFilePath()
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        return steps;
+    }
+}
+exports.TypeScriptStepParser = TypeScriptStepParser;
+class RegexStepParser {
+    parse(workspaceRoot) {
+        // A fallback parser for languages without AST support yet (Python, Java, etc.)
+        // Searches text for @given('...') or @When("...")
+        return [];
+    }
+}
+exports.RegexStepParser = RegexStepParser;
+class StepIndexer {
+    parsers = [
+        new TypeScriptStepParser(),
+        new RegexStepParser() // Fallback
+    ];
+    getAvailableSteps(workspaceRoot) {
+        const allSteps = [];
+        for (const parser of this.parsers) {
+            try {
+                const parsed = parser.parse(workspaceRoot);
+                allSteps.push(...parsed);
+            }
+            catch (e) {
+                logger_1.logger.error(`Error parsing steps: ${e.message}`);
+            }
+        }
+        return allSteps;
+    }
+}
+exports.StepIndexer = StepIndexer;
+//# sourceMappingURL=step-indexer.js.map

package/dist/core/step-indexer.js.map

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

package/dist/core/syntax-validator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validates TypeScript syntax in-memory before writing to disk.
+ * Returns true if valid, false if syntax errors exist.
+ */
+export declare function validateTypeScriptSyntax(filename: string, content: string): boolean;
+//# sourceMappingURL=syntax-validator.d.ts.map

package/dist/core/syntax-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-validator.d.ts","sourceRoot":"","sources":["../../src/core/syntax-validator.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBnF"}

package/dist/core/syntax-validator.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTypeScriptSyntax = validateTypeScriptSyntax;
+const ts_morph_1 = require("ts-morph");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Validates TypeScript syntax in-memory before writing to disk.
+ * Returns true if valid, false if syntax errors exist.
+ */
+function validateTypeScriptSyntax(filename, content) {
+    if (!filename.endsWith('.ts') && !filename.endsWith('.tsx')) {
+        return true; // We only validate TS files for now
+    }
+    try {
+        const project = new ts_morph_1.Project({ useInMemoryFileSystem: true });
+        const sourceFile = project.createSourceFile(filename, content);
+        // Check syntactic diagnostics (fast) rather than semantic (slow, requires full project)
+        const diagnostics = sourceFile.getPreEmitDiagnostics();
+        const errors = diagnostics.filter(d => d.getCategory() === 1); // Error category
+        if (errors.length > 0) {
+            console.log(chalk_1.default.yellow(`   ⚠️ Pre-validation failed for ${filename}:`));
+            for (const diag of errors.slice(0, 3)) {
+                console.log(chalk_1.default.yellow(`      - ${diag.getMessageText()}`));
+            }
+            return false;
+        }
+        return true;
+    }
+    catch (err) {
+        console.log(chalk_1.default.yellow(`   ⚠️ Pre-validation exception for ${filename}: ${err.message}`));
+        return false;
+    }
+}
+//# sourceMappingURL=syntax-validator.js.map

package/dist/core/syntax-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-validator.js","sourceRoot":"","sources":["../../src/core/syntax-validator.ts"],"names":[],"mappings":";;;;;AAOA,4DAyBC;AAhCD,uCAAmC;AACnC,kDAA0B;AAE1B;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,QAAgB,EAAE,OAAe;IACxE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,CAAC,oCAAoC;IACnD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,kBAAO,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE/D,wFAAwF;QACxF,MAAM,WAAW,GAAG,UAAU,CAAC,qBAAqB,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB;QAEhF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,mCAAmC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC1E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,sCAAsC,QAAQ,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/generators/prompt-templates/base.d.ts

@@ -2,12 +2,16 @@ import { GherkinAIConfig } from '../../core/config';
 import { ParsedFeature } from '../../core/gherkin-parser';
 import { ArchRuleSpec } from '../../core/arch-rules';
 import { StackSpec } from '../../core/stack-specs';
+import { ExtractedStep } from '../../core/step-indexer';
+import { AppContext } from '../../core/context-extractor';
 export interface PromptTemplateContext {
     config: GherkinAIConfig;
     parsed: ParsedFeature;
     arch: ArchRuleSpec;
     spec: StackSpec;
     isSpanishUser: boolean;
+    availableSteps: ExtractedStep[];
+    appContext: AppContext;
 }
 export interface PromptTemplate {
     name: string;

package/dist/generators/prompt-templates/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/generators/prompt-templates/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;IAC5C,mBAAmB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC5D,oBAAoB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC7D,eAAe,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IACxD,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;CAC1D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAOrG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAEnE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/generators/prompt-templates/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;IAC5C,mBAAmB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC5D,oBAAoB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC7D,eAAe,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IACxD,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;CAC1D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAOrG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAEnE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAEjE"}

package/dist/generators/prompt-templates/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/generators/prompt-templates/base.ts"],"names":[],"mappings":";;AAsBA,8CAOC;AAED,4CAEC;AAED,wCAEC;AAfD,SAAgB,iBAAiB,CAAC,IAAY,EAAE,SAAiB,EAAE,GAA0B;IAC3F,IAAI,MAAM,GAAG,YAAY,IAAI,IAAI,CAAC;IAClC,MAAM,IAAI,cAAc,SAAS,MAAM,CAAC;IACxC,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,MAAM,IAAI,gJAAgJ,CAAC;IAC7J,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,gBAAgB,CAAC,GAA0B;IACzD,OAAO,6BAA6B,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/H,CAAC;AAED,SAAgB,cAAc,CAAC,GAA0B;IACvD,OAAO,6BAA6B,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACnH,CAAC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/generators/prompt-templates/base.ts"],"names":[],"mappings":";;AA0BA,8CAOC;AAED,4CAEC;AAED,wCAEC;AAfD,SAAgB,iBAAiB,CAAC,IAAY,EAAE,SAAiB,EAAE,GAA0B;IAC3F,IAAI,MAAM,GAAG,YAAY,IAAI,IAAI,CAAC;IAClC,MAAM,IAAI,cAAc,SAAS,MAAM,CAAC;IACxC,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,MAAM,IAAI,gJAAgJ,CAAC;IAC7J,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,gBAAgB,CAAC,GAA0B;IACzD,OAAO,6BAA6B,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/H,CAAC;AAED,SAAgB,cAAc,CAAC,GAA0B;IACvD,OAAO,6BAA6B,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACnH,CAAC"}

package/dist/generators/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/generators/prompts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BtG"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/generators/prompts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AASjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgEtG"}

package/dist/generators/prompts.js

@@ -8,16 +8,24 @@ const arch_rules_1 = require("../core/arch-rules");
 const stack_specs_1 = require("../core/stack-specs");
 const factory_1 = require("./prompt-templates/factory");
 const i18n_cli_1 = require("../utils/i18n-cli");
+const step_indexer_1 = require("../core/step-indexer");
+const context_extractor_1 = require("../core/context-extractor");
 function generatePrompts(parsed, config) {
     const arch = (0, arch_rules_1.getArchRule)(config.architecture);
     const spec = (0, stack_specs_1.getStackSpec)(config.stack);
     const isSpanishUser = (0, i18n_cli_1.getGlobalUserLocale)() === 'es';
+    const indexer = new step_indexer_1.StepIndexer();
+    const availableSteps = indexer.getAvailableSteps(process.cwd());
+    const extractor = new context_extractor_1.ContextExtractor();
+    const appContext = extractor.extract(process.cwd());
     const ctx = {
         config,
         parsed,
         arch,
         spec,
-        isSpanishUser
+        isSpanishUser,
+        availableSteps,
+        appContext
     };
     const template = (0, factory_1.resolvePromptTemplate)(config);
     const result = {
@@ -25,8 +33,36 @@ function generatePrompts(parsed, config) {
         'backend-agent.md': template.generateBackendAgent(ctx),
         'qa-agent.md': template.generateQaAgent(ctx)
     };
+    // Inject DOM and Data Models to Backend/QA/Domain agents
+    let contextDict = '';
+    if (ctx.appContext.dataModels.length > 0) {
+        contextDict += `\n## [MANDATORY] Extracted Data Models (Prisma)\n\`\`\`prisma\n${ctx.appContext.dataModels.join('\n\n')}\n\`\`\`\n`;
+        result['backend-agent.md'] += contextDict;
+        result['domain-agent.md'] += contextDict;
+    }
+    if (ctx.appContext.domSelectors.length > 0) {
+        let domDict = `\n## [MANDATORY] Discovered DOM Selectors (POM)\nYou must use these selectors in your tests:\n${ctx.appContext.domSelectors.map(s => `- \`${s}\``).join('\n')}\n`;
+        result['qa-agent.md'] += domDict;
+    }
+    // Inject extracted Step Definitions (AST Indexing) to force step reuse
+    if (ctx.availableSteps && ctx.availableSteps.length > 0) {
+        let stepsDict = `\n## [MANDATORY] Step Definitions Dictionary\n`;
+        stepsDict += `You MUST reuse the following existing Step Definitions whenever possible instead of inventing new ones:\n\n`;
+        ctx.availableSteps.forEach(st => {
+            stepsDict += `- \`${st.keyword} ${st.pattern}\` (found in ${st.filePath})\n`;
+        });
+        result['qa-agent.md'] += stepsDict;
+    }
     if (template.generateAiAgent && config.stack.aiEngine) {
         result['ai-engineer-agent.md'] = template.generateAiAgent(ctx);
+        if (contextDict)
+            result['ai-engineer-agent.md'] += contextDict;
+        if (ctx.appContext.domSelectors.length > 0) {
+            result['ai-engineer-agent.md'] += `\n## [MANDATORY] Discovered DOM Selectors (POM)\nYou must use these selectors in your UI tests:\n${ctx.appContext.domSelectors.map(s => `- \`${s}\``).join('\n')}\n`;
+        }
+        if (ctx.availableSteps && ctx.availableSteps.length > 0) {
+            result['ai-engineer-agent.md'] += `\n## [MANDATORY] Step Definitions Dictionary\nYou MUST reuse existing Step Definitions in QA specs:\n${ctx.availableSteps.map(s => `- \`${s.keyword} ${s.pattern}\``).join('\n')}\n`;
+        }
     }
     return result;
 }

package/dist/generators/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/generators/prompts.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAUhF,0CA0BC;AAhCD,mDAAiD;AACjD,qDAAmD;AACnD,wDAAmE;AAEnE,gDAAwD;AAExD,SAAgB,eAAe,CAAC,MAAqB,EAAE,MAAuB;IAC5E,MAAM,IAAI,GAAG,IAAA,wBAAW,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAA,0BAAY,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,IAAA,8BAAmB,GAAE,KAAK,IAAI,CAAC;IAErD,MAAM,GAAG,GAA0B;QACjC,MAAM;QACN,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,aAAa;KACd,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAA,+BAAqB,EAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,MAAM,GAA2B;QACrC,iBAAiB,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC;QACpD,kBAAkB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,CAAC;QACtD,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC;KAC7C,CAAC;IAEF,IAAI,QAAQ,CAAC,eAAe,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtD,MAAM,CAAC,sBAAsB,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/generators/prompts.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -135,6 +135,8 @@ program
     .option('-t, --target <directory>', 'Target directory to inject contracts')
     .option('-l, --lang <locale>', 'Override CLI interaction language for this run (en or es)')
     .option('-C, --caveman', 'Enable simple prompt creation mode (skip step-by-step wizard)')
+    .option('--headless', 'Run in headless non-interactive mode for CI/CD')
+    .option('--config <file>', 'Path to JSON configuration file for headless mode')
     .action(async (options) => {
     await (0, create_1.handleCreateCommand)(options);
 });

package/dist/index.js.map

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

package/dist/ui/public/index.html

@@ -0,0 +1,156 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Gherkin AI Studio</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
+    <style>
+        body { font-family: 'Inter', sans-serif; background-color: #0f172a; color: #e2e8f0; }
+        .glass-panel { background: rgba(30, 41, 59, 0.7); backdrop-filter: blur(10px); border: 1px solid rgba(255, 255, 255, 0.1); border-radius: 12px; }
+        .code-bg { background-color: #1e293b; color: #38bdf8; font-family: monospace; }
+        .gradient-text { background: linear-gradient(to right, #38bdf8, #818cf8); -webkit-background-clip: text; color: transparent; }
+    </style>
+</head>
+<body class="min-h-screen flex flex-col p-6">
+    <header class="flex justify-between items-center mb-8 glass-panel p-4 px-6 shadow-lg">
+        <h1 class="text-2xl font-bold gradient-text flex items-center gap-3">
+            <i class="fa-solid fa-robot"></i> Gherkin AI Studio
+        </h1>
+        <div id="stack-badge" class="hidden items-center gap-2 px-3 py-1 bg-indigo-900/50 text-indigo-200 border border-indigo-700/50 rounded-full text-sm font-medium">
+            <i class="fa-solid fa-layer-group"></i> <span id="stack-name">Detecting...</span>
+        </div>
+    </header>
+
+    <main class="flex-1 grid grid-cols-1 lg:grid-cols-2 gap-6">
+        <!-- Editor Section -->
+        <section class="glass-panel p-6 flex flex-col shadow-xl">
+            <h2 class="text-xl font-semibold mb-4 text-sky-400 border-b border-slate-700 pb-2"><i class="fa-regular fa-file-code"></i> Feature Specification</h2>
+            <div class="mb-4">
+                <label class="block text-sm font-medium text-slate-400 mb-1">Feature Name</label>
+                <input type="text" id="feature-name" placeholder="e.g. User Authentication" class="w-full bg-slate-800 border border-slate-600 rounded-md p-2 text-white focus:outline-none focus:ring-2 focus:ring-sky-500">
+            </div>
+            <div class="flex-1 flex flex-col">
+                <label class="block text-sm font-medium text-slate-400 mb-1">Gherkin Scenarios</label>
+                <textarea id="gherkin-text" class="w-full flex-1 min-h-[300px] bg-slate-900 border border-slate-700 rounded-md p-4 text-sky-100 font-mono text-sm focus:outline-none focus:ring-2 focus:ring-sky-500" placeholder="Feature: Example Feature&#10;&#10;  Scenario: Successful login&#10;    Given the user is on the login page&#10;    When they enter valid credentials&#10;    Then they should be redirected to the dashboard"></textarea>
+            </div>
+            <button id="generate-btn" class="mt-6 w-full py-3 bg-gradient-to-r from-sky-500 to-indigo-600 hover:from-sky-400 hover:to-indigo-500 text-white font-bold rounded-lg shadow-lg shadow-sky-500/20 transition-all flex justify-center items-center gap-2">
+                <i class="fa-solid fa-wand-magic-sparkles"></i> Generate AI Agents & Contracts
+            </button>
+        </section>
+
+        <!-- Results Section -->
+        <section class="glass-panel p-6 flex flex-col shadow-xl">
+            <h2 class="text-xl font-semibold mb-4 text-indigo-400 border-b border-slate-700 pb-2"><i class="fa-solid fa-microchip"></i> Generation Results</h2>
+            
+            <div id="loading" class="hidden flex-1 flex flex-col justify-center items-center text-slate-400">
+                <i class="fa-solid fa-circle-notch fa-spin text-4xl mb-4 text-sky-500"></i>
+                <p>Orchestrating agents and generating code...</p>
+            </div>
+
+            <div id="results-empty" class="flex-1 flex flex-col justify-center items-center text-slate-500 text-center p-8">
+                <i class="fa-regular fa-folder-open text-6xl mb-4 opacity-50"></i>
+                <p>Waiting for Gherkin specification.<br>Click Generate to see the results here.</p>
+            </div>
+
+            <div id="results-content" class="hidden flex-1 flex flex-col gap-4 overflow-y-auto pr-2">
+                <div class="bg-emerald-900/30 border border-emerald-700/50 text-emerald-200 p-4 rounded-lg flex items-start gap-3">
+                    <i class="fa-solid fa-check-circle mt-1"></i>
+                    <div>
+                        <p class="font-bold">Generation Successful!</p>
+                        <p class="text-sm opacity-80" id="success-path">Files saved to ./generated-specs/</p>
+                    </div>
+                </div>
+
+                <h3 class="font-semibold text-slate-300 mt-2">Generated Files:</h3>
+                <div id="file-list" class="flex flex-col gap-2">
+                    <!-- Files injected via JS -->
+                </div>
+            </div>
+        </section>
+    </main>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', async () => {
+            // Fetch detected stack
+            try {
+                const res = await fetch('/api/stack');
+                const data = await res.json();
+                if (data.success) {
+                    const cfg = data.config;
+                    document.getElementById('stack-name').textContent = `${cfg.architecture.toUpperCase()} | ${cfg.stack.language} (${cfg.stack.framework})`;
+                    document.getElementById('stack-badge').classList.remove('hidden');
+                    document.getElementById('stack-badge').classList.add('flex');
+                }
+            } catch (err) {
+                console.error("Failed to fetch stack", err);
+            }
+
+            // Handle Generate Button
+            document.getElementById('generate-btn').addEventListener('click', async () => {
+                const featureName = document.getElementById('feature-name').value;
+                const gherkinText = document.getElementById('gherkin-text').value;
+
+                if (!gherkinText.trim()) {
+                    alert("Please write some Gherkin scenarios first.");
+                    return;
+                }
+
+                // UI State
+                document.getElementById('results-empty').classList.add('hidden');
+                document.getElementById('results-content').classList.add('hidden');
+                document.getElementById('loading').classList.remove('hidden');
+                document.getElementById('loading').classList.add('flex');
+                document.getElementById('generate-btn').disabled = true;
+
+                try {
+                    const res = await fetch('/api/generate', {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ featureName, gherkinText })
+                    });
+                    const data = await res.json();
+
+                    document.getElementById('loading').classList.add('hidden');
+                    document.getElementById('loading').classList.remove('flex');
+
+                    if (data.success) {
+                        document.getElementById('results-content').classList.remove('hidden');
+                        document.getElementById('results-content').classList.add('flex');
+                        document.getElementById('success-path').textContent = `Saved to: ${data.outDir}`;
+
+                        const fileList = document.getElementById('file-list');
+                        fileList.innerHTML = '';
+                        Object.keys(data.files).forEach(filename => {
+                            const div = document.createElement('div');
+                            const isMd = filename.endsWith('.md');
+                            div.className = 'bg-slate-800 border border-slate-700 rounded p-3 text-sm flex justify-between items-center';
+                            div.innerHTML = `
+                                <div class="flex items-center gap-2">
+                                    <i class="fa-solid ${isMd ? 'fa-file-lines text-sky-400' : 'fa-code text-amber-400'}"></i>
+                                    <span class="font-mono">${filename}</span>
+                                </div>
+                                <span class="text-xs bg-slate-700 px-2 py-1 rounded text-slate-300">Generated</span>
+                            `;
+                            fileList.appendChild(div);
+                        });
+                    } else {
+                        alert("Error generating specs: " + data.error);
+                        document.getElementById('results-empty').classList.remove('hidden');
+                        document.getElementById('results-empty').classList.add('flex');
+                    }
+                } catch (err) {
+                    alert("Network error: " + err.message);
+                    document.getElementById('loading').classList.add('hidden');
+                    document.getElementById('loading').classList.remove('flex');
+                    document.getElementById('results-empty').classList.remove('hidden');
+                    document.getElementById('results-empty').classList.add('flex');
+                } finally {
+                    document.getElementById('generate-btn').disabled = false;
+                }
+            });
+        });
+    </script>
+</body>
+</html>

package/docs/ai-skills.md

@@ -0,0 +1,42 @@
+# AI Skills & Context Extraction
+
+`gherkin-ai` is built to seamlessly integrate with modern AI IDEs and standalone agents. It provides native skills and context anchors to ensure the LLM understands your architecture.
+
+## 1. Context Anchoring (DOM & Data Models)
+
+Generating Gherkin specs in a vacuum produces abstract scenarios that require human intervention to execute. To generate truly executable automation, the AI must understand your application's technical reality.
+
+`gherkin-ai` introduces **Context Extractor**.
+
+Before generating prompts or agent contexts, the CLI scans your workspace for:
+- **Data Models:** It parses `prisma/schema.prisma` to extract your entity schemas (up to 5 models).
+- **DOM Selectors (Page Object Model):** It scans your `e2e/` folder for `data-test` and `data-testid` attributes.
+
+These assets are injected into the agent's markdown instructions as `[MANDATORY]` directives, forcing the LLM to write tests that match the actual database models and frontend HTML structure.
+
+## 2. Cursor & Windsurf Skills (`ghk skill`)
+
+Modern AI IDEs like [Cursor](https://cursor.sh/) and [Windsurf](https://codeium.com/windsurf) support custom `.cursorrules` and project instructions to steer the built-in AI's behavior.
+
+The `ghk skill` command configures `gherkin-ai` as a native skill inside your IDE.
+
+```bash
+ghk skill
+```
+
+This command automatically generates a `.cursorrules` file (or appends to an existing one) instructing the IDE's AI to:
+1. Always parse `.feature` files to understand business logic.
+2. Use `ghk verify --auto-fix` whenever running tests.
+3. Automatically run `ghk diff` to ensure DTOs match specs.
+
+By configuring this skill, your AI assistant goes from being a generic coding bot to an enterprise-grade QA engineer constrained by BDD specifications.
+
+## 3. Model Context Protocol (MCP)
+
+For desktop agents like Claude Desktop, `gherkin-ai` operates as a native JSON-RPC Model Context Protocol (MCP) server.
+
+```bash
+ghk mcp install
+```
+
+This command auto-configures your `claude_desktop_config.json`, exposing tools that the AI can call natively to validate syntax, generate contracts, or read the Step Definitions dictionary in real-time.

package/docs/ast-step-indexer.md

@@ -0,0 +1,47 @@
+# AST Step Definitions Indexer
+
+A common challenge when integrating AI into Behavior-Driven Development (BDD) is **AI Hallucination**: Large Language Models (LLMs) tend to invent generic Gherkin steps (e.g., `Given that the user enters data`) rather than reusing the exact Step Definitions already implemented in your test automation framework (e.g., `Given I navigate to login`).
+
+This lack of alignment forces QA engineers to manually rewrite generated steps or duplicate test executor code.
+
+## How `gherkin-ai` Solves This
+
+`gherkin-ai` incorporates an advanced **AST (Abstract Syntax Tree) Step Indexer** powered by `ts-morph`.
+
+Instead of relying on the LLM's raw creativity, the CLI performs static code analysis on your project workspace before generating any AI prompts.
+
+### 1. Static Analysis
+The indexer scans common E2E directories in your project:
+- `cypress/support/**/*.ts`
+- `e2e/steps/**/*.ts`
+- `features/step_definitions/**/*.ts`
+
+It extracts the string literals and regular expressions defined inside `Given`, `When`, and `Then` function calls.
+
+### 2. Prompt Injection (The Dictionary)
+All extracted steps are compiled into a mandatory "Step Definitions Dictionary" and injected into the System Prompt for the `qa-agent` and `ai-engineer` agents.
+
+The prompt explicitly enforces:
+> *You MUST reuse the following existing Step Definitions whenever possible instead of inventing new ones.*
+
+### Example
+
+**Existing Cypress Step:**
+```typescript
+Given('I navigate to the {string} page', (pageName: string) => {
+    cy.visit(`/${pageName}`);
+});
+```
+
+**What the AI Agent sees:**
+```markdown
+## [MANDATORY] Step Definitions Dictionary
+You MUST reuse the following existing Step Definitions whenever possible instead of inventing new ones:
+- `Given I navigate to the {string} page` (found in cypress/support/steps.ts)
+```
+
+## Phased Language Support
+
+Currently, the AST Indexer natively supports TypeScript and JavaScript ecosystems (Cypress, Playwright, Cucumber-JS) via `ts-morph`. 
+
+A secondary `RegexStepParser` acts as a fallback foundation designed to support Python (Behave), Java (Cucumber-JVM), and other languages in future phases.

package/docs/headless-mode.md

@@ -0,0 +1,74 @@
+# Headless CI/CD Mode
+
+`gherkin-ai` is designed to be an enterprise automation framework. While the interactive CLI wizard (`ghk create`) is excellent for local development, CI/CD pipelines (like GitHub Actions, GitLab CI, Azure DevOps) operate in non-interactive (TTY-less) environments where standard input prompts cause execution to hang.
+
+To solve this, `gherkin-ai` provides a robust **Headless Mode**.
+
+## Usage
+
+You can completely bypass the interactive `inquirer` prompts by combining the `--headless` flag with the `--config` flag.
+
+```bash
+ghk create --headless --config my-spec.json
+```
+
+### Configuration File (`my-spec.json`)
+
+The `--config` file must contain the structured JSON representation of your feature.
+
+```json
+{
+  "featureName": "Two Factor Authentication 2FA",
+  "actor": "authenticated system user",
+  "action": "enable and verify a two-factor OTP code",
+  "outcome": "protect my account against unauthorized access",
+  "scenarioName": "Enable and verify 2FA code successfully",
+  "injectTarget": "./src/application/dtos",
+  "steps": [
+    {
+      "keyword": "Given",
+      "text": "the user has logged in successfully"
+    },
+    {
+      "keyword": "When",
+      "text": "they enter a valid 6-digit OTP code"
+    },
+    {
+      "keyword": "Then",
+      "text": "the system authenticates the session"
+    }
+  ]
+}
+```
+
+## Integration with GitHub Actions
+
+Here is an example of running `gherkin-ai` completely headlessly inside a GitHub Actions workflow:
+
+```yaml
+name: Generate Contracts
+
+on:
+  push:
+    branches: [ "main" ]
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install gherkin-ai
+        run: npm install -g gherkin-ai
+
+      - name: Generate Feature Headlessly
+        run: ghk create --headless --config specs/login-spec.json --output specs/login.feature
+        
+      - name: Generate Typings & Prompts
+        run: ghk generate -f specs/login.feature
+```