gherkin-ai 1.3.2 → 1.4.0

package/README.md

@@ -16,29 +16,33 @@ While simple AI prompt generators produce generic text instructions, AI agents o
 - **`contracts.ts`**: Strict domain interfaces, event schemas, Zod DTOs, CQRS Event Store ports, and Architecture Decision Records (ADRs).
 - **`openapi.json`**: Auto-generated OpenAPI 3.0 specification derived directly from Gherkin AST schemas.
 - **`fixtures.ts` & `seed.sql`**: Concrete database seeds (hashed passwords, bcrypt cost factor 12, pre-conditions) raising AI acceptance test success rates from ~30% to ~85%.
-- **Brownfield Integration (`ghk detect` & `ghk add`)**: Inject contracts directly into existing project module folders without starting from scratch.
+- **Interactive Spec Wizard (`ghk create`)**: Create Gherkin specifications step-by-step directly from your terminal.
+- **Brownfield Integration (`ghk detect` & `ghk add`)**: Inject contracts directly into existing project module folders (Laravel, Rails, .NET, Angular, NestJS, etc.).
 - **Bilingual Gherkin Parsing**: Native support for English (`Given/When/Then`) and Spanish (`Dado/Cuando/Entonces`).
-- **Strict Stack Versions**: Enforces explicit package versions (e.g., NestJS v10 + Prisma + Zod + Redis) so agents never diverge.
-- **Runnable Infrastructure**: Includes pre-configured `docker-compose.yml` (PostgreSQL, Redis, RabbitMQ) and native AWS Lambda `serverless.yml` for FaaS architectures.
-- **`ghk validate`**: Deep Architectural Linter checking layer boundary import isolation, step coverage, and circular dependency rules.
 
 ---
 
-## 🚀 Usage Modes: Greenfield vs. Brownfield (Existing Projects)
+## 🚀 Quick Start Commands
 
-### 1. Existing Projects (Brownfield Mode)
+### 1. Create a Gherkin Spec Interactively (`ghk create`)
 
-If you have an existing codebase, auto-detect your stack and inject feature contracts into specific module folders:
+Don't have a `.feature` file ready? Build one interactively step-by-step in terminal:
 
 ```bash
-# 1. Auto-detect stack (reads package.json, prisma, tsconfig, etc.)
+ghk create   # (or: ghk new)
+```
+
+### 2. Existing Projects (Brownfield Mode)
+
+```bash
+# 1. Auto-detect stack (Laravel, Rails, .NET, NestJS, Angular, Flutter, etc.)
 ghk detect
 
 # 2. Inject contract directly into an existing module folder
 ghk add --feature ./specs/payments.feature --target ./src/modules/payments
 ```
 
