mycontext-cli 4.2.10 → 4.2.12

package/dist/agents/implementations/VisionTestCoordinator.js

@@ -0,0 +1,348 @@
+"use strict";
+/**
+ * Vision Test Coordinator
+ *
+ * Orchestrates all vision-based testing agents using the Living Brain (context.json) as
+ * the communication blackboard. Coordinates navigation, validation, demo recording, and
+ * script generation in a cohesive workflow.
+ *
+ * Uses the SubAgentOrchestrator pattern for robust agent management.
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisionTestCoordinator = void 0;
+const SubAgentOrchestrator_1 = require("../orchestrator/SubAgentOrchestrator");
+const VisionNavigatorAgent_1 = require("./VisionNavigatorAgent");
+const VisualValidatorAgent_1 = require("./VisualValidatorAgent");
+const DemoRecorderAgent_1 = require("./DemoRecorderAgent");
+const VOScriptExtractorAgent_1 = require("./VOScriptExtractorAgent");
+const ContextService_1 = require("../../services/ContextService");
+const AICore_1 = require("../../core/ai/AICore");
+const uuid_1 = require("uuid");
+const chalk_1 = __importDefault(require("chalk"));
+const path = __importStar(require("path"));
+class VisionTestCoordinator {
+    constructor() {
+        this.name = "VisionTestCoordinator";
+        this.description = "Master coordinator for vision-based testing workflows";
+        this.personality = `You are a master coordinator overseeing an autonomous testing team.
+You delegate tasks to specialized agents, monitor their progress via the Living Brain, and
+ensure all pieces come together into a cohesive test execution. You're the conductor of the
+vision testing orchestra.`;
+        this.llmProvider = "multi"; // Uses multiple providers through agents
+        this.expertise = [
+            "Test orchestration",
+            "Agent coordination",
+            "Workflow management",
+            "Result aggregation",
+            "Living Brain communication",
+        ];
+        // Initialize orchestrator
+        this.orchestrator = new SubAgentOrchestrator_1.SubAgentOrchestrator();
+        // Initialize specialized agents
+        this.navigatorAgent = new VisionNavigatorAgent_1.VisionNavigatorAgent();
+        this.validatorAgent = new VisualValidatorAgent_1.VisualValidatorAgent();
+        this.recorderAgent = new DemoRecorderAgent_1.DemoRecorderAgent();
+        this.voExtractorAgent = new VOScriptExtractorAgent_1.VOScriptExtractorAgent();
+        // Register agents with orchestrator
+        this.orchestrator.registerAgent(this.navigatorAgent);
+        this.orchestrator.registerAgent(this.validatorAgent);
+        this.orchestrator.registerAgent(this.recorderAgent);
+        this.orchestrator.registerAgent(this.voExtractorAgent);
+    }
+    async run(input) {
+        const { page, browserContext, mission, projectPath } = input;
+        // Initialize context service
+        this.contextService = new ContextService_1.ContextService(projectPath);
+        await this.contextService.initialize();
+        const executionId = (0, uuid_1.v4)();
+        const startTime = Date.now();
+        console.log(chalk_1.default.bold.blue(`\n${"=".repeat(60)}`));
+        console.log(chalk_1.default.bold.blue(`🎯 VISION TEST COORDINATOR`));
+        console.log(chalk_1.default.bold.blue(`${"=".repeat(60)}\n`));
+        console.log(chalk_1.default.white(`Mission: ${mission.name}`));
+        console.log(chalk_1.default.gray(`ID: ${executionId}`));
+        console.log(chalk_1.default.gray(`Record Demo: ${mission.recordDemo || false}\n`));
+        // Write mission start to Living Brain
+        await this.writeLivingBrain({
+            timestamp: new Date().toISOString(),
+            agentName: this.name,
+            updateType: "test-start",
+            data: {
+                executionId,
+                missionId: mission.id,
+                missionName: mission.name,
+                recordDemo: mission.recordDemo,
+            },
+            metadata: {
+                testId: mission.id,
+                executionId,
+            },
+        });
+        try {
+            // PHASE 1: Navigation
+            console.log(chalk_1.default.bold.cyan(`\n━━━ PHASE 1: NAVIGATION ━━━`));
+            const navigationResult = await this.orchestrator.executeAgent(this.navigatorAgent.name, {
+                page,
+                mission,
+                projectPath,
+                maxSteps: 20,
+            });
+            const steps = navigationResult.steps;
+            console.log(chalk_1.default.green(`\n✓ Navigation complete: ${steps.length} steps executed`));
+            // PHASE 2: Validation (if validation rules exist)
+            console.log(chalk_1.default.bold.cyan(`\n━━━ PHASE 2: VALIDATION ━━━`));
+            let validationResults = [];
+            if (mission.validationRules &&
+                mission.validationRules.length > 0) {
+                // Get final screenshot
+                const finalStep = steps[steps.length - 1];
+                const currentScreenshot = finalStep?.screenshot || "";
+                const validationOutput = await this.orchestrator.executeAgent(this.validatorAgent.name, {
+                    currentScreenshot,
+                    baselineScreenshot: mission.baselineScreenshots?.[0],
+                    validationRules: mission.validationRules,
+                    projectPath,
+                    page,
+                });
+                validationResults = validationOutput.results;
+                console.log(chalk_1.default.green(`\n✓ Validation complete: ${validationOutput.summary.passed}/${validationOutput.summary.totalChecks} passed`));
+            }
+            else {
+                console.log(chalk_1.default.gray("  No validation rules defined, skipping..."));
+            }
+            // PHASE 3: Demo Recording (if requested)
+            let demoArtifacts;
+            if (mission.recordDemo && mission.demoConfig) {
+                console.log(chalk_1.default.bold.cyan(`\n━━━ PHASE 3: DEMO RECORDING ━━━`));
+                const recorderOutput = await this.orchestrator.executeAgent(this.recorderAgent.name, {
+                    browserContext,
+                    steps,
+                    config: mission.demoConfig,
+                    projectPath,
+                    missionName: mission.name,
+                    missionDescription: mission.description,
+                });
+                demoArtifacts = recorderOutput.artifacts;
+                if (demoArtifacts) {
+                    console.log(chalk_1.default.green(`\n✓ Demo artifacts generated in ${Object.keys(demoArtifacts.formats).length} format(s)`));
+                }
+                // PHASE 4: VO Script Generation (if requested)
+                if (mission.demoConfig.includeVoiceOver) {
+                    console.log(chalk_1.default.bold.cyan(`\n━━━ PHASE 4: VO SCRIPT GENERATION ━━━`));
+                    const voScriptPath = path.join(projectPath, ".mycontext", "demos", `${mission.name}-${Date.now()}`, "voiceover-script.json");
+                    const voOutput = await this.orchestrator.executeAgent(this.voExtractorAgent.name, {
+                        steps,
+                        missionName: mission.name,
+                        missionDescription: mission.description,
+                        narrationStyle: mission.demoConfig.narrationStyle,
+                        projectPath,
+                        outputPath: voScriptPath,
+                        generateAudio: mission.demoConfig.generateAudio,
+                        ttsConfig: mission.demoConfig.ttsConfig,
+                    });
+                    if (demoArtifacts && voOutput.success) {
+                        demoArtifacts.voiceOver = {
+                            script: voOutput.script,
+                            audio: voOutput.audioPath
+                                ? {
+                                    path: voOutput.audioPath,
+                                    duration: voOutput.script.totalDuration,
+                                    format: "mp3",
+                                }
+                                : undefined,
+                        };
+                    }
+                    console.log(chalk_1.default.green(`\n✓ Voice-over script generated with ${voOutput.script.segments.length} segments`));
+                }
+            }
+            // Calculate final result
+            const endTime = Date.now();
+            const duration = endTime - startTime;
+            const successfulSteps = steps.filter((s) => s.success).length;
+            const passedValidations = validationResults.filter((v) => v.passed).length;
+            const allStepsSuccessful = successfulSteps === steps.length;
+            const allValidationsPassed = validationResults.length === 0 ||
+                passedValidations === validationResults.length;
+            const finalStatus = allStepsSuccessful && allValidationsPassed ? "passed" : "failed";
+            // Get final URL
+            const finalUrl = page.url();
+            // Build test execution result
+            const testResult = {
+                missionId: mission.id,
+                executionId,
+                status: finalStatus,
+                startedAt: new Date(startTime).toISOString(),
+                completedAt: new Date(endTime).toISOString(),
+                duration,
+                steps,
+                validationResults,
+                finalState: {
+                    url: finalUrl,
+                    screenshot: steps[steps.length - 1]?.screenshot,
+                },
+                visualSummary: {
+                    totalScreenshots: steps.filter((s) => s.screenshot).length,
+                    visualRegressionsDetected: validationResults.filter((v) => !v.passed && v.rule.type?.includes("visual")).length,
+                    colorSchemeMatches: validationResults.every((v) => v.passed || v.rule.type !== "color-scheme-match"),
+                    layoutMatches: validationResults.every((v) => v.passed || v.rule.type !== "layout-match"),
+                },
+                demoArtifacts,
+            };
+            // Write completion to Living Brain
+            await this.writeLivingBrain({
+                timestamp: new Date().toISOString(),
+                agentName: this.name,
+                updateType: "test-complete",
+                data: {
+                    executionId,
+                    status: finalStatus,
+                    duration,
+                    totalSteps: steps.length,
+                    successfulSteps,
+                    validationResults: validationResults.length,
+                    passedValidations,
+                    demoGenerated: !!demoArtifacts,
+                },
+                metadata: {
+                    testId: mission.id,
+                    executionId,
+                },
+            });
+            // Print final summary
+            console.log(chalk_1.default.bold.blue(`\n${"=".repeat(60)}`));
+            console.log(chalk_1.default.bold[finalStatus === "passed" ? "green" : "red"](`${finalStatus === "passed" ? "✅ TEST PASSED" : "❌ TEST FAILED"}`));
+            console.log(chalk_1.default.bold.blue(`${"=".repeat(60)}\n`));
+            console.log(chalk_1.default.white(`Duration: ${(duration / 1000).toFixed(1)}s`));
+            console.log(chalk_1.default.white(`Steps: ${successfulSteps}/${steps.length} successful`));
+            if (validationResults.length > 0) {
+                console.log(chalk_1.default.white(`Validations: ${passedValidations}/${validationResults.length} passed`));
+            }
+            if (demoArtifacts) {
+                console.log(chalk_1.default.white(`Demo formats: ${Object.keys(demoArtifacts.formats).join(", ")}`));
+            }
+            console.log("");
+            return {
+                result: testResult,
+                success: finalStatus === "passed",
+            };
+        }
+        catch (error) {
+            const endTime = Date.now();
+            const duration = endTime - startTime;
+            console.error(chalk_1.default.red(`\n❌ Test execution error: ${error.message}`));
+            // Write error to Living Brain
+            await this.writeLivingBrain({
+                timestamp: new Date().toISOString(),
+                agentName: this.name,
+                updateType: "error",
+                data: {
+                    executionId,
+                    error: error.message,
+                    stack: error.stack,
+                    duration,
+                },
+                metadata: {
+                    testId: mission.id,
+                    executionId,
+                },
+            });
+            // Return error result
+            const errorResult = {
+                missionId: mission.id,
+                executionId,
+                status: "error",
+                startedAt: new Date(startTime).toISOString(),
+                completedAt: new Date(endTime).toISOString(),
+                duration,
+                steps: [],
+                validationResults: [],
+                finalState: {
+                    url: page.url(),
+                },
+                error: {
+                    message: error.message,
+                    stack: error.stack,
+                },
+            };
+            return {
+                result: errorResult,
+                success: false,
+            };
+        }
+    }
+    /**
+     * Write update to Living Brain
+     */
+    async writeLivingBrain(update) {
+        try {
+            // Read current context using AICore
+            const aiCore = AICore_1.AICore.getInstance();
+            const currentContext = (await aiCore.getLivingContext()) || {};
+            if (!currentContext.testExecutionHistory) {
+                currentContext.testExecutionHistory = [];
+            }
+            currentContext.testExecutionHistory.push(update);
+            // Keep only last 100 updates
+            if (currentContext.testExecutionHistory.length > 100) {
+                currentContext.testExecutionHistory = currentContext.testExecutionHistory.slice(-100);
+            }
+            // Save back to context.json using AICore
+            await aiCore.saveLivingContext(currentContext);
+        }
+        catch (error) {
+            console.warn("Failed to write to Living Brain:", error);
+        }
+    }
+    async validate(input) {
+        return !!(input.page &&
+            input.browserContext &&
+            input.mission &&
+            input.projectPath);
+    }
+    async getStatus() {
+        return {
+            name: this.name,
+            status: "idle",
+            errorCount: 0,
+            successCount: 0,
+        };
+    }
+}
+exports.VisionTestCoordinator = VisionTestCoordinator;
+//# sourceMappingURL=VisionTestCoordinator.js.map

