devharness 0.8.0

package/build/port-reserver.js

@@ -0,0 +1,118 @@
+/**
+ * Port Reserver
+ * Holds a port by binding a TCP socket to prevent other programs from using it
+ */
+import { createServer } from 'net';
+import { debugLog } from './debug-logger.js';
+export class PortReserver {
+    server = null;
+    port = null;
+    isReserving = false;
+    connections = new Set();
+    /**
+     * Reserve a port by binding a TCP socket to it
+     */
+    async reserve(port) {
+        // If already reserving this port, do nothing
+        if (this.port === port && this.server) {
+            await debugLog('PortReserver', `Port ${port} already reserved`);
+            return;
+        }
+        // Release any existing reservation
+        if (this.server) {
+            await this.release();
+        }
+        return new Promise((resolve, reject) => {
+            this.isReserving = true;
+            this.server = createServer();
+            // Handle incoming connections - respond immediately to indicate port is reserved
+            this.server.on('connection', (socket) => {
+                debugLog('PortReserver', `Received connection on port ${port}, responding with 'chrome-not-running'`);
+                // Track this connection
+                this.connections.add(socket);
+                // Remove from tracking when closed
+                socket.on('close', () => {
+                    this.connections.delete(socket);
+                });
+                // Send a clear signal that this port is reserved and Chrome is not running
+                socket.write('chrome-not-running\r\n');
+                socket.end();
+            });
+            this.server.on('error', (err) => {
+                this.isReserving = false;
+                if (err.code === 'EADDRINUSE') {
+                    reject(new Error(`Port ${port} is already in use`));
+                }
+                else {
+                    reject(new Error(`Failed to reserve port ${port}: ${err.message}`));
+                }
+            });
+            // Bind to IPv4 localhost to match Chrome's behavior
+            this.server.listen(port, '127.0.0.1', () => {
+                this.port = port;
+                this.isReserving = false;
+                debugLog('PortReserver', `Successfully reserved port ${port}`);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Release the reserved port
+     */
+    async release() {
+        if (!this.server) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const portToRelease = this.port;
+            // Destroy all active connections first to ensure server.close() completes quickly
+            debugLog('PortReserver', `Closing ${this.connections.size} active connections before release`);
+            for (const socket of this.connections) {
+                socket.destroy();
+            }
+            this.connections.clear();
+            // Add timeout as safety net in case close still hangs
+            const timeout = setTimeout(() => {
+                debugLog('PortReserver', `WARNING: Release timeout for port ${portToRelease}, forcing cleanup`);
+                this.server = null;
+                this.port = null;
+                resolve();
+            }, 2000);
+            this.server.close((err) => {
+                clearTimeout(timeout);
+                if (err) {
+                    debugLog('PortReserver', `Error releasing port ${portToRelease}: ${err}`);
+                    // Still clean up state even on error
+                    this.server = null;
+                    this.port = null;
+                    resolve(); // Don't reject - we want to continue
+                }
+                else {
+                    debugLog('PortReserver', `Released port ${portToRelease}`);
+                    this.server = null;
+                    this.port = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Check if a port is currently reserved
+     */
+    isReserved() {
+        return this.server !== null && this.port !== null;
+    }
+    /**
+     * Get the currently reserved port
+     */
+    getPort() {
+        return this.port;
+    }
+    /**
+     * Get the server instance (for testing)
+     */
+    getServer() {
+        return this.server;
+    }
+}
+//# sourceMappingURL=port-reserver.js.map

package/build/port-reserver.js.map

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

package/build/puppeteer-manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Puppeteer Manager
+ * Manages Puppeteer connection to Chrome for browser automation
+ */
+import { Browser, Page } from 'puppeteer-core';
+export declare class PuppeteerManager {
+    private browser;
+    private page;
+    private debugPort;
+    /**
+     * Connect to an existing Chrome instance
+     */
+    connect(host?: string, port?: number): Promise<void>;
+    /**
+     * Disconnect from the browser
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the current page
+     */
+    getPage(): Page;
+    /**
+     * Get the browser instance
+     */
+    getBrowser(): Browser;
+    /**
+     * Get all pages
+     */
+    getPages(): Promise<Page[]>;
+    /**
+     * Create a new page
+     */
+    newPage(): Promise<Page>;
+    /**
+     * Set the current page by index
+     */
+    setPage(index: number): Promise<void>;
+    /**
+     * Close a page by index
+     */
+    closePage(index: number): Promise<void>;
+}
+//# sourceMappingURL=puppeteer-manager.d.ts.map

package/build/puppeteer-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-manager.d.ts","sourceRoot":"","sources":["../src/puppeteer-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAgB;IAEjC;;OAEG;IACG,OAAO,CAAC,IAAI,GAAE,MAAoB,EAAE,IAAI,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,UAAU,IAAI,OAAO;IAOrB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAOjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAc9C"}

package/build/puppeteer-manager.js

@@ -0,0 +1,116 @@
+/**
+ * Puppeteer Manager
+ * Manages Puppeteer connection to Chrome for browser automation
+ */
+import puppeteer from 'puppeteer-core';
+export class PuppeteerManager {
+    browser = null;
+    page = null;
+    debugPort = 9222;
+    /**
+     * Connect to an existing Chrome instance
+     */
+    async connect(host = 'localhost', port = 9222) {
+        try {
+            this.debugPort = port;
+            const browserURL = `http://${host}:${port}`;
+            this.browser = await puppeteer.connect({
+                browserURL,
+                defaultViewport: null,
+            });
+            // Get the first page or create a new one
+            const pages = await this.browser.pages();
+            if (pages.length > 0) {
+                this.page = pages[0];
+            }
+            else {
+                this.page = await this.browser.newPage();
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to Puppeteer: ${error}`);
+        }
+    }
+    /**
+     * Disconnect from the browser
+     */
+    async disconnect() {
+        if (this.browser) {
+            await this.browser.disconnect();
+            this.browser = null;
+            this.page = null;
+        }
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.browser !== null && this.browser.connected;
+    }
+    /**
+     * Get the current page
+     */
+    getPage() {
+        if (!this.page) {
+            throw new Error('Not connected to a page');
+        }
+        return this.page;
+    }
+    /**
+     * Get the browser instance
+     */
+    getBrowser() {
+        if (!this.browser) {
+            throw new Error('Not connected to browser');
+        }
+        return this.browser;
+    }
+    /**
+     * Get all pages
+     */
+    async getPages() {
+        if (!this.browser) {
+            throw new Error('Not connected to browser');
+        }
+        return await this.browser.pages();
+    }
+    /**
+     * Create a new page
+     */
+    async newPage() {
+        if (!this.browser) {
+            throw new Error('Not connected to browser');
+        }
+        const newPage = await this.browser.newPage();
+        this.page = newPage;
+        return newPage;
+    }
+    /**
+     * Set the current page by index
+     */
+    async setPage(index) {
+        const pages = await this.getPages();
+        if (index < 0 || index >= pages.length) {
+            throw new Error(`Page index ${index} out of range (0-${pages.length - 1})`);
+        }
+        this.page = pages[index];
+    }
+    /**
+     * Close a page by index
+     */
+    async closePage(index) {
+        const pages = await this.getPages();
+        if (index < 0 || index >= pages.length) {
+            throw new Error(`Page index ${index} out of range (0-${pages.length - 1})`);
+        }
+        if (pages.length === 1) {
+            throw new Error('Cannot close the last page');
+        }
+        await pages[index].close();
+        // Switch to first available page
+        if (this.page === pages[index]) {
+            this.page = pages[0] === pages[index] ? pages[1] : pages[0];
+        }
+    }
+}
+//# sourceMappingURL=puppeteer-manager.js.map

package/build/puppeteer-manager.js.map

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

package/build/recording-coverage.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Selector coverage in a recording's summary.
+ *
+ * Counting events tells you how much was recorded; coverage tells you whether
+ * the recording will still work after a re-render. A click captured as a
+ * selector survives layout changes; one captured as bare coordinates does not,
+ * and fails in the least obvious way - it clicks whatever now sits at that
+ * position. These assertions pin the classification, not merely that the
+ * fields exist.
+ */
+export {};
+//# sourceMappingURL=recording-coverage.test.d.ts.map

package/build/recording-coverage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-coverage.test.d.ts","sourceRoot":"","sources":["../src/recording-coverage.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/build/recording-coverage.test.js

@@ -0,0 +1,72 @@
+/**
+ * Selector coverage in a recording's summary.
+ *
+ * Counting events tells you how much was recorded; coverage tells you whether
+ * the recording will still work after a re-render. A click captured as a
+ * selector survives layout changes; one captured as bare coordinates does not,
+ * and fails in the least obvious way - it clicks whatever now sits at that
+ * position. These assertions pin the classification, not merely that the
+ * fields exist.
+ */
+import { describe, it, expect } from 'vitest';
+import { calculateSummary } from './interaction-recorder.js';
+const click = (elementInfo) => ({
+    type: 'click', x: 10, y: 20, timestamp: 0, elementInfo,
+});
+const key = (k) => ({
+    type: 'keydown', key: k, code: k, timestamp: 0,
+});
+describe('recording summary - selector coverage', () => {
+    it('counts a click with a selector as covered, and as interactive only when the element is', () => {
+        const summary = calculateSummary([
+            click({ selector: '#submit', isInteractive: true, tag: 'button' }),
+            click({ selector: '.card', isInteractive: false, tag: 'div' }),
+        ]);
+        expect(summary.clicks).toBe(2);
+        expect(summary.selectorsAvailable).toBe(2);
+        expect(summary.interactiveElements).toBe(1);
+        expect(summary.coordinatesOnly).toBe(0);
+    });
+    it('counts a click with no selector as coordinates-only - the brittle case', () => {
+        const summary = calculateSummary([
+            click({ tag: 'div' }),
+            click(undefined),
+        ]);
+        expect(summary.coordinatesOnly).toBe(2);
+        expect(summary.selectorsAvailable).toBe(0);
+        expect(summary.canvasInteractions).toBe(0);
+    });
+    it('counts a canvas click as both canvas and coordinates-only', () => {
+        // Canvas is coordinate-fragile by necessity rather than by failure to find
+        // a selector, so it belongs in both counts: the caller needs to know the
+        // click is position-dependent, and also that this one is expected to be.
+        const summary = calculateSummary([click({ isCanvas: true, tag: 'canvas' })]);
+        expect(summary.canvasInteractions).toBe(1);
+        expect(summary.coordinatesOnly).toBe(1);
+        expect(summary.selectorsAvailable).toBe(0);
+    });
+    it('separates typed characters from navigation and modifier keys', () => {
+        const summary = calculateSummary([
+            key('a'), key('b'), key('Enter'), key('Shift'), key('ArrowDown'),
+        ]);
+        expect(summary.keyPresses).toBe(5);
+        expect(summary.typedCharacters).toBe(2);
+    });
+    it('reports full coverage for a wholly selector-based recording', () => {
+        const summary = calculateSummary([
+            click({ selector: '#a', isInteractive: true }),
+            click({ selector: '#b', isInteractive: true }),
+        ]);
+        // coordinatesOnly === 0 is what suppresses the warning in the tool
+        // response, so this is the case that must NOT produce one.
+        expect(summary.coordinatesOnly).toBe(0);
+        expect(summary.selectorsAvailable).toBe(summary.clicks);
+    });
+    it('leaves coverage at zero for a recording with no clicks', () => {
+        const summary = calculateSummary([key('a')]);
+        expect(summary.clicks).toBe(0);
+        expect(summary.selectorsAvailable).toBe(0);
+        expect(summary.coordinatesOnly).toBe(0);
+    });
+});
+//# sourceMappingURL=recording-coverage.test.js.map

package/build/recording-coverage.test.js.map

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

package/build/reference-validator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Reference validation utilities
+ */
+export declare const UNNAMED_CONNECTION = "unnamed-connection-default";
+export declare const RESERVED_REFERENCES: string[];
+/**
+ * Sanitize a reference string to a consistent format
+ * Converts "Test Payment Flow" -> "test-payment-flow"
+ */
+export declare function sanitizeReference(ref: string): string;
+/**
+ * Derive a valid 3-word connection reference from an arbitrary name (e.g. a
+ * sequence filename), which has no guaranteed word count. Deterministic per
+ * input name, so repeated runs of the same sequence reuse the same reference.
+ */
+export declare function deriveConnectionReference(name: string): string;
+/**
+ * Validate a reference string (legacy API)
+ * Returns the sanitized reference if valid, or an error if invalid
+ *
+ * Accepts both formats:
+ * - "test replay feature" (3 space-separated words)
+ * - "test-replay-feature" (already sanitized, 3 hyphen-separated parts)
+ */
+export declare function validateReference(ref: string): {
+    valid: boolean;
+    sanitized?: string;
+    error?: string;
+};
+/**
+ * Error class for invalid references - contains the MCP error response
+ */
+export declare class InvalidReferenceError extends Error {
+    readonly response: {
+        content: {
+            type: string;
+            text: string;
+        }[];
+    };
+    constructor(error: string);
+}
+/**
+ * Validate and return sanitized reference, or throw InvalidReferenceError
+ * Use this in tool handlers - throws if invalid, returns sanitized string if valid
+ */
+export declare function requireValidReference(ref: string): string;
+//# sourceMappingURL=reference-validator.d.ts.map

package/build/reference-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-validator.d.ts","sourceRoot":"","sources":["../src/reference-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAC/D,eAAO,MAAM,mBAAmB,UAK/B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA4BrG;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,QAAQ,EAAE;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;gBAE5D,KAAK,EAAE,MAAM;CAK1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/build/reference-validator.js

@@ -0,0 +1,86 @@
+/**
+ * Reference validation utilities
+ */
+import { createErrorResponse } from './messages.js';
+// Constants
+export const UNNAMED_CONNECTION = 'unnamed-connection-default';
+export const RESERVED_REFERENCES = [
+    UNNAMED_CONNECTION,
+    'no-reference-set',
+    'unknown-connection-type',
+    'none-none-none',
+];
+/**
+ * Sanitize a reference string to a consistent format
+ * Converts "Test Payment Flow" -> "test-payment-flow"
+ */
+export function sanitizeReference(ref) {
+    return ref.toLowerCase().trim().replace(/\s+/g, '-');
+}
+/**
+ * Derive a valid 3-word connection reference from an arbitrary name (e.g. a
+ * sequence filename), which has no guaranteed word count. Deterministic per
+ * input name, so repeated runs of the same sequence reuse the same reference.
+ */
+export function deriveConnectionReference(name) {
+    const parts = sanitizeReference(name).split('-').filter(Boolean);
+    if (parts.length === 3)
+        return parts.join('-');
+    if (parts.length > 3)
+        return `${parts[0]}-${parts[1]}-run`;
+    return [...parts, 'seq', 'run'].slice(0, 3).join('-');
+}
+/**
+ * Validate a reference string (legacy API)
+ * Returns the sanitized reference if valid, or an error if invalid
+ *
+ * Accepts both formats:
+ * - "test replay feature" (3 space-separated words)
+ * - "test-replay-feature" (already sanitized, 3 hyphen-separated parts)
+ */
+export function validateReference(ref) {
+    const trimmed = ref.trim();
+    if (!trimmed) {
+        return { valid: false, error: 'Reference cannot be empty' };
+    }
+    // First, sanitize the reference
+    const sanitized = sanitizeReference(ref);
+    // Check for reserved words on sanitized version
+    if (RESERVED_REFERENCES.includes(sanitized)) {
+        return { valid: false, error: `Reference "${trimmed}" is reserved and cannot be used` };
+    }
+    // Verify sanitized version has exactly 3 parts
+    // This works for both "test replay feature" and "test-replay-feature"
+    const sanitizedParts = sanitized.split('-');
+    if (sanitizedParts.length !== 3) {
+        return { valid: false, error: `Reference must be exactly 3 words, got ${sanitizedParts.length}` };
+    }
+    // Verify each part is non-empty (catches cases like "test--feature" or "test- -feature")
+    if (sanitizedParts.some(part => !part)) {
+        return { valid: false, error: `Invalid reference format: contains empty parts` };
+    }
+    return { valid: true, sanitized };
+}
+/**
+ * Error class for invalid references - contains the MCP error response
+ */
+export class InvalidReferenceError extends Error {
+    response;
+    constructor(error) {
+        super(error);
+        this.name = 'InvalidReferenceError';
+        this.response = createErrorResponse('INVALID_REFERENCE', { error });
+    }
+}
+/**
+ * Validate and return sanitized reference, or throw InvalidReferenceError
+ * Use this in tool handlers - throws if invalid, returns sanitized string if valid
+ */
+export function requireValidReference(ref) {
+    const result = validateReference(ref);
+    if (!result.valid) {
+        throw new InvalidReferenceError(result.error);
+    }
+    return result.sanitized;
+}
+//# sourceMappingURL=reference-validator.js.map

package/build/reference-validator.js.map

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

package/build/reference-validator.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for reference validation
+ */
+export {};
+//# sourceMappingURL=reference-validator.test.d.ts.map

package/build/reference-validator.test.d.ts.map

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