mycontext-cli 4.0.0 → 4.1.0

package/dist/mcp/testing-server.js

@@ -0,0 +1,516 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Flow Testing MCP Server
+ *
+ * A Model Context Protocol server that provides AI-powered UI flow testing capabilities.
+ * Can be used standalone or integrated with MyContext CLI.
+ *
+ * MCP Tools:
+ * - create_test_mission: Create a new test mission from natural language
+ * - run_test: Execute a test mission with autonomous browser navigation
+ * - list_test_missions: List all saved test missions
+ * - get_test_report: Retrieve detailed test execution report
+ * - record_flow: Interactive flow recording mode
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowTestingMCPServer = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const test_mission_manager_1 = require("./test-mission-manager");
+const browser_test_runner_1 = require("./browser-test-runner");
+const test_reporter_1 = require("./test-reporter");
+const ProbeManager_1 = require("../services/ProbeManager");
+const ContextService_1 = require("../services/ContextService");
+const chalk_1 = __importDefault(require("chalk"));
+class FlowTestingMCPServer {
+    constructor(projectPath) {
+        this.projectPath = projectPath || process.cwd();
+        this.server = new index_js_1.Server({
+            name: "flow-testing-server",
+            version: "1.0.0",
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Initialize managers
+        this.missionManager = new test_mission_manager_1.TestMissionManager(this.projectPath);
+        this.testRunner = new browser_test_runner_1.BrowserTestRunner(this.projectPath);
+        this.reporter = new test_reporter_1.TestReporter(this.projectPath);
+        this.probeManager = new ProbeManager_1.ProbeManager(this.projectPath);
+        this.contextService = new ContextService_1.ContextService(this.projectPath);
+        this.setupToolHandlers();
+    }
+    setupToolHandlers() {
+        // List available tools
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+            return {
+                tools: this.getAvailableTools(),
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case "create_test_mission":
+                        return await this.handleCreateTestMission(args);
+                    case "run_test":
+                        return await this.handleRunTest(args);
+                    case "list_test_missions":
+                        return await this.handleListTestMissions(args);
+                    case "get_test_report":
+                        return await this.handleGetTestReport(args);
+                    case "run_probe":
+                        return await this.handleRunProbe(args);
+                    case "query_context":
+                        return await this.handleQueryContext(args);
+                    case "record_flow":
+                        return await this.handleRecordFlow(args);
+                    case "watch_tests":
+                        return await this.handleWatchTests(args);
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error executing ${name}: ${error.message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    getAvailableTools() {
+        return [
+            {
+                name: "create_test_mission",
+                description: "Create a new UI flow test mission from natural language description",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Name for the test mission",
+                        },
+                        mission: {
+                            type: "string",
+                            description: "Natural language description of what to test (e.g., 'User should be able to login with valid credentials')",
+                        },
+                        expectedOutcome: {
+                            type: "string",
+                            description: "Expected result after completing the mission",
+                        },
+                        validationRules: {
+                            type: "array",
+                            description: "Optional validation rules to check",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    type: {
+                                        type: "string",
+                                        enum: [
+                                            "url-match",
+                                            "element-exists",
+                                            "text-contains",
+                                            "element-visible",
+                                            "form-submitted",
+                                            "data-updated",
+                                            "custom",
+                                        ],
+                                    },
+                                    description: { type: "string" },
+                                    selector: { type: "string" },
+                                    expectedValue: { type: "string" },
+                                },
+                            },
+                        },
+                        startUrl: {
+                            type: "string",
+                            description: "Starting URL for the test",
+                        },
+                    },
+                    required: ["name", "mission", "expectedOutcome"],
+                },
+            },
+            {
+                name: "run_test",
+                description: "Execute a test mission with autonomous browser navigation",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        missionId: {
+                            type: "string",
+                            description: "ID of the test mission to run",
+                        },
+                        headless: {
+                            type: "boolean",
+                            description: "Run browser in headless mode (default: true)",
+                        },
+                        baseUrl: {
+                            type: "string",
+                            description: "Base URL to use if different from mission config",
+                        },
+                        slowMo: {
+                            type: "number",
+                            description: "Slow down operations by N milliseconds for debugging",
+                        },
+                    },
+                    required: ["missionId"],
+                },
+            },
+            {
+                name: "list_test_missions",
+                description: "List all saved test missions",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        status: {
+                            type: "string",
+                            enum: ["all", "passing", "failing"],
+                            description: "Filter missions by last execution status",
+                        },
+                        tag: {
+                            type: "string",
+                            description: "Filter missions by tag",
+                        },
+                    },
+                },
+            },
+            {
+                name: "get_test_report",
+                description: "Retrieve detailed report from a test execution",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        executionId: {
+                            type: "string",
+                            description: "ID of the test execution",
+                        },
+                        includeScreenshots: {
+                            type: "boolean",
+                            description: "Include screenshot paths in report (default: true)",
+                        },
+                    },
+                    required: ["executionId"],
+                },
+            },
+            {
+                name: "run_probe",
+                description: "Execute a repository interrogation script (e.g., find, grep, lint) to get ground truth state",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string", description: "Name of the probe" },
+                        command: { type: "string", description: "The shell command to execute" },
+                        description: { type: "string", description: "What this probe is looking for" },
+                    },
+                    required: ["name", "command"],
+                },
+            },
+            {
+                name: "query_context",
+                description: "Query the design-manifest.json for project anchors, intent, and visual specs",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "The path in the manifest to query (e.g., 'phases.visual_system')" },
+                    },
+                    required: ["path"],
+                },
+            },
+            {
+                name: "record_flow",
+                description: "Start interactive recording mode to learn a flow by observing user actions",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Name for the recorded flow",
+                        },
+                        startUrl: {
+                            type: "string",
+                            description: "URL to start recording from",
+                        },
+                    },
+                    required: ["name", "startUrl"],
+                },
+            },
+            {
+                name: "watch_tests",
+                description: "Start watch mode to automatically re-run tests on file changes",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        missions: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Mission IDs to watch (empty = watch all)",
+                        },
+                        watchPaths: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Paths to watch for changes (default: src/, app/, components/)",
+                        },
+                    },
+                },
+            },
+        ];
+    }
+    async handleCreateTestMission(args) {
+        const { name, mission, expectedOutcome, validationRules = [], startUrl, } = args;
+        // Milestone 3: Grounding Pre-hook
+        await this.contextService.initialize();
+        const manifest = this.contextService.getManifest();
+        if (manifest) {
+            const grounding = await this.contextService.validateIntent(mission);
+            if (!grounding.valid) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `⚠️ MISSION REJECTED: Your mission "${mission}" deviates from the Project's Prime Objective: "${manifest.phases.functional_summary.core_purpose}".\n\nREASON: ${grounding.reason}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        const newMission = await this.missionManager.createMission({
+            name,
+            mission,
+            expectedOutcome,
+            validationRules,
+            startUrl,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ Test mission created successfully!
+
+**Mission ID**: ${newMission.id}
+**Name**: ${newMission.name}
+**Mission**: ${newMission.mission}
+**Expected Outcome**: ${newMission.expectedOutcome}
+${startUrl ? `**Start URL**: ${startUrl}` : ""}
+${validationRules.length > 0 ? `**Validation Rules**: ${validationRules.length}` : ""}
+
+You can now run this mission with:
+\`\`\`
+run_test(missionId: "${newMission.id}")
+\`\`\`
+
+Or from CLI:
+\`\`\`
+mycontext test:run ${newMission.name}
+\`\`\`
+`,
+                },
+            ],
+        };
+    }
+    async handleRunTest(args) {
+        const { missionId, headless = true, baseUrl, slowMo } = args;
+        const mission = await this.missionManager.getMission(missionId);
+        if (!mission) {
+            throw new Error(`Mission not found: ${missionId}`);
+        }
+        // Milestone 3: Pre-flight Grounding
+        await this.contextService.initialize();
+        const manifest = this.contextService.getManifest();
+        if (manifest) {
+            console.log(chalk_1.default.blue(`🛰️  Pre-flight Grounding: Anchoring mission to "${manifest.project_name}"`));
+        }
+        // Execute the test
+        const result = await this.testRunner.runTest(mission, {
+            headless,
+            baseUrl,
+            slowMo,
+        });
+        // Save execution result
+        await this.missionManager.saveExecution(result);
+        // Generate report
+        const report = await this.reporter.generateReport(result);
+        const statusEmoji = result.status === "passed" ? "✅" : "❌";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${statusEmoji} Test execution ${result.status.toUpperCase()}
+
+**Mission**: ${mission.name}
+**Execution ID**: ${result.executionId}
+**Duration**: ${result.duration}ms
+**Steps Executed**: ${result.steps.length}
+**Validations**: ${result.validationResults.length} (${result.validationResults.filter((v) => v.passed).length} passed)
+
+${result.status === "failed" ? `**Error**: ${result.error?.message}\n` : ""}
+
+**Final State**:
+- URL: ${result.finalState.url}
+- Screenshot: ${result.finalState.screenshot || "N/A"}
+
+${result.aiNotes ? `**AI Notes**: ${result.aiNotes}\n` : ""}
+
+View full report:
+\`\`\`
+get_test_report(executionId: "${result.executionId}")
+\`\`\`
+`,
+                },
+            ],
+        };
+    }
+    async handleListTestMissions(args) {
+        const { status = "all", tag } = args;
+        const missions = await this.missionManager.listMissions({ status, tag });
+        const output = [
+            `# Test Missions (${missions.length})`,
+            "",
+            ...missions.map((m, index) => {
+                return `${index + 1}. **${m.name}** (${m.id})
+   - Mission: ${m.mission}
+   - Expected: ${m.expectedOutcome}
+   - Tags: ${m.tags?.join(", ") || "none"}
+   - Created: ${new Date(m.createdAt).toLocaleString()}`;
+            }),
+        ];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: output.join("\n"),
+                },
+            ],
+        };
+    }
+    async handleGetTestReport(args) {
+        const { executionId, includeScreenshots = true } = args;
+        const report = await this.reporter.getReport(executionId);
+        if (!report) {
+            throw new Error(`Report not found: ${executionId}`);
+        }
+        const output = await this.reporter.formatReport(report, {
+            includeScreenshots,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: output,
+                },
+            ],
+        };
+    }
+    async handleRunProbe(args) {
+        const { name, command, description = "" } = args;
+        const result = await this.probeManager.runProbe({
+            name,
+            command,
+            description,
+            category: "custom",
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `🔍 Probe Results: ${name}
+          
+Status: ${result.success ? "✅ Success" : "❌ Failed"}
+Output:
+\`\`\`
+${result.output || "No output"}
+\`\`\`
+${result.error ? `Error: \n\`\`\`\n${result.error}\n\`\`\`` : ""}
+`,
+                },
+            ],
+        };
+    }
+    async handleQueryContext(args) {
+        const { path: queryPath } = args;
+        await this.contextService.initialize();
+        const result = await this.contextService.queryContext({ path: queryPath });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `📖 Manifest Query: ${queryPath}
+          
+Result:
+\`\`\`json
+${JSON.stringify(result, null, 2)}
+\`\`\`
+`,
+                },
+            ],
+        };
+    }
+    async handleRecordFlow(args) {
+        const { name, startUrl } = args;
+        // Start interactive recording
+        const session = await this.testRunner.startRecording(name, startUrl);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `🎥 Recording started for "${name}"
+
+**Session ID**: ${session.sessionId}
+**Start URL**: ${startUrl}
+
+A browser window will open. Perform your actions, and the AI will observe and learn.
+When done, the recorded flow will be saved as a test mission.
+
+Recording in progress...
+`,
+                },
+            ],
+        };
+    }
+    async handleWatchTests(args) {
+        const { missions = [], watchPaths = ["src", "app", "components"] } = args;
+        // Start watch mode
+        await this.testRunner.startWatchMode(missions, watchPaths);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `👀 Watch mode started
+
+**Watching**: ${missions.length > 0 ? missions.join(", ") : "all missions"}
+**Paths**: ${watchPaths.join(", ")}
+
+Tests will automatically re-run when files change.
+Press Ctrl+C to stop.
+`,
+                },
+            ],
+        };
+    }
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("Flow Testing MCP Server running on stdio");
+    }
+}
+exports.FlowTestingMCPServer = FlowTestingMCPServer;
+// Start server if run directly
+if (require.main === module) {
+    const projectPath = process.argv[2] || process.cwd();
+    const server = new FlowTestingMCPServer(projectPath);
+    server.start().catch(console.error);
+}
+//# sourceMappingURL=testing-server.js.map