package/dist/agents/implementations/VisionTestCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisionTestCoordinator.js","sourceRoot":"","sources":["../../../src/agents/implementations/VisionTestCoordinator.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,+EAA4E;AAC5E,iEAA8D;AAC9D,iEAA8D;AAC9D,2DAAwD;AACxD,qEAAkE;AASlE,kEAA+D;AAC/D,iDAA8C;AAC9C,+BAAoC;AACpC,kDAA0B;AAC1B,2CAA6B;AAc7B,MAAa,qBAAqB;IAmBhC;QAhBA,SAAI,GAAG,uBAAuB,CAAC;QAC/B,gBAAW,GACT,uDAAuD,CAAC;QAexD,IAAI,CAAC,WAAW,GAAG;;;0BAGG,CAAC;QAEvB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,CAAC,yCAAyC;QACrE,IAAI,CAAC,SAAS,GAAG;YACf,oBAAoB;YACpB,oBAAoB;YACpB,qBAAqB;YACrB,oBAAoB;YACpB,4BAA4B;SAC7B,CAAC;QAEF,0BAA0B;QAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,2CAAoB,EAAE,CAAC;QAE/C,gCAAgC;QAChC,IAAI,CAAC,cAAc,GAAG,IAAI,2CAAoB,EAAE,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,IAAI,2CAAoB,EAAE,CAAC;QACjD,IAAI,CAAC,aAAa,GAAG,IAAI,qCAAiB,EAAE,CAAC;QAC7C,IAAI,CAAC,gBAAgB,GAAG,IAAI,+CAAsB,EAAE,CAAC;QAErD,oCAAoC;QACpC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,GAAG,CACP,KAAiC;QAEjC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;QAE7D,6BAA6B;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,+BAAc,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QAEvC,MAAM,WAAW,GAAG,IAAA,SAAM,GAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,UAAU,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;QAEzE,sCAAsC;QACtC,MAAM,IAAI,CAAC,gBAAgB,CAAC;YAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE;gBACJ,WAAW;gBACX,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,WAAW,EAAE,OAAO,CAAC,IAAI;gBACzB,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B;YACD,QAAQ,EAAE;gBACR,MAAM,EAAE,OAAO,CAAC,EAAE;gBAClB,WAAW;aACZ;SACF,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,sBAAsB;YACtB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;YAE9D,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAC3D,IAAI,CAAC,cAAc,CAAC,IAAI,EACxB;gBACE,IAAI;gBACJ,OAAO;gBACP,WAAW;gBACX,QAAQ,EAAE,EAAE;aACb,CACF,CAAC;YAEF,MAAM,KAAK,GAAqB,gBAAgB,CAAC,KAAK,CAAC;YAEvD,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CACT,4BAA4B,KAAK,CAAC,MAAM,iBAAiB,CAC1D,CACF,CAAC;YAEF,kDAAkD;YAClD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;YAE9D,IAAI,iBAAiB,GAA6B,EAAE,CAAC;YAErD,IACE,OAAO,CAAC,eAAe;gBACvB,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAClC,CAAC;gBACD,uBAAuB;gBACvB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC1C,MAAM,iBAAiB,GAAG,SAAS,EAAE,UAAU,IAAI,EAAE,CAAC;gBAEtD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAC3D,IAAI,CAAC,cAAc,CAAC,IAAI,EACxB;oBACE,iBAAiB;oBACjB,kBAAkB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;oBACpD,eAAe,EAAE,OAAO,CAAC,eAAe;oBACxC,WAAW;oBACX,IAAI;iBACL,CACF,CAAC;gBAEF,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC;gBAE7C,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CACT,4BAA4B,gBAAgB,CAAC,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,WAAW,SAAS,CAC7G,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;YACxE,CAAC;YAED,yCAAyC;YACzC,IAAI,aAAwC,CAAC;YAE7C,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,CAAC;gBAElE,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CACzD,IAAI,CAAC,aAAa,CAAC,IAAI,EACvB;oBACE,cAAc;oBACd,KAAK;oBACL,MAAM,EAAE,OAAO,CAAC,UAAU;oBAC1B,WAAW;oBACX,WAAW,EAAE,OAAO,CAAC,IAAI;oBACzB,kBAAkB,EAAE,OAAO,CAAC,WAAW;iBACxC,CACF,CAAC;gBAEF,aAAa,GAAG,cAAc,CAAC,SAAS,CAAC;gBAEzC,IAAI,aAAa,EAAE,CAAC;oBAClB,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CACT,mCAAmC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,YAAY,CACzF,CACF,CAAC;gBACJ,CAAC;gBAED,+CAA+C;gBAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;oBACxC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC,CAAC;oBAExE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,WAAW,EACX,YAAY,EACZ,OAAO,EACP,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,EAC/B,uBAAuB,CACxB,CAAC;oBAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CACnD,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAC1B;wBACE,KAAK;wBACL,WAAW,EAAE,OAAO,CAAC,IAAI;wBACzB,kBAAkB,EAAE,OAAO,CAAC,WAAW;wBACvC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,cAAc;wBACjD,WAAW;wBACX,UAAU,EAAE,YAAY;wBACxB,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,aAAa;wBAC/C,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS;qBACxC,CACF,CAAC;oBAEF,IAAI,aAAa,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;wBACtC,aAAa,CAAC,SAAS,GAAG;4BACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;4BACvB,KAAK,EAAE,QAAQ,CAAC,SAAS;gCACvB,CAAC,CAAC;oCACE,IAAI,EAAE,QAAQ,CAAC,SAAS;oCACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa;oCACvC,MAAM,EAAE,KAAK;iCACd;gCACH,CAAC,CAAC,SAAS;yBACd,CAAC;oBACJ,CAAC;oBAED,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CACT,wCAAwC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,WAAW,CACnF,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;YAErC,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAC9D,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;YAE3E,MAAM,kBAAkB,GAAG,eAAe,KAAK,KAAK,CAAC,MAAM,CAAC;YAC5D,MAAM,oBAAoB,GACxB,iBAAiB,CAAC,MAAM,KAAK,CAAC;gBAC9B,iBAAiB,KAAK,iBAAiB,CAAC,MAAM,CAAC;YAEjD,MAAM,WAAW,GACf,kBAAkB,IAAI,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAEnE,gBAAgB;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE5B,8BAA8B;YAC9B,MAAM,UAAU,GAA8B;gBAC5C,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,WAAW;gBACX,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBAC5C,WAAW,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;gBAC5C,QAAQ;gBACR,KAAK;gBACL,iBAAiB;gBACjB,UAAU,EAAE;oBACV,GAAG,EAAE,QAAQ;oBACb,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU;iBAChD;gBACD,aAAa,EAAE;oBACb,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM;oBAC1D,yBAAyB,EAAE,iBAAiB,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CACpD,CAAC,MAAM;oBACR,kBAAkB,EAAE,iBAAiB,CAAC,KAAK,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB,CACxD;oBACD,aAAa,EAAE,iBAAiB,CAAC,KAAK,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAClD;iBACF;gBACD,aAAa;aACd,CAAC;YAEF,mCAAmC;YACnC,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,IAAI,CAAC,IAAI;gBACpB,UAAU,EAAE,eAAe;gBAC3B,IAAI,EAAE;oBACJ,WAAW;oBACX,MAAM,EAAE,WAAW;oBACnB,QAAQ;oBACR,UAAU,EAAE,KAAK,CAAC,MAAM;oBACxB,eAAe;oBACf,iBAAiB,EAAE,iBAAiB,CAAC,MAAM;oBAC3C,iBAAiB;oBACjB,aAAa,EAAE,CAAC,CAAC,aAAa;iBAC/B;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO,CAAC,EAAE;oBAClB,WAAW;iBACZ;aACF,CAAC,CAAC;YAEH,sBAAsB;YACtB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CACpD,GAAG,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,EAAE,CAClE,CACF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,UAAU,eAAe,IAAI,KAAK,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC;YACjF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CACT,gBAAgB,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,SAAS,CACvE,CACF,CAAC;YACJ,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CACT,iBAAiB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjE,CACF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,WAAW,KAAK,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;YAErC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAEvE,8BAA8B;YAC9B,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,IAAI,CAAC,IAAI;gBACpB,UAAU,EAAE,OAAO;gBACnB,IAAI,EAAE;oBACJ,WAAW;oBACX,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,QAAQ;iBACT;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO,CAAC,EAAE;oBAClB,WAAW;iBACZ;aACF,CAAC,CAAC;YAEH,sBAAsB;YACtB,MAAM,WAAW,GAA8B;gBAC7C,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,WAAW;gBACX,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBAC5C,WAAW,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;gBAC5C,QAAQ;gBACR,KAAK,EAAE,EAAE;gBACT,iBAAiB,EAAE,EAAE;gBACrB,UAAU,EAAE;oBACV,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;iBAChB;gBACD,KAAK,EAAE;oBACL,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB;aACF,CAAC;YAEF,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,MAAyB;QACtD,IAAI,CAAC;YACH,oCAAoC;YACpC,MAAM,MAAM,GAAG,eAAM,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,cAAc,GAAQ,CAAC,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,CAAC;YAEpE,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC;gBACzC,cAAc,CAAC,oBAAoB,GAAG,EAAE,CAAC;YAC3C,CAAC;YAED,cAAc,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEjD,6BAA6B;YAC7B,IAAI,cAAc,CAAC,oBAAoB,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACrD,cAAc,CAAC,oBAAoB,GAAG,cAAc,CAAC,oBAAoB,CAAC,KAAK,CAC7E,CAAC,GAAG,CACL,CAAC;YACJ,CAAC;YAED,yCAAyC;YACzC,MAAM,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAiC;QAC9C,OAAO,CAAC,CAAC,CACP,KAAK,CAAC,IAAI;YACV,KAAK,CAAC,cAAc;YACpB,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,WAAW,CAClB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QAQb,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;CACF;AAlaD,sDAkaC"}

