@yasserkhanorg/impact-gate 2.0.0

package/dist/index.js

@@ -0,0 +1,169 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgenticGeneration = exports.getSpecsForFamily = exports.buildSpecIndex = exports.loadOrBuildApiSurface = exports.buildApiSurface = exports.getUserFlowsForBinding = exports.getPriorityForBinding = exports.getCypressSpecDirsForBinding = exports.bindFilesToFamilies = exports.loadRouteFamilyManifest = exports.buildQualityFixPrompt = exports.buildHealPrompt = exports.renderHealMarkdown = exports.resolveHealTargets = exports.healFromReport = exports.runHealStage = exports.detectHallucinatedMethods = exports.parseGenerationResponse = exports.buildGenerationPrompt = exports.runGenerationStage = exports.runPipeline = exports.captureTraceabilityInput = exports.ingestTraceabilityInput = exports.finalizeGeneratedTests = exports.getAdaptiveThresholds = exports.readFlakyTests = exports.readCalibration = exports.appendFeedbackAndRecompute = exports.buildPlanFromImpact = exports.extractScenarios = exports.getPartialGaps = exports.getGapsWithSuppressed = exports.getGaps = exports.analyzeImpactV2 = exports.captureTraceability = exports.ingestTraceability = exports.handoffGeneratedTests = exports.recommendTestsDeterministic = exports.analyzeImpactDeterministic = exports.validateProviderSetup = exports.LLMProviderFactory = exports.CustomProvider = exports.checkOpenAISetup = exports.OpenAIProvider = exports.checkOllamaSetup = exports.OllamaProvider = exports.checkAnthropicSetup = exports.AnthropicProvider = exports.UnsupportedCapabilityError = exports.LLMProviderError = void 0;
+exports.serializeManifest = exports.detectTestMode = exports.detectFramework = exports.isMattermostProfile = exports.resolveGenerationProfile = exports.scanFromKnowledgeGraph = exports.loadDiffOverlay = exports.transformKGToFamilies = exports.classifyProjectType = exports.loadKnowledgeGraph = exports.formatValidationReport = exports.buildValidationReport = exports.validateCommit = exports.getCommitFiles = exports.enrichFamilies = exports.detectStaleFamilies = exports.mergeFamilies = exports.scanProject = exports.EXIT_CODES = exports.classifyError = exports.CliError = exports.sanitizeObject = exports.containsSecrets = exports.sanitizeSecrets = exports.PrometheusMetrics = exports.CircuitBreaker = exports.withRetry = exports.ModelRouter = exports.BudgetLedger = exports.BudgetExceededError = exports.BaseProvider = exports.RegressionAdvisorAgent = exports.CrossImpactAgent = exports.TestDesignerAgent = exports.StrategistAgent = exports.ExplorerAgent = exports.HealerAgent = exports.ExecutorAgent = exports.GeneratorAgent = exports.CoverageEvaluatorAgent = exports.ImpactAnalystAgent = exports.WORKFLOWS = exports.CrewOrchestrator = void 0;
+var provider_interface_js_1 = require("./provider_interface.js");
+Object.defineProperty(exports, "LLMProviderError", { enumerable: true, get: function () { return provider_interface_js_1.LLMProviderError; } });
+Object.defineProperty(exports, "UnsupportedCapabilityError", { enumerable: true, get: function () { return provider_interface_js_1.UnsupportedCapabilityError; } });
+// Provider implementations
+var anthropic_provider_js_1 = require("./anthropic_provider.js");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return anthropic_provider_js_1.AnthropicProvider; } });
+Object.defineProperty(exports, "checkAnthropicSetup", { enumerable: true, get: function () { return anthropic_provider_js_1.checkAnthropicSetup; } });
+var ollama_provider_js_1 = require("./ollama_provider.js");
+Object.defineProperty(exports, "OllamaProvider", { enumerable: true, get: function () { return ollama_provider_js_1.OllamaProvider; } });
+Object.defineProperty(exports, "checkOllamaSetup", { enumerable: true, get: function () { return ollama_provider_js_1.checkOllamaSetup; } });
+var openai_provider_js_1 = require("./openai_provider.js");
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_provider_js_1.OpenAIProvider; } });
+Object.defineProperty(exports, "checkOpenAISetup", { enumerable: true, get: function () { return openai_provider_js_1.checkOpenAISetup; } });
+var custom_provider_js_1 = require("./custom_provider.js");
+Object.defineProperty(exports, "CustomProvider", { enumerable: true, get: function () { return custom_provider_js_1.CustomProvider; } });
+// Factory
+var provider_factory_js_1 = require("./provider_factory.js");
+Object.defineProperty(exports, "LLMProviderFactory", { enumerable: true, get: function () { return provider_factory_js_1.LLMProviderFactory; } });
+Object.defineProperty(exports, "validateProviderSetup", { enumerable: true, get: function () { return provider_factory_js_1.validateProviderSetup; } });
+// Agent API (deterministic impact + plan, traceability)
+var api_js_1 = require("./api.js");
+Object.defineProperty(exports, "analyzeImpactDeterministic", { enumerable: true, get: function () { return api_js_1.analyzeImpactDeterministic; } });
+Object.defineProperty(exports, "recommendTestsDeterministic", { enumerable: true, get: function () { return api_js_1.recommendTestsDeterministic; } });
+Object.defineProperty(exports, "handoffGeneratedTests", { enumerable: true, get: function () { return api_js_1.handoffGeneratedTests; } });
+Object.defineProperty(exports, "ingestTraceability", { enumerable: true, get: function () { return api_js_1.ingestTraceability; } });
+Object.defineProperty(exports, "captureTraceability", { enumerable: true, get: function () { return api_js_1.captureTraceability; } });
+// V2 Engine (deterministic impact + plan)
+var impact_engine_js_1 = require("./engine/impact_engine.js");
+Object.defineProperty(exports, "analyzeImpactV2", { enumerable: true, get: function () { return impact_engine_js_1.analyzeImpact; } });
+Object.defineProperty(exports, "getGaps", { enumerable: true, get: function () { return impact_engine_js_1.getGaps; } });
+Object.defineProperty(exports, "getGapsWithSuppressed", { enumerable: true, get: function () { return impact_engine_js_1.getGapsWithSuppressed; } });
+Object.defineProperty(exports, "getPartialGaps", { enumerable: true, get: function () { return impact_engine_js_1.getPartialGaps; } });
+var impact_engine_js_2 = require("./engine/impact_engine.js");
+Object.defineProperty(exports, "extractScenarios", { enumerable: true, get: function () { return impact_engine_js_2.extractScenarios; } });
+var plan_builder_js_1 = require("./engine/plan_builder.js");
+Object.defineProperty(exports, "buildPlanFromImpact", { enumerable: true, get: function () { return plan_builder_js_1.buildPlanFromImpact; } });
+var feedback_js_1 = require("./agent/feedback.js");
+Object.defineProperty(exports, "appendFeedbackAndRecompute", { enumerable: true, get: function () { return feedback_js_1.appendFeedbackAndRecompute; } });
+Object.defineProperty(exports, "readCalibration", { enumerable: true, get: function () { return feedback_js_1.readCalibration; } });
+Object.defineProperty(exports, "readFlakyTests", { enumerable: true, get: function () { return feedback_js_1.readFlakyTests; } });
+Object.defineProperty(exports, "getAdaptiveThresholds", { enumerable: true, get: function () { return feedback_js_1.getAdaptiveThresholds; } });
+var handoff_js_1 = require("./agent/handoff.js");
+Object.defineProperty(exports, "finalizeGeneratedTests", { enumerable: true, get: function () { return handoff_js_1.finalizeGeneratedTests; } });
+var traceability_ingest_js_1 = require("./agent/traceability_ingest.js");
+Object.defineProperty(exports, "ingestTraceabilityInput", { enumerable: true, get: function () { return traceability_ingest_js_1.ingestTraceabilityInput; } });
+var traceability_capture_js_1 = require("./agent/traceability_capture.js");
+Object.defineProperty(exports, "captureTraceabilityInput", { enumerable: true, get: function () { return traceability_capture_js_1.captureTraceabilityInput; } });
+// Pipeline API (route-family-bound impact analysis)
+var orchestrator_js_1 = require("./pipeline/orchestrator.js");
+Object.defineProperty(exports, "runPipeline", { enumerable: true, get: function () { return orchestrator_js_1.runPipeline; } });
+var stage3_generation_js_1 = require("./pipeline/stage3_generation.js");
+Object.defineProperty(exports, "runGenerationStage", { enumerable: true, get: function () { return stage3_generation_js_1.runGenerationStage; } });
+var generation_js_1 = require("./prompts/generation.js");
+Object.defineProperty(exports, "buildGenerationPrompt", { enumerable: true, get: function () { return generation_js_1.buildGenerationPrompt; } });
+Object.defineProperty(exports, "parseGenerationResponse", { enumerable: true, get: function () { return generation_js_1.parseGenerationResponse; } });
+Object.defineProperty(exports, "detectHallucinatedMethods", { enumerable: true, get: function () { return generation_js_1.detectHallucinatedMethods; } });
+var stage4_heal_js_1 = require("./pipeline/stage4_heal.js");
+Object.defineProperty(exports, "runHealStage", { enumerable: true, get: function () { return stage4_heal_js_1.runHealStage; } });
+Object.defineProperty(exports, "healFromReport", { enumerable: true, get: function () { return stage4_heal_js_1.healFromReport; } });
+Object.defineProperty(exports, "resolveHealTargets", { enumerable: true, get: function () { return stage4_heal_js_1.resolveHealTargets; } });
+Object.defineProperty(exports, "renderHealMarkdown", { enumerable: true, get: function () { return stage4_heal_js_1.renderHealMarkdown; } });
+var heal_js_1 = require("./prompts/heal.js");
+Object.defineProperty(exports, "buildHealPrompt", { enumerable: true, get: function () { return heal_js_1.buildHealPrompt; } });
+Object.defineProperty(exports, "buildQualityFixPrompt", { enumerable: true, get: function () { return heal_js_1.buildQualityFixPrompt; } });
+// Knowledge modules
+var route_families_js_1 = require("./knowledge/route_families.js");
+Object.defineProperty(exports, "loadRouteFamilyManifest", { enumerable: true, get: function () { return route_families_js_1.loadRouteFamilyManifest; } });
+Object.defineProperty(exports, "bindFilesToFamilies", { enumerable: true, get: function () { return route_families_js_1.bindFilesToFamilies; } });
+Object.defineProperty(exports, "getCypressSpecDirsForBinding", { enumerable: true, get: function () { return route_families_js_1.getCypressSpecDirsForBinding; } });
+Object.defineProperty(exports, "getPriorityForBinding", { enumerable: true, get: function () { return route_families_js_1.getPriorityForBinding; } });
+Object.defineProperty(exports, "getUserFlowsForBinding", { enumerable: true, get: function () { return route_families_js_1.getUserFlowsForBinding; } });
+var api_surface_js_1 = require("./knowledge/api_surface.js");
+Object.defineProperty(exports, "buildApiSurface", { enumerable: true, get: function () { return api_surface_js_1.buildApiSurface; } });
+Object.defineProperty(exports, "loadOrBuildApiSurface", { enumerable: true, get: function () { return api_surface_js_1.loadOrBuildApiSurface; } });
+var spec_index_js_1 = require("./knowledge/spec_index.js");
+Object.defineProperty(exports, "buildSpecIndex", { enumerable: true, get: function () { return spec_index_js_1.buildSpecIndex; } });
+Object.defineProperty(exports, "getSpecsForFamily", { enumerable: true, get: function () { return spec_index_js_1.getSpecsForFamily; } });
+// Agentic generation
+var runner_js_1 = require("./agentic/runner.js");
+Object.defineProperty(exports, "runAgenticGeneration", { enumerable: true, get: function () { return runner_js_1.runAgenticGeneration; } });
+// Crew (multi-agent QA workflows)
+var orchestrator_js_2 = require("./crew/orchestrator.js");
+Object.defineProperty(exports, "CrewOrchestrator", { enumerable: true, get: function () { return orchestrator_js_2.CrewOrchestrator; } });
+var workflows_js_1 = require("./crew/workflows.js");
+Object.defineProperty(exports, "WORKFLOWS", { enumerable: true, get: function () { return workflows_js_1.WORKFLOWS; } });
+// Crew agents
+var impact_analyst_js_1 = require("./agents/impact-analyst.js");
+Object.defineProperty(exports, "ImpactAnalystAgent", { enumerable: true, get: function () { return impact_analyst_js_1.ImpactAnalystAgent; } });
+var coverage_evaluator_js_1 = require("./agents/coverage-evaluator.js");
+Object.defineProperty(exports, "CoverageEvaluatorAgent", { enumerable: true, get: function () { return coverage_evaluator_js_1.CoverageEvaluatorAgent; } });
+var generator_js_1 = require("./agents/generator.js");
+Object.defineProperty(exports, "GeneratorAgent", { enumerable: true, get: function () { return generator_js_1.GeneratorAgent; } });
+var executor_js_1 = require("./agents/executor.js");
+Object.defineProperty(exports, "ExecutorAgent", { enumerable: true, get: function () { return executor_js_1.ExecutorAgent; } });
+var healer_js_1 = require("./agents/healer.js");
+Object.defineProperty(exports, "HealerAgent", { enumerable: true, get: function () { return healer_js_1.HealerAgent; } });
+var explorer_js_1 = require("./agents/explorer.js");
+Object.defineProperty(exports, "ExplorerAgent", { enumerable: true, get: function () { return explorer_js_1.ExplorerAgent; } });
+var strategist_js_1 = require("./agents/strategist.js");
+Object.defineProperty(exports, "StrategistAgent", { enumerable: true, get: function () { return strategist_js_1.StrategistAgent; } });
+var test_designer_js_1 = require("./agents/test-designer.js");
+Object.defineProperty(exports, "TestDesignerAgent", { enumerable: true, get: function () { return test_designer_js_1.TestDesignerAgent; } });
+var cross_impact_js_1 = require("./agents/cross-impact.js");
+Object.defineProperty(exports, "CrossImpactAgent", { enumerable: true, get: function () { return cross_impact_js_1.CrossImpactAgent; } });
+var regression_advisor_js_1 = require("./agents/regression-advisor.js");
+Object.defineProperty(exports, "RegressionAdvisorAgent", { enumerable: true, get: function () { return regression_advisor_js_1.RegressionAdvisorAgent; } });
+// Base provider (for extending with custom providers)
+var base_provider_js_1 = require("./base_provider.js");
+Object.defineProperty(exports, "BaseProvider", { enumerable: true, get: function () { return base_provider_js_1.BaseProvider; } });
+Object.defineProperty(exports, "BudgetExceededError", { enumerable: true, get: function () { return base_provider_js_1.BudgetExceededError; } });
+// Budget tracking
+var budget_ledger_js_1 = require("./budget_ledger.js");
+Object.defineProperty(exports, "BudgetLedger", { enumerable: true, get: function () { return budget_ledger_js_1.BudgetLedger; } });
+// Model routing
+var model_router_js_1 = require("./model_router.js");
+Object.defineProperty(exports, "ModelRouter", { enumerable: true, get: function () { return model_router_js_1.ModelRouter; } });
+// Resilience
+var retry_js_1 = require("./resilience/retry.js");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return retry_js_1.withRetry; } });
+var circuit_breaker_js_1 = require("./resilience/circuit_breaker.js");
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_js_1.CircuitBreaker; } });
+// Metrics
+var prometheus_js_1 = require("./metrics/prometheus.js");
+Object.defineProperty(exports, "PrometheusMetrics", { enumerable: true, get: function () { return prometheus_js_1.PrometheusMetrics; } });
+// Secret scanning
+var sanitize_js_1 = require("./sanitize.js");
+Object.defineProperty(exports, "sanitizeSecrets", { enumerable: true, get: function () { return sanitize_js_1.sanitizeSecrets; } });
+Object.defineProperty(exports, "containsSecrets", { enumerable: true, get: function () { return sanitize_js_1.containsSecrets; } });
+Object.defineProperty(exports, "sanitizeObject", { enumerable: true, get: function () { return sanitize_js_1.sanitizeObject; } });
+// CLI errors
+var errors_js_1 = require("./cli/errors.js");
+Object.defineProperty(exports, "CliError", { enumerable: true, get: function () { return errors_js_1.CliError; } });
+Object.defineProperty(exports, "classifyError", { enumerable: true, get: function () { return errors_js_1.classifyError; } });
+Object.defineProperty(exports, "EXIT_CODES", { enumerable: true, get: function () { return errors_js_1.EXIT_CODES; } });
+// Training (route-families bootstrap and maintenance)
+var scanner_js_1 = require("./training/scanner.js");
+Object.defineProperty(exports, "scanProject", { enumerable: true, get: function () { return scanner_js_1.scanProject; } });
+var merger_js_1 = require("./training/merger.js");
+Object.defineProperty(exports, "mergeFamilies", { enumerable: true, get: function () { return merger_js_1.mergeFamilies; } });
+Object.defineProperty(exports, "detectStaleFamilies", { enumerable: true, get: function () { return merger_js_1.detectStaleFamilies; } });
+var enricher_js_1 = require("./training/enricher.js");
+Object.defineProperty(exports, "enrichFamilies", { enumerable: true, get: function () { return enricher_js_1.enrichFamilies; } });
+var validator_js_1 = require("./training/validator.js");
+Object.defineProperty(exports, "getCommitFiles", { enumerable: true, get: function () { return validator_js_1.getCommitFiles; } });
+Object.defineProperty(exports, "validateCommit", { enumerable: true, get: function () { return validator_js_1.validateCommit; } });
+Object.defineProperty(exports, "buildValidationReport", { enumerable: true, get: function () { return validator_js_1.buildValidationReport; } });
+Object.defineProperty(exports, "formatValidationReport", { enumerable: true, get: function () { return validator_js_1.formatValidationReport; } });
+var kg_bridge_js_1 = require("./knowledge/kg_bridge.js");
+Object.defineProperty(exports, "loadKnowledgeGraph", { enumerable: true, get: function () { return kg_bridge_js_1.loadKnowledgeGraph; } });
+Object.defineProperty(exports, "classifyProjectType", { enumerable: true, get: function () { return kg_bridge_js_1.classifyProjectType; } });
+Object.defineProperty(exports, "transformKGToFamilies", { enumerable: true, get: function () { return kg_bridge_js_1.transformKGToFamilies; } });
+Object.defineProperty(exports, "loadDiffOverlay", { enumerable: true, get: function () { return kg_bridge_js_1.loadDiffOverlay; } });
+var kg_scanner_js_1 = require("./training/kg_scanner.js");
+Object.defineProperty(exports, "scanFromKnowledgeGraph", { enumerable: true, get: function () { return kg_scanner_js_1.scanFromKnowledgeGraph; } });
+var generation_profile_js_1 = require("./prompts/generation_profile.js");
+Object.defineProperty(exports, "resolveGenerationProfile", { enumerable: true, get: function () { return generation_profile_js_1.resolveGenerationProfile; } });
+Object.defineProperty(exports, "isMattermostProfile", { enumerable: true, get: function () { return generation_profile_js_1.isMattermostProfile; } });
+var framework_adapter_js_1 = require("./adapters/framework_adapter.js");
+Object.defineProperty(exports, "detectFramework", { enumerable: true, get: function () { return framework_adapter_js_1.detectFramework; } });
+Object.defineProperty(exports, "detectTestMode", { enumerable: true, get: function () { return framework_adapter_js_1.detectTestMode; } });
+// Route families (additional)
+var route_families_js_2 = require("./knowledge/route_families.js");
+Object.defineProperty(exports, "serializeManifest", { enumerable: true, get: function () { return route_families_js_2.serializeManifest; } });