package/dist/mcp/testing-server.js.map

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

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "CLI tool for spec-driven development - Generate comprehensive context, visual screens, and scaffolding for AI-powered coding",
   "main": "dist/cli.js",
   "bin": {
@@ -52,6 +52,8 @@
     "@google-cloud/vertexai": "^1.10.0",
     "@google/generative-ai": "^0.24.1",
     "@huggingface/inference": "^4.11.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@playwright/test": "^1.58.2",
     "@types/figlet": "^1.7.0",
     "axios": "^1.6.0",
     "chalk": "^5.3.0",
@@ -63,12 +65,14 @@
     "fs-extra": "^11.1.1",
     "fuse.js": "^7.1.0",
     "glob": "^10.3.10",
+    "global": "link:../../../../Library/pnpm/global/5/node_modules/global",
     "gradient-string": "^3.0.0",
     "inquirer": "^9.2.12",
     "mdast-util-to-markdown": "^2.1.2",
     "node-fetch": "^2.7.0",
     "openai": "^6.2.0",
     "ora": "^7.0.1",
+    "playwright": "^1.58.2",
     "prompts": "^2.4.2",
     "remark-parse": "^11.0.0",
     "sonner": "^2.0.7",
@@ -101,4 +105,4 @@
     "package.json"
   ],
   "packageManager": "pnpm@10.11.0+sha512.6540583f41cc5f628eb3d9773ecee802f4f9ef9923cc45b69890fb47991d4b092964694ec3a4f738a420c918a333062c8b925d312f42e4f0c263eb603551f977"
