@gherkle/runner 0.1.0

package/dist/__tests__/tmpdir-materialization.test.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Tests for CucumberSubprocessExecutor.prepareTmpdir — the on-disk layout
+ * the forked Cucumber.js worker reads.
+ *
+ * Tmpdir layout under verification:
+ *   <tmpdir>/
+ *     features/<feature_id>.feature
+ *     steps/<filename>
+ *     support/world.{js|ts}
+ *     cucumber.cjs
+ *     .use-ts                 (only when any step-def is TypeScript)
+ *
+ * The runtime call site is private to executeAll(); this test calls
+ * prepareTmpdir directly and asserts the filesystem state. Each test cleans
+ * up the directory it created.
+ */
+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 vitest_1 = require("vitest");
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const cucumber_subprocess_1 = require("../frameworks/cucumber-subprocess");
+const cleanupPaths = [];
+(0, vitest_1.afterEach)(async () => {
+    while (cleanupPaths.length) {
+        const p = cleanupPaths.pop();
+        try {
+            await fs.rm(p, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+});
+function track(p) {
+    cleanupPaths.push(p);
+    return p;
+}
+const featureFactory = (id, name = 'demo') => ({
+    id,
+    name: `features/${name}.feature`,
+    path: `features/${name}.feature`,
+    content: `Feature: ${name}\n  Scenario: it works\n    Given a thing\n`,
+});
+const stepDefFactory = (featureId, filename, language = 'javascript') => ({
+    featureId,
+    filename,
+    content: `// step defs for ${featureId}\n`,
+    language,
+});
+(0, vitest_1.describe)('CucumberSubprocessExecutor.prepareTmpdir', () => {
+    (0, vitest_1.it)('creates features/, steps/, support/ directories and cucumber.cjs', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a')], [stepDefFactory('feat-a', 'steps.js')]));
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'features'))).resolves.toBeUndefined();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'steps'))).resolves.toBeUndefined();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'support'))).resolves.toBeUndefined();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'cucumber.cjs'))).resolves.toBeUndefined();
+    });
+    (0, vitest_1.it)('writes each feature at features/<feature_id>.feature (NOT the DB path)', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('uuid-1234')], [stepDefFactory('uuid-1234', 'steps.js')]));
+        // Stored by feature_id, NOT by the DB-side path. This is what lets the
+        // envelope mapper recover feature_id from pickle.uri.
+        const featurePath = path.join(tmpdir, 'features', 'uuid-1234.feature');
+        const content = await fs.readFile(featurePath, 'utf8');
+        (0, vitest_1.expect)(content).toContain('Feature: demo');
+    });
+    (0, vitest_1.it)('renames colliding step-def filenames with feature_id suffix', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a'), featureFactory('feat-b')], [
+            stepDefFactory('feat-a', 'steps.js'),
+            // Same filename — must be renamed, not silently overwritten.
+            stepDefFactory('feat-b', 'steps.js'),
+        ]));
+        const stepsDir = await fs.readdir(path.join(tmpdir, 'steps'));
+        (0, vitest_1.expect)(stepsDir).toContain('steps.js');
+        (0, vitest_1.expect)(stepsDir).toContain('steps-feat-b.js');
+        (0, vitest_1.expect)(stepsDir).toHaveLength(2);
+    });
+    (0, vitest_1.it)('emits world.js + NO .use-ts marker when all step-defs are JavaScript', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a')], [stepDefFactory('feat-a', 'steps.js', 'javascript')]));
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'support', 'world.js'))).resolves.toBeUndefined();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'support', 'world.ts'))).rejects.toThrow();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, '.use-ts'))).rejects.toThrow();
+    });
+    (0, vitest_1.it)('emits world.ts + .use-ts marker when ANY step-def is TypeScript', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a'), featureFactory('feat-b')], [
+            // Mixed: one JS, one TS → still triggers TS path (ts-node handles both)
+            stepDefFactory('feat-a', 'a.js', 'javascript'),
+            stepDefFactory('feat-b', 'b.ts', 'typescript'),
+        ]));
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'support', 'world.ts'))).resolves.toBeUndefined();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, 'support', 'world.js'))).rejects.toThrow();
+        await (0, vitest_1.expect)(fs.access(path.join(tmpdir, '.use-ts'))).resolves.toBeUndefined();
+    });
+    (0, vitest_1.it)('cucumber.cjs require glob matches chosen language extension', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const jsTmp = track(await exec.prepareTmpdir([featureFactory('feat-a')], [stepDefFactory('feat-a', 'steps.js', 'javascript')]));
+        const jsConfig = await fs.readFile(path.join(jsTmp, 'cucumber.cjs'), 'utf8');
+        (0, vitest_1.expect)(jsConfig).toContain("'steps/**/*.js'");
+        (0, vitest_1.expect)(jsConfig).toContain("requireModule: []");
+        const tsTmp = track(await exec.prepareTmpdir([featureFactory('feat-b')], [stepDefFactory('feat-b', 'steps.ts', 'typescript')]));
+        const tsConfig = await fs.readFile(path.join(tsTmp, 'cucumber.cjs'), 'utf8');
+        (0, vitest_1.expect)(tsConfig).toContain("'steps/**/*.ts'");
+        (0, vitest_1.expect)(tsConfig).toContain("requireModule: ['ts-node/register/transpile-only']");
+    });
+    (0, vitest_1.it)('world.ts includes ICustomWorld interface export (matches AI prompt import)', async () => {
+        // The AI prompt at apps/web/.../route.ts emits:
+        //   import { ICustomWorld } from '../support/world'
+        // The generated world.ts must export ICustomWorld for that import to resolve.
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a')], [stepDefFactory('feat-a', 'steps.ts', 'typescript')]));
+        const world = await fs.readFile(path.join(tmpdir, 'support', 'world.ts'), 'utf8');
+        (0, vitest_1.expect)(world).toContain('export interface ICustomWorld');
+        (0, vitest_1.expect)(world).toContain('AfterAll'); // browser close — codex finding #2 regression guard
+    });
+    (0, vitest_1.it)('world.js (JS variant) also registers AfterAll for browser close', async () => {
+        // Regression guard for codex P1 #2: without AfterAll the chromium browser
+        // stays alive, the worker never exits, and the parent hangs.
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a')], [stepDefFactory('feat-a', 'steps.js', 'javascript')]));
+        const world = await fs.readFile(path.join(tmpdir, 'support', 'world.js'), 'utf8');
+        (0, vitest_1.expect)(world).toContain('AfterAll');
+        (0, vitest_1.expect)(world).toContain('browser.close()');
+    });
+    (0, vitest_1.it)('writes step-def content verbatim', async () => {
+        const exec = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+        const customCode = `const { Given } = require('@cucumber/cucumber');\nGiven('a thing', () => {});\n`;
+        const tmpdir = track(await exec.prepareTmpdir([featureFactory('feat-a')], [
+            {
+                featureId: 'feat-a',
+                filename: 'auth.steps.js',
+                content: customCode,
+                language: 'javascript',
+            },
+        ]));
+        const written = await fs.readFile(path.join(tmpdir, 'steps', 'auth.steps.js'), 'utf8');
+        (0, vitest_1.expect)(written).toBe(customCode);
+    });
+});
+//# sourceMappingURL=tmpdir-materialization.test.js.map

