@gherkle/runner 0.1.0

package/dist/step-registry.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepRegistry = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class StepRegistry {
+    steps = [];
+    register(keyword, pattern, fn, source = "inline") {
+        this.steps.push({ keyword, pattern, fn, source });
+    }
+    findMatch(keyword, text) {
+        const effectiveKeyword = this.resolveKeyword(keyword);
+        for (const step of this.steps) {
+            if (step.keyword !== effectiveKeyword && effectiveKeyword !== "Any")
+                continue;
+            const match = step.pattern.exec(text);
+            if (match) {
+                return {
+                    definition: step,
+                    args: match.slice(1),
+                };
+            }
+        }
+        // Also try matching without keyword constraint (And/But inherit from previous)
+        for (const step of this.steps) {
+            const match = step.pattern.exec(text);
+            if (match) {
+                return {
+                    definition: step,
+                    args: match.slice(1),
+                };
+            }
+        }
+        return null;
+    }
+    resolveKeyword(keyword) {
+        switch (keyword) {
+            case "Given":
+                return "Given";
+            case "When":
+                return "When";
+            case "Then":
+                return "Then";
+            case "And":
+            case "But":
+                return "Any";
+            default:
+                return "Any";
+        }
+    }
+    get count() {
+        return this.steps.length;
+    }
+    async loadFromDirectory(dirPath) {
+        const absolutePath = path.resolve(process.cwd(), dirPath);
+        if (!fs.existsSync(absolutePath)) {
+            console.warn(`Step definitions directory not found: ${absolutePath}`);
+            return;
+        }
+        const files = this.findStepFiles(absolutePath);
+        for (const file of files) {
+            try {
+                await this.loadStepFile(file);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                console.error(`Failed to load step file ${file}: ${error.message}`);
+            }
+        }
+        console.log(`Loaded ${this.steps.length} step definitions from ${files.length} files`);
+    }
+    findStepFiles(dirPath) {
+        const files = [];
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...this.findStepFiles(fullPath));
+            }
+            else if (entry.name.endsWith(".steps.ts") ||
+                entry.name.endsWith(".steps.js") ||
+                entry.name.endsWith(".step.ts") ||
+                entry.name.endsWith(".step.js") ||
+                entry.name.endsWith("_steps.ts") ||
+                entry.name.endsWith("_steps.js")) {
+                files.push(fullPath);
+            }
+        }
+        return files;
+    }
+    async loadStepFile(filePath) {
+        // Step files export functions that register steps when called with the registry
+        // Pattern: module.exports = function(registry) { registry.Given(/pattern/, fn) }
+        // Or: export default function(registry) { registry.Given(/pattern/, fn) }
+        try {
+            const loaded = require(filePath);
+            const registrar = loaded.default || loaded;
+            if (typeof registrar === "function") {
+                const helpers = {
+                    Given: (pattern, fn) => this.register("Given", pattern, fn, filePath),
+                    When: (pattern, fn) => this.register("When", pattern, fn, filePath),
+                    Then: (pattern, fn) => this.register("Then", pattern, fn, filePath),
+                };
+                registrar(helpers);
+            }
+            else if (typeof registrar === "object" && registrar !== null) {
+                // Object with step definitions as properties
+                for (const [, value] of Object.entries(registrar)) {
+                    if (typeof value === "function") {
+                        const helpers = {
+                            Given: (pattern, fn) => this.register("Given", pattern, fn, filePath),
+                            When: (pattern, fn) => this.register("When", pattern, fn, filePath),
+                            Then: (pattern, fn) => this.register("Then", pattern, fn, filePath),
+                        };
+                        value(helpers);
+                    }
+                }
+            }
+        }
+        catch {
+            // If require fails (e.g., TypeScript file), try to load as a simple module
+            console.warn(`Could not load step file: ${filePath} (may need compilation)`);
+        }
+    }
+}
+exports.StepRegistry = StepRegistry;
+//# sourceMappingURL=step-registry.js.map