-}
+}

package/dist/services/ContextService.d.ts

@@ -0,0 +1,38 @@
+import { DesignManifest, EnrichedContext } from '../types/design-pipeline';
+export interface ContextQuery {
+    path: string;
+    filter?: string;
+}
+export declare class ContextService {
+    private manifestManager;
+    private aiClient;
+    private projectPath;
+    private manifest;
+    constructor(projectPath: string);
+    /**
+     * Initialize and load the manifest
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the full manifest
+     */
+    getManifest(): DesignManifest | null;
+    /**
+     * Query specific data from the manifest
+     */
+    queryContext(query: ContextQuery): Promise<any>;
+    /**
+     * Get a consolidated enrichment context for the AI
+     */
+    getEnrichedContext(): Promise<EnrichedContext | null>;
+    /**
+     * Validate an intent against the Prime Objective
+     * (Milestone 2: Hard Gravity)
+     */
+    validateIntent(intent: string): Promise<{
+        valid: boolean;
+        reason?: string;
+        narrativeWeight: number;
+    }>;
+}
+//# sourceMappingURL=ContextService.d.ts.map

package/dist/services/ContextService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextService.d.ts","sourceRoot":"","sources":["../../src/services/ContextService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAI3E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAA+B;gBAEnC,WAAW,EAAE,MAAM;IAM/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI;IAIpC;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBrD;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI3D;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5C,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CAiDH"}