package/dist/__tests__/tmpdir-materialization.test.js.map

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

package/dist/agent.d.ts

@@ -0,0 +1,71 @@
+/**
+ * GherkleAgent - Main agent class for connecting to Gherkle and executing tests
+ */
+import { AgentConfig } from './config';
+export declare class GherkleAgent {
+    private config;
+    private ws;
+    private runnerId;
+    private status;
+    private currentRunId;
+    private currentCucumberExecutor;
+    private heartbeatInterval;
+    private reconnectTimeout;
+    private shouldReconnect;
+    constructor(config: AgentConfig);
+    /**
+     * Start the agent and connect to Gherkle
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the agent and disconnect
+     */
+    stop(): Promise<void>;
+    /**
+     * Connect to Gherkle WebSocket server
+     */
+    private connect;
+    /**
+     * Handle incoming messages from Gherkle
+     */
+    private handleMessage;
+    /**
+     * Send a message to Gherkle
+     */
+    private send;
+    /**
+     * Start heartbeat interval
+     */
+    private startHeartbeat;
+    /**
+     * Stop heartbeat interval
+     */
+    private stopHeartbeat;
+    /**
+     * Execute a test run.
+     *
+     * Two paths:
+     *   - stepDefinitions non-empty → CucumberSubprocessExecutor (default).
+     *     The server has already gathered AI-generated step-def code; the
+     *     runner ships it into a forked Cucumber.js process. No local
+     *     dependencies on the runner machine beyond what @gherkle/runner
+     *     itself bundles.
+     *   - stepDefinitions empty AND testConfig.stepDefinitionsPath set →
+     *     legacy PlaywrightExecutor (BYO: user keeps step defs on disk).
+     *   - Otherwise → error the run with a clear message. The server already
+     *     hard-fails dispatch in this case (D9); this is defense in depth.
+     */
+    private executeRun;
+    /**
+     * Cancel an in-progress run. SIGTERMs the Cucumber subprocess (with a 5s
+     * SIGKILL fallback) so the run terminates promptly. The executeRun()
+     * promise then resolves naturally: its 'exit' handler returns the
+     * partial scenarios it had accumulated, and run:completed flows as usual.
+     */
+    private cancelRun;
+    /**
+     * Get the appropriate executor for the framework
+     */
+    private getExecutor;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAgBvC,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,YAAY,CAAuB;IAG3C,OAAO,CAAC,uBAAuB,CAA2C;IAC1E,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,eAAe,CAAQ;gBAEnB,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B;;OAEG;YACW,OAAO;IA4CrB;;OAEG;YACW,aAAa;IA+B3B;;OAEG;IACH,OAAO,CAAC,IAAI;IAMZ;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;;;;;;OAaG;YACW,UAAU;IA6IxB;;;;;OAKG;YACW,SAAS;IASvB;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB"}

package/dist/agent.js

@@ -0,0 +1,312 @@
+"use strict";
+/**
+ * GherkleAgent - Main agent class for connecting to Gherkle and executing tests
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GherkleAgent = void 0;
+const ws_1 = __importDefault(require("ws"));
+const playwright_1 = require("./frameworks/playwright");
+const cucumber_subprocess_1 = require("./frameworks/cucumber-subprocess");
+const HEARTBEAT_INTERVAL = 30000; // 30 seconds
+const RECONNECT_DELAY = 5000; // 5 seconds
+class GherkleAgent {
+    config;
+    ws = null;
+    runnerId = null;
+    status = 'offline';
+    currentRunId = null;
+    // Held only while a cucumber-subprocess run is in flight so a 'cancel'
+    // ServerMessage can kill the child cleanly.
+    currentCucumberExecutor = null;
+    heartbeatInterval = null;
+    reconnectTimeout = null;
+    shouldReconnect = true;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Start the agent and connect to Gherkle
+     */
+    async start() {
+        console.log(`🚀 Starting Gherkle Runner: ${this.config.name}`);
+        console.log(`   Connecting to: ${this.config.apiUrl}`);
+        await this.connect();
+    }
+    /**
+     * Stop the agent and disconnect
+     */
+    async stop() {
+        console.log('🛑 Stopping Gherkle Runner...');
+        this.shouldReconnect = false;
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.status = 'offline';
+    }
+    /**
+     * Connect to Gherkle WebSocket server
+     */
+    async connect() {
+        const wsUrl = this.config.apiUrl
+            .replace('https://', 'wss://')
+            .replace('http://', 'ws://');
+        const url = `${wsUrl}/api/runners/ws`;
+        // Send the runner token in the Authorization header, not the URL query
+        // string — query strings leak into proxy logs, traces, and browser history.
+        this.ws = new ws_1.default(url, {
+            headers: { Authorization: `Bearer ${this.config.token}` },
+        });
+        this.ws.on('open', () => {
+            console.log('✅ Connected to Gherkle');
+            this.status = 'online';
+            this.startHeartbeat();
+        });
+        this.ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleMessage(message);
+            }
+            catch (err) {
+                console.error('Failed to parse message:', err);
+            }
+        });
+        this.ws.on('close', () => {
+            console.log('🔌 Disconnected from Gherkle');
+            this.status = 'offline';
+            this.stopHeartbeat();
+            if (this.shouldReconnect) {
+                console.log(`   Reconnecting in ${RECONNECT_DELAY / 1000}s...`);
+                this.reconnectTimeout = setTimeout(() => this.connect(), RECONNECT_DELAY);
+            }
+        });
+        this.ws.on('error', (err) => {
+            console.error('❌ WebSocket error:', err.message);
+            this.status = 'error';
+        });
+    }
+    /**
+     * Handle incoming messages from Gherkle
+     */
+    async handleMessage(message) {
+        switch (message.type) {
+            case 'connected':
+                this.runnerId = message.runnerId;
+                console.log(`   Runner ID: ${this.runnerId}`);
+                break;
+            case 'ack':
+                // Heartbeat acknowledged
+                break;
+            case 'execute':
+                await this.executeRun(message.runId, message.features, message.stepDefinitions ?? [], message.env ?? {}, message.config);
+                break;
+            case 'cancel':
+                await this.cancelRun(message.runId);
+                break;
+            case 'error':
+                console.error('Server error:', message.message);
+                break;
+        }
+    }
+    /**
+     * Send a message to Gherkle
+     */
+    send(message) {
+        if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * Start heartbeat interval
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            this.send({
+                type: 'heartbeat',
+                status: this.status,
+                currentRun: this.currentRunId || undefined,
+            });
+        }, HEARTBEAT_INTERVAL);
+    }
+    /**
+     * Stop heartbeat interval
+     */
+    stopHeartbeat() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+    }
+    /**
+     * Execute a test run.
+     *
+     * Two paths:
+     *   - stepDefinitions non-empty → CucumberSubprocessExecutor (default).
+     *     The server has already gathered AI-generated step-def code; the
+     *     runner ships it into a forked Cucumber.js process. No local
+     *     dependencies on the runner machine beyond what @gherkle/runner
+     *     itself bundles.
+     *   - stepDefinitions empty AND testConfig.stepDefinitionsPath set →
+     *     legacy PlaywrightExecutor (BYO: user keeps step defs on disk).
+     *   - Otherwise → error the run with a clear message. The server already
+     *     hard-fails dispatch in this case (D9); this is defense in depth.
+     */
+    async executeRun(runId, features, stepDefinitions, env, testConfig) {
+        // Defensive busy-guard. The server-side dispatch is the proper place
+        // to enforce one-run-at-a-time per runner (TODOS P1: per-runner busy
+        // reservation in pollAndDispatch). Until that lands, if a second
+        // 'execute' arrives mid-run, return an error rather than silently
+        // clobbering currentRunId + the in-flight executor handle.
+        if (this.currentRunId !== null) {
+            console.warn(`⚠️  Refusing concurrent run ${runId}: runner is busy with ${this.currentRunId}`);
+            this.send({
+                type: 'error',
+                runId,
+                message: `Runner busy with run ${this.currentRunId}; dispatched without busy-check (TODOS P1).`,
+            });
+            this.send({
+                type: 'run:completed',
+                runId,
+                summary: { total: 0, passed: 0, failed: 0, skipped: 0, durationMs: 0 },
+            });
+            return;
+        }
+        console.log(`\n🧪 Starting test run: ${runId}`);
+        console.log(`   Features: ${features.length}`);
+        console.log(`   Framework: ${testConfig.framework}`);
+        console.log(`   Step-defs: ${stepDefinitions.length} (${stepDefinitions.length > 0 ? 'cucumber-subprocess' : 'BYO playwright'})`);
+        this.status = 'busy';
+        this.currentRunId = runId;
+        this.send({ type: 'run:started', runId });
+        const summary = {
+            total: 0,
+            passed: 0,
+            failed: 0,
+            skipped: 0,
+            durationMs: 0,
+        };
+        const startTime = Date.now();
+        const onScenarioStart = (scenarioId, scenarioName, featureName) => {
+            this.send({
+                type: 'scenario:started',
+                runId,
+                scenarioId,
+                scenarioName,
+                featureName,
+            });
+        };
+        const onStepComplete = (scenarioId, step) => {
+            this.send({ type: 'step:completed', runId, scenarioId, step });
+        };
+        const onScenarioComplete = (scenarioId, status, durationMs, error) => {
+            summary.total++;
+            if (status === 'passed')
+                summary.passed++;
+            else if (status === 'failed')
+                summary.failed++;
+            else if (status === 'skipped')
+                summary.skipped++;
+            this.send({ type: 'scenario:completed', runId, scenarioId, status, durationMs, error });
+        };
+        try {
+            if (stepDefinitions.length > 0) {
+                const executor = new cucumber_subprocess_1.CucumberSubprocessExecutor();
+                this.currentCucumberExecutor = executor;
+                const results = await executor.executeAll(features, stepDefinitions, env, {
+                    onScenarioStart,
+                    onStepComplete,
+                    onScenarioComplete,
+                });
+                this.currentCucumberExecutor = null;
+                for (const result of results) {
+                    if (result.artifacts) {
+                        for (const artifact of result.artifacts) {
+                            this.send({ type: 'artifact:upload', runId, scenarioId: result.scenarioId, artifact });
+                        }
+                    }
+                }
+            }
+            else if (testConfig.stepDefinitionsPath) {
+                // BYO fallback: user has step-def code on the runner's local disk.
+                const executor = this.getExecutor(testConfig.framework);
+                for (const feature of features) {
+                    const results = await executor.execute(feature, testConfig, {
+                        onScenarioStart: (scenarioId, scenarioName) => onScenarioStart(scenarioId, scenarioName, feature.name),
+                        onStepComplete,
+                        onScenarioComplete,
+                    });
+                    for (const result of results) {
+                        if (result.artifacts) {
+                            for (const artifact of result.artifacts) {
+                                this.send({ type: 'artifact:upload', runId, scenarioId: result.scenarioId, artifact });
+                            }
+                        }
+                    }
+                }
+            }
+            else {
+                throw new Error('No step definitions: run carried no generated step-defs and no local stepDefinitionsPath is configured.');
+            }
+            summary.durationMs = Date.now() - startTime;
+            console.log(`\n✅ Test run complete: ${runId}`);
+            console.log(`   Passed: ${summary.passed}/${summary.total}`);
+            console.log(`   Duration: ${summary.durationMs}ms`);
+        }
+        catch (err) {
+            const error = err;
+            console.error(`\n❌ Test run failed: ${runId}`, error.message);
+            this.send({
+                type: 'error',
+                runId,
+                message: error.message,
+            });
+            summary.durationMs = Date.now() - startTime;
+        }
+        finally {
+            this.currentCucumberExecutor = null;
+        }
+        this.send({ type: 'run:completed', runId, summary });
+        this.status = 'online';
+        this.currentRunId = null;
+    }
+    /**
+     * Cancel an in-progress run. SIGTERMs the Cucumber subprocess (with a 5s
+     * SIGKILL fallback) so the run terminates promptly. The executeRun()
+     * promise then resolves naturally: its 'exit' handler returns the
+     * partial scenarios it had accumulated, and run:completed flows as usual.
+     */
+    async cancelRun(runId) {
+        if (this.currentRunId !== runId)
+            return;
+        console.log(`🚫 Canceling run: ${runId}`);
+        if (this.currentCucumberExecutor) {
+            this.currentCucumberExecutor.cancel();
+        }
+        // Status/currentRunId reset in executeRun's finally block.
+    }
+    /**
+     * Get the appropriate executor for the framework
+     */
+    getExecutor(framework) {
+        switch (framework) {
+            case 'playwright':
+                return new playwright_1.PlaywrightExecutor(this.config);
+            // TODO: Add Cypress, Cucumber executors
+            default:
+                throw new Error(`Unsupported framework: ${framework}`);
+        }
+    }
+}
+exports.GherkleAgent = GherkleAgent;
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Configuration loading and validation for @gherkle/runner
+ */
+import { Framework } from './types';
+export interface AgentConfig {
+    token: string;
+    apiUrl: string;
+    name: string;
+    labels: string[];
+    framework: Framework;
+    featuresPath: string;
+    stepDefinitionsPath: string;
+    supportPath: string;
+    browsers: string[];
+    headless: boolean;
+    testTimeout: number;
+    stepTimeout: number;
+    screenshots: 'always' | 'on-failure' | 'never';
+    video: 'always' | 'on-failure' | 'never';
+    baseUrl?: string;
+    env: Record<string, string>;
+}
+/**
+ * Load configuration from file and environment
+ */
+export declare function loadConfig(cliOptions?: Partial<AgentConfig>): AgentConfig;
+/**
+ * Generate a sample config file
+ */
+export declare function generateSampleConfig(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,WAAW;IAE1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAGf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IAGjB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IAGpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAGlB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IAGpB,WAAW,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IAC/C,KAAK,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IAGzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AA2BD;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CA4D7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAqC7C"}