package/dist/knowledge/api_surface.d.ts

@@ -0,0 +1,37 @@
+export interface MethodParam {
+    name: string;
+    type?: string;
+    optional?: boolean;
+}
+export interface MethodSignature {
+    name: string;
+    kind: 'method' | 'property' | 'getter';
+    params?: MethodParam[];
+    returnType?: string;
+    async?: boolean;
+}
+export interface PageObjectSurface {
+    className: string;
+    file: string;
+    methods: MethodSignature[];
+    /** Base class name if the class extends another */
+    extends?: string;
+}
+export interface ApiSurfaceCatalog {
+    pageObjects: PageObjectSurface[];
+    generatedAt: string;
+}
+export interface ApiSurfaceConfig {
+    enabled: boolean;
+    pageObjectsDir?: string;
+    componentsDir?: string;
+    cachePath?: string;
+    /** Use fast regex extraction instead of TypeScript AST (fallback mode) */
+    useRegexFallback?: boolean;
+}
+export declare function buildApiSurface(testsRoot: string, config?: ApiSurfaceConfig): ApiSurfaceCatalog;
+export declare function loadOrBuildApiSurface(testsRoot: string, config?: ApiSurfaceConfig): ApiSurfaceCatalog;
+export declare function getMethodsForPageObject(catalog: ApiSurfaceCatalog, className: string): MethodSignature[];
+export declare function validateMethodCall(catalog: ApiSurfaceCatalog, className: string, methodName: string): boolean;
+export declare function formatApiSurfaceForPrompt(catalog: ApiSurfaceCatalog, classNames: string[]): string;
+//# sourceMappingURL=api_surface.d.ts.map