-### 2. New Projects (Greenfield Mode)
+### 3. New Projects (Greenfield Mode)
 
 ```bash
 # 1. Initialize project configuration interactively
@@ -53,17 +57,6 @@ ghk validate --feature ./specs/auth.feature
 
 ---
 
-## 🏗️ Supported Architecture Styles
-
-- **Hexagonal Architecture (Ports & Adapters)**
-- **Domain-Driven Design (DDD)**
-- **Clean Architecture**
-- **CQRS + Event Sourcing (Real Event Store & Aggregate Versions)**
-- **Serverless / FaaS (Native AWS Lambda & `serverless.yml`)**
-- **Microservices Architecture**
-
----
-
 ## 📖 Complete Documentation
 
 - [Comprehensive Usage Guide](docs/USAGE_GUIDE.md)

package/dist/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAaA,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDrH"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAeA,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwErH"}

package/dist/commands/add.js

@@ -8,24 +8,40 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleAddCommand = handleAddCommand;
 const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
 const config_1 = require("../core/config");
 const stack_detector_1 = require("../core/stack-detector");
 const gherkin_parser_1 = require("../core/gherkin-parser");
 const contracts_1 = require("../generators/contracts");
 const prompts_1 = require("../generators/prompts");
+const create_1 = require("./create");
 const file_system_1 = require("../utils/file-system");
 const logger_1 = require("../utils/logger");
 async function handleAddCommand(options) {
     logger_1.logger.banner();
     if (!options.feature) {
-        logger_1.logger.error('Missing required option: --feature <file>');
-        logger_1.logger.info('Usage: ghk add --feature ./specs/my-feature.feature [--target ./src/modules/my-feature]');
-        process.exit(1);
+        logger_1.logger.info('No --feature file specified. Launching interactive spec wizard...');
+        await (0, create_1.handleCreateCommand)({ target: options.target });
+        return;
     }
     const featurePath = path_1.default.resolve(process.cwd(), options.feature);
     if (!(0, file_system_1.fileExistsSync)(featurePath)) {
-        logger_1.logger.error(`Feature file not found at: ${featurePath}`);
-        process.exit(1);
+        logger_1.logger.warn(`Feature file not found at: ${featurePath}`);
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: 'confirm',
+                name: 'createNow',
+                message: '¿Deseas crear la especificación Gherkin paso a paso ahora (wizard interactivo)?',
+                default: true
+            }
+        ]);
+        if (answer.createNow) {
+            await (0, create_1.handleCreateCommand)({ output: options.feature, target: options.target });
+            return;
+        }
+        else {
+            process.exit(1);
+        }
     }
     // Load config or auto-detect if config doesn't exist
     let config = (0, config_1.loadConfig)(options.config);

package/dist/commands/add.js.map

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

package/dist/commands/create.d.ts

@@ -0,0 +1,6 @@
+export declare function handleCreateCommand(options: {
+    output?: string;
+    target?: string;
+    lang?: string;
+}): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAWA,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiIrH"}

package/dist/commands/create.js

@@ -0,0 +1,130 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - 'create' Command Handler (Localized Interactive Spec Wizard)
+   ========================================================================== */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCreateCommand = handleCreateCommand;
+const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const add_1 = require("./add");
+const i18n_cli_1 = require("../utils/i18n-cli");
+const file_system_1 = require("../utils/file-system");
+const logger_1 = require("../utils/logger");
+async function handleCreateCommand(options) {
+    logger_1.logger.banner();
+    const locale = await (0, i18n_cli_1.ensureCliLanguage)(options.lang);
+    const isEs = locale === 'es';
+    logger_1.logger.info(isEs ? 'Asistente Interactivo Gherkin - Creación paso a paso' : 'Interactive Gherkin Spec Wizard - Step-by-step feature creator');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'featureName',
+            message: (0, i18n_cli_1.t)('featureNamePrompt', locale),
+            default: isEs ? 'Autenticación de Doble Factor 2FA' : 'Two Factor Authentication 2FA',
+            validate: (input) => input.trim().length > 0 || 'Name cannot be empty.'
+        },
+        {
+            type: 'input',
+            name: 'actor',
+            message: (0, i18n_cli_1.t)('actorPrompt', locale),
+            default: isEs ? 'usuario autenticado del sistema' : 'authenticated system user'
+        },
+        {
+            type: 'input',
+            name: 'action',
+            message: (0, i18n_cli_1.t)('actionPrompt', locale),
+            default: isEs ? 'habilitar y verificar un código OTP de dos factores' : 'enable and verify a two-factor OTP code'
+        },
+        {
+            type: 'input',
+            name: 'outcome',
+            message: (0, i18n_cli_1.t)('outcomePrompt', locale),
+            default: isEs ? 'proteger mi cuenta contra accesos no autorizados' : 'protect my account against unauthorized access'
+        },
+        {
+            type: 'input',
+            name: 'scenarioName',
+            message: (0, i18n_cli_1.t)('scenarioNamePrompt', locale),
+            default: isEs ? 'Habilitar y verificar código 2FA exitosamente' : 'Enable and verify 2FA code successfully'
+        }
+    ]);
+    const steps = [];
+    console.log(isEs ? '\n--- Asistente de Pasos Gherkin (Dado / Cuando / Entonces) ---' : '\n--- Step-by-step Gherkin Scenario Builder (Given / When / Then) ---');
+    let addMore = true;
+    let defaultKw = isEs ? 'Dado' : 'Given';
+    const choicesEn = ['Given', 'When', 'Then', 'And', 'But'];
+    const choicesEs = ['Dado', 'Cuando', 'Entonces', 'Y', 'Pero'];
+    while (addMore) {
+        const stepAnswers = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'keyword',
+                message: (0, i18n_cli_1.t)('stepKeywordPrompt', locale),
+                choices: isEs ? choicesEs : choicesEn,
+                default: defaultKw
+            },
+            {
+                type: 'input',
+                name: 'text',
+                message: (0, i18n_cli_1.t)('stepDescPrompt', locale),
+                validate: (input) => input.trim().length > 0 || 'Description cannot be empty.'
+            },
+            {
+                type: 'confirm',
+                name: 'next',
+                message: (0, i18n_cli_1.t)('addAnotherStepPrompt', locale),
+                default: true
+            }
+        ]);
+        steps.push({ keyword: stepAnswers.keyword, text: stepAnswers.text });
+        if (['Dado', 'Given'].includes(stepAnswers.keyword))
+            defaultKw = isEs ? 'Cuando' : 'When';
+        else if (['Cuando', 'When'].includes(stepAnswers.keyword))
+            defaultKw = isEs ? 'Entonces' : 'Then';
+        else
+            defaultKw = isEs ? 'Y' : 'And';
+        addMore = stepAnswers.next;
+    }
+    // Construct Gherkin File Content
+    const featureKw = isEs ? 'Característica:' : 'Feature:';
+    const asKw = isEs ? 'Como' : 'As a';
+    const wantKw = isEs ? 'Quiero' : 'I want to';
+    const soKw = isEs ? 'Para' : 'So that';
+    const scKw = isEs ? 'Escenario:' : 'Scenario:';
+    let gherkinContent = `${featureKw} ${answers.featureName}\n`;
+    gherkinContent += `  ${asKw} ${answers.actor}\n`;
+    gherkinContent += `  ${wantKw} ${answers.action}\n`;
+    gherkinContent += `  ${soKw} ${answers.outcome}\n\n`;
+    gherkinContent += `  ${scKw} ${answers.scenarioName}\n`;
+    steps.forEach(st => {
+        gherkinContent += `    ${st.keyword} ${st.text}\n`;
+    });
+    const defaultFileName = answers.featureName.toLowerCase().replace(/[^a-z0-9]/g, '_') + '.feature';
+    const targetSpecPath = options.output
+        ? path_1.default.resolve(process.cwd(), options.output)
+        : path_1.default.resolve(process.cwd(), 'specs', defaultFileName);
+    (0, file_system_1.writeFileSync)(targetSpecPath, gherkinContent);
+    logger_1.logger.success(`${(0, i18n_cli_1.t)('specCreated', locale)} ${targetSpecPath}`);
+    console.log('\n------------------------------------------------------------');
+    console.log(gherkinContent);
+    console.log('------------------------------------------------------------\n');
+    // Prompt to immediately inject contracts into project
+    const injectAnswer = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'inject',
+            message: (0, i18n_cli_1.t)('injectPrompt', locale),
+            default: true
+        }
+    ]);
+    if (injectAnswer.inject) {
+        await (0, add_1.handleAddCommand)({
+            feature: targetSpecPath,
+            target: options.target
+        });
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/lang.d.ts

@@ -0,0 +1,4 @@
+export declare function handleLangCommand(options: {
+    set?: string;
+}): Promise<void>;
+//# sourceMappingURL=lang.d.ts.map

package/dist/commands/lang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../src/commands/lang.ts"],"names":[],"mappings":"AAQA,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhF"}

package/dist/commands/lang.js

@@ -0,0 +1,38 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - 'lang' Command Handler (Language Switcher)
+   ========================================================================== */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleLangCommand = handleLangCommand;
+const inquirer_1 = __importDefault(require("inquirer"));
+const i18n_cli_1 = require("../utils/i18n-cli");
+const logger_1 = require("../utils/logger");
+async function handleLangCommand(options) {
+    logger_1.logger.banner();
+    if (options.set === 'en' || options.set === 'es') {
+        (0, i18n_cli_1.saveGlobalUserLocale)(options.set);
+        logger_1.logger.success((0, i18n_cli_1.t)('langUpdated', options.set));
+        return;
+    }
+    const current = (0, i18n_cli_1.getGlobalUserLocale)() || 'en';
+    logger_1.logger.info(`${(0, i18n_cli_1.t)('langCurrent', current)} ${current === 'es' ? '🇪🇸 Español' : '🇺🇸 English'}`);
+    const answer = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'locale',
+            message: (0, i18n_cli_1.t)('selectLanguagePrompt', current),
+            choices: [
+                { name: '🇺🇸 English', value: 'en' },
+                { name: '🇪🇸 Español', value: 'es' }
+            ],
+            default: current
+        }
+    ]);
+    const selected = answer.locale;
+    (0, i18n_cli_1.saveGlobalUserLocale)(selected);
+    logger_1.logger.success((0, i18n_cli_1.t)('langUpdated', selected));
+}
+//# sourceMappingURL=lang.js.map

package/dist/commands/lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../src/commands/lang.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;;;;AAMhF,8CA4BC;AAhCD,wDAAgC;AAChC,gDAAqH;AACrH,4CAAyC;AAElC,KAAK,UAAU,iBAAiB,CAAC,OAAyB;IAC/D,eAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACjD,IAAA,+BAAoB,EAAC,OAAO,CAAC,GAAsB,CAAC,CAAC;QACrD,eAAM,CAAC,OAAO,CAAC,IAAA,YAAC,EAAC,aAAa,EAAE,OAAO,CAAC,GAAsB,CAAC,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,8BAAmB,GAAE,IAAI,IAAI,CAAC;IAC9C,eAAM,CAAC,IAAI,CAAC,GAAG,IAAA,YAAC,EAAC,aAAa,EAAE,OAAO,CAAC,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;IAElG,MAAM,MAAM,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAC;QACnC;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAA,YAAC,EAAC,sBAAsB,EAAE,OAAO,CAAC;YAC3C,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE;gBACrC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE;aACtC;YACD,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAyB,CAAC;IAClD,IAAA,+BAAoB,EAAC,QAAQ,CAAC,CAAC;IAC/B,eAAM,CAAC,OAAO,CAAC,IAAA,YAAC,EAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/index.js

@@ -10,14 +10,17 @@ const validate_1 = require("./commands/validate");
 const export_1 = require("./commands/export");
 const detect_1 = require("./commands/detect");
 const add_1 = require("./commands/add");
+const create_1 = require("./commands/create");
+const lang_1 = require("./commands/lang");
 // Dynamic version from package.json
 const pkg = require('../package.json');
 const program = new commander_1.Command();
 program
     .name('gherkin-ai')
     .description('CLI tool & contract engine translating Gherkin specs into executable prompts, TypeScript contracts, and seed fixtures for AI Agents.')
-    .version(pkg.version || '1.3.0')
+    .version(pkg.version || '1.4.0')
     .option('--init', 'Alias for init command')
+    .option('--create', 'Alias for create command')
     .option('--generate', 'Alias for generate command')
     .option('--validate', 'Alias for validate command')
     .option('--detect', 'Alias for detect command');
@@ -28,6 +31,26 @@ program
     .action(async () => {
     await (0, init_1.handleInitCommand)();
 });
+program
+    .command('lang')
+    .alias('l')
+    .alias('language')
+    .description('Configure CLI preferred interaction language (English or Spanish)')
+    .option('-s, --set <locale>', 'Set language directly (en or es)')
+    .action(async (options) => {
+    await (0, lang_1.handleLangCommand)(options);
+});
+program
+    .command('create')
+    .alias('c')
+    .alias('new')
+    .description('Create a Gherkin feature specification interactively step-by-step from the terminal')
+    .option('-o, --output <file>', 'Output destination for .feature file')
+    .option('-t, --target <directory>', 'Target directory to inject contracts')
+    .option('-l, --lang <locale>', 'Override CLI interaction language for this run (en or es)')
+    .action(async (options) => {
+    await (0, create_1.handleCreateCommand)(options);
+});
 program
     .command('detect')
     .alias('d')
@@ -73,11 +96,14 @@ program
     .action(async (options) => {
     await (0, export_1.handleExportCommand)(options);
 });
-// Action fallback for root flags (--init, --generate, --validate, --detect)
+// Action fallback for root flags (--init, --create, --generate, --validate, --detect)
 program.action(async (options) => {
     if (options.init) {
         await (0, init_1.handleInitCommand)();
     }
+    else if (options.create) {
+        await (0, create_1.handleCreateCommand)({});
+    }
     else if (options.detect) {
         await (0, detect_1.handleDetectCommand)();
     }

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/utils/i18n-cli.d.ts

@@ -0,0 +1,53 @@
+export type SupportedLocale = 'en' | 'es';
+declare const messages: {
+    en: {
+        selectLanguagePrompt: string;
+        langUpdated: string;
+        langCurrent: string;
+        featureNamePrompt: string;
+        actorPrompt: string;
+        actionPrompt: string;
+        outcomePrompt: string;
+        scenarioNamePrompt: string;
+        stepKeywordPrompt: string;
+        stepDescPrompt: string;
+        addAnotherStepPrompt: string;
+        specCreated: string;
+        injectPrompt: string;
+        featureNotFound: string;
+        askCreateInteractive: string;
+        detectingStack: string;
+        stackDetected: string;
+        savedConfig: string;
+        injectingContracts: string;
+        contractsInjected: string;
+    };
+    es: {
+        selectLanguagePrompt: string;
+        langUpdated: string;
+        langCurrent: string;
+        featureNamePrompt: string;
+        actorPrompt: string;
+        actionPrompt: string;
+        outcomePrompt: string;
+        scenarioNamePrompt: string;
+        stepKeywordPrompt: string;
+        stepDescPrompt: string;
+        addAnotherStepPrompt: string;
+        specCreated: string;
+        injectPrompt: string;
+        featureNotFound: string;
+        askCreateInteractive: string;
+        detectingStack: string;
+        stackDetected: string;
+        savedConfig: string;
+        injectingContracts: string;
+        contractsInjected: string;
+    };
+};
+export declare function getGlobalUserLocale(): SupportedLocale | null;
+export declare function saveGlobalUserLocale(locale: SupportedLocale): void;
+export declare function ensureCliLanguage(requestedLang?: string): Promise<SupportedLocale>;
+export declare function t(key: keyof typeof messages['en'], locale?: SupportedLocale): string;
+export {};
+//# sourceMappingURL=i18n-cli.d.ts.map

package/dist/utils/i18n-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-cli.d.ts","sourceRoot":"","sources":["../../src/utils/i18n-cli.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAS1C,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Cb,CAAC;AAIF,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CAgB5D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAMlE;AAED,wBAAsB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA+BxF;AAED,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAGpF"}

package/dist/utils/i18n-cli.js

@@ -0,0 +1,124 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - Interactive i18n Engine for CLI (EN / ES)
+   ========================================================================== */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalUserLocale = getGlobalUserLocale;
+exports.saveGlobalUserLocale = saveGlobalUserLocale;
+exports.ensureCliLanguage = ensureCliLanguage;
+exports.t = t;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const file_system_1 = require("./file-system");
+const GLOBAL_CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.gherkin-ai');
+const GLOBAL_CONFIG_PATH = path_1.default.join(GLOBAL_CONFIG_DIR, 'config.json');
+const messages = {
+    en: {
+        selectLanguagePrompt: 'Select preferred CLI interaction language / Selecciona el idioma preferido para la CLI:',
+        langUpdated: 'CLI language successfully updated to English (en).',
+        langCurrent: 'Current CLI language:',
+        featureNamePrompt: 'Feature Name:',
+        actorPrompt: 'Actor (As a...):',
+        actionPrompt: 'Action (I want to...):',
+        outcomePrompt: 'Benefit (So that...):',
+        scenarioNamePrompt: 'Scenario Name:',
+        stepKeywordPrompt: 'Step Keyword:',
+        stepDescPrompt: 'Step Description:',
+        addAnotherStepPrompt: 'Add another step?',
+        specCreated: 'Created Gherkin feature specification at:',
+        injectPrompt: 'Do you want to inject contracts and prompts into your project now (ghk add)?',
+        featureNotFound: 'Feature file not found at:',
+        askCreateInteractive: 'Would you like to create the Gherkin specification step-by-step interactively now?',
+        detectingStack: 'Scanning project directory for existing stack & architecture...',
+        stackDetected: 'Existing Project Stack & Architecture Detected:',
+        savedConfig: 'Saved project configuration to:',
+        injectingContracts: 'Injecting contracts & AI prompts into:',
+        contractsInjected: 'Contracts & AI prompts injected into existing project at'
+    },
+    es: {
+        selectLanguagePrompt: 'Selecciona el idioma preferido para la CLI / Select preferred CLI interaction language:',
+        langUpdated: 'Idioma de la CLI actualizado exitosamente a Español (es).',
+        langCurrent: 'Idioma actual de la CLI:',
+        featureNamePrompt: 'Nombre de la Feature:',
+        actorPrompt: 'Actor (Como...):',
+        actionPrompt: 'Acción (Quiero...):',
+        outcomePrompt: 'Beneficio (Para...):',
+        scenarioNamePrompt: 'Nombre del Escenario:',
+        stepKeywordPrompt: 'Palabra clave del paso:',
+        stepDescPrompt: 'Descripción del paso:',
+        addAnotherStepPrompt: '¿Añadir otro paso?',
+        specCreated: 'Especificación Gherkin creada exitosamente en:',
+        injectPrompt: '¿Deseas inyectar inmediatamente los contratos y prompts en tu proyecto (ghk add)?',
+        featureNotFound: 'Archivo de feature no encontrado en:',
+        askCreateInteractive: '¿Deseas crear la especificación Gherkin paso a paso ahora (wizard interactivo)?',
+        detectingStack: 'Escaneando directorio del proyecto en busca de stack y arquitectura...',
+        stackDetected: 'Stack y Arquitectura del Proyecto Detectados:',
+        savedConfig: 'Configuración guardada exitosamente en:',
+        injectingContracts: 'Inyectando contratos y prompts para Agentes de IA en:',
+        contractsInjected: 'Contratos y prompts inyectados exitosamente en el proyecto en'
+    }
+};
+let cachedLocale = null;
+function getGlobalUserLocale() {
+    if (cachedLocale)
+        return cachedLocale;
+    if ((0, file_system_1.fileExistsSync)(GLOBAL_CONFIG_PATH)) {
+        try {
+            const raw = (0, file_system_1.readFileSync)(GLOBAL_CONFIG_PATH);
+            const parsed = JSON.parse(raw);
+            if (parsed.locale === 'en' || parsed.locale === 'es') {
+                cachedLocale = parsed.locale;
+                return parsed.locale;
+            }
+        }
+        catch {
+            // Ignore JSON parse error
+        }
+    }
+    return null;
+}
+function saveGlobalUserLocale(locale) {
+    (0, file_system_1.ensureDirSync)(GLOBAL_CONFIG_DIR);
+    const current = (0, file_system_1.fileExistsSync)(GLOBAL_CONFIG_PATH) ? JSON.parse((0, file_system_1.readFileSync)(GLOBAL_CONFIG_PATH)) : {};
+    current.locale = locale;
+    (0, file_system_1.writeFileSync)(GLOBAL_CONFIG_PATH, JSON.stringify(current, null, 2));
+    cachedLocale = locale;
+}
+async function ensureCliLanguage(requestedLang) {
+    if (requestedLang === 'en' || requestedLang === 'es') {
+        saveGlobalUserLocale(requestedLang);
+        return requestedLang;
+    }
+    const existing = getGlobalUserLocale();
+    if (existing)
+        return existing;
+    // Default is English if running in non-interactive CI mode
+    if (!process.stdout.isTTY) {
+        saveGlobalUserLocale('en');
+        return 'en';
+    }
+    const answer = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'locale',
+            message: 'Select preferred CLI language / Selecciona el idioma para la CLI:',
+            choices: [
+                { name: '🇺🇸 English (Default)', value: 'en' },
+                { name: '🇪🇸 Español', value: 'es' }
+            ],
+            default: 'en'
+        }
+    ]);
+    const selectedLocale = answer.locale;
+    saveGlobalUserLocale(selectedLocale);
+    return selectedLocale;
+}
+function t(key, locale) {
+    const lang = locale || getGlobalUserLocale() || 'en';
+    return messages[lang][key] || messages['en'][key] || key;
+}
+//# sourceMappingURL=i18n-cli.js.map

package/dist/utils/i18n-cli.js.map

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

package/docs/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # 🏗️ `gherkin-ai` CLI Architecture & Agent Pipeline Design
 
-This document details the internal design, Abstract Syntax Tree (AST) parsing pipeline, and contract generation mechanisms of `gherkin-ai` CLI.
+This document details the internal design, Abstract Syntax Tree (AST) parsing pipeline, multi-stack detection, and contract generation mechanisms of `gherkin-ai` CLI.
 
 ---
 
@@ -13,12 +13,17 @@ This document details the internal design, Abstract Syntax Tree (AST) parsing pi
             │
             ▼
  ┌──────────────────────┐      ┌───────────────────────┐
- │ gherkin-parser.ts    ├─────►│ ParsedFeature (AST)   │
+ │ gherkin-parser.ts    ├─────►│ ParsedFeature (AST)   │ (Bilingual EN / ES)
  └──────────────────────┘      └──────────┬────────────┘
                                           │
                                           ▼
  ┌──────────────────────┐      ┌───────────────────────┐
- │ config.ts            ├─────►│ Execution Context     │
+ │ stack-detector.ts   ├─────►│ Detected Stack        │ (Laravel, Rails, .NET, Angular, Nest, etc.)
+ └──────────────────────┘      └──────────┬────────────┘
+                                          │
+                                          ▼
+ ┌──────────────────────┐      ┌───────────────────────┐
+ │ i18n-cli.ts          ├─────►│ User Locale Context   │ (English / Spanish)
  └──────────────────────┘      └──────────┬────────────┘
                                           │
                ┌──────────────────────────┼──────────────────────────┐
@@ -36,22 +41,36 @@ This document details the internal design, Abstract Syntax Tree (AST) parsing pi
 ## 2. Core Components
 
 ### 2.1 AST Parser (`src/core/gherkin-parser.ts`)
-Parses `.feature` text into structured models:
-- **Feature Title & Business Goal**
-- **Scenarios & Given/When/Then Steps**
-- **Domain Analysis**: Automatically classifies step phrases into Actors, Commands (When), Queries (Then), Events (Domain Events), and Fixtures (Given).
+Parses `.feature` text into structured models with native bilingual support:
+- **Feature Title & Business Goal** (supports `Feature:` / `Característica:`)
+- **Scenarios & Given/When/Then Steps** (supports `Scenario:` / `Escenario:`, `Given` / `Dado`, `When` / `Cuando`, `Then` / `Entonces`, `And` / `Y`, `But` / `Pero`).
+- **Domain Analysis**: Automatically classifies step phrases into Actors, Commands, Queries, Events, and Fixtures.
 
-### 2.2 Architecture Rules Engine (`src/core/arch-rules.ts`)
-Defines strict layer import boundaries for 10 architecture patterns. Ensures that domain entities generated by AI agents never import HTTP or ORM dependencies.
+### 2.2 Stack Auto-Detector (`src/core/stack-detector.ts`)
+Inspects root workspace files to identify the tech stack of existing projects:
+- **PHP / Laravel**: Inspects `artisan` and `composer.json`.
+- **Ruby on Rails**: Inspects `Gemfile` and `Rakefile`.
+- **C# / .NET**: Inspects `Program.cs` and `appsettings.json`.
+- **Java / Spring Boot**: Inspects `pom.xml` and `build.gradle`.
+- **Python (Django / FastAPI)**: Inspects `manage.py`, `pyproject.toml`, `requirements.txt`.
+- **Go**: Inspects `go.mod`.
+- **Frontend & Mobile**: Inspects `angular.json` (Angular / Ionic), `react-native`, `pubspec.yaml` (Flutter/Dart).
 
-### 2.3 Contract & DTO Generator (`src/generators/contracts.ts`)
-Transforms parsed AST commands into valid Zod validation schemas and TypeScript interfaces:
+### 2.3 Interactive CLI i18n Engine (`src/utils/i18n-cli.ts`)
+Manages CLI locale preferences (`en` / `es`):
+- Defaults to **English** (`en`).
+- Persists user preferences globally in `~/.gherkin-ai/config.json`.
+- Allows switching preferred CLI language anytime using `ghk lang`.
+
+### 2.4 Interactive Spec Wizard (`src/commands/create.ts`)
+Guides users step-by-step through terminal prompts to build Gherkin `.feature` specifications in English or Spanish, saving the resulting file and offering direct contract injection.
+
+### 2.5 Contract & DTO Generator (`src/generators/contracts.ts`)
+Transforms parsed AST commands into valid Zod validation schemas, OpenAPI 3.0 JSON specifications, and TypeScript interfaces:
 - `IDomainEvent` & explicit event schemas.
 - Command DTO schemas for input validation.
 - Outbound repository ports (`IRepository`).
-
-### 2.4 Test Fixture Engine (`src/generators/fixtures.ts`)
-Generates concrete setup fixtures and SQL seeds (hashed passwords via `bcrypt`, pre-conditions) to resolve the ambiguity of `Given` steps.
+- CQRS Event Store ports (`IEventStore`, `IAggregateRoot<T>`, `ISnapshotStore<T>`).
 
 ---
 
@@ -59,5 +78,5 @@ Generates concrete setup fixtures and SQL seeds (hashed passwords via `bcrypt`,
 
 To prevent AI coding agents from diverging or producing uncompilable code:
 1. **Domain Architect Agent** reads `contracts.ts` and implements pure business logic without external dependencies.
-2. **Backend Developer Agent** uses `contracts.ts` and `fixtures.ts` to implement Use Cases, Controllers, and ORM Repositories.
-3. **QA Automation Agent** uses `fixtures.ts` and `.feature` files to write deterministic unit and integration tests.
+2. **Backend Developer Agent** uses `contracts.ts` and `fixtures.ts` to implement Use Cases, Controllers, and ORM Repositories (NestJS, Laravel, Rails, .NET, Spring Boot).
+3. **QA Automation Agent** uses `fixtures.ts` and `.feature` files to write deterministic unit and integration tests (Jest, PHPUnit, RSpec, xUnit, Pytest).

package/docs/USAGE_GUIDE.md

@@ -6,120 +6,147 @@ This guide provides step-by-step instructions for installing, configuring, and e
 
 ## Table of Contents
 
-1. [Installation](#installation)
-2. [CLI Configuration (`gherkin-ai.config.json`)](#cli-configuration)
-3. [Writing Gherkin Features](#writing-gherkin-features)
-4. [Command Reference](#command-reference)
-   - [`init`](#init)
-   - [`generate`](#generate)
-   - [`validate`](#validate)
-   - [`export`](#export)
-5. [Feeding Generated Prompts into AI Agents](#feeding-prompts-into-ai-agents)
+1. [Installation & Short Alias (`ghk`)](#1-installation--short-alias-ghk)
+2. [Language Configuration (`ghk lang`)](#2-language-configuration-ghk-lang)
+3. [Interactive Gherkin Spec Wizard (`ghk create`)](#3-interactive-gherkin-spec-wizard-ghk-create)
+4. [Existing Projects / Brownfield Mode (`ghk detect` & `ghk add`)](#4-existing-projects--brownfield-mode-ghk-detect--ghk-add)
+5. [New Projects / Greenfield Mode (`ghk init` & `ghk generate`)](#5-new-projects--greenfield-mode-ghk-init--ghk-generate)
+6. [Command Reference](#6-command-reference)
+7. [Feeding Generated Prompts into AI Agents](#7-feeding-generated-prompts-into-ai-agents)
 
 ---
 
-## 1. Installation
+## 1. Installation & Short Alias (`ghk`)
 
-You can run `gherkin-ai` directly without installation using `npx`:
+Run `gherkin-ai` instantly without installation using `npx` and the short alias **`ghk`**:
 
 ```bash