package/dist/agents/implementations/VisualValidatorAgent.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Visual Validator Agent
+ *
+ * Performs visual regression testing by comparing screenshots.
+ * Detects UI changes, color scheme drift, layout shifts, and more.
+ *
+ * Communicates via Living Brain (context.json).
+ */
+import { Page } from "playwright";
+import { SubAgent } from "../interfaces/SubAgent";
+import { VisualValidationResult, VisionValidationRule, VisualDiffResult } from "../../types/vision-testing";
+export interface VisualValidatorInput {
+    currentScreenshot: string;
+    baselineScreenshot?: string;
+    validationRules: VisionValidationRule[];
+    projectPath: string;
+    page?: Page;
+}
+export interface VisualValidatorOutput {
+    results: VisualValidationResult[];
+    passed: boolean;
+    visualDiff?: VisualDiffResult;
+    summary: {
+        totalChecks: number;
+        passed: number;
+        failed: number;
+        warnings: number;
+    };
+}
+export declare class VisualValidatorAgent implements SubAgent<VisualValidatorInput, VisualValidatorOutput> {
+    name: string;
+    description: string;
+    personality: string;
+    llmProvider: string;
+    expertise: string[];
+    private visionService;
+    private contextService?;
+    constructor();
+    run(input: VisualValidatorInput): Promise<VisualValidatorOutput>;
+    /**
+     * Validate visual match between current and baseline screenshots
+     */
+    private validateVisualMatch;
+    /**
+     * Validate color scheme matches expectations
+     */
+    private validateColorScheme;
+    /**
+     * Validate layout structure
+     */
+    private validateLayout;
+    /**
+     * Validate text readability
+     */
+    private validateTextReadability;
+    /**
+     * Validate no visual regression
+     */
+    private validateNoRegression;
+    /**
+     * Validate DOM-based rules (fallback for non-visual checks)
+     */
+    private validateDOMRule;
+    /**
+     * Compare two screenshots and detect differences
+     * NOTE: This is a placeholder - in production would use pixelmatch or sharp
+     */
+    private compareScreenshots;
+    /**
+     * Write update to Living Brain
+     */
+    private writeLivingBrain;
+    validate(input: VisualValidatorInput): Promise<boolean>;
+    getStatus(): Promise<{
+        name: string;
+        status: "idle" | "running" | "completed" | "error";
+        lastRun?: Date;
+        executionTime?: number;
+        errorCount: number;
+        successCount: number;
+    }>;
+}
+//# sourceMappingURL=VisualValidatorAgent.d.ts.map

package/dist/agents/implementations/VisualValidatorAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualValidatorAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/implementations/VisualValidatorAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EACL,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAGjB,MAAM,4BAA4B,CAAC;AAQpC,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,qBAAa,oBACX,YAAW,QAAQ,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAEhE,IAAI,SAA0B;IAC9B,WAAW,SACoE;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAiB;;IAqBlC,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8ItE;;OAEG;YACW,mBAAmB;IAuDjC;;OAEG;YACW,mBAAmB;IAwCjC;;OAEG;YACW,cAAc;IA2B5B;;OAEG;YACW,uBAAuB;IAoCrC;;OAEG;YACW,oBAAoB;IAYlC;;OAEG;YACW,eAAe;IAmF7B;;;OAGG;YACW,kBAAkB;IAsChC;;OAEG;YACW,gBAAgB;IA0BxB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvD,SAAS,IAAI,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;QACnD,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CAQH"}