gherkin-ai 2.6.1 → 2.6.2

package/README.md

@@ -3,78 +3,37 @@
 [![npm version](https://img.shields.io/npm/v/gherkin-ai.svg)](https://www.npmjs.com/package/gherkin-ai)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-> **The Closed-Loop Agentic Testing & Orchestration Engine for Enterprise Full-Stack Applications.**
-> Turn product requirements into verifiable Gherkin specifications, execute dual-stack implementations (React + Java Spring Boot), and run self-healing agent loops with zero regressions.
+> **The Closed-Loop Agentic Testing & Orchestration Engine for Full-Stack Applications.**
+> Turn product requirements into verifiable Gherkin specifications, execute dual-stack implementations (React + Java / PHP / .NET / Python), and experiment with self-healing agent loops.
+> 
+> [![CI](https://github.com/FennerEduardo/gherkin-ai-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/FennerEduardo/gherkin-ai-cli/actions/workflows/ci.yml)
+> [![Coverage Status](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)]()
 
 ---
 
-## 🌟 Strategic Capabilities (`v2.6.1` Stable Patch Release)
+## 🌟 Strategic Capabilities
 
-While basic AI spec tools only generate text prompts, `gherkin-ai` acts as an **executable contract and verification harness** between Product Intent, AI Agents (Cursor, Claude Code, Windsurf, Antigravity), Code Implementation, and CI/CD Quality Gates:
+While basic AI spec tools only generate text prompts, `gherkin-ai` acts as an **executable contract and verification harness** between Product Intent, AI Agents (Cursor, Antigravity, Claude Code, Windsurf, Copilot), Code Implementation, and CI/CD Quality Gates:
 
-- 🤖 **True Agentic Engine & Self-Healing (`ghk verify --auto-fix` & `ghk autopilot`)**: Natively connects with LLMs (OpenAI, Anthropic, Ollama). It doesn't just log output; it actively writes and modifies your source code, intercepts test failures, and recursively applies repairs in a true **Closed-Loop**.
+- 🤖 **AI Agent Implementation Orchestration (`ghk implement`)**: Compiles `.ghkgovernance.yaml`, domain contracts (`*.contract.php`, `.ts`, `.py`, `.java`), ADRs, and Gherkin features into a copy-pasteable Master Agent Implementation Prompt.
+- 🐳 **Docker Container Sandbox & Host Protection (`--docker`)**: Generates stack-specific dev container environments (`mcr.microsoft.com/dotnet/sdk:8.0`, `eclipse-temurin:21-jdk-alpine`, `php:8.3-cli-alpine`, `python:3.11-slim`, `node:20-alpine`, `golang:1.22-alpine`, `ruby:3.3-alpine`) so AI agents run tests inside isolated Docker containers without polluting host OS.
+- 📋 **Feature Inventory & Developer Audit Trail (`ghk audit`)**: Auto-detects developer identity (`git config user.name`/`email`), SHA-256 spec & prompt hashes, timestamps, and execution records stored in `.ghe/inventory.json` with LRU retention limit (`maxEntries: 50`) and `--json` export for CI/CD audit pipelines.
+- ⚡ **Token Efficiency & Ultra-Compact Mode (`-C, --compact`)**: Uses direct `@` file pointers for on-demand context resolution (70–85% token savings vs code dumping) and provides a dense ~90-token compact prompt mode for cost-sensitive LLMs.
+- 🌐 **Multilingual CLI & English Prompt Rationale (`ghk lang`)**: Full interactive CLI support in Spanish (`es`) and English (`en`). Master AI Prompts are intentionally generated in **English** for maximum BPE token density (~30% cheaper) and LLM reasoning accuracy.
+- 🤖 **True Agentic Engine & Self-Healing (EXPERIMENTAL - `ghk verify --auto-fix` & `ghk autopilot`)**: Connects natively with LLMs (OpenAI, Anthropic, Ollama), modifies source code, intercepts test failures, and recursively applies repairs in a true **Closed-Loop**. *Note: Agentic execution is currently experimental and should be run with human supervision.*
 - 🌐 **Web Studio UI (`ghk web`)**: Launch a premium local graphical interface to interactively generate your Gherkin specifications, detect your stack, and orchestrate agent prompts visually.
-- 🌳 **Official Cucumber AST Parser**: 100% compliant with the Gherkin standard using the official `@cucumber/gherkin` package. Flawlessly parses DataTables, DocStrings, and advanced scenarios for semantic extraction.
-- 🔗 **AST Step Definitions Indexer**: Prevents AI hallucinations by statically analyzing your E2E project (Cypress/Playwright/Cucumber-JS) via `ts-morph`, extracting existing `Given/When/Then` steps, and forcing the LLM to reuse them.
-- 🛡️ **Semantically Typed Contracts**: Extracts variables straight from your Gherkin data tables (like `@validate:email`) and outputs strictly typed Zod DTOs instead of generic objects.
-- ⚙️ **Headless CI/CD Mode**: Fully decoupled non-interactive mode (`--yes`, `--non-interactive`, `--project <dir>`) designed for frictionless integration into GitHub Actions, Azure DevOps, and automated pipelines.
-- 📋 **Pre-flight Requirement Validation**: Built-in semantic validator inside `ghk autopilot` that analyzes requirements before triggering LLM agents, preventing token waste on vague features.
-- 🔌 **Native MCP Server & Cursor Skills (`ghk mcp install` & `ghk skill`)**: Zero-config Model Context Protocol (MCP) server. The new `ghk skill` command injects native Cursor and Windsurf `.cursorrules` to let your IDE automatically invoke Gherkin AI as an internal skill.
-- 📦 **Context Engineering & Guardrails Engine (`ghk context`)**: Structurally packages project architecture, conventions, and security policies into `.ghe/`, enforcing strict path protection and agent change limits.
-- 🏗️ **DOM & Data Model Anchor**: Automatically extracts `schema.prisma` models and Page Object Model (POM) `data-test` selectors, injecting them into the agent's context to ensure generated tests are grounded in technical reality.
-- 🏆 **Dynamic Quality Gate Index (`ghk quality`)**: Measures spec coverage, unit tests, E2E, type safety, and security dynamically by parsing your real test coverage (`coverage-summary.json`) and linter outputs.
-- ☕ **Enterprise Java, React, Rust & Go Templates**: Extensive boilerplate support. Scaffolds Spring Boot, Next.js, Rust Axum, Go Fiber, and mobile (Flutter/React Native) architectures out-of-the-box.
-- 🕵️ **Interactive Stack & Pattern Detection (`ghk detect`)**: Auto-detects existing brownfield architectures and intelligently injects industry-standard design patterns (e.g., Hooks, CQRS, MVC) into Agent prompts.
-- 📡 **Event-Driven & AsyncAPI Support**: Automatically extracts domain events from Gherkin and scaffolds standard `asyncapi.json` contracts.
-- 🔍 **Deep AST Drift Detection (`ghk diff`)**: Validates in CI/CD pipelines if the implemented DTOs and code have drifted from the `.feature` file. Now cross-references semantic fields, HTTP status codes, and API Endpoints.
+- 🌳 **Official Cucumber AST Parser**: 100% compliant with the Gherkin standard using the official `@cucumber/gherkin` package.
 
 ---
 
-## 📥 Installation & Execution (`v2.6.1`)
+## 📥 Installation & Execution
 
-You can use `gherkin-ai` via global `npm` installation, on-demand zero-install `npx`, or as a project local dev dependency:
-
-### Option 1: Global Installation (`npm`)
 ```bash
+# Global Installation
 npm install -g gherkin-ai
-```
-Once installed globally, you can use `ghk` or `gherkin-ai` CLI commands directly:
-```bash
-ghk mcp install
-ghk verify --auto-fix
-ghk context build
-ghk quality
-```
-
-### Option 2: Zero-Install On-Demand (`npx`)
-Run any `gherkin-ai` command instantly without global installation:
-```bash
-# Auto-install MCP server for Cursor & Claude Desktop
-npx -y gherkin-ai mcp install
-
-# Run closed-loop verification test harness
-npx -y gherkin-ai verify --auto-fix
 
-# Build project context & guardrails (.ghe/)
-npx -y gherkin-ai context build
-
-# Calculate feature quality score index
-npx -y gherkin-ai quality
-```
-
-### Option 3: Local Project Dev Dependency
-Add to your project's `devDependencies`:
-```bash
-npm install --save-dev gherkin-ai
-```
-Then invoke via `npx` or add scripts to your `package.json`:
-```json
-{
-  "scripts": {
-    "test:verify": "ghk verify --auto-fix",
-    "quality:check": "ghk quality"
-  }
-}
+# Or Zero-Install On-Demand
+npx -y gherkin-ai implement --feature ./features/01-customer-management.feature
 ```
 
 ---
@@ -82,20 +41,23 @@ Then invoke via `npx` or add scripts to your `package.json`:
 ## 🚀 Quick Start Commands
 
 ```bash
-# 1. Setup MCP Server for Cursor & Claude Desktop
-ghk mcp install   # (or: npx -y gherkin-ai mcp install)
+# 1. Generate Master AI Agent Implementation Prompt & Context Package
+ghk implement --feature ./features/01-customer-management.feature
 
-# 2. Closed-Loop Test Verification with Auto-Fix Loop
-ghk verify --auto-fix
+# 2. Generate Ultra-Compact Prompt for Low-Cost LLMs (~90 tokens)
+ghk implement --feature ./features/01-customer-management.feature --compact
 
-# 3. Create a feature using Caveman Mode (skip wizard)
-ghk create --caveman
+# 3. View Feature Inventory & Developer Audit Trail History
+ghk audit
 
-# 4. Auto-detect project stack & suggest design patterns
-ghk detect
+# 4. Export Audit History as JSON for CI/CD Compliance Pipelines
+ghk audit --json
 
-# 5. Build Project Context & Policy Engine (.ghe/)
-ghk context build
+# 5. Configure CLI Language (English or Spanish)
+ghk lang --set es
+
+# 6. Run Closed-Loop Test Verification with Auto-Fix Loop
+ghk verify --auto-fix
 ```
 
 ---

package/dist/commands/add.d.ts

@@ -2,5 +2,7 @@ export declare function handleAddCommand(options: {
     feature?: string;
     target?: string;
     config?: string;
+    yes?: boolean;
+    nonInteractive?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=add.d.ts.map

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

@@ -1 +1 @@
-{"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,CA8FrH"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAgBA,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsG9J"}

package/dist/commands/add.js

@@ -8,35 +8,36 @@ 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 ir_builder_1 = require("../core/ir-builder");
 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();
+    const { promptOrFallback } = require('../utils/i18n-cli');
     if (!options.feature) {
         logger_1.logger.info('No --feature file specified. Launching interactive spec wizard...');
-        await (0, create_1.handleCreateCommand)({ target: options.target });
+        await (0, create_1.handleCreateCommand)({ target: options.target, yes: options.yes, nonInteractive: options.nonInteractive });
         return;
     }
     const featurePath = path_1.default.resolve(process.cwd(), options.feature);
     if (!(0, file_system_1.fileExistsSync)(featurePath)) {
         logger_1.logger.warn(`Feature file not found at: ${featurePath}`);
-        const answer = await inquirer_1.default.prompt([
+        const answer = await promptOrFallback([
             {
                 type: 'confirm',
                 name: 'createNow',
                 message: '¿Deseas crear la especificación Gherkin paso a paso ahora (wizard interactivo)?',
                 default: true
             }
-        ]);
+        ], options);
         if (answer.createNow) {
-            await (0, create_1.handleCreateCommand)({ output: options.feature, target: options.target });
+            await (0, create_1.handleCreateCommand)({ output: options.feature, target: options.target, yes: options.yes, nonInteractive: options.nonInteractive });
             return;
         }
         else {
@@ -53,13 +54,18 @@ async function handleAddCommand(options) {
     const gherkinText = (0, file_system_1.readFileSync)(featurePath);
     const parsed = (0, gherkin_parser_1.parseGherkinText)(gherkinText);
     const featurePascal = parsed.featureName.replace(/[^a-zA-Z0-9]/g, '') || 'Feature';
-    const targetDir = options.target
+    let targetDir = options.target
         ? path_1.default.resolve(process.cwd(), options.target)
         : path_1.default.resolve(process.cwd(), 'src', 'modules', featurePascal.toLowerCase());
+    if (!targetDir.startsWith(process.cwd())) {
+        logger_1.logger.error(`Security Violation: Target path escapes the current workspace: ${targetDir}`);
+        process.exit(1);
+    }
     (0, file_system_1.ensureDirSync)(targetDir);
     logger_1.logger.info(`Injecting contracts & AI prompts into: ${targetDir}`);
     // 1. Generate Contracts, OpenAPI, AsyncAPI & Native Language Contract
-    const { contractsTs, adrMd, openApiJson, asyncApiJson, nativeContract } = (0, contracts_1.generateContracts)(parsed, config);
+    const ir = (0, ir_builder_1.buildSpecificationIR)(parsed, featurePath, { domainProfile: config.domainProfile });
+    const { contractsTs, adrMd, openApiJson, asyncApiJson, nativeContract } = (0, contracts_1.generateContracts)(parsed, ir, config);
     const contractFileName = `${featurePascal.toLowerCase()}.contract.ts`;
     (0, file_system_1.writeFileSync)(path_1.default.join(targetDir, contractFileName), contractsTs);
     (0, file_system_1.writeFileSync)(path_1.default.join(targetDir, `${featurePascal.toLowerCase()}.openapi.json`), openApiJson);

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/agent-log.d.ts

@@ -0,0 +1,8 @@
+export declare function handleAgentLogCommand(options: {
+    action?: string;
+    feature?: string;
+    list?: boolean;
+    json?: boolean;
+    clear?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=agent-log.d.ts.map

package/dist/commands/agent-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-log.d.ts","sourceRoot":"","sources":["../../src/commands/agent-log.ts"],"names":[],"mappings":"AAQA,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBhB"}

package/dist/commands/agent-log.js

@@ -0,0 +1,30 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - 'agent-log' Command Handler
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAgentLogCommand = handleAgentLogCommand;
+const agent_logger_1 = require("../core/agent-logger");
+const logger_1 = require("../utils/logger");
+async function handleAgentLogCommand(options) {
+    const manager = new agent_logger_1.AgentLogManager(process.cwd());
+    if (options.clear) {
+        manager.clearLogs();
+        logger_1.logger.success('Agent action logs cleared successfully.');
+        return;
+    }
+    if (options.action) {
+        const featureName = options.feature || 'Global Action';
+        manager.recordAction(featureName, options.action);
+        logger_1.logger.success(`Agent action logged for feature: ${featureName}`);
+        return;
+    }
+    // Display logs (list mode)
+    const records = manager.getLogs(options.feature);
+    if (options.json) {
+        console.log(JSON.stringify(records, null, 2));
+        return;
+    }
+    console.log(manager.formatCLIReport(records));
+}
+//# sourceMappingURL=agent-log.js.map

package/dist/commands/agent-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-log.js","sourceRoot":"","sources":["../../src/commands/agent-log.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAMhF,sDA+BC;AAnCD,uDAAuD;AACvD,4CAAyC;AAGlC,KAAK,UAAU,qBAAqB,CAAC,OAM3C;IACC,MAAM,OAAO,GAAG,IAAI,8BAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,eAAM,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC;QACvD,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,eAAM,CAAC,OAAO,CAAC,oCAAoC,WAAW,EAAE,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,2BAA2B;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/commands/audit.d.ts

@@ -0,0 +1,6 @@
+export declare function handleAuditCommand(options: {
+    feature?: string;
+    json?: boolean;
+    clear?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=audit.d.ts.map

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

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

package/dist/commands/audit.js

@@ -0,0 +1,29 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - 'audit' Command Handler (Feature Inventory & Audit Trail)
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAuditCommand = handleAuditCommand;
+const logger_1 = require("../utils/logger");
+const inventory_1 = require("../core/inventory");
+async function handleAuditCommand(options) {
+    const manager = new inventory_1.InventoryManager();
+    if (options.clear) {
+        manager.clearInventory();
+        logger_1.logger.success('Feature audit trail inventory cleared successfully.');
+        return;
+    }
+    const isJson = options.json || process.argv.includes('--json');
+    if (!isJson) {
+        logger_1.logger.banner();
+        logger_1.logger.info('Retrieving Feature Implementation & Prompt Audit Records...');
+    }
+    const records = manager.getInventory(options.feature);
+    if (isJson) {
+        console.log(JSON.stringify(records, null, 2));
+        return;
+    }
+    console.log(manager.formatCLIReport(records));
+    logger_1.logger.success(`Audit trail query complete. (${records.length} record(s) found)`);
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAKhF,gDAyBC;AA5BD,4CAAyC;AACzC,iDAAqD;AAE9C,KAAK,UAAU,kBAAkB,CAAC,OAA8D;IACrG,MAAM,OAAO,GAAG,IAAI,4BAAgB,EAAE,CAAC;IAEvC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,eAAM,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,eAAM,CAAC,MAAM,EAAE,CAAC;QAChB,eAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,eAAM,CAAC,OAAO,CAAC,gCAAgC,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC;AACpF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"autopilot.d.ts","sourceRoot":"","sources":["../../src/commands/autopilot.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmK1F"}
+{"version":3,"file":"autopilot.d.ts","sourceRoot":"","sources":["../../src/commands/autopilot.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyS1F"}

package/dist/commands/autopilot.js

@@ -1,6 +1,11 @@
 "use strict";
 /* ==========================================================================
    gherkin-ai-cli - 'autopilot' Command Handler (Multi-Agent Orchestrator)
+   
+   Enhanced with:
+   - Pre-lint validation of generated specifications
+   - IR structural validation (commands, events, scenarios)
+   - Structured JSON run logging for traceability
    ========================================================================== */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -11,39 +16,77 @@ const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const context_builder_1 = require("../core/context-builder");
-const quality_score_1 = require("../core/quality-score");
+const risk_engine_1 = require("../core/risk-engine");
 const agent_adapter_1 = require("../core/agent-adapter");
 const verify_1 = require("./verify");
 const config_1 = require("../core/config");
 const spec_dir_resolver_1 = require("../utils/spec-dir-resolver");
 const requirement_validator_1 = require("../core/requirement-validator");
+const metrics_engine_1 = require("../core/metrics-engine");
 async function handleAutopilotCommand(options = {}) {
     console.log(chalk_1.default.bold.cyan('\n🚀 Launching gherkin-ai Autopilot Autonomous Delivery Orchestrator...\n'));
+    const runLog = {
+        runId: `run-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        requirementFile: '',
+        requirementScore: 0,
+        specGenerated: false,
+        lintScore: null,
+        irValidation: null,
+        scaffoldingResult: 'skipped',
+        verifyIterations: 0,
+        riskLevel: 'UNKNOWN',
+        riskScore: 0,
+        finalStatus: 'failed'
+    };
+    const metricsEngine = new metrics_engine_1.MetricsEngine();
+    const execEvents = [];
+    const execErrors = [];
     const reqFile = options.requirement || 'requirement.md';
+    runLog.requirementFile = reqFile;
     if (!fs_1.default.existsSync(reqFile)) {
         console.log(chalk_1.default.red(`\n✖ Requirement file not found: ${reqFile}`));
         console.log(chalk_1.default.yellow(`  → Fix: Provide a valid path with --requirement <file>`));
         console.log(chalk_1.default.yellow(`  → Example: ghk autopilot --requirement docs/user-crud.md\n`));
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
     const reqContent = fs_1.default.readFileSync(reqFile, 'utf8');
     // Validate requirement before proceeding with agents
     const validation = (0, requirement_validator_1.validateRequirement)(reqContent);
+    runLog.requirementScore = validation.score;
     if (!validation.isValid) {
         console.log(chalk_1.default.red('\n✖ Requirement validation failed:'));
         for (const issue of validation.issues) {
-            console.log(chalk_1.default.yellow(`  ⚠ ${issue.message}`));
+            const icon = issue.severity === 'error' ? '✖' : issue.severity === 'warning' ? '⚠' : 'ℹ';
+            const color = issue.severity === 'error' ? chalk_1.default.red : issue.severity === 'warning' ? chalk_1.default.yellow : chalk_1.default.gray;
+            console.log(color(`  ${icon} [${issue.severity.toUpperCase()}] ${issue.message}`));
             console.log(chalk_1.default.gray(`    → ${issue.suggestion}`));
         }
+        console.log(chalk_1.default.cyan(`\n  Requirement quality score: ${validation.score}/100`));
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
+    // Show warnings even if valid
+    const warnings = validation.issues.filter(i => i.severity !== 'error');
+    if (warnings.length > 0) {
+        console.log(chalk_1.default.yellow(`\n⚠ Requirement passed with ${warnings.length} warning(s) (score: ${validation.score}/100):`));
+        for (const w of warnings) {
+            console.log(chalk_1.default.yellow(`  ⚠ ${w.message}`));
+        }
+        console.log('');
+    }
+    else {
+        console.log(chalk_1.default.green(`✓ Requirement validation passed (score: ${validation.score}/100)\n`));
+    }
     const { detectPromptInjection } = require('../core/security-sanitizer');
     const securityCheck = detectPromptInjection(reqContent);
     if (!securityCheck.isSafe) {
         console.log(chalk_1.default.red('\n✖ SECURITY ALERT: Prompt Injection Attempt Blocked!'));
         console.log(chalk_1.default.red(`  ⚠ Reason: ${securityCheck.reason}`));
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
@@ -65,11 +108,14 @@ async function handleAutopilotCommand(options = {}) {
     }
     catch (error) {
         console.log(chalk_1.default.red(`\n✖ Spec Agent execution crashed: ${error.message}`));
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
     let specContent = '';
     if (specRes.success && specRes.codeModifications && specRes.codeModifications.length > 0) {
+        metricsEngine.recordAgentAttempt(specRes.tokensUsed || 0, specRes.codeModifications.length);
+        execEvents.push({ type: 'spec_agent_attempt', tokens: specRes.tokensUsed });
         let specDirPath = process.env.GHK_SPEC_DIR || configInstance.specDir || 'specs';
         try {
             specDirPath = (0, spec_dir_resolver_1.resolveSpecDir)(configInstance.specDir);
@@ -85,7 +131,8 @@ async function handleAutopilotCommand(options = {}) {
             else if (!p.includes('/') && !p.includes('\\')) {
                 p = path_1.default.join(specDirPath, p);
             }
-            const fullPath = path_1.default.resolve(p);
+            const { resolveSafePath } = require('../utils/file-system');
+            const fullPath = resolveSafePath(process.cwd(), p);
             if (process.env.GHK_DRY_RUN === 'true') {
                 if (process.env.GHK_STDOUT === 'true') {
                     console.log(chalk_1.default.yellow(`   [DRY RUN] Proposed spec for ${p}:\n${mod.content}`));
@@ -107,6 +154,7 @@ async function handleAutopilotCommand(options = {}) {
                 specContent = mod.content;
             }
         }
+        runLog.specGenerated = true;
     }
     else {
         const { saveFailedAttemptLog } = require('../core/agent-adapter');
@@ -114,9 +162,46 @@ async function handleAutopilotCommand(options = {}) {
         console.log(chalk_1.default.red(`\n✖ Spec Agent failed to generate valid code blocks.`));
         console.log(chalk_1.default.yellow(`  Response from Agent:\n${specRes.agentResponse.substring(0, 300)}...\n`));
         console.log(chalk_1.default.cyan(`  → Diagnostics log saved to: ${logPath}\n`));
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
+    // ── Pre-Lint Validation of Generated Spec ──────────────────────────
+    if (specContent) {
+        try {
+            const { parseGherkinText } = require('../core/gherkin-parser');
+            const { lintSpecification } = require('../core/specification-linter');
+            const { buildIR } = require('../core/ir-builder');
+            const parsed = parseGherkinText(specContent);
+            const lintResult = lintSpecification(parsed, 'autopilot-generated.feature');
+            runLog.lintScore = lintResult.score;
+            console.log(chalk_1.default.blue(`   🔍 Pre-lint score of generated spec: ${lintResult.score}/100`));
+            if (lintResult.score < 60) {
+                console.log(chalk_1.default.red(`   ✖ Generated specification quality is too low (${lintResult.score}/100). Minimum: 60.`));
+                for (const d of lintResult.diagnostics.filter((d) => d.severity === 'error').slice(0, 5)) {
+                    console.log(chalk_1.default.red(`     ✖ [${d.ruleId}] ${d.message}`));
+                }
+                console.log(chalk_1.default.yellow(`   → Consider improving the requirement document and retrying.\n`));
+                saveRunLog(runLog);
+                process.exitCode = 1;
+                return;
+            }
+            // IR Structural Validation
+            const ir = buildIR(parsed, 'autopilot-generated.feature');
+            runLog.irValidation = {
+                commands: ir.commands?.length || 0,
+                events: ir.events?.length || 0,
+                scenarios: ir.scenarios?.length || 0
+            };
+            console.log(chalk_1.default.blue(`   🧠 IR Validation: ${ir.commands?.length || 0} command(s), ${ir.events?.length || 0} event(s), ${ir.scenarios?.length || 0} scenario(s)`));
+            if ((ir.commands?.length || 0) === 0 && (ir.events?.length || 0) === 0) {
+                console.log(chalk_1.default.yellow(`   ⚠ Warning: Generated spec has no extractable commands or events. Agent prompts may lack context.`));
+            }
+        }
+        catch (lintErr) {
+            console.log(chalk_1.default.yellow(`   ⚠ Pre-lint skipped: ${lintErr.message}`));
+        }
+    }
     console.log(chalk_1.default.blue(`3. Invoking Scaffolding Agent -> Generating Bindings...`));
     let scaffoldRes;
     try {
@@ -129,17 +214,35 @@ async function handleAutopilotCommand(options = {}) {
     }
     catch (error) {
         console.log(chalk_1.default.red(`\n✖ Scaffolding Agent execution crashed: ${error.message}`));
+        runLog.scaffoldingResult = 'failed';
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
     if (scaffoldRes.success && scaffoldRes.codeModifications && scaffoldRes.codeModifications.length > 0) {
+        metricsEngine.recordAgentAttempt(scaffoldRes.tokensUsed || 0, scaffoldRes.codeModifications.length);
+        execEvents.push({ type: 'scaffold_agent_attempt', tokens: scaffoldRes.tokensUsed });
+        runLog.scaffoldingResult = 'success';
         const { validateTypeScriptSyntax } = require('../core/syntax-validator');
         for (const mod of scaffoldRes.codeModifications) {
             if (!validateTypeScriptSyntax(mod.filePath, mod.content)) {
                 console.log(chalk_1.default.yellow(`     ✖ Skipped writing ${mod.filePath} due to syntax errors.`));
                 continue;
             }
-            const fullPath = path_1.default.resolve(mod.filePath);
+            const { validateGuardrails } = require('../core/guardrails');
+            const guardrailValidation = validateGuardrails({
+                action: 'generate_code',
+                targetFiles: [mod.filePath]
+            }, process.cwd());
+            if (!guardrailValidation.allowed) {
+                console.log(chalk_1.default.red(`     ✖ GUARDRAIL VIOLATION: Agent changes rejected for ${mod.filePath}.`));
+                for (const v of guardrailValidation.violations) {
+                    console.log(chalk_1.default.red(`       - ${v}`));
+                }
+                continue;
+            }
+            const { resolveSafePath } = require('../utils/file-system');
+            const fullPath = resolveSafePath(process.cwd(), mod.filePath);
             if (process.env.GHK_DRY_RUN === 'true') {
                 if (process.env.GHK_STDOUT === 'true') {
                     console.log(chalk_1.default.yellow(`   [DRY RUN] Proposed bindings for ${mod.filePath}:\n${mod.content}`));
@@ -165,14 +268,46 @@ async function handleAutopilotCommand(options = {}) {
         console.log(chalk_1.default.red(`\n✖ Scaffolding Agent failed to generate valid code blocks.`));
         console.log(chalk_1.default.yellow(`  Response from Agent:\n${scaffoldRes.agentResponse.substring(0, 300)}...\n`));
         console.log(chalk_1.default.cyan(`  → Diagnostics log saved to: ${logPath}\n`));
+        runLog.scaffoldingResult = 'failed';
+        saveRunLog(runLog);
         process.exitCode = 1;
         return;
     }
     console.log(chalk_1.default.blue(`4. Invoking Verification Agent & Closed-Loop Repair...`));
     await (0, verify_1.handleVerifyCommand)({ autoFix: true, maxRetries: 2, command: options.command });
     console.log(chalk_1.default.blue(`5. Evaluating Enterprise Quality Score Gate...`));
-    const scorecard = (0, quality_score_1.calculateQualityScorecard)(process.cwd(), configInstance.specDir);
-    console.log(chalk_1.default.bold.green(`\n✅ Autopilot Execution Complete! Quality Score: ${scorecard.overallScore}%`));
-    console.log(chalk_1.default.bold.cyan(`   Ready for PR Review & Human Approval.\n`));
+    const riskCard = (0, risk_engine_1.calculateDeliveryRisk)(process.cwd(), configInstance.specDir);
+    runLog.riskLevel = riskCard.riskLevel;
+    runLog.riskScore = riskCard.overallRiskScore;
+    console.log('\n======================================================');
+    console.log(chalk_1.default.bold('  Autopilot Deployment Risk Assessment'));
+    console.log('======================================================');
+    const riskColor = riskCard.riskLevel === 'CRITICAL' || riskCard.riskLevel === 'HIGH' ? chalk_1.default.red :
+        riskCard.riskLevel === 'MEDIUM' ? chalk_1.default.yellow : chalk_1.default.green;
+    console.log(chalk_1.default.bold(`Risk Level:   ${riskColor(riskCard.riskLevel)} (Score: ${riskCard.overallRiskScore})`));
+    if (riskCard.requiresHumanApproval) {
+        console.log(chalk_1.default.red('⚠ This change is highly risky and requires human approval.'));
+        runLog.finalStatus = 'failed';
+    }
+    else {
+        console.log(chalk_1.default.green('✅ This change is considered safe for autonomous delivery.'));
+        runLog.finalStatus = 'success';
+    }
+    console.log('\nRun `ghk quality` to see a detailed risk breakdown.\n');
+    metricsEngine.setRequirements(validation.score > 70 ? 10 : 5, 10); // Mock coverage mapping
+    const logPath = metricsEngine.saveExecutionLog(execEvents, execErrors);
+    console.log(chalk_1.default.bold.magenta(`\n📊 DVE Metrics & Execution Log saved to: ${logPath}`));
+    saveRunLog(runLog);
+}
+function saveRunLog(log) {
+    try {
+        const logDir = path_1.default.resolve('.gherkin-ai', 'logs', 'autopilot');
+        fs_1.default.mkdirSync(logDir, { recursive: true });
+        const logPath = path_1.default.join(logDir, `${log.runId}.json`);
+        fs_1.default.writeFileSync(logPath, JSON.stringify(log, null, 2), 'utf8');
+    }
+    catch {
+        // Non-critical: don't crash if logging fails
+    }
 }
 //# sourceMappingURL=autopilot.js.map