gherkin-ai 1.4.0 → 1.5.0

package/README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 > **Bridge the gap between business specifications and AI Coding Agents.**
-> Convert Gherkin `.feature` files into production-ready TypeScript contracts, Zod schemas, OpenAPI specs, deterministic test seeds, and role-specialized executable prompt packages for AI Agents (**Claude Code, Cursor, Antigravity, Windsurf, GitHub Copilot Workspace**).
+> Convert Gherkin `.feature` files into production-ready TypeScript contracts, Python Pydantic DTOs, PHP 8.2 Classes, Go Structs, C# Records, OpenAPI specs, deterministic test seeds, and role-specialized executable prompt packages for AI Agents (**Claude Code, Cursor, Antigravity, Windsurf, GitHub Copilot Workspace**).
 
 ---
 
@@ -13,7 +13,8 @@
 While simple AI prompt generators produce generic text instructions, AI agents often invent conflicting package versions, violate domain boundaries, or fail to write working tests due to missing setup state.
 
 `gherkin-ai` CLI solves this by generating **deterministic technical rails**:
-- **`contracts.ts`**: Strict domain interfaces, event schemas, Zod DTOs, CQRS Event Store ports, and Architecture Decision Records (ADRs).
+- **Native Model Context Protocol (MCP) Server (`ghk mcp`)**: Exposes stdio MCP JSON-RPC 2.0 tools so Claude Desktop, Cursor, Antigravity, and Windsurf can invoke `gherkin-ai` tools directly.
+- **Native Multi-Language Contracts (`contracts.py`, `contracts.php`, `contracts.go`, `contracts.cs`, `contracts.ts`)**: Strict domain interfaces and DTOs generated natively for your target language (Pydantic v2 in Python, Readonly Classes in PHP 8.2, Structs in Go, Records in C#).
 - **`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%.
 - **Interactive Spec Wizard (`ghk create`)**: Create Gherkin specifications step-by-step directly from your terminal.
@@ -24,41 +25,37 @@ While simple AI prompt generators produce generic text instructions, AI agents o
 
 ## 🚀 Quick Start Commands
 
-### 1. Create a Gherkin Spec Interactively (`ghk create`)
+### 1. Model Context Protocol (MCP) Server
 
-Don't have a `.feature` file ready? Build one interactively step-by-step in terminal:
+Connect your AI Agent (Claude Desktop, Cursor, Antigravity) directly to `gherkin-ai`:
 
 ```bash
-ghk create   # (or: ghk new)
+ghk mcp
 ```
 
-### 2. Existing Projects (Brownfield Mode)
+*(See the complete [MCP Integration Guide](docs/MCP_GUIDE.md) for step-by-step setup).*
 
-```bash
-# 1. Auto-detect stack (Laravel, Rails, .NET, NestJS, Angular, Flutter, etc.)
-ghk detect
+### 2. Create a Gherkin Spec Interactively (`ghk create`)
 
-# 2. Inject contract directly into an existing module folder
-ghk add --feature ./specs/payments.feature --target ./src/modules/payments
+```bash
+ghk create   # (or: ghk new)
 ```
 
-### 3. New Projects (Greenfield Mode)
+### 3. Existing Projects (Brownfield Mode)
 
 ```bash
-# 1. Initialize project configuration interactively
-ghk init
-
-# 2. Generate contracts, OpenAPI, fixtures, and AI agent prompts
-ghk generate --feature ./specs/auth.feature
+# 1. Auto-detect stack (Laravel, Rails, .NET, NestJS, Angular, Flutter, etc.)
+ghk detect
 
-# 3. Perform deep architectural linting and layer boundary checks
-ghk validate --feature ./specs/auth.feature
+# 2. Inject native language contract directly into an existing module folder
+ghk add --feature ./specs/payments.feature --target ./src/modules/payments
 ```
 
 ---
 
 ## 📖 Complete Documentation
 
+- [Model Context Protocol (MCP) Integration Guide](docs/MCP_GUIDE.md)
 - [Comprehensive Usage Guide](docs/USAGE_GUIDE.md)
 - [CLI Architecture & Agent Pipeline](docs/ARCHITECTURE.md)
 - [Live Web SPA Playground](https://fennereduardo.com/pages/GherkinIATool/)

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,CAwErH"}
+{"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,CA6ErH"}

package/dist/commands/add.js

@@ -58,13 +58,17 @@ async function handleAddCommand(options) {
         : path_1.default.resolve(process.cwd(), 'src', 'modules', featurePascal.toLowerCase());
     (0, file_system_1.ensureDirSync)(targetDir);
     logger_1.logger.info(`Injecting contracts & AI prompts into: ${targetDir}`);
-    // 1. Generate Contracts & OpenAPI
-    const { contractsTs, adrMd, openApiJson } = (0, contracts_1.generateContracts)(parsed, config);
+    // 1. Generate Contracts, OpenAPI & Native Language Contract
+    const { contractsTs, adrMd, openApiJson, nativeContract } = (0, contracts_1.generateContracts)(parsed, 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);
     (0, file_system_1.writeFileSync)(path_1.default.join(targetDir, `ADR-${featurePascal}.md`), adrMd);
     logger_1.logger.success(`Created contract file: ${path_1.default.join(targetDir, contractFileName)}`);
+    if (nativeContract) {
+        (0, file_system_1.writeFileSync)(path_1.default.join(targetDir, nativeContract.filename), nativeContract.content);
+        logger_1.logger.success(`Created language-native contract file: ${path_1.default.join(targetDir, nativeContract.filename)}`);
+    }
     // 2. Generate Agent Prompts inside target module
     const promptsDir = path_1.default.join(targetDir, 'prompts');
     (0, file_system_1.ensureDirSync)(promptsDir);
@@ -75,6 +79,6 @@ async function handleAddCommand(options) {
     logger_1.logger.success(`Created specialized AI prompts inside: ${promptsDir}`);
     logger_1.logger.banner();
     logger_1.logger.success(`Contracts & AI prompts injected into existing project at ${targetDir}!`);
-    logger_1.logger.info(`Now your AI Coding Agent can consume ${contractFileName} directly inside your module.`);
+    logger_1.logger.info(`Now your AI Coding Agent can consume ${nativeContract ? nativeContract.filename : contractFileName} directly inside your module.`);
 }
 //# sourceMappingURL=add.js.map

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

@@ -0,0 +1,2 @@
+export declare function handleMcpCommand(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAMA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGtD"}

package/dist/commands/mcp.js

@@ -0,0 +1,12 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - 'mcp' Command Handler (Model Context Protocol Server)
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMcpCommand = handleMcpCommand;
+const mcp_server_1 = require("../mcp/mcp-server");
+async function handleMcpCommand() {
+    // Silent start for stdio MCP JSON-RPC 2.0 protocol
+    (0, mcp_server_1.startMcpServer)();
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAIhF,4CAGC;AALD,kDAAmD;AAE5C,KAAK,UAAU,gBAAgB;IACpC,mDAAmD;IACnD,IAAA,2BAAc,GAAE,CAAC;AACnB,CAAC"}

package/dist/generators/contracts-csharp.d.ts

@@ -0,0 +1,4 @@
+import { ParsedFeature } from '../core/gherkin-parser';
+import { GherkinAIConfig } from '../core/config';
+export declare function generateCsharpContracts(parsed: ParsedFeature, config: GherkinAIConfig): string;
+//# sourceMappingURL=contracts-csharp.d.ts.map

package/dist/generators/contracts-csharp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-csharp.d.ts","sourceRoot":"","sources":["../../src/generators/contracts-csharp.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CA8D9F"}

package/dist/generators/contracts-csharp.js

@@ -0,0 +1,69 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - C# 11 Records & Interfaces Generator
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCsharpContracts = generateCsharpContracts;
+function generateCsharpContracts(parsed, config) {
+    const featurePascal = parsed.featureName.replace(/[^a-zA-Z0-9]/g, '');
+    return `/* ==========================================================================
+   Generated Domain Contracts & C# 11 Records
+   Feature: ${parsed.featureName}
+   Stack: C# + ${config.stack.framework} + ${config.stack.orm}
+   Generated by gherkin-ai CLI v1.5.0
+   ========================================================================== */
+
+namespace Domain.Contracts.${featurePascal};
+
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+// --------------------------------------------------------------------------
+// 1. Domain Event Interface & Record Implementations
+// --------------------------------------------------------------------------
+public interface IDomainEvent
+{
+    Guid EventId { get; }
+    DateTime OccurredOn { get; }
+    string EventType { get; }
+}
+
+${parsed.domainAnalysis.events.map((ev, i) => `public record Event${i + 1}(
+    Guid EventId,
+    DateTime OccurredOn,
+    Dictionary<string, object> Payload
+) : IDomainEvent
+{
+    public string EventType => "${ev.replace(/[^a-zA-Z0-9]/g, '')}";
+}`).join('\n\n')}
+
+// --------------------------------------------------------------------------
+// 2. Command DTO Record
+// --------------------------------------------------------------------------
+public record ${featurePascal}Command(
+    Guid RequestId,
+    DateTime Timestamp,
+    Dictionary<string, object> Payload
+);
+
+// --------------------------------------------------------------------------
+// 3. Domain Repository Port
+// --------------------------------------------------------------------------
+public interface I${featurePascal}Repository
+{
+    Task<object?> FindByIdAsync(string id);
+    Task SaveAsync(object entity);
+    Task DeleteAsync(string id);
+}
+
+// --------------------------------------------------------------------------
+// 4. Application Event Publisher Port
+// --------------------------------------------------------------------------
+public interface IEventPublisher
+{
+    Task PublishAsync(IDomainEvent domainEvent);
+}
+`;
+}
+//# sourceMappingURL=contracts-csharp.js.map

package/dist/generators/contracts-csharp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-csharp.js","sourceRoot":"","sources":["../../src/generators/contracts-csharp.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAKhF,0DA8DC;AA9DD,SAAgB,uBAAuB,CAAC,MAAqB,EAAE,MAAuB;IACpF,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEtE,OAAO;;cAEK,MAAM,CAAC,WAAW;iBACf,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG;;;;6BAIhC,aAAa;;;;;;;;;;;;;;;;EAgBxC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC;;;;;;kCAMvC,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;EAC/D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;gBAKA,aAAa;;;;;;;;;oBAST,aAAa;;;;;;;;;;;;;;CAchC,CAAC;AACF,CAAC"}

package/dist/generators/contracts-go.d.ts

@@ -0,0 +1,4 @@
+import { ParsedFeature } from '../core/gherkin-parser';
+import { GherkinAIConfig } from '../core/config';
+export declare function generateGoContracts(parsed: ParsedFeature, config: GherkinAIConfig): string;
+//# sourceMappingURL=contracts-go.d.ts.map

package/dist/generators/contracts-go.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-go.d.ts","sourceRoot":"","sources":["../../src/generators/contracts-go.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CA8D1F"}

package/dist/generators/contracts-go.js

@@ -0,0 +1,69 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - Go Structs & Domain Interfaces Generator
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGoContracts = generateGoContracts;
+function generateGoContracts(parsed, config) {
+    const featurePascal = parsed.featureName.replace(/[^a-zA-Z0-9]/g, '');
+    return `/* ==========================================================================
+   Generated Domain Contracts & Go Structs
+   Feature: ${parsed.featureName}
+   Stack: Go + ${config.stack.framework} + ${config.stack.orm}
+   Generated by gherkin-ai CLI v1.5.0
+   ========================================================================== */
+
+package contracts
+
+import (
+	"context"
+	"time"
+)
+
+// --------------------------------------------------------------------------
+// 1. Domain Event Interface
+// --------------------------------------------------------------------------
+type IDomainEvent interface {
+	GetEventID() string
+	GetOccurredOn() time.Time
+	GetEventType() string
+}
+
+${parsed.domainAnalysis.events.map((ev, i) => `type Event${i + 1} struct {
+	EventID    string                 \`json:"event_id"\`
+	OccurredOn time.Time              \`json:"occurred_on"\`
+	EventType  string                 \`json:"event_type"\`
+	Payload    map[string]interface{} \`json:"payload"\`
+}
+
+func (e Event${i + 1}) GetEventID() string       { return e.EventID }
+func (e Event${i + 1}) GetOccurredOn() time.Time { return e.OccurredOn }
+func (e Event${i + 1}) GetEventType() string    { return "${ev.replace(/[^a-zA-Z0-9]/g, '')}" }`).join('\n\n')}
+
+// --------------------------------------------------------------------------
+// 2. Command DTO Struct
+// --------------------------------------------------------------------------
+type ${featurePascal}Command struct {
+	RequestID string                 \`json:"request_id" validate:"required,uuid"\`
+	Timestamp time.Time              \`json:"timestamp" validate:"required"\`
+	Payload   map[string]interface{} \`json:"payload" validate:"required"\`
+}
+
+// --------------------------------------------------------------------------
+// 3. Domain Repository Port
+// --------------------------------------------------------------------------
+type I${featurePascal}Repository interface {
+	FindByID(ctx context.Context, id string) (interface{}, error)
+	Save(ctx context.Context, entity interface{}) error
+	Delete(ctx context.Context, id string) error
+}
+
+// --------------------------------------------------------------------------
+// 4. Application Event Publisher Port
+// --------------------------------------------------------------------------
+type IEventPublisher interface {
+	Publish(ctx context.Context, event IDomainEvent) error
+}
+`;
+}
+//# sourceMappingURL=contracts-go.js.map

package/dist/generators/contracts-go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-go.js","sourceRoot":"","sources":["../../src/generators/contracts-go.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAKhF,kDA8DC;AA9DD,SAAgB,mBAAmB,CAAC,MAAqB,EAAE,MAAuB;IAChF,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEtE,OAAO;;cAEK,MAAM,CAAC,WAAW;iBACf,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;EAoB3D,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC;;;;;;;eAOjD,CAAC,GAAG,CAAC;eACL,CAAC,GAAG,CAAC;eACL,CAAC,GAAG,CAAC,wCAAwC,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;OAKvG,aAAa;;;;;;;;;QASZ,aAAa;;;;;;;;;;;;CAYpB,CAAC;AACF,CAAC"}

package/dist/generators/contracts-php.d.ts

@@ -0,0 +1,4 @@
+import { ParsedFeature } from '../core/gherkin-parser';
+import { GherkinAIConfig } from '../core/config';
+export declare function generatePhpContracts(parsed: ParsedFeature, config: GherkinAIConfig): string;
+//# sourceMappingURL=contracts-php.d.ts.map

package/dist/generators/contracts-php.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-php.d.ts","sourceRoot":"","sources":["../../src/generators/contracts-php.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAuE3F"}

package/dist/generators/contracts-php.js

@@ -0,0 +1,78 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - PHP 8.2 Domain Contracts & DTOs Generator
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePhpContracts = generatePhpContracts;
+function generatePhpContracts(parsed, config) {
+    const featurePascal = parsed.featureName.replace(/[^a-zA-Z0-9]/g, '');
+    return `<?php
+
+declare(strict_types=1);
+
+/* ==========================================================================
+   Generated Domain Contracts & PHP DTOs
+   Feature: ${parsed.featureName}
+   Stack: PHP 8.2 + ${config.stack.framework} + ${config.stack.orm}
+   Generated by gherkin-ai CLI v1.5.0
+   ========================================================================== */
+
+namespace App\\Domain\\Contracts\\${featurePascal};
+
+use DateTimeImmutable;
+
+// --------------------------------------------------------------------------
+// 1. Base Domain Event Interface
+// --------------------------------------------------------------------------
+interface IDomainEvent
+{
+    public function getEventId(): string;
+    public function getOccurredOn(): DateTimeImmutable;
+    public function getEventType(): string;
+}
+
+${parsed.domainAnalysis.events.map((ev, i) => `readonly class Event${i + 1} implements IDomainEvent
+{
+    public function __construct(
+        public string $eventId,
+        public DateTimeImmutable $occurredOn,
+        public array $payload = []
+    ) {}
+
+    public function getEventId(): string { return $this->eventId; }
+    public function getOccurredOn(): DateTimeImmutable { return $this->occurredOn; }
+    public function getEventType(): string { return '${ev.replace(/[^a-zA-Z0-9]/g, '')}'; }
+}`).join('\n\n')}
+
+// --------------------------------------------------------------------------
+// 2. Command DTO Class (Readonly PHP 8.2)
+// --------------------------------------------------------------------------
+readonly class ${featurePascal}Command
+{
+    public function __construct(
+        public string $requestId,
+        public DateTimeImmutable $timestamp,
+        public array $payload
+    ) {}
+}
+
+// --------------------------------------------------------------------------
+// 3. Domain Repository Port (Outbound Interface)
+// --------------------------------------------------------------------------
+interface I${featurePascal}Repository
+{
+    public function findById(string $id): mixed;
+    public function save(mixed $entity): void;
+    public function delete(string $id): void;
+}
+
+// --------------------------------------------------------------------------
+// 4. Application Event Publisher Port
+// --------------------------------------------------------------------------
+interface IEventPublisher
+{
+    public function publish(IDomainEvent $event): void;
+}
+`;
+}
+//# sourceMappingURL=contracts-php.js.map

package/dist/generators/contracts-php.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-php.js","sourceRoot":"","sources":["../../src/generators/contracts-php.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAKhF,oDAuEC;AAvED,SAAgB,oBAAoB,CAAC,MAAqB,EAAE,MAAuB;IACjF,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEtE,OAAO;;;;;;cAMK,MAAM,CAAC,WAAW;sBACV,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG;;;;oCAI9B,aAAa;;;;;;;;;;;;;;EAc/C,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC;;;;;;;;;;uDAUnB,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;EACpF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;iBAKC,aAAa;;;;;;;;;;;;aAYjB,aAAa;;;;;;;;;;;;;;CAczB,CAAC;AACF,CAAC"}

package/dist/generators/contracts-python.d.ts

@@ -0,0 +1,4 @@
+import { ParsedFeature } from '../core/gherkin-parser';
+import { GherkinAIConfig } from '../core/config';
+export declare function generatePythonContracts(parsed: ParsedFeature, config: GherkinAIConfig): string;
+//# sourceMappingURL=contracts-python.d.ts.map

package/dist/generators/contracts-python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-python.d.ts","sourceRoot":"","sources":["../../src/generators/contracts-python.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAsD9F"}

package/dist/generators/contracts-python.js

@@ -0,0 +1,61 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - Python Pydantic v2 & Domain Contracts Generator
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePythonContracts = generatePythonContracts;
+function generatePythonContracts(parsed, config) {
+    const featurePascal = parsed.featureName.replace(/[^a-zA-Z0-9]/g, '');
+    return `# ==========================================================================
+# Generated Domain Contracts & Pydantic DTO Schemas
+# Feature: ${parsed.featureName}
+# Stack: Python + ${config.stack.framework} + ${config.stack.orm}
+# Generated by gherkin-ai CLI v1.5.0
+# ==========================================================================
+
+from datetime import datetime
+from typing import Protocol, Any, Dict, Optional
+from pydantic import BaseModel, Field, UUID4
+
+# --------------------------------------------------------------------------
+# 1. Base Domain Event & Event Schemas
+# --------------------------------------------------------------------------
+class IDomainEvent(BaseModel):
+    event_id: UUID4
+    occurred_on: datetime = Field(default_factory=datetime.utcnow)
+    event_type: str
+
+${parsed.domainAnalysis.events.map((ev, i) => `class Event${i + 1}(IDomainEvent):
+    event_type: str = "${ev.replace(/[^a-zA-Z0-9]/g, '')}"
+    payload: Dict[str, Any]`).join('\n\n')}
+
+# --------------------------------------------------------------------------
+# 2. Command DTO Schema (Pydantic v2 Validation)
+# --------------------------------------------------------------------------
+class ${featurePascal}Command(BaseModel):
+    request_id: UUID4
+    timestamp: datetime = Field(default_factory=datetime.utcnow)
+    payload: Dict[str, Any]
+
+# --------------------------------------------------------------------------
+# 3. Domain Repository Port (Outbound Protocol)
+# --------------------------------------------------------------------------
+class I${featurePascal}Repository(Protocol):
+    async def find_by_id(self, entity_id: str) -> Optional[Any]:
+        ...
+
+    async def save(self, entity: Any) -> None:
+        ...
+
+    async def delete(self, entity_id: str) -> None:
+        ...
+
+# --------------------------------------------------------------------------
+# 4. Application Event Publisher Port
+# --------------------------------------------------------------------------
+class IEventPublisher(Protocol):
+    async def publish(self, event: IDomainEvent) -> None:
+        ...
+`;
+}
+//# sourceMappingURL=contracts-python.js.map

package/dist/generators/contracts-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-python.js","sourceRoot":"","sources":["../../src/generators/contracts-python.ts"],"names":[],"mappings":";AAAA;;gFAEgF;;AAKhF,0DAsDC;AAtDD,SAAgB,uBAAuB,CAAC,MAAqB,EAAE,MAAuB;IACpF,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEtE,OAAO;;aAEI,MAAM,CAAC,WAAW;oBACX,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG;;;;;;;;;;;;;;;;EAgB9D,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC;yBACxC,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;4BAC5B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;QAKlC,aAAa;;;;;;;;SAQZ,aAAa;;;;;;;;;;;;;;;;CAgBrB,CAAC;AACF,CAAC"}

package/dist/generators/contracts.d.ts

@@ -1,8 +1,13 @@
 import { ParsedFeature } from '../core/gherkin-parser';
 import { GherkinAIConfig } from '../core/config';
-export declare function generateContracts(parsed: ParsedFeature, config: GherkinAIConfig): {
+export interface GeneratedContractsOutput {
     contractsTs: string;
     adrMd: string;
     openApiJson: string;
-};
+    nativeContract?: {
+        filename: string;
+        content: string;
+    };
+}
+export declare function generateContracts(parsed: ParsedFeature, config: GherkinAIConfig): GeneratedContractsOutput;
 //# sourceMappingURL=contracts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/generators/contracts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA+I7I"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/generators/contracts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQjD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAAG,wBAAwB,CAwK1G"}

package/dist/generators/contracts.js

@@ -1,11 +1,15 @@
 "use strict";
 /* ==========================================================================
-   gherkin-ai-cli - TypeScript Contracts, CQRS Event Sourcing & OpenAPI Generator
+   gherkin-ai-cli - Multi-Language Domain Contracts & OpenAPI Generator
    ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateContracts = generateContracts;
 const arch_rules_1 = require("../core/arch-rules");
 const stack_specs_1 = require("../core/stack-specs");
+const contracts_python_1 = require("./contracts-python");
+const contracts_php_1 = require("./contracts-php");
+const contracts_go_1 = require("./contracts-go");
+const contracts_csharp_1 = require("./contracts-csharp");
 function generateContracts(parsed, config) {
     const arch = (0, arch_rules_1.getArchRule)(config.architecture);
     const spec = (0, stack_specs_1.getStackSpec)(config.stack);
@@ -38,7 +42,7 @@ export interface ISnapshotStore<T> {
    Feature: ${parsed.featureName}
    Architecture: ${arch.name}
    Stack: ${config.stack.language} + ${config.stack.framework} + ${config.stack.orm}
-   Generated by gherkin-ai CLI v1.0.0
+   Generated by gherkin-ai CLI v1.5.0
    ========================================================================== */
 
 import { z } from '${spec.validationPackage.split('@')[0]}';
@@ -142,6 +146,32 @@ ${arch.prohibitedImports.map(p => `- \`${p}\``).join('\n')}
             }
         }
     }, null, 2);
-    return { contractsTs, adrMd, openApiJson };
+    // Generate Native Contract file based on target stack language
+    let nativeContract;
+    if (config.stack.language === 'python') {
+        nativeContract = {
+            filename: `${featurePascal.toLowerCase()}.contract.py`,
+            content: (0, contracts_python_1.generatePythonContracts)(parsed, config)
+        };
+    }
+    else if (config.stack.language === 'php') {
+        nativeContract = {
+            filename: `${featurePascal.toLowerCase()}.contract.php`,
+            content: (0, contracts_php_1.generatePhpContracts)(parsed, config)
+        };
+    }
+    else if (config.stack.language === 'go') {
+        nativeContract = {
+            filename: `${featurePascal.toLowerCase()}.contract.go`,
+            content: (0, contracts_go_1.generateGoContracts)(parsed, config)
+        };
+    }
+    else if (config.stack.language === 'csharp') {
+        nativeContract = {
+            filename: `${featurePascal.toLowerCase()}.contract.cs`,
+            content: (0, contracts_csharp_1.generateCsharpContracts)(parsed, config)
+        };
+    }
+    return { contractsTs, adrMd, openApiJson, nativeContract };
 }
 //# sourceMappingURL=contracts.js.map