-npx gherkin-ai --version
+npx ghk --version
 ```
 
-Or install it globally using npm:
+Or install it globally:
 
 ```bash
 npm install -g gherkin-ai
+ghk --help
 ```
 
 ---
 
-## 2. CLI Configuration
-
-Run `gherkin-ai init` to generate a `gherkin-ai.config.json` file in your root folder:
-
-```json
-{
-  "projectName": "auth-service",
-  "architecture": "hexagonal",
-  "stack": {
-    "language": "typescript",
-    "framework": "nestjs",
-    "orm": "prisma",
-    "database": "postgresql",
-    "validation": "zod",
-    "auth": "jwt-bcrypt",
-    "messaging": "rabbitmq",
-    "testing": "jest"
-  },
-  "rules": {
-    "bcryptCostFactor": 12,
-    "jwtTtlSeconds": 3600,
-    "strictLayerBoundaries": true,
-    "coverageTarget": 85
-  },
-  "outputDir": "./generated-specs"
-}
+## 2. Language Configuration (`ghk lang`)
+
+By default, CLI interactions run in **English**. You can switch CLI interaction language to **Spanish** or **English** at any time.
+
+```bash
+# Interactive language selector
+ghk lang
+
+# Or set directly
+ghk lang --set es   # Switch to Spanish
+ghk lang --set en   # Switch to English
 ```
 
