@yasserkhanorg/impact-gate 2.0.0

package/dist/adapters/cypress.d.ts

@@ -0,0 +1,10 @@
+import type { FrameworkAdapter, RunCommand, RunOptions } from './framework_adapter.js';
+export declare class CypressAdapter implements FrameworkAdapter {
+    readonly name = "cypress";
+    readonly specGlob = "**/*.cy.{ts,js,tsx,jsx}";
+    readonly extractTestPattern: RegExp;
+    readonly configFileNames: string[];
+    detect(projectRoot: string): boolean;
+    buildRunCommand(specPath: string, options?: RunOptions): RunCommand;
+}
+//# sourceMappingURL=cypress.d.ts.map

package/dist/adapters/cypress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypress.d.ts","sourceRoot":"","sources":["../../src/adapters/cypress.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAErF,qBAAa,cAAe,YAAW,gBAAgB;IACnD,QAAQ,CAAC,IAAI,aAAa;IAE1B,QAAQ,CAAC,QAAQ,6BAA6B;IAE9C,QAAQ,CAAC,kBAAkB,SAAqC;IAEhE,QAAQ,CAAC,eAAe,WAA8C;IAEtE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAwBpC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU;CAqBtE"}

package/dist/adapters/cypress.js

@@ -0,0 +1,86 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+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.CypressAdapter = void 0;
+/**
+ * Cypress Adapter — FrameworkAdapter implementation for Cypress.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class CypressAdapter {
+    constructor() {
+        this.name = 'cypress';
+        this.specGlob = '**/*.cy.{ts,js,tsx,jsx}';
+        this.extractTestPattern = /\b(?:it|describe|context)\s*\(/g;
+        this.configFileNames = ['cypress.config.ts', 'cypress.config.js'];
+    }
+    detect(projectRoot) {
+        const pkgPath = path.join(projectRoot, 'package.json');
+        if (!fs.existsSync(pkgPath)) {
+            return false;
+        }
+        try {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            const allDeps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+            };
+            return 'cypress' in allDeps;
+        }
+        catch {
+            return false;
+        }
+    }
+    buildRunCommand(specPath, options) {
+        const args = ['cypress', 'run', '--spec', specPath];
+        if (options?.headed) {
+            args.push('--headed');
+        }
+        if (options?.browser) {
+            args.push('--browser', options.browser);
+        }
+        if (options?.project) {
+            args.push('--project', options.project);
+        }
+        if (options?.timeout != null) {
+            args.push('--config', `defaultCommandTimeout=${options.timeout}`);
+        }
+        return { executable: 'npx', args };
+    }
+}
+exports.CypressAdapter = CypressAdapter;

package/dist/adapters/framework_adapter.d.ts

@@ -0,0 +1,41 @@
+import type { KnowledgeGraph } from '../knowledge/kg_types.js';
+import type { TestType } from '../knowledge/route_families.js';
+/** Shared framework name lists used for test-mode detection across the codebase. */
+export declare const UI_FRAMEWORKS: readonly ["playwright", "@playwright/test", "cypress", "selenium"];
+export declare const API_FRAMEWORKS: readonly ["supertest", "pytest", "requests", "vitest", "jest"];
+export interface RunOptions {
+    headed?: boolean;
+    browser?: string;
+    project?: string;
+    timeout?: number;
+}
+export interface RunCommand {
+    executable: string;
+    args: string[];
+}
+export interface FrameworkAdapter {
+    /** Human-readable framework identifier (e.g. 'playwright', 'cypress'). */
+    name: string;
+    /** Return true when `projectRoot` appears to use this framework. */
+    detect(projectRoot: string): boolean;
+    /** Glob that matches spec files for this framework. */
+    specGlob: string;
+    /** Regex that extracts test blocks from source text. */
+    extractTestPattern: RegExp;
+    /** Possible config file names to look for at the project root. */
+    configFileNames: string[];
+    /** Build a structured command to execute a single spec file. */
+    buildRunCommand(specPath: string, options?: RunOptions): RunCommand;
+}
+/**
+ * Auto-detect which test framework a project uses by inspecting its
+ * package.json dependencies.  Falls back to Playwright when detection
+ * is inconclusive.
+ */
+export declare function detectFramework(projectRoot: string): FrameworkAdapter;
+/**
+ * Detect the test mode for a project: UI testing, API testing, or both.
+ * Uses package.json / pyproject.toml dependencies and optional KG metadata.
+ */
+export declare function detectTestMode(projectRoot: string, kg?: KnowledgeGraph | null): TestType;
+//# sourceMappingURL=framework_adapter.d.ts.map

package/dist/adapters/framework_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework_adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/framework_adapter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,gCAAgC,CAAC;AAE7D,oFAAoF;AACpF,eAAO,MAAM,aAAa,oEAAqE,CAAC;AAChG,eAAO,MAAM,cAAc,gEAAiE,CAAC;AAE7F,MAAM,WAAW,UAAU;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IAEb,oEAAoE;IACpE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAErC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAE3B,kEAAkE;IAClE,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,gEAAgE;IAChE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CACvE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAiDrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,GAAG,QAAQ,CAgDxF"}

package/dist/adapters/framework_adapter.js

@@ -0,0 +1,152 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+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.API_FRAMEWORKS = exports.UI_FRAMEWORKS = void 0;
+exports.detectFramework = detectFramework;
+exports.detectTestMode = detectTestMode;
+/**
+ * Framework Adapter Interface — abstracts test-framework-specific logic
+ * behind a uniform contract so the rest of the pipeline is framework-agnostic.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const playwright_js_1 = require("./playwright.js");
+const cypress_js_1 = require("./cypress.js");
+const supertest_js_1 = require("./supertest.js");
+const pytest_js_1 = require("./pytest.js");
+/** Shared framework name lists used for test-mode detection across the codebase. */
+exports.UI_FRAMEWORKS = ['playwright', '@playwright/test', 'cypress', 'selenium'];
+exports.API_FRAMEWORKS = ['supertest', 'pytest', 'requests', 'vitest', 'jest'];
+/**
+ * Auto-detect which test framework a project uses by inspecting its
+ * package.json dependencies.  Falls back to Playwright when detection
+ * is inconclusive.
+ */
+function detectFramework(projectRoot) {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            const allDeps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+            };
+            if ('@playwright/test' in allDeps) {
+                return new playwright_js_1.PlaywrightAdapter();
+            }
+            if ('cypress' in allDeps) {
+                return new cypress_js_1.CypressAdapter();
+            }
+            // Backend API test frameworks
+            if ('supertest' in allDeps) {
+                const runner = 'vitest' in allDeps ? 'vitest' : 'jest';
+                return new supertest_js_1.SupertestAdapter(runner);
+            }
+        }
+        catch {
+            // Malformed package.json — fall through to default.
+        }
+    }
+    // Check for Python project
+    const pyprojectPath = path.join(projectRoot, 'pyproject.toml');
+    if (fs.existsSync(pyprojectPath)) {
+        try {
+            const content = fs.readFileSync(pyprojectPath, 'utf-8');
+            if (content.includes('pytest')) {
+                return new pytest_js_1.PytestAdapter();
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    // Default to Playwright when we cannot determine the framework.
+    return new playwright_js_1.PlaywrightAdapter();
+}
+/**
+ * Detect the test mode for a project: UI testing, API testing, or both.
+ * Uses package.json / pyproject.toml dependencies and optional KG metadata.
+ */
+function detectTestMode(projectRoot, kg) {
+    // If KG provides framework hints, use them
+    if (kg) {
+        const frameworks = kg.project.frameworks.map((f) => f.toLowerCase());
+        const uiSet = new Set(exports.UI_FRAMEWORKS);
+        const apiSet = new Set(exports.API_FRAMEWORKS);
+        const hasUi = frameworks.some((f) => uiSet.has(f));
+        const hasApi = frameworks.some((f) => apiSet.has(f));
+        if (hasUi && hasApi)
+            return 'both';
+        if (hasApi)
+            return 'api';
+        if (hasUi)
+            return 'ui';
+    }
+    // Fall back to package.json inspection
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            const hasUi = '@playwright/test' in allDeps || 'cypress' in allDeps;
+            const hasApi = 'supertest' in allDeps;
+            if (hasUi && hasApi)
+                return 'both';
+            if (hasApi)
+                return 'api'; // supertest alone means API-only when no UI framework is present
+        }
+        catch {
+            // fall through
+        }
+    }
+    // Check for Python API testing
+    const pyprojectPath = path.join(projectRoot, 'pyproject.toml');
+    if (fs.existsSync(pyprojectPath)) {
+        try {
+            const content = fs.readFileSync(pyprojectPath, 'utf-8');
+            if (content.includes('pytest') && !fs.existsSync(path.join(projectRoot, 'package.json'))) {
+                return 'api';
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    return 'ui';
+}

package/dist/adapters/playwright.d.ts

@@ -0,0 +1,10 @@
+import type { FrameworkAdapter, RunCommand, RunOptions } from './framework_adapter.js';
+export declare class PlaywrightAdapter implements FrameworkAdapter {
+    readonly name = "playwright";
+    readonly specGlob = "**/*.spec.{ts,js}";
+    readonly extractTestPattern: RegExp;
+    readonly configFileNames: string[];
+    detect(projectRoot: string): boolean;
+    buildRunCommand(specPath: string, options?: RunOptions): RunCommand;
+}
+//# sourceMappingURL=playwright.d.ts.map

package/dist/adapters/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/adapters/playwright.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAErF,qBAAa,iBAAkB,YAAW,gBAAgB;IACtD,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,QAAQ,CAAC,QAAQ,uBAAuB;IAExC,QAAQ,CAAC,kBAAkB,SAAiC;IAE5D,QAAQ,CAAC,eAAe,WAAoD;IAE5E,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAwBpC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU;CAqBtE"}

package/dist/adapters/playwright.js

@@ -0,0 +1,86 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+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.PlaywrightAdapter = void 0;
+/**
+ * Playwright Adapter — FrameworkAdapter implementation for @playwright/test.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class PlaywrightAdapter {
+    constructor() {
+        this.name = 'playwright';
+        this.specGlob = '**/*.spec.{ts,js}';
+        this.extractTestPattern = /\btest(?:\.describe)?\s*\(/g;
+        this.configFileNames = ['playwright.config.ts', 'playwright.config.js'];
+    }
+    detect(projectRoot) {
+        const pkgPath = path.join(projectRoot, 'package.json');
+        if (!fs.existsSync(pkgPath)) {
+            return false;
+        }
+        try {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            const allDeps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+            };
+            return '@playwright/test' in allDeps;
+        }
+        catch {
+            return false;
+        }
+    }
+    buildRunCommand(specPath, options) {
+        const args = ['playwright', 'test', specPath];
+        if (options?.headed) {
+            args.push('--headed');
+        }
+        if (options?.browser) {
+            args.push('--browser', options.browser);
+        }
+        if (options?.project) {
+            args.push('--project', options.project);
+        }
+        if (options?.timeout != null) {
+            args.push('--timeout', String(options.timeout));
+        }
+        return { executable: 'npx', args };
+    }
+}
+exports.PlaywrightAdapter = PlaywrightAdapter;

package/dist/adapters/pytest.d.ts

@@ -0,0 +1,10 @@
+import type { FrameworkAdapter, RunCommand, RunOptions } from './framework_adapter.js';
+export declare class PytestAdapter implements FrameworkAdapter {
+    name: string;
+    specGlob: string;
+    extractTestPattern: RegExp;
+    configFileNames: string[];
+    detect(projectRoot: string): boolean;
+    buildRunCommand(specPath: string, options?: RunOptions): RunCommand;
+}
+//# sourceMappingURL=pytest.d.ts.map

package/dist/adapters/pytest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pytest.d.ts","sourceRoot":"","sources":["../../src/adapters/pytest.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAErF,qBAAa,aAAc,YAAW,gBAAgB;IAClD,IAAI,SAAY;IAChB,QAAQ,SAAkB;IAC1B,kBAAkB,SAAuB;IACzC,eAAe,WAAgE;IAE/E,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAkCpC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU;CAOtE"}

package/dist/adapters/pytest.js

@@ -0,0 +1,96 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+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.PytestAdapter = void 0;
+/**
+ * Pytest adapter for Python API testing.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class PytestAdapter {
+    constructor() {
+        this.name = 'pytest';
+        this.specGlob = '**/test_*.py';
+        this.extractTestPattern = /def\s+(test_\w+)/g;
+        this.configFileNames = ['pytest.ini', 'pyproject.toml', 'setup.cfg', 'conftest.py'];
+    }
+    detect(projectRoot) {
+        // Check for common pytest indicator files
+        const indicators = ['pyproject.toml', 'pytest.ini', 'conftest.py', 'setup.cfg'];
+        for (const file of indicators) {
+            const filePath = path.join(projectRoot, file);
+            if (!fs.existsSync(filePath))
+                continue;
+            // For setup.cfg, only match if it contains a [tool:pytest] or [pytest] section
+            if (file === 'setup.cfg') {
+                try {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    if (content.includes('[tool:pytest]') || content.includes('[pytest]')) {
+                        return true;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            else if (file === 'pyproject.toml') {
+                try {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    if (content.includes('pytest')) {
+                        return true;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            else {
+                // pytest.ini or conftest.py existence is sufficient
+                return true;
+            }
+        }
+        return false;
+    }
+    buildRunCommand(specPath, options) {
+        const args = ['-m', 'pytest', specPath, '-v'];
+        if (options?.timeout) {
+            args.push(`--timeout=${Math.ceil(options.timeout / 1000)}`);
+        }
+        return { executable: 'python', args };
+    }
+}
+exports.PytestAdapter = PytestAdapter;

package/dist/adapters/supertest.d.ts

@@ -0,0 +1,12 @@
+import type { FrameworkAdapter, RunCommand, RunOptions } from './framework_adapter.js';
+export declare class SupertestAdapter implements FrameworkAdapter {
+    name: string;
+    specGlob: string;
+    extractTestPattern: RegExp;
+    configFileNames: string[];
+    private runner;
+    constructor(runner?: 'vitest' | 'jest');
+    detect(projectRoot: string): boolean;
+    buildRunCommand(specPath: string, options?: RunOptions): RunCommand;
+}
+//# sourceMappingURL=supertest.d.ts.map

package/dist/adapters/supertest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supertest.d.ts","sourceRoot":"","sources":["../../src/adapters/supertest.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAErF,qBAAa,gBAAiB,YAAW,gBAAgB;IACrD,IAAI,SAAe;IACnB,QAAQ,SAA8B;IACtC,kBAAkB,SAAwC;IAC1D,eAAe,WAAgF;IAE/F,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,GAAE,QAAQ,GAAG,MAAiB;IAIhD,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAwBpC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU;CAetE"}

package/dist/adapters/supertest.js

@@ -0,0 +1,85 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+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.SupertestAdapter = void 0;
+/**
+ * Supertest + Vitest/Jest adapter for Node.js API testing.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class SupertestAdapter {
+    constructor(runner = 'vitest') {
+        this.name = 'supertest';
+        this.specGlob = '**/*.{test,spec}.{ts,js}';
+        this.extractTestPattern = /(?:it|test)\s*\(\s*(['"`])(.*?)\1/g;
+        this.configFileNames = ['vitest.config.ts', 'vitest.config.js', 'jest.config.ts', 'jest.config.js'];
+        this.runner = runner;
+    }
+    detect(projectRoot) {
+        const pkgPath = path.join(projectRoot, 'package.json');
+        if (!fs.existsSync(pkgPath)) {
+            return false;
+        }
+        try {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            const allDeps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+            };
+            return 'supertest' in allDeps;
+        }
+        catch {
+            return false;
+        }
+    }
+    buildRunCommand(specPath, options) {
+        if (this.runner === 'jest') {
+            const args = ['jest', specPath];
+            if (options?.timeout) {
+                args.push(`--testTimeout=${options.timeout}`);
+            }
+            return { executable: 'npx', args };
+        }
+        const args = ['vitest', 'run', specPath];
+        if (options?.timeout) {
+            args.push(`--testTimeout=${options.timeout}`);
+        }
+        return { executable: 'npx', args };
+    }
+}
+exports.SupertestAdapter = SupertestAdapter;

package/dist/agent/api_catalog.d.ts

@@ -0,0 +1,11 @@
+import type { ApiSurfaceCatalog, InitSetupBinding } from './pipeline_types.js';
+export declare function createDefaultApiSurfaceCatalog(): ApiSurfaceCatalog;
+export declare function collectMatches(content: string, pattern: RegExp): Set<string>;
+export declare function addNestedMethod(catalog: ApiSurfaceCatalog, objectName: string, methodName: string): void;
+export declare function escapeRegExp(value: string): string;
+export declare function parseInitSetupBindings(content: string): InitSetupBinding[];
+export declare function collectDestructuredInitSetupKeys(content: string): Set<string>;
+export declare function addInitSetupVariableMethod(catalog: ApiSurfaceCatalog, variable: string, methodName: string): void;
+export declare function collectApiSurfaceFromContent(content: string, catalog: ApiSurfaceCatalog): void;
+export declare function buildApiSurfaceCatalog(testsRoot: string, seedFile: string): ApiSurfaceCatalog;
+//# sourceMappingURL=api_catalog.d.ts.map

package/dist/agent/api_catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_catalog.d.ts","sourceRoot":"","sources":["../../src/agent/api_catalog.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAE7E,wBAAgB,8BAA8B,IAAI,iBAAiB,CAuDlE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAS5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIxG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAsB1E;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAE7E;AAED,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACnB,IAAI,CAIN;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA4B9F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA4D7F"}