package/dist/generators/contracts.js.map

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

package/dist/index.js

@@ -12,13 +12,14 @@ const detect_1 = require("./commands/detect");
 const add_1 = require("./commands/add");
 const create_1 = require("./commands/create");
 const lang_1 = require("./commands/lang");
+const mcp_1 = require("./commands/mcp");
 // 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.4.0')
+    .version(pkg.version || '1.5.0')
     .option('--init', 'Alias for init command')
     .option('--create', 'Alias for create command')
     .option('--generate', 'Alias for generate command')
@@ -31,6 +32,12 @@ program
     .action(async () => {
     await (0, init_1.handleInitCommand)();
 });
+program
+    .command('mcp')
+    .description('Start native Model Context Protocol (MCP) JSON-RPC 2.0 stdio server for AI Agents')
+    .action(async () => {
+    await (0, mcp_1.handleMcpCommand)();
+});
 program
     .command('lang')
     .alias('l')

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":";AAAA;;gFAEgF;;AAEhF,yCAAoC;AACpC,0CAAoD;AACpD,kDAA4D;AAC5D,kDAA4D;AAC5D,8CAAwD;AACxD,8CAAwD;AACxD,wCAAkD;AAClD,8CAAwD;AACxD,0CAAoD;AACpD,wCAAkD;AAElD,oCAAoC;AACpC,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEvC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,sIAAsI,CAAC;KACnJ,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;KAC/B,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC1C,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC;KAC9C,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC;KAClD,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC;KAClD,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAAC;AAElD,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,kFAAkF,CAAC;KAC/F,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,wBAAiB,GAAE,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,mFAAmF,CAAC;KAChG,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,sBAAgB,GAAE,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,KAAK,CAAC,GAAG,CAAC;KACV,KAAK,CAAC,UAAU,CAAC;KACjB,WAAW,CAAC,mEAAmE,CAAC;KAChF,MAAM,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;KAChE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,wBAAiB,EAAC,OAAO,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,KAAK,CAAC,GAAG,CAAC;KACV,KAAK,CAAC,KAAK,CAAC;KACZ,WAAW,CAAC,qFAAqF,CAAC;KAClG,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;KACrE,MAAM,CAAC,0BAA0B,EAAE,sCAAsC,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,2DAA2D,CAAC;KAC1F,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,gFAAgF,CAAC;KAC7F,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,4BAAmB,GAAE,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,uFAAuF,CAAC;KACpG,MAAM,CAAC,sBAAsB,EAAE,+BAA+B,CAAC;KAC/D,MAAM,CAAC,0BAA0B,EAAE,0CAA0C,CAAC;KAC9E,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,sBAAgB,EAAC,OAAO,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,wHAAwH,CAAC;KACrI,MAAM,CAAC,sBAAsB,EAAE,+BAA+B,CAAC;KAC/D,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,gCAAqB,EAAC,OAAO,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,kEAAkE,CAAC;KAC/E,MAAM,CAAC,sBAAsB,EAAE,+BAA+B,CAAC;KAC/D,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,gCAAqB,EAAC,OAAO,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,0DAA0D,CAAC;KACvE,MAAM,CAAC,sBAAsB,EAAE,+BAA+B,CAAC;KAC/D,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,EAAE,IAAI,CAAC;KAC7D,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEL,sFAAsF;AACtF,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC/B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAA,wBAAiB,GAAE,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAA,4BAAmB,EAAC,EAAE,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAA,4BAAmB,GAAE,CAAC;IAC9B,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAA,gCAAqB,EAAC,EAAE,CAAC,CAAC;IAClC,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAA,gCAAqB,EAAC,EAAE,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/mcp/mcp-server.d.ts