----
+The language preference is saved globally under `~/.gherkin-ai/config.json` and automatically applies to all future terminal sessions.
 
-## 3. Writing Gherkin Features
+---
 
-Create a feature file (e.g. `./specs/auth.feature`):
+## 3. Interactive Gherkin Spec Wizard (`ghk create`)
 
-```gherkin
-Feature: User Authentication & Token Issuance
-  As a registered system user
-  I want to authenticate using valid credentials
-  So that I obtain a JWT token to access protected APIs
+Build a Gherkin specification step-by-step interactively directly in your terminal without typing raw `.feature` syntax:
 
-  Scenario: Successful login with valid credentials
-    Given a registered user exists with email "dev@example.com" and password "Pass123!"
-    When sending an authentication request with email "dev@example.com" and password "Pass123!"
-    Then the system responds with HTTP status 200 OK
-    And returns a short-lived access JWT token
-    And emits a "UserAuthenticated" domain event
+```bash
+ghk create    # (or alias: ghk new)
 ```
 
+The wizard prompts you for:
+1. Feature Name (e.g. *Two Factor Authentication 2FA* / *Autenticación de Doble Factor*)
+2. Actor (*As a...* / *Como...*)
+3. Action (*I want to...* / *Quiero...*)
+4. Benefit (*So that...* / *Para...*)
+5. Scenario Name & Step Loop (`Given`/`Dado`, `When`/`Cuando`, `Then`/`Entonces`, `And`/`Y`).
+
+After creation, it saves the file to `./specs/` and offers to immediately inject contracts into your project.
+
 ---
 
-## 4. Command Reference
+## 4. Existing Projects / Brownfield Mode (`ghk detect` & `ghk add`)
 
-### `gherkin-ai generate`
+If you have an existing codebase (**Laravel, Rails, ASP.NET Core, Angular, Ionic, Spring Boot, NestJS, FastAPI, Django, Flutter**):
 
-Generates TypeScript contracts, DTO schemas, test fixtures, docker-compose, and role prompts:
+### Step 1: Auto-Detect Tech Stack
 
 ```bash