package/dist/step-registry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Type definitions for @gherkle/runner
+ */
+export type RunnerStatus = 'online' | 'offline' | 'busy' | 'error';
+export type TestStatus = 'pending' | 'running' | 'passed' | 'failed' | 'skipped';
+export type Framework = 'playwright' | 'cypress' | 'cucumber';
+export interface StepResult {
+    keyword: 'Given' | 'When' | 'Then' | 'And' | 'But';
+    text: string;
+    status: TestStatus;
+    durationMs?: number;
+    error?: string;
+}
+export interface ScenarioResult {
+    scenarioId: string;
+    scenarioName: string;
+    featureId: string;
+    status: TestStatus;
+    durationMs?: number;
+    steps: StepResult[];
+    error?: {
+        message: string;
+        stack?: string;
+    };
+    artifacts?: ArtifactInfo[];
+}
+export interface ArtifactInfo {
+    type: 'screenshot' | 'video' | 'trace' | 'log';
+    name: string;
+    path: string;
+    stepName?: string;
+}
+export interface RunSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    durationMs: number;
+}
+export interface FeatureContent {
+    id: string;
+    name: string;
+    path: string;
+    content: string;
+}
+export interface GeneratedStepDef {
+    featureId: string;
+    filename: string;
+    content: string;
+    language: 'typescript' | 'javascript';
+}
+export interface TestConfig {
+    framework: Framework;
+    language: string;
+    stepDefinitionsPath: string;
+    supportFilesPath: string;
+    config: Record<string, unknown>;
+}
+export type RunnerMessage = {
+    type: 'heartbeat';
+    status: RunnerStatus;
+    currentRun?: string;
+} | {
+    type: 'run:started';
+    runId: string;
+} | {
+    type: 'scenario:started';
+    runId: string;
+    scenarioId: string;
+    scenarioName: string;
+    featureName: string;
+} | {
+    type: 'step:completed';
+    runId: string;
+    scenarioId: string;
+    step: StepResult;
+} | {
+    type: 'scenario:completed';
+    runId: string;
+    scenarioId: string;
+    status: TestStatus;
+    durationMs: number;
+    error?: string;
+} | {
+    type: 'run:completed';
+    runId: string;
+    summary: RunSummary;
+} | {
+    type: 'artifact:upload';
+    runId: string;
+    scenarioId?: string;
+    artifact: ArtifactInfo;
+} | {
+    type: 'error';
+    runId?: string;
+    message: string;
+};
+export type ServerMessage = {
+    type: 'connected';
+    runnerId: string;
+} | {
+    type: 'ack';
+} | {
+    type: 'execute';
+    runId: string;
+    features: FeatureContent[];
+    stepDefinitions: GeneratedStepDef[];
+    env: Record<string, string>;
+    config: TestConfig;
+} | {
+    type: 'cancel';
+    runId: string;
+} | {
+    type: 'error';
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for @gherkle/runner
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/workers/cucumber-worker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * cucumber-worker.ts — forked child process that runs Cucumber.js against a
+ * prepared temp project and streams envelope events back to the parent over
+ * IPC.
+ *
+ * Layout the parent (cucumber-subprocess.ts) prepares before fork:
+ *
+ *   <tmpdir>/
+ *     features/<feature_id>.feature
+ *     steps/<filename>           (AI-generated, .js or .ts)
+ *     support/world.js           (default World shim — exposes this.page etc.)
+ *     cucumber.cjs               (config: feature glob, requireModule, format)
+ *
+ * IPC contract with parent:
+ *   parent → child: nothing after fork (config lives in tmpdir)
+ *   child  → parent:
+ *     { kind: 'envelope', envelope: <Cucumber Envelope> }    per envelope
+ *     { kind: 'done',     success: boolean }                 on clean exit
+ *     { kind: 'fatal',    message: string }                  on infra failure
+ *
+ * Lifecycle:
+ *   - argv[2] is the tmpdir path.
+ *   - We do NOT process.exit() after `done` — we let the event loop drain so
+ *     in-flight async messages reach the parent first. The parent's
+ *     'message' listener for 'done' resolves and proceeds.
+ *   - Cancel is handled in the parent via SIGTERM (and SIGKILL fallback).
+ */
+export {};
+//# sourceMappingURL=cucumber-worker.d.ts.map

package/dist/workers/cucumber-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cucumber-worker.d.ts","sourceRoot":"","sources":["../../src/workers/cucumber-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/workers/cucumber-worker.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * cucumber-worker.ts — forked child process that runs Cucumber.js against a
+ * prepared temp project and streams envelope events back to the parent over
+ * IPC.
+ *
+ * Layout the parent (cucumber-subprocess.ts) prepares before fork:
+ *
+ *   <tmpdir>/
+ *     features/<feature_id>.feature
+ *     steps/<filename>           (AI-generated, .js or .ts)
+ *     support/world.js           (default World shim — exposes this.page etc.)
+ *     cucumber.cjs               (config: feature glob, requireModule, format)
+ *
+ * IPC contract with parent:
+ *   parent → child: nothing after fork (config lives in tmpdir)
+ *   child  → parent:
+ *     { kind: 'envelope', envelope: <Cucumber Envelope> }    per envelope
+ *     { kind: 'done',     success: boolean }                 on clean exit
+ *     { kind: 'fatal',    message: string }                  on infra failure
+ *
+ * Lifecycle:
+ *   - argv[2] is the tmpdir path.
+ *   - We do NOT process.exit() after `done` — we let the event loop drain so
+ *     in-flight async messages reach the parent first. The parent's
+ *     'message' listener for 'done' resolves and proceeds.
+ *   - Cancel is handled in the parent via SIGTERM (and SIGKILL fallback).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("node:path"));
+async function main() {
+    const tmpdir = process.argv[2];
+    if (!tmpdir) {
+        safeSendThenExit({ kind: 'fatal', message: 'cucumber-worker: missing tmpdir argv' }, 1);
+        return;
+    }
+    // ts-node is required only when AI-generated step defs are TypeScript.
+    // The subprocess parent writes a `.use-ts` marker file in that case.
+    // Loading ts-node lazily keeps the JS path's cold-start fast.
+    const useTs = await fileExists(path.join(tmpdir, '.use-ts'));
+    if (useTs) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            require('ts-node/register/transpile-only');
+        }
+        catch (err) {
+            safeSendThenExit({
+                kind: 'fatal',
+                message: `cucumber-worker: failed to load ts-node — install it as a runner dep. ${err.message}`,
+            }, 1);
+            return;
+        }
+    }
+    let runCucumber;
+    let loadConfiguration;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const api = require('@cucumber/cucumber/api');
+        runCucumber = api.runCucumber;
+        loadConfiguration = api.loadConfiguration;
+    }
+    catch (err) {
+        safeSendThenExit({
+            kind: 'fatal',
+            message: `cucumber-worker: @cucumber/cucumber not installed. ${err.message}`,
+        }, 1);
+        return;
+    }
+    try {
+        // BOTH calls need cwd: tmpdir. loadConfiguration resolves relative
+        // path patterns from the config file (`paths: ['features/**/*.feature']`)
+        // against environment.cwd; without it, the glob expands against the
+        // runner process's cwd and finds zero features.
+        const environment = {
+            cwd: tmpdir,
+            // Cucumber writes its CLI summary to stdout. Forwarding to the parent
+            // keeps the runner's console output coherent; envelopes carry the
+            // structured data we actually act on.
+            stdout: process.stdout,
+            stderr: process.stderr,
+            env: process.env,
+        };
+        // loadConfiguration returns { useConfiguration, runConfiguration }. The
+        // runConfiguration field is the one shaped for runCucumber (sources +
+        // support + runtime + formats); useConfiguration is the flat IConfiguration
+        // form, which runCucumber does NOT accept.
+        const { runConfiguration } = await loadConfiguration({ file: path.join(tmpdir, 'cucumber.cjs'), provided: {} }, environment);
+        const { success } = await runCucumber(runConfiguration, environment, (envelope) => {
+            // Envelopes are small JSON objects (testCase, testCaseStarted,
+            // testStepFinished, etc). The parent maps them to runner events.
+            safeSend({ kind: 'envelope', envelope });
+        });
+        safeSend({ kind: 'done', success });
+        // Allow IPC drain; the parent's 'done' handler triggers cleanup. Exit
+        // naturally once the IPC channel closes.
+    }
+    catch (err) {
+        safeSendThenExit({
+            kind: 'fatal',
+            message: `cucumber-worker: runCucumber threw — ${err.message}`,
+        }, 1);
+    }
+}
+function safeSend(msg) {
+    if (typeof process.send === 'function') {
+        process.send(msg);
+    }
+}
+// Flush a final message and exit only after the IPC channel confirms the
+// send. process.send() is async — calling process.exit(N) immediately after
+// can race the OS pipe flush and the parent will see 'exit' with no message.
+// Used for the fatal/done terminal events.
+function safeSendThenExit(msg, code) {
+    if (typeof process.send !== 'function') {
+        process.exit(code);
+    }
+    // The send callback fires after Node has handed the data to the OS write
+    // buffer; that's sufficient for the parent's 'message' handler to fire
+    // before 'exit'. If sending itself errors, exit anyway — better than hang.
+    let exited = false;
+    const done = () => {
+        if (exited)
+            return;
+        exited = true;
+        process.exit(code);
+    };
+    try {
+        process.send(msg, undefined, undefined, (err) => {
+            // Ignore err — by the time we're here we're exiting either way.
+            void err;
+            done();
+        });
+    }
+    catch {
+        done();
+    }
+    // Safety net: if the callback never fires (shouldn't happen but
+    // process.send semantics differ across Node versions), exit after 1s.
+    setTimeout(done, 1000).unref();
+}
+async function fileExists(p) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const fs = require('node:fs/promises');
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+main().catch((err) => {
+    safeSendThenExit({
+        kind: 'fatal',
+        message: `cucumber-worker: main() crashed — ${err.message}`,
+    }, 1);
+});
+//# sourceMappingURL=cucumber-worker.js.map