package/dist/knowledge/api_surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_surface.d.ts","sourceRoot":"","sources":["../../src/knowledge/api_surface.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAgVD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAqC/F;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAgCrG;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAGxG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG7G;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CA0BlG"}

package/dist/knowledge/api_surface.js

@@ -0,0 +1,418 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildApiSurface = buildApiSurface;
+exports.loadOrBuildApiSurface = loadOrBuildApiSurface;
+exports.getMethodsForPageObject = getMethodsForPageObject;
+exports.validateMethodCall = validateMethodCall;
+exports.formatApiSurfaceForPrompt = formatApiSurfaceForPrompt;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const typescript_1 = __importDefault(require("typescript"));
+// ── TypeScript AST-based extraction ────────────────────────
+function extractMethodsFromAST(sourceFile, checker) {
+    const surfaces = [];
+    typescript_1.default.forEachChild(sourceFile, (node) => {
+        if (!typescript_1.default.isClassDeclaration(node) || !node.name) {
+            return;
+        }
+        const className = node.name.text;
+        const methods = [];
+        const seen = new Set();
+        // Get base class name if extends
+        let extendsName;
+        if (node.heritageClauses) {
+            for (const clause of node.heritageClauses) {
+                if (clause.token === typescript_1.default.SyntaxKind.ExtendsKeyword && clause.types.length > 0) {
+                    const expr = clause.types[0].expression;
+                    if (typescript_1.default.isIdentifier(expr)) {
+                        extendsName = expr.text;
+                    }
+                }
+            }
+        }
+        for (const member of node.members) {
+            // Skip constructor
+            if (typescript_1.default.isConstructorDeclaration(member)) {
+                continue;
+            }
+            // Skip private/protected members
+            const modifiers = typescript_1.default.canHaveModifiers(member) ? typescript_1.default.getModifiers(member) : undefined;
+            if (modifiers?.some((m) => m.kind === typescript_1.default.SyntaxKind.PrivateKeyword || m.kind === typescript_1.default.SyntaxKind.ProtectedKeyword)) {
+                continue;
+            }
+            const name = member.name && typescript_1.default.isIdentifier(member.name) ? member.name.text : null;
+            if (!name || name.startsWith('_') || seen.has(name)) {
+                continue;
+            }
+            seen.add(name);
+            if (typescript_1.default.isMethodDeclaration(member)) {
+                const isAsync = modifiers?.some((m) => m.kind === typescript_1.default.SyntaxKind.AsyncKeyword) ?? false;
+                const params = extractParams(member.parameters, checker);
+                const returnType = extractReturnType(member, checker);
+                methods.push({
+                    name,
+                    kind: 'method',
+                    async: isAsync ? true : undefined,
+                    params: params.length > 0 ? params : undefined,
+                    returnType: returnType || undefined,
+                });
+            }
+            else if (typescript_1.default.isGetAccessorDeclaration(member)) {
+                methods.push({ name, kind: 'getter' });
+            }
+            else if (typescript_1.default.isPropertyDeclaration(member)) {
+                // Check if it's an arrow function property (e.g., name = async () => {})
+                if (member.initializer && (typescript_1.default.isArrowFunction(member.initializer) || typescript_1.default.isFunctionExpression(member.initializer))) {
+                    const fn = member.initializer;
+                    const fnModifiers = typescript_1.default.canHaveModifiers(fn) ? typescript_1.default.getModifiers(fn) : undefined;
+                    const isAsync = fnModifiers?.some((m) => m.kind === typescript_1.default.SyntaxKind.AsyncKeyword) ?? false;
+                    const params = extractParams(fn.parameters, checker);
+                    methods.push({
+                        name,
+                        kind: 'method',
+                        async: isAsync ? true : undefined,
+                        params: params.length > 0 ? params : undefined,
+                    });
+                }
+                else {
+                    methods.push({ name, kind: 'property' });
+                }
+            }
+        }
+        if (methods.length > 0) {
+            surfaces.push({
+                className,
+                file: sourceFile.fileName,
+                methods,
+                extends: extendsName,
+            });
+        }
+    });
+    return surfaces;
+}
+function extractParams(params, checker) {
+    return params.map((p) => {
+        const name = typescript_1.default.isIdentifier(p.name) ? p.name.text : p.name.getText();
+        const optional = p.questionToken !== undefined || p.initializer !== undefined;
+        let type;
+        if (p.type) {
+            type = p.type.getText();
+        }
+        else if (checker) {
+            try {
+                const symbol = checker.getSymbolAtLocation(p.name);
+                if (symbol) {
+                    const t = checker.getTypeOfSymbolAtLocation(symbol, p);
+                    type = checker.typeToString(t);
+                }
+            }
+            catch {
+                // Type inference failure is non-fatal
+            }
+        }
+        return { name, type, optional: optional || undefined };
+    });
+}
+function extractReturnType(method, checker) {
+    if (method.type) {
+        return method.type.getText();
+    }
+    if (checker) {
+        try {
+            const signature = checker.getSignatureFromDeclaration(method);
+            if (signature) {
+                const returnType = checker.getReturnTypeOfSignature(signature);
+                const typeStr = checker.typeToString(returnType);
+                // Skip overly verbose inferred types
+                if (typeStr.length < 100) {
+                    return typeStr;
+                }
+            }
+        }
+        catch {
+            // Type inference failure is non-fatal
+        }
+    }
+    return null;
+}
+/**
+ * Extract page objects using the TypeScript Compiler API.
+ * Falls back to regex if compilation fails.
+ */
+function extractWithAST(files) {
+    if (files.length === 0) {
+        return [];
+    }
+    // Find the nearest tsconfig.json
+    const firstDir = (0, path_1.join)(files[0], '..');
+    const tsconfigPath = typescript_1.default.findConfigFile(firstDir, typescript_1.default.sys.fileExists, 'tsconfig.json');
+    let program;
+    if (tsconfigPath) {
+        const configFile = typescript_1.default.readConfigFile(tsconfigPath, typescript_1.default.sys.readFile);
+        const parsedConfig = typescript_1.default.parseJsonConfigFileContent(configFile.config, typescript_1.default.sys, (0, path_1.join)(tsconfigPath, '..'));
+        // Only compile the files we care about, using the config's compiler options
+        program = typescript_1.default.createProgram(files, parsedConfig.options);
+    }
+    else {
+        program = typescript_1.default.createProgram(files, {
+            target: typescript_1.default.ScriptTarget.ES2022,
+            module: typescript_1.default.ModuleKind.ESNext,
+            moduleResolution: typescript_1.default.ModuleResolutionKind.Bundler,
+            strict: true,
+            allowJs: false,
+            noEmit: true,
+        });
+    }
+    const checker = program.getTypeChecker();
+    const surfaces = [];
+    for (const filePath of files) {
+        const sourceFile = program.getSourceFile(filePath);
+        if (!sourceFile) {
+            continue;
+        }
+        surfaces.push(...extractMethodsFromAST(sourceFile, checker));
+    }
+    // Resolve inherited methods: if class extends another class in the catalog,
+    // merge parent methods that the child doesn't override
+    resolveInheritance(surfaces);
+    return surfaces;
+}
+/**
+ * Merge parent class methods into child classes that extend them.
+ */
+function resolveInheritance(surfaces) {
+    const byName = new Map(surfaces.map((s) => [s.className, s]));
+    for (const surface of surfaces) {
+        if (!surface.extends) {
+            continue;
+        }
+        const parent = byName.get(surface.extends);
+        if (!parent) {
+            continue;
+        }
+        const childMethodNames = new Set(surface.methods.map((m) => m.name));
+        for (const parentMethod of parent.methods) {
+            if (!childMethodNames.has(parentMethod.name)) {
+                surface.methods.push({ ...parentMethod });
+            }
+        }
+    }
+}
+// ── Regex-based extraction (fallback) ──────────────────────
+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 extractMethodsFromRegex(content) {
+    const methods = [];
+    const seen = new Set();
+    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) && !seen.has(name)) {
+            seen.add(name);
+            methods.push({ name, kind: 'method', async: true });
+        }
+    }
+    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)) {
+            seen.add(name);
+            const isAsync = match[0].includes('async');
+            methods.push({ name, kind: 'method', async: isAsync ? true : undefined });
+        }
+    }
+    const arrowRe = /^\s+([a-zA-Z_]\w*)\s*=\s*(async\s+)?(?:\([^)]*\)|[a-zA-Z_]\w*)\s*=>/gm;
+    while ((match = arrowRe.exec(content)) !== null) {
+        const name = match[1];
+        if (!RESERVED_WORDS.has(name) && !seen.has(name)) {
+            seen.add(name);
+            methods.push({ name, kind: 'method', async: match[2] ? true : undefined });
+        }
+    }
+    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' });
+        }
+    }
+    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)) {
+            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;
+}
+// ── Directory scanning ─────────────────────────────────────
+function collectTypeScriptFiles(dir) {
+    const files = [];
+    if (!(0, fs_1.existsSync)(dir)) {
+        return files;
+    }
+    const entries = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = (0, path_1.join)(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...collectTypeScriptFiles(fullPath));
+            continue;
+        }
+        const ext = (0, path_1.extname)(entry.name);
+        if (ext === '.ts' || ext === '.tsx') {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function scanDirectoryWithRegex(dir) {
+    const surfaces = [];
+    if (!(0, fs_1.existsSync)(dir)) {
+        return surfaces;
+    }
+    const entries = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = (0, path_1.join)(dir, entry.name);
+        if (entry.isDirectory()) {
+            surfaces.push(...scanDirectoryWithRegex(fullPath));
+            continue;
+        }
+        const ext = (0, path_1.extname)(entry.name);
+        if (ext !== '.ts' && ext !== '.tsx') {
+            continue;
+        }
+        try {
+            const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+            const className = extractClassName(content);
+            if (!className) {
+                continue;
+            }
+            const extractedMethods = extractMethodsFromRegex(content);
+            if (extractedMethods.length > 0) {
+                surfaces.push({ className, file: fullPath, methods: extractedMethods });
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return surfaces;
+}
+// ── Public API ──────────────────────────────────────────────
+function buildApiSurface(testsRoot, config) {
+    const pageObjectsDir = config?.pageObjectsDir
+        ? (0, path_1.join)(testsRoot, config.pageObjectsDir)
+        : (0, path_1.join)(testsRoot, 'lib', 'src', 'ui', 'pages');
+    const componentsDir = config?.componentsDir
+        ? (0, path_1.join)(testsRoot, config.componentsDir)
+        : (0, path_1.join)(testsRoot, 'lib', 'src', 'ui', 'components');
+    let pageObjects;
+    if (config?.useRegexFallback) {
+        pageObjects = [
+            ...scanDirectoryWithRegex(pageObjectsDir),
+            ...scanDirectoryWithRegex(componentsDir),
+        ];
+    }
+    else {
+        // Use TypeScript AST — full type info, inheritance, params
+        const allFiles = [
+            ...collectTypeScriptFiles(pageObjectsDir),
+            ...collectTypeScriptFiles(componentsDir),
+        ];
+        try {
+            pageObjects = extractWithAST(allFiles);
+        }
+        catch {
+            // Fall back to regex if AST extraction fails
+            pageObjects = [
+                ...scanDirectoryWithRegex(pageObjectsDir),
+                ...scanDirectoryWithRegex(componentsDir),
+            ];
+        }
+    }
+    return {
+        pageObjects,
+        generatedAt: new Date().toISOString(),
+    };
+}
+function loadOrBuildApiSurface(testsRoot, config) {
+    if (!config?.enabled) {
+        return { pageObjects: [], generatedAt: new Date().toISOString() };
+    }
+    const cachePath = config.cachePath
+        ? (0, path_1.join)(testsRoot, config.cachePath)
+        : (0, path_1.join)(testsRoot, '.e2e-ai-agents', 'api-surface.json');
+    if ((0, fs_1.existsSync)(cachePath)) {
+        try {
+            const cached = JSON.parse((0, fs_1.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 = (0, path_1.join)(cachePath, '..');
+        if ((0, fs_1.existsSync)(dir)) {
+            (0, fs_1.writeFileSync)(cachePath, JSON.stringify(catalog, null, 2), 'utf-8');
+        }
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+    return catalog;
+}
+function getMethodsForPageObject(catalog, className) {
+    const surface = catalog.pageObjects.find((po) => po.className === className);
+    return surface?.methods || [];
+}
+function validateMethodCall(catalog, className, methodName) {
+    const methods = getMethodsForPageObject(catalog, className);
+    return methods.some((m) => m.name === methodName);
+}
+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}()`;
+            }
+            const prefix = m.async ? 'async ' : '';
+            const paramStr = m.params
+                ? m.params.map((p) => `${p.name}${p.optional ? '?' : ''}${p.type ? `: ${p.type}` : ''}`).join(', ')
+                : '';
+            const retStr = m.returnType ? `: ${m.returnType}` : '';
+            return `  ${prefix}${m.name}(${paramStr})${retStr}`;
+        })
+            .join('\n');
+        sections.push(`${name}:\n${methodList}`);
+    }
+    return sections.join('\n\n');
+}