@yasserkhanorg/e2e-agents 0.3.7 → 0.4.0

package/dist/agent/config.d.ts

@@ -121,6 +121,16 @@ export interface GitConfig {
     since: string;
     includeUncommitted?: boolean;
 }
+export interface RouteFamiliesConfig {
+    manifestPath?: string;
+    strict?: boolean;
+}
+export interface ApiSurfaceConfig {
+    enabled: boolean;
+    pageObjectsDir?: string;
+    componentsDir?: string;
+    cachePath?: string;
+}
 export interface AgentConfig {
     path: string;
     profile: AnalysisProfile;
@@ -152,6 +162,8 @@ export interface AgentConfig {
     audience: AudienceConfig;
     blastRadius: BlastRadiusConfig;
     git: GitConfig;
+    routeFamilies: RouteFamiliesConfig;
+    apiSurface: ApiSurfaceConfig;
 }
 export interface ResolvedConfig {
     config: AgentConfig;

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

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

package/dist/agent/config.js

@@ -172,6 +172,12 @@ const DEFAULT_CONFIG = {
         since: 'HEAD~1',
         includeUncommitted: true,
     },
+    routeFamilies: {
+        strict: false,
+    },
+    apiSurface: {
+        enabled: false,
+    },
 };
 function normalizeMattermostProvider(rawProvider, fallback, strict = false) {
     if (typeof rawProvider !== 'string') {
@@ -295,6 +301,14 @@ function mergeConfig(base, patch) {
             ...base.git,
             ...(patch.git || {}),
         },
+        routeFamilies: {
+            ...base.routeFamilies,
+            ...(patch.routeFamilies || {}),
+        },
+        apiSurface: {
+            ...base.apiSurface,
+            ...(patch.apiSurface || {}),
+        },
     };
 }
 function coerceNumber(value) {
@@ -652,6 +666,22 @@ function extractConfigPatch(raw) {
             includeUncommitted: git.includeUncommitted !== undefined ? Boolean(git.includeUncommitted) : DEFAULT_CONFIG.git.includeUncommitted,
         };
     }
+    if (raw.routeFamilies && typeof raw.routeFamilies === 'object') {
+        const rf = raw.routeFamilies;
+        patch.routeFamilies = {
+            manifestPath: typeof rf.manifestPath === 'string' ? rf.manifestPath : undefined,
+            strict: rf.strict !== undefined ? Boolean(rf.strict) : DEFAULT_CONFIG.routeFamilies.strict,
+        };
+    }
+    if (raw.apiSurface && typeof raw.apiSurface === 'object') {
+        const api = raw.apiSurface;
+        patch.apiSurface = {
+            enabled: api.enabled !== undefined ? Boolean(api.enabled) : DEFAULT_CONFIG.apiSurface.enabled,
+            pageObjectsDir: typeof api.pageObjectsDir === 'string' ? api.pageObjectsDir : undefined,
+            componentsDir: typeof api.componentsDir === 'string' ? api.componentsDir : undefined,
+            cachePath: typeof api.cachePath === 'string' ? api.cachePath : undefined,
+        };
+    }
     return patch;
 }
 function resolveConfig(cwd, configPath, overrides) {
@@ -815,6 +845,8 @@ function resolveConfig(cwd, configPath, overrides) {
         config.policy.forceFullOnWarningsAtOrAbove = 1;
         config.policy.forceFullOnP0WithGaps = true;
         config.policy.forceFullOnRiskyFiles = true;
+        config.routeFamilies.strict = true;
+        config.apiSurface.enabled = true;
     }
     const resolvedRoot = (0, path_1.resolve)(configDir, config.path);
     config.path = resolvedRoot;

package/dist/anthropic_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic_provider.d.ts","sourceRoot":"","sources":["../src/anthropic_provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,EACX,oBAAoB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAehD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,IAAI,SAAe;IACnB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,EAAE,oBAAoB,CAShC;gBAEU,MAAM,EAAE,eAAe;IA2B7B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA4D7E,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAgHlG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IA4CnG,OAAO,CAAC,uBAAuB;IAU/B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC;CAyBpE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;CAChC,CAAC,CAyBD"}
+{"version":3,"file":"anthropic_provider.d.ts","sourceRoot":"","sources":["../src/anthropic_provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,EACX,oBAAoB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAehD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,IAAI,SAAe;IACnB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,EAAE,oBAAoB,CAShC;gBAEU,MAAM,EAAE,eAAe;IA4B7B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA4D7E,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAgHlG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IA4CnG,OAAO,CAAC,uBAAuB;IAU/B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC;CAyBpE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;CAChC,CAAC,CAyBD"}

package/dist/anthropic_provider.js

@@ -70,6 +70,7 @@ class AnthropicProvider extends base_provider_js_1.BaseProvider {
         this.client = new sdk_1.default({
             apiKey: config.apiKey,
             baseURL: config.baseUrl,
+            maxRetries: 0,
         });
         this.model = config.model || 'claude-sonnet-4-5-20250929';
     }

package/dist/cli.js

@@ -17,6 +17,7 @@ const traceability_ingest_js_1 = require("./agent/traceability_ingest.js");
 const traceability_capture_js_1 = require("./agent/traceability_capture.js");
 const pipeline_js_1 = require("./agent/pipeline.js");
 const playwright_report_js_1 = require("./agent/playwright_report.js");
+const orchestrator_js_1 = require("./pipeline/orchestrator.js");
 const CONFIG_CANDIDATES = ['e2e-ai-agents.config.json', '.e2e-ai-agents.config.json'];
 function findConfigUpwards(startDir) {
     if (!startDir) {
@@ -71,6 +72,7 @@ function printUsage() {
         '  e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
         '  e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
         '  e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
+        '  e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>]',
         '  e2e-ai-agents llm-health',
         '',
         'Options:',
@@ -155,6 +157,7 @@ function parseArgs(argv) {
         || command === 'feedback'
         || command === 'traceability-capture'
         || command === 'traceability-ingest'
+        || command === 'analyze'
         || command === 'llm-health') {
         parsed.command = command;
     }
@@ -481,6 +484,15 @@ function parseArgs(argv) {
             parsed.dryRun = true;
             continue;
         }
+        if (arg === '--generate') {
+            parsed.analyzeGenerate = true;
+            continue;
+        }
+        if (arg === '--generate-output' && next) {
+            parsed.analyzeGenerateOutputDir = next;
+            i += 1;
+            continue;
+        }
     }
     return parsed;
 }
@@ -495,6 +507,68 @@ async function main() {
         await runLlmHealth();
         return;
     }
+    if (args.command === 'analyze') {
+        if (!args.path && !autoConfig) {
+            // eslint-disable-next-line no-console
+            console.error('Error: --path is required for analyze command');
+            process.exit(1);
+        }
+        const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+            path: args.path,
+            profile: args.profile,
+            testsRoot: args.testsRoot,
+            mode: 'impact',
+            gitSince: args.gitSince,
+            llmProvider: args.llmProvider,
+        });
+        const testsRoot = config.testsRoot || config.path;
+        const analyzeStages = [
+            'preprocess', 'impact', 'coverage',
+        ];
+        if (args.analyzeGenerate) {
+            analyzeStages.push('generation');
+        }
+        const result = await (0, orchestrator_js_1.runPipeline)({
+            appPath: config.path,
+            testsRoot,
+            gitSince: args.gitSince || config.git.since,
+            routeFamilies: config.routeFamilies,
+            apiSurface: config.apiSurface,
+            stages: analyzeStages,
+            generation: args.analyzeGenerate
+                ? {
+                    defaultOutputDir: args.analyzeGenerateOutputDir || 'specs/functional/ai-assisted',
+                    dryRun: args.dryRun,
+                }
+                : undefined,
+        });
+        // eslint-disable-next-line no-console
+        console.log(`Analyze report: ${result.reportPath}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze flows identified: ${result.report.summary.flowsIdentified}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze flows covered: ${result.report.summary.flowsCovered}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze flows uncovered: ${result.report.summary.flowsUncovered}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze overall confidence: ${result.report.summary.overallConfidence}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze route families: ${result.report.summary.routeFamiliesImpacted.join(', ') || 'none'}`);
+        if (result.generated && result.generated.length > 0) {
+            const written = result.generated.filter((g) => g.written).length;
+            // eslint-disable-next-line no-console
+            console.log(`Analyze generated specs: ${result.generated.length} (written=${written})`);
+            for (const g of result.generated) {
+                // eslint-disable-next-line no-console
+                console.log(`  ${g.mode}: ${g.specPath}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            // eslint-disable-next-line no-console
+            console.log(`Analyze warnings: ${result.warnings.join(' | ')}`);
+        }
+        return;
+    }
     if (args.command === 'feedback') {
         if (!args.path && !autoConfig) {
             // eslint-disable-next-line no-console

package/dist/esm/agent/config.js

@@ -169,6 +169,12 @@ const DEFAULT_CONFIG = {
         since: 'HEAD~1',
         includeUncommitted: true,
     },
+    routeFamilies: {
+        strict: false,
+    },
+    apiSurface: {
+        enabled: false,
+    },
 };
 function normalizeMattermostProvider(rawProvider, fallback, strict = false) {
     if (typeof rawProvider !== 'string') {
@@ -292,6 +298,14 @@ function mergeConfig(base, patch) {
             ...base.git,
             ...(patch.git || {}),
         },
+        routeFamilies: {
+            ...base.routeFamilies,
+            ...(patch.routeFamilies || {}),
+        },
+        apiSurface: {
+            ...base.apiSurface,
+            ...(patch.apiSurface || {}),
+        },
     };
 }
 function coerceNumber(value) {
@@ -649,6 +663,22 @@ function extractConfigPatch(raw) {
             includeUncommitted: git.includeUncommitted !== undefined ? Boolean(git.includeUncommitted) : DEFAULT_CONFIG.git.includeUncommitted,
         };
     }
+    if (raw.routeFamilies && typeof raw.routeFamilies === 'object') {
+        const rf = raw.routeFamilies;
+        patch.routeFamilies = {
+            manifestPath: typeof rf.manifestPath === 'string' ? rf.manifestPath : undefined,
+            strict: rf.strict !== undefined ? Boolean(rf.strict) : DEFAULT_CONFIG.routeFamilies.strict,
+        };
+    }
+    if (raw.apiSurface && typeof raw.apiSurface === 'object') {
+        const api = raw.apiSurface;
+        patch.apiSurface = {
+            enabled: api.enabled !== undefined ? Boolean(api.enabled) : DEFAULT_CONFIG.apiSurface.enabled,
+            pageObjectsDir: typeof api.pageObjectsDir === 'string' ? api.pageObjectsDir : undefined,
+            componentsDir: typeof api.componentsDir === 'string' ? api.componentsDir : undefined,
+            cachePath: typeof api.cachePath === 'string' ? api.cachePath : undefined,
+        };
+    }
     return patch;
 }
 export function resolveConfig(cwd, configPath, overrides) {
@@ -812,6 +842,8 @@ export function resolveConfig(cwd, configPath, overrides) {
         config.policy.forceFullOnWarningsAtOrAbove = 1;
         config.policy.forceFullOnP0WithGaps = true;
         config.policy.forceFullOnRiskyFiles = true;
+        config.routeFamilies.strict = true;
+        config.apiSurface.enabled = true;
     }
     const resolvedRoot = resolve(configDir, config.path);
     config.path = resolvedRoot;

package/dist/esm/anthropic_provider.js

@@ -63,6 +63,7 @@ export class AnthropicProvider extends BaseProvider {
         this.client = new Anthropic({
             apiKey: config.apiKey,
             baseURL: config.baseUrl,
+            maxRetries: 0,
         });
         this.model = config.model || 'claude-sonnet-4-5-20250929';
     }

package/dist/esm/cli.js

@@ -15,6 +15,7 @@ import { ingestTraceabilityInput } from './agent/traceability_ingest.js';
 import { captureTraceabilityInput } from './agent/traceability_capture.js';
 import { runTargetedSpecHeal } from './agent/pipeline.js';
 import { extractPlaywrightUnstableSpecs } from './agent/playwright_report.js';
+import { runPipeline } from './pipeline/orchestrator.js';
 const CONFIG_CANDIDATES = ['e2e-ai-agents.config.json', '.e2e-ai-agents.config.json'];
 function findConfigUpwards(startDir) {
     if (!startDir) {
@@ -69,6 +70,7 @@ function printUsage() {
         '  e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
         '  e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
         '  e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
+        '  e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>]',
         '  e2e-ai-agents llm-health',
         '',
         'Options:',
@@ -153,6 +155,7 @@ function parseArgs(argv) {
         || command === 'feedback'
         || command === 'traceability-capture'
         || command === 'traceability-ingest'
+        || command === 'analyze'
         || command === 'llm-health') {
         parsed.command = command;
     }
@@ -479,6 +482,15 @@ function parseArgs(argv) {
             parsed.dryRun = true;
             continue;
         }
+        if (arg === '--generate') {
+            parsed.analyzeGenerate = true;
+            continue;
+        }
+        if (arg === '--generate-output' && next) {
+            parsed.analyzeGenerateOutputDir = next;
+            i += 1;
+            continue;
+        }
     }
     return parsed;
 }
@@ -493,6 +505,68 @@ async function main() {
         await runLlmHealth();
         return;
     }
+    if (args.command === 'analyze') {
+        if (!args.path && !autoConfig) {
+            // eslint-disable-next-line no-console
+            console.error('Error: --path is required for analyze command');
+            process.exit(1);
+        }
+        const { config } = resolveConfig(process.cwd(), autoConfig, {
+            path: args.path,
+            profile: args.profile,
+            testsRoot: args.testsRoot,
+            mode: 'impact',
+            gitSince: args.gitSince,
+            llmProvider: args.llmProvider,
+        });
+        const testsRoot = config.testsRoot || config.path;
+        const analyzeStages = [
+            'preprocess', 'impact', 'coverage',
+        ];
+        if (args.analyzeGenerate) {
+            analyzeStages.push('generation');
+        }
+        const result = await runPipeline({
+            appPath: config.path,
+            testsRoot,
+            gitSince: args.gitSince || config.git.since,
+            routeFamilies: config.routeFamilies,
+            apiSurface: config.apiSurface,
+            stages: analyzeStages,
+            generation: args.analyzeGenerate
+                ? {
+                    defaultOutputDir: args.analyzeGenerateOutputDir || 'specs/functional/ai-assisted',
+                    dryRun: args.dryRun,
+                }
+                : undefined,
+        });
+        // eslint-disable-next-line no-console
+        console.log(`Analyze report: ${result.reportPath}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze flows identified: ${result.report.summary.flowsIdentified}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze flows covered: ${result.report.summary.flowsCovered}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze flows uncovered: ${result.report.summary.flowsUncovered}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze overall confidence: ${result.report.summary.overallConfidence}`);
+        // eslint-disable-next-line no-console
+        console.log(`Analyze route families: ${result.report.summary.routeFamiliesImpacted.join(', ') || 'none'}`);
+        if (result.generated && result.generated.length > 0) {
+            const written = result.generated.filter((g) => g.written).length;
+            // eslint-disable-next-line no-console
+            console.log(`Analyze generated specs: ${result.generated.length} (written=${written})`);
+            for (const g of result.generated) {
+                // eslint-disable-next-line no-console
+                console.log(`  ${g.mode}: ${g.specPath}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            // eslint-disable-next-line no-console
+            console.log(`Analyze warnings: ${result.warnings.join(' | ')}`);
+        }
+        return;
+    }
     if (args.command === 'feedback') {
         if (!args.path && !autoConfig) {
             // eslint-disable-next-line no-console

package/dist/esm/index.js

@@ -14,3 +14,11 @@ export { appendFeedbackAndRecompute, readCalibration } from './agent/feedback.js
 export { finalizeGeneratedTests } from './agent/handoff.js';
 export { ingestTraceabilityInput } from './agent/traceability_ingest.js';
 export { captureTraceabilityInput } from './agent/traceability_capture.js';
+// Pipeline API (route-family-bound impact analysis)
+export { runPipeline } from './pipeline/orchestrator.js';
+export { runGenerationStage } from './pipeline/stage3_generation.js';
+export { buildGenerationPrompt, parseGenerationResponse, detectHallucinatedMethods } from './prompts/generation.js';
+// Knowledge modules
+export { loadRouteFamilyManifest, bindFilesToFamilies } from './knowledge/route_families.js';
+export { buildApiSurface, loadOrBuildApiSurface } from './knowledge/api_surface.js';
+export { buildSpecIndex, getSpecsForFamily } from './knowledge/spec_index.js';

package/dist/esm/knowledge/api_surface.js

@@ -0,0 +1,177 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'fs';
+import { join, extname } from 'path';
+const RESERVED_WORDS = new Set([
+    'private', 'protected', 'static', 'abstract', 'override',
+    'if', 'for', 'while', 'switch', 'return',
+    'const', 'let', 'var', 'import', 'export',
+    'class', 'type', 'interface', 'constructor',
+]);
+function extractMethodsFromSource(content) {
+    const methods = [];
+    const seen = new Set();
+    // Match async method declarations: async methodName(
+    const asyncMethodRe = /(?:async\s+)([a-zA-Z_]\w*)\s*\(/g;
+    let match;
+    while ((match = asyncMethodRe.exec(content)) !== null) {
+        const name = match[1];
+        if (RESERVED_WORDS.has(name)) {
+            continue;
+        }
+        if (!seen.has(name)) {
+            seen.add(name);
+            methods.push({ name, kind: 'method' });
+        }
+    }
+    // Match non-async public method patterns
+    const methodRe = /^\s+(?:readonly\s+)?([a-zA-Z_]\w*)\s*(?:\(|=\s*(?:async\s*)?\()/gm;
+    while ((match = methodRe.exec(content)) !== null) {
+        const name = match[1];
+        if (RESERVED_WORDS.has(name) || seen.has(name)) {
+            continue;
+        }
+        seen.add(name);
+        methods.push({ name, kind: 'method' });
+    }
+    // Match getter patterns: get propertyName()
+    const getterRe = /\bget\s+([a-zA-Z_]\w*)\s*\(\)/g;
+    while ((match = getterRe.exec(content)) !== null) {
+        const name = match[1];
+        if (!seen.has(name)) {
+            seen.add(name);
+            methods.push({ name, kind: 'getter' });
+        }
+    }
+    // Match readonly property declarations
+    const propRe = /^\s+(?:readonly\s+)?([a-zA-Z_]\w*)\s*[:=]/gm;
+    while ((match = propRe.exec(content)) !== null) {
+        const name = match[1];
+        if (RESERVED_WORDS.has(name) || seen.has(name)) {
+            continue;
+        }
+        seen.add(name);
+        methods.push({ name, kind: 'property' });
+    }
+    return methods;
+}
+function extractClassName(content) {
+    const match = content.match(/(?:export\s+)?class\s+(\w+)/);
+    return match ? match[1] : null;
+}
+function scanDirectory(dir) {
+    const surfaces = [];
+    if (!existsSync(dir)) {
+        return surfaces;
+    }
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            surfaces.push(...scanDirectory(fullPath));
+            continue;
+        }
+        const ext = extname(entry.name);
+        if (ext !== '.ts' && ext !== '.tsx') {
+            continue;
+        }
+        if (entry.name === 'index.ts' || entry.name === 'index.tsx') {
+            continue;
+        }
+        try {
+            const content = readFileSync(fullPath, 'utf-8');
+            const className = extractClassName(content);
+            if (!className) {
+                continue;
+            }
+            const extractedMethods = extractMethodsFromSource(content);
+            if (extractedMethods.length > 0) {
+                surfaces.push({
+                    className,
+                    file: fullPath,
+                    methods: extractedMethods,
+                });
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return surfaces;
+}
+export function buildApiSurface(testsRoot, config) {
+    const pageObjectsDir = config?.pageObjectsDir
+        ? join(testsRoot, config.pageObjectsDir)
+        : join(testsRoot, 'lib', 'src', 'ui', 'pages');
+    const componentsDir = config?.componentsDir
+        ? join(testsRoot, config.componentsDir)
+        : join(testsRoot, 'lib', 'src', 'ui', 'components');
+    const pageObjects = [
+        ...scanDirectory(pageObjectsDir),
+        ...scanDirectory(componentsDir),
+    ];
+    return {
+        pageObjects,
+        generatedAt: new Date().toISOString(),
+    };
+}
+export function loadOrBuildApiSurface(testsRoot, config) {
+    if (!config?.enabled) {
+        return { pageObjects: [], generatedAt: new Date().toISOString() };
+    }
+    const cachePath = config.cachePath
+        ? join(testsRoot, config.cachePath)
+        : join(testsRoot, '.e2e-ai-agents', 'api-surface.json');
+    if (existsSync(cachePath)) {
+        try {
+            const cached = JSON.parse(readFileSync(cachePath, 'utf-8'));
+            if (cached.pageObjects && Array.isArray(cached.pageObjects)) {
+                return cached;
+            }
+        }
+        catch {
+            // Rebuild if cache is corrupt
+        }
+    }
+    const catalog = buildApiSurface(testsRoot, config);
+    try {
+        const dir = join(cachePath, '..');
+        if (existsSync(dir)) {
+            writeFileSync(cachePath, JSON.stringify(catalog, null, 2), 'utf-8');
+        }
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+    return catalog;
+}
+export function getMethodsForPageObject(catalog, className) {
+    const surface = catalog.pageObjects.find((po) => po.className === className);
+    return surface?.methods || [];
+}
+export function validateMethodCall(catalog, className, methodName) {
+    const methods = getMethodsForPageObject(catalog, className);
+    return methods.some((m) => m.name === methodName);
+}
+export function formatApiSurfaceForPrompt(catalog, classNames) {
+    const sections = [];
+    for (const name of classNames) {
+        const surface = catalog.pageObjects.find((po) => po.className === name);
+        if (!surface) {
+            continue;
+        }
+        const methodList = surface.methods
+            .map((m) => {
+            if (m.kind === 'property') {
+                return `  ${m.name} (property)`;
+            }
+            if (m.kind === 'getter') {
+                return `  get ${m.name}()`;
+            }
+            return `  ${m.name}()`;
+        })
+            .join('\n');
+        sections.push(`${name}:\n${methodList}`);
+    }
+    return sections.join('\n\n');
+}