package/dist/workers/cucumber-worker.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@gherkle/runner",
+  "version": "0.1.0",
+  "description": "Test runner agent for Gherkle - execute Gherkin feature files",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "gherkle-runner": "./bin/gherkle-runner.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "gherkle",
+    "test-runner",
+    "gherkin",
+    "bdd",
+    "cucumber",
+    "playwright",
+    "cypress"
+  ],
+  "author": "Gherkle",
+  "license": "MIT",
+  "dependencies": {
+    "@cucumber/cucumber": "^11.3.0",
+    "@cucumber/gherkin": "^38.0.0",
+    "@cucumber/messages": "^32.0.1",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "ora": "^8.0.1",
+    "ts-node": "^10.9.2",
+    "ws": "^8.16.0"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.58.2",
+    "playwright-core": "^1.58.2"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": { "optional": false },
+    "playwright-core": { "optional": false }
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/node": "^20.10.0",
+    "@types/ws": "^8.5.10",
+    "playwright-core": "^1.58.2",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rvasqz86/gherkle-monorepo.git",
+    "directory": "packages/runner"
+  },
+  "bugs": {
+    "url": "https://github.com/rvasqz86/gherkle-monorepo/issues"
+  },
+  "homepage": "https://github.com/rvasqz86/gherkle-monorepo/tree/main/packages/runner#readme"
+}