-gherkin-ai generate --feature ./specs/auth.feature --config ./gherkin-ai.config.json
+ghk detect
 ```
 
-### `gherkin-ai validate`
+Scans your root directory for manifests (`package.json`, `artisan`, `composer.json`, `pom.xml`, `go.mod`, `requirements.txt`, `Gemfile`, `angular.json`, `pubspec.yaml`) and saves `gherkin-ai.config.json` with `projectMode: "brownfield"`.
 
-Validates that your feature spec and project setup adhere to chosen architecture boundaries:
+### Step 2: Inject Feature Contracts into Existing Modules
 
 ```bash
-gherkin-ai validate --feature ./specs/auth.feature
+ghk add --feature ./specs/payments.feature --target ./src/modules/payments
 ```
 
-### `gherkin-ai export`
+Injects `<feature>.contract.ts`, `<feature>.openapi.json`, `ADR-<feature>.md`, and specialized AI prompts directly inside `./src/modules/payments/` without modifying the rest of your application.
+
+---
+
+## 5. New Projects / Greenfield Mode (`ghk init` & `ghk generate`)
 
-Exports a single Markdown or JSON context bundle for AI coding agents:
+For starting a brand-new service from scratch:
 
 ```bash
-gherkin-ai export --feature ./specs/auth.feature --format md --output ./agent-context.md
+# 1. Initialize configuration
+ghk init
+
+# 2. Generate complete specification artifacts
+ghk generate --feature ./specs/auth.feature
+
+# 3. Perform architectural linting
+ghk validate --feature ./specs/auth.feature
+```
+
+Generates:
+```text
+generated-specs/
+├── contracts.ts                      # Interfaces, Zod schemas, Repository & Event Store ports
+├── openapi.json                      # Auto-generated OpenAPI 3.0 specification
+├── fixtures.ts                       # Test seed functions (bcrypt, Given setup)
+├── seed.sql                          # Raw SQL initialization script
+├── docker-compose.yml / serverless.yml # Pre-configured infrastructure
+├── .env.example                      # Environment variables template
+├── ADR-001-architecture-decisions.md # Architecture Decision Record
+└── prompts/
+    ├── domain-agent.md               # Instructions for Domain Architect Agent
+    ├── backend-agent.md              # Instructions for Backend Developer Agent
+    └── qa-agent.md                   # Instructions for QA Automation Agent
 ```
 
 ---
 
-## 5. Feeding Generated Prompts into AI Agents
+## 6. Command Reference
+
+| Command | Alias | Description |
+|---|---|---|
+| `ghk init` | `i` | Initialize interactive project configuration (`gherkin-ai.config.json`). |
+| `ghk lang` | `l`, `language` | Configure preferred CLI interaction language (English or Spanish). |
+| `ghk create` | `c`, `new` | Interactive terminal wizard to build Gherkin `.feature` specs step-by-step. |
+| `ghk detect` | `d` | Auto-detect stack & architecture of an existing codebase (Brownfield mode). |
+| `ghk add` | `a` | Inject contracts and AI prompts into a specific module in an existing project. |
+| `ghk generate` | `g` | Generate complete contracts, OpenAPI, seeds, docker-compose, and prompts. |
+| `ghk validate` | `v` | Perform deep architectural linting and layer boundary checks. |
+| `ghk export` | `e` | Export a single Markdown or JSON context bundle for AI agents. |
+
+---
+
+## 7. Feeding Generated Prompts into AI Agents
 
 ### For Claude Code / Terminal Agents:
 ```bash
-claude "Read generated-specs/prompts/domain-agent.md and generated-specs/contracts.ts. Implement the domain entities in src/domain/."
+claude "Read generated-specs/prompts/backend-agent.md and contracts.ts. Implement the controllers and services in src/."
 ```
 
-### For Cursor / Windsurf / IDE Agents:
-1. Open `@generated-specs/contracts.ts` in your workspace.
-2. Load `@generated-specs/prompts/backend-agent.md` as context.
-3. Instruct the AI agent: *"Implement the application use cases and controllers following contracts.ts."*
+### For Cursor / Windsurf / Antigravity / IDE Agents:
+1. Open `@contracts.ts` (or `@<module>.contract.ts`) in your workspace.
+2. Load `@prompts/backend-agent.md` as context.
+3. Instruct the AI agent: *"Implement the application use cases and controllers following the contract interfaces."*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gherkin-ai",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "CLI tool & contract engine translating Gherkin specs into production-grade executable prompts, TypeScript contracts, and seed fixtures for AI Coding Agents.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -34,16 +34,8 @@
     "ghk",
     "brownfield",
     "detect",
-    "laravel",
-    "php",
-    "ruby",
-    "rails",
-    "dotnet",
-    "csharp",
-    "angular",
-    "ionic",
-    "react-native",
-    "flutter"
+    "create",
+    "wizard"
   ],
   "author": "Fenner Eduardo <contact@fennereduardo.com> (https://fennereduardo.com)",
   "license": "MIT",