@@ -0,0 +1,2 @@
+export declare function startMcpServer(): void;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-server.ts"],"names":[],"mappings":"AAUA,wBAAgB,cAAc,IAAI,IAAI,CAwBrC"}

package/dist/mcp/mcp-server.js

@@ -0,0 +1,185 @@
+"use strict";
+/* ==========================================================================
+   gherkin-ai-cli - Model Context Protocol (MCP) Stdio JSON-RPC 2.0 Server
+   ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startMcpServer = startMcpServer;
+const gherkin_parser_1 = require("../core/gherkin-parser");
+const contracts_1 = require("../generators/contracts");
+const stack_detector_1 = require("../core/stack-detector");
+const arch_rules_1 = require("../core/arch-rules");
+const config_1 = require("../core/config");
+function startMcpServer() {
+    process.stdin.setEncoding('utf8');
+    let buffer = '';
+    process.stdin.on('data', (chunk) => {
+        buffer += chunk;
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line.trim());
+                handleJsonRpcMessage(message);
+            }
+            catch (err) {
+                // Send JSON-RPC Parse Error
+                sendJsonRpcResponse(null, null, {
+                    code: -32700,
+                    message: `Parse error: ${err.message}`
+                });
+            }
+        }
+    });
+}
+function sendJsonRpcResponse(id, result, error = null) {
+    const response = { jsonrpc: '2.0', id };
+    if (error) {
+        response.error = error;
+    }
+    else {
+        response.result = result;
+    }
+    process.stdout.write(JSON.stringify(response) + '\n');
+}
+function handleJsonRpcMessage(message) {
+    const { id, method, params } = message;
+    switch (method) {
+        case 'initialize':
+            sendJsonRpcResponse(id, {
+                protocolVersion: '2024-11-05',
+                capabilities: {
+                    tools: {}
+                },
+                serverInfo: {
+                    name: 'gherkin-ai-mcp',
+                    version: '1.5.0'
+                }
+            });
+            break;
+        case 'notifications/initialized':
+            // Notification, no response needed
+            break;
+        case 'tools/list':
+            sendJsonRpcResponse(id, {
+                tools: [
+                    {
+                        name: 'parse_gherkin',
+                        description: 'Parse Gherkin .feature specification text into domain AST (commands, queries, events, actors).',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                gherkinText: { type: 'string', description: 'Gherkin feature file content.' }
+                            },
+                            required: ['gherkinText']
+                        }
+                    },
+                    {
+                        name: 'generate_contracts',
+                        description: 'Generate TypeScript, OpenAPI 3.0, and native language contracts (Python, PHP, Go, C#) from Gherkin text.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                gherkinText: { type: 'string', description: 'Gherkin feature file content.' },
+                                language: { type: 'string', description: 'Target language (typescript, python, php, go, csharp).' },
+                                architecture: { type: 'string', description: 'Architecture style (hexagonal, ddd, clean, cqrs, serverless, microservices).' }
+                            },
+                            required: ['gherkinText']
+                        }
+                    },
+                    {
+                        name: 'detect_stack',
+                        description: 'Auto-detect project tech stack and architecture from workspace root directory.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                projectDir: { type: 'string', description: 'Absolute path to project directory.' }
+                            }
+                        }
+                    },
+                    {
+                        name: 'validate_architecture',
+                        description: 'Validate Gherkin AST step coverage and layer import boundary isolation rules.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                gherkinText: { type: 'string', description: 'Gherkin feature text.' },
+                                architecture: { type: 'string', description: 'Architecture style to validate against.' }
+                            },
+                            required: ['gherkinText']
+                        }
+                    }
+                ]
+            });
+            break;
+        case 'tools/call':
+            handleToolCall(id, params?.name, params?.arguments || {});
+            break;
+        default:
+            if (id !== undefined) {
+                sendJsonRpcResponse(id, null, {
+                    code: -32601,
+                    message: `Method not found: ${method}`
+                });
+            }
+            break;
+    }
+}
+function handleToolCall(id, name, args) {
+    try {
+        if (name === 'parse_gherkin') {
+            const parsed = (0, gherkin_parser_1.parseGherkinText)(args.gherkinText || '');
+            sendJsonRpcResponse(id, {
+                content: [{ type: 'text', text: JSON.stringify(parsed, null, 2) }]
+            });
+        }
+        else if (name === 'generate_contracts') {
+            const config = (0, config_1.loadConfig)();
+            if (args.language)
+                config.stack.language = args.language;
+            if (args.architecture)
+                config.architecture = args.architecture;
+            const parsed = (0, gherkin_parser_1.parseGherkinText)(args.gherkinText || '');
+            const output = (0, contracts_1.generateContracts)(parsed, config);
+            sendJsonRpcResponse(id, {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }]
+            });
+        }
+        else if (name === 'detect_stack') {
+            const targetDir = args.projectDir || process.cwd();
+            const detected = (0, stack_detector_1.detectExistingStack)(targetDir);
+            sendJsonRpcResponse(id, {
+                content: [{ type: 'text', text: JSON.stringify(detected, null, 2) }]
+            });
+        }
+        else if (name === 'validate_architecture') {
+            const parsed = (0, gherkin_parser_1.parseGherkinText)(args.gherkinText || '');
+            const arch = (0, arch_rules_1.getArchRule)(args.architecture || 'hexagonal');
+            const scorecard = {
+                featureName: parsed.featureName,
+                scenariosCount: parsed.scenarios.length,
+                commandsCount: parsed.domainAnalysis.commands.length,
+                eventsCount: parsed.domainAnalysis.events.length,
+                prohibitedImportsGuard: arch.prohibitedImports,
+                passed: parsed.scenarios.length > 0
+            };
+            sendJsonRpcResponse(id, {
+                content: [{ type: 'text', text: JSON.stringify(scorecard, null, 2) }]
+            });
+        }
+        else {
+            sendJsonRpcResponse(id, null, {
+                code: -32601,
+                message: `Unknown tool: ${name}`
+            });
+        }
+    }
+    catch (err) {
+        sendJsonRpcResponse(id, null, {
+            code: -32000,
+            message: `Tool execution failed: ${err.message}`
+        });
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp/mcp-server.js.map

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

package/docs/MCP_GUIDE.md

@@ -0,0 +1,145 @@
+# 🔌 Model Context Protocol (MCP) Integration Guide for `gherkin-ai`
+
+`gherkin-ai` CLI includes a native **Model Context Protocol (MCP)** JSON-RPC 2.0 stdio server (`ghk mcp`). This allows AI Agents (**Claude Desktop, Cursor, Antigravity, Windsurf, Roo Code, VS Code MCP Extensions**) to invoke `gherkin-ai` tools directly when editing `.feature` files or building architecture.
+
+---
+
+## 🌟 Exposed MCP Tools
+
+When connected to `ghk mcp`, AI Agents gain direct access to the following 4 tools:
+
+1. **`parse_gherkin`**: Parses `.feature` specification text into a domain AST (commands, queries, events, actors).
+2. **`generate_contracts`**: Generates TypeScript, OpenAPI 3.0, and native language contracts (Python, PHP, Go, C#) from Gherkin text.
+3. **`detect_stack`**: Auto-detects project tech stack & architecture from the workspace root directory.
+4. **`validate_architecture`**: Validates Gherkin AST step coverage and layer import boundary isolation rules.
+
+---
+
+## 🛠️ Step-by-Step Configuration per AI Agent / IDE
+
+### 1. Claude Desktop App
+
+Edit your `claude_desktop_config.json`:
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add `gherkin-ai` to the `mcpServers` section:
+
+```json
+{
+  "mcpServers": {
+    "gherkin-ai": {
+      "command": "npx",
+      "args": ["-y", "gherkin-ai@latest", "mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You will see a hammer icon 🔨 indicating that `gherkin-ai` tools are active.
+
+---
+
+### 2. Cursor IDE
+
+In Cursor, configure MCP tools via **Settings** or project configuration:
+
+1. Open **Cursor Settings** (`Ctrl + ,` / `Cmd + ,`) → **Features** → **MCP Servers**.
+2. Click **+ Add New MCP Server**.
+3. Fill in:
+   - **Name**: `gherkin-ai`
+   - **Type**: `command` (stdio)
+   - **Command**: `npx -y gherkin-ai@latest mcp`
+
+Or add a `.cursor/mcp.json` file in your repository:
+
+```json
+{
+  "mcpServers": {
+    "gherkin-ai": {
+      "command": "npx",
+      "args": ["-y", "gherkin-ai@latest", "mcp"]
+    }
+  }
+}
+```
+
+---
+
+### 3. Antigravity / VS Code MCP Extensions
+
+In VS Code or Antigravity with MCP extension installed:
+
+Open `settings.json` and add:
+
+```json
+{
+  "mcp.servers": {
+    "gherkin-ai": {
+      "command": "npx",
+      "args": ["-y", "gherkin-ai@latest", "mcp"]
+    }
+  }
+}
+```
+
+---
+
+### 4. Windsurf IDE
+
+Add `.windsurf/mcp.json` to your user home directory or project root:
+
+```json
+{
+  "mcpServers": {
+    "gherkin-ai": {
+      "command": "npx",
+      "args": ["-y", "gherkin-ai@latest", "mcp"]
+    }
+  }
+}
+```
+
+---
+
+### 5. Roo Code / Continue.dev
+
+In `~/.continue/config.json` or Roo Code settings:
+
+```json
+{
+  "experimental": {
+    "modelContextProtocolServers": [
+      {
+        "transport": {
+          "type": "stdio",
+          "command": "npx",
+          "args": ["-y", "gherkin-ai@latest", "mcp"]
+        }
+      }
+    ]
+  }
+}
+```
+
+---
+
+## 🧪 Testing the MCP Server Connection
+
+You can manually verify that the stdio MCP server is working by running:
+
+```bash
+ghk mcp
+```
+
+Send the JSON-RPC `initialize` request via stdin:
+
+```json
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}
+```
+
+The server will respond with:
+
+```json
+{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"gherkin-ai-mcp","version":"1.5.0"}}}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gherkin-ai",
-  "version": "1.4.0",
+  "version": "1.5.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",
@@ -35,7 +35,14 @@
     "brownfield",
     "detect",
     "create",
-    "wizard"
+    "wizard",
+    "pydantic",
+    "python",
+    "php",
+    "laravel",
+    "go",
+    "csharp",
+    "dotnet"
   ],
   "author": "Fenner Eduardo <contact@fennereduardo.com> (https://fennereduardo.com)",
   "license": "MIT",