0xray 3.1.1 → 3.3.0

package/dist/mcps/knowledge-skills/multimodal-looker.server.js

@@ -7,179 +7,150 @@
  *
  * Production-ready implementation with real analysis logic.
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import * as fs from "fs";
 import { fileURLToPath } from "url";
 import { frameworkLogger } from "../../core/framework-logger.js";
+import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
 /* ============================================================================
  * Analysis Engine
  * ============================================================================ */
-class MultimodalLookerServer {
-    server;
+class MultimodalLookerServer extends XrayKnowledgeSkillBase {
     constructor() {
-        this.server = new Server({ name: "multimodal-looker", version: "3.1.0" }, { capabilities: { tools: {} } });
-        this.setupToolHandlers();
-    }
-    /* --------------------------------------------------------------------------
-     * Tool Registration
-     * -------------------------------------------------------------------------- */
-    setupToolHandlers() {
-        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-            tools: [
-                {
-                    name: "analyze-screenshot",
-                    description: "Extract UI elements from screenshots. Identifies components, layout structure, and provides detailed element analysis for code generation.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            imageData: {
-                                type: "string",
-                                description: "Base64 encoded image or detailed visual description",
-                            },
-                            extractComponents: {
-                                type: "boolean",
-                                default: true,
-                                description: "Extract individual UI components",
-                            },
-                            checkAccessibility: {
-                                type: "boolean",
-                                default: true,
-                                description: "Check for accessibility issues",
-                            },
-                            analyzeLayout: {
-                                type: "boolean",
-                                default: true,
-                                description: "Analyze layout structure and grid",
-                            },
+        super("multimodal-looker", "3.1.0");
+        this.tools = [
+            {
+                name: "analyze-screenshot",
+                description: "Extract UI elements from screenshots. Identifies components, layout structure, and provides detailed element analysis for code generation.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        imageData: {
+                            type: "string",
+                            description: "Base64 encoded image or detailed visual description",
+                        },
+                        extractComponents: {
+                            type: "boolean",
+                            default: true,
+                            description: "Extract individual UI components",
+                        },
+                        checkAccessibility: {
+                            type: "boolean",
+                            default: true,
+                            description: "Check for accessibility issues",
+                        },
+                        analyzeLayout: {
+                            type: "boolean",
+                            default: true,
+                            description: "Analyze layout structure and grid",
                         },
-                        required: ["imageData"],
                     },
+                    required: ["imageData"],
                 },
-                {
-                    name: "describe-diagram",
-                    description: "Parse architecture and flow diagrams. Extracts nodes, edges, relationships for understanding system design.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            imageData: {
-                                type: "string",
-                                description: "Diagram image or description",
-                            },
-                            diagramType: {
-                                type: "string",
-                                enum: ["auto", "flowchart", "sequence", "class", "architecture", "erd", "state"],
-                                default: "auto",
-                            },
-                            extractMetadata: {
-                                type: "boolean",
-                                default: true,
-                                description: "Extract additional metadata about the diagram",
-                            },
+            },
+            {
+                name: "describe-diagram",
+                description: "Parse architecture and flow diagrams. Extracts nodes, edges, relationships for understanding system design.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        imageData: {
+                            type: "string",
+                            description: "Diagram image or description",
+                        },
+                        diagramType: {
+                            type: "string",
+                            enum: ["auto", "flowchart", "sequence", "class", "architecture", "erd", "state"],
+                            default: "auto",
+                        },
+                        extractMetadata: {
+                            type: "boolean",
+                            default: true,
+                            description: "Extract additional metadata about the diagram",
                         },
-                        required: ["imageData"],
                     },
+                    required: ["imageData"],
                 },
-                {
-                    name: "review-ui-mockup",
-                    description: "Evaluate UI mockups against best practices. Checks consistency, accessibility, and provides improvement suggestions.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            imageData: {
-                                type: "string",
-                                description: "UI mockup image or description",
-                            },
-                            framework: {
-                                type: "string",
-                                enum: ["react", "vue", "angular", "svelte", "html"],
-                                default: "react",
-                            },
-                            checkResponsive: {
-                                type: "boolean",
-                                default: true,
-                                description: "Check for responsive design patterns",
-                            },
+            },
+            {
+                name: "review-ui-mockup",
+                description: "Evaluate UI mockups against best practices. Checks consistency, accessibility, and provides improvement suggestions.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        imageData: {
+                            type: "string",
+                            description: "UI mockup image or description",
+                        },
+                        framework: {
+                            type: "string",
+                            enum: ["react", "vue", "angular", "svelte", "html"],
+                            default: "react",
+                        },
+                        checkResponsive: {
+                            type: "boolean",
+                            default: true,
+                            description: "Check for responsive design patterns",
                         },
-                        required: ["imageData"],
                     },
+                    required: ["imageData"],
                 },
-                {
-                    name: "extract-visual-specs",
-                    description: "Convert visual content to design specifications. Extracts colors, spacing, typography, and other design tokens.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            imageData: {
-                                type: "string",
-                                description: "Visual content to analyze",
-                            },
-                            includeValues: {
-                                type: "boolean",
-                                default: true,
-                                description: "Include actual CSS values",
-                            },
-                            format: {
-                                type: "string",
-                                enum: ["css", "tailwind", "json"],
-                                default: "css",
-                            },
+            },
+            {
+                name: "extract-visual-specs",
+                description: "Convert visual content to design specifications. Extracts colors, spacing, typography, and other design tokens.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        imageData: {
+                            type: "string",
+                            description: "Visual content to analyze",
+                        },
+                        includeValues: {
+                            type: "boolean",
+                            default: true,
+                            description: "Include actual CSS values",
+                        },
+                        format: {
+                            type: "string",
+                            enum: ["css", "tailwind", "json"],
+                            default: "css",
                         },
-                        required: ["imageData"],
                     },
+                    required: ["imageData"],
                 },
-                {
-                    name: "compare-designs",
-                    description: "Compare two designs for consistency. Identifies differences in colors, layout, typography, and components.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            imageA: {
-                                type: "string",
-                                description: "Reference design",
-                            },
-                            imageB: {
-                                type: "string",
-                                description: "Design to compare",
-                            },
-                            tolerance: {
-                                type: "number",
-                                default: 5,
-                                description: "Difference tolerance threshold (0-100)",
-                            },
+            },
+            {
+                name: "compare-designs",
+                description: "Compare two designs for consistency. Identifies differences in colors, layout, typography, and components.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        imageA: {
+                            type: "string",
+                            description: "Reference design",
+                        },
+                        imageB: {
+                            type: "string",
+                            description: "Design to compare",
+                        },
+                        tolerance: {
+                            type: "number",
+                            default: 5,
+                            description: "Difference tolerance threshold (0-100)",
                         },
-                        required: ["imageA", "imageB"],
                     },
+                    required: ["imageA", "imageB"],
                 },
-            ],
-        }));
-        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-            const { name, arguments: args = {} } = request.params;
-            const params = args;
-            try {
-                switch (name) {
-                    case "analyze-screenshot":
-                        return this.handleAnalyzeScreenshot(params);
-                    case "describe-diagram":
-                        return this.handleDescribeDiagram(params);
-                    case "review-ui-mockup":
-                        return this.handleReviewUIMockup(params);
-                    case "extract-visual-specs":
-                        return this.handleExtractVisualSpecs(params);
-                    case "compare-designs":
-                        return this.handleCompareDesigns(params);
-                    default:
-                        throw new Error(`Unknown tool: ${name}`);
-                }
-            }
-            catch (error) {
-                return {
-                    content: [{ type: "text", text: `Error: ${error}` }],
-                    isError: true,
-                };
-            }
-        });
+            },
+        ];
+        this.handlers = {
+            "analyze-screenshot": async (args) => this.handleAnalyzeScreenshot(args),
+            "describe-diagram": async (args) => this.handleDescribeDiagram(args),
+            "review-ui-mockup": async (args) => this.handleReviewUIMockup(args),
+            "extract-visual-specs": async (args) => this.handleExtractVisualSpecs(args),
+            "compare-designs": async (args) => this.handleCompareDesigns(args),
+        };
+        this.setupToolHandlers();
     }
     /* --------------------------------------------------------------------------
      * Tool Handlers
@@ -1048,13 +1019,6 @@ class MultimodalLookerServer {
         }
         return recommendations;
     }
-    /* --------------------------------------------------------------------------
-     * Server Lifecycle
-     * -------------------------------------------------------------------------- */
-    async run() {
-        const transport = new StdioServerTransport();
-        await this.server.connect(transport);
-    }
 }
 const entryPoint = fs.realpathSync(process.argv[1] ?? "");
 if (entryPoint && fileURLToPath(import.meta.url) === entryPoint) {

package/dist/mcps/knowledge-skills/performance-optimization.server.js

@@ -4,144 +4,105 @@
  * Knowledge skill for performance analysis, optimization recommendations,
  * profiling, benchmarking, memory analysis, and Core Web Vitals measurement
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { frameworkLogger, generateJobId } from "../../core/framework-logger.js";
-import { createGracefulShutdown } from "../../utils/shutdown-handler.js";
 import fs from "fs";
 import path from "path";
-class XrayPerformanceOptimizationServer {
-    server;
-    startTime;
+import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
+class XrayPerformanceOptimizationServer extends XrayKnowledgeSkillBase {
     constructor() {
-        this.server = new Server({
-            name: "performance-optimization", version: "3.1.0",
-        }, {
-            capabilities: {
-                tools: {},
+        super("performance-optimization", "3.1.0");
+        this.tools = [
+            {
+                name: "profile-application",
+                description: "Run comprehensive performance profiling on the codebase to identify bottlenecks and hot paths",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectRoot: { type: "string", description: "Path to the project root directory" },
+                        scope: {
+                            type: "string",
+                            enum: ["full", "runtime", "build", "memory"],
+                            default: "full",
+                            description: "Scope of profiling analysis"
+                        },
+                        duration: { type: "number", default: 30, description: "Profiling duration in seconds" },
+                        includeHotPaths: { type: "boolean", default: true, description: "Include hot path analysis" }
+                    },
+                    required: ["projectRoot"]
+                }
             },
-        });
-        this.startTime = Date.now();
-        this.setupToolHandlers();
-    }
-    setupToolHandlers() {
-        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-            return {
-                tools: [
-                    {
-                        name: "profile-application",
-                        description: "Run comprehensive performance profiling on the codebase to identify bottlenecks and hot paths",
-                        inputSchema: {
-                            type: "object",
-                            properties: {
-                                projectRoot: { type: "string", description: "Path to the project root directory" },
-                                scope: {
-                                    type: "string",
-                                    enum: ["full", "runtime", "build", "memory"],
-                                    default: "full",
-                                    description: "Scope of profiling analysis"
-                                },
-                                duration: { type: "number", default: 30, description: "Profiling duration in seconds" },
-                                includeHotPaths: { type: "boolean", default: true, description: "Include hot path analysis" }
-                            },
-                            required: ["projectRoot"]
-                        }
+            {
+                name: "analyze-memory",
+                description: "Perform memory leak detection and heap analysis to identify memory issues",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectRoot: { type: "string", description: "Path to the project root directory" },
+                        heapSnapshot: { type: "boolean", default: true, description: "Generate heap snapshot analysis" },
+                        gcAnalysis: { type: "boolean", default: true, description: "Analyze garbage collection patterns" },
+                        leakDetection: { type: "boolean", default: true, description: "Detect potential memory leaks" }
                     },
-                    {
-                        name: "analyze-memory",
-                        description: "Perform memory leak detection and heap analysis to identify memory issues",
-                        inputSchema: {
-                            type: "object",
-                            properties: {
-                                projectRoot: { type: "string", description: "Path to the project root directory" },
-                                heapSnapshot: { type: "boolean", default: true, description: "Generate heap snapshot analysis" },
-                                gcAnalysis: { type: "boolean", default: true, description: "Analyze garbage collection patterns" },
-                                leakDetection: { type: "boolean", default: true, description: "Detect potential memory leaks" }
-                            },
-                            required: ["projectRoot"]
-                        }
+                    required: ["projectRoot"]
+                }
+            },
+            {
+                name: "benchmark-code",
+                description: "Execute and compare benchmark results for code performance measurement",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectRoot: { type: "string", description: "Path to the project root directory" },
+                        testFile: { type: "string", description: "Specific benchmark test file to run" },
+                        iterations: { type: "number", default: 100, description: "Number of benchmark iterations" },
+                        warmupRuns: { type: "number", default: 10, description: "Number of warmup runs" },
+                        compareBaseline: { type: "boolean", default: false, description: "Compare results against baseline" }
                     },
-                    {
-                        name: "benchmark-code",
-                        description: "Execute and compare benchmark results for code performance measurement",
-                        inputSchema: {
-                            type: "object",
-                            properties: {
-                                projectRoot: { type: "string", description: "Path to the project root directory" },
-                                testFile: { type: "string", description: "Specific benchmark test file to run" },
-                                iterations: { type: "number", default: 100, description: "Number of benchmark iterations" },
-                                warmupRuns: { type: "number", default: 10, description: "Number of warmup runs" },
-                                compareBaseline: { type: "boolean", default: false, description: "Compare results against baseline" }
-                            },
-                            required: ["projectRoot"]
-                        }
+                    required: ["projectRoot"]
+                }
+            },
+            {
+                name: "suggest-optimizations",
+                description: "Generate specific, actionable optimization suggestions based on code analysis",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectRoot: { type: "string", description: "Path to the project root directory" },
+                        focus: {
+                            type: "string",
+                            enum: ["cpu", "memory", "network", "io", "all"],
+                            default: "all",
+                            description: "Focus area for optimizations"
+                        },
+                        threshold: { type: "number", default: 100, description: "Performance threshold in ms" }
                     },
-                    {
-                        name: "suggest-optimizations",
-                        description: "Generate specific, actionable optimization suggestions based on code analysis",
-                        inputSchema: {
-                            type: "object",
-                            properties: {
-                                projectRoot: { type: "string", description: "Path to the project root directory" },
-                                focus: {
-                                    type: "string",
-                                    enum: ["cpu", "memory", "network", "io", "all"],
-                                    default: "all",
-                                    description: "Focus area for optimizations"
-                                },
-                                threshold: { type: "number", default: 100, description: "Performance threshold in ms" }
-                            },
-                            required: ["projectRoot"]
-                        }
+                    required: ["projectRoot"]
+                }
+            },
+            {
+                name: "measure-core-web-vitals",
+                description: "Analyze Core Web Vitals metrics (LCP, INP, CLS) for web application performance",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectRoot: { type: "string", description: "Path to the project root directory" },
+                        analyzeBundle: { type: "boolean", default: true, description: "Analyze JavaScript bundle" },
+                        checkAccessibility: { type: "boolean", default: true, description: "Check accessibility factors affecting CLS" },
+                        measureLCP: { type: "boolean", default: true, description: "Measure Largest Contentful Paint" },
+                        measureINP: { type: "boolean", default: true, description: "Measure Interaction to Next Paint" },
+                        measureCLS: { type: "boolean", default: true, description: "Measure Cumulative Layout Shift" }
                     },
-                    {
-                        name: "measure-core-web-vitals",
-                        description: "Analyze Core Web Vitals metrics (LCP, INP, CLS) for web application performance",
-                        inputSchema: {
-                            type: "object",
-                            properties: {
-                                projectRoot: { type: "string", description: "Path to the project root directory" },
-                                analyzeBundle: { type: "boolean", default: true, description: "Analyze JavaScript bundle" },
-                                checkAccessibility: { type: "boolean", default: true, description: "Check accessibility factors affecting CLS" },
-                                measureLCP: { type: "boolean", default: true, description: "Measure Largest Contentful Paint" },
-                                measureINP: { type: "boolean", default: true, description: "Measure Interaction to Next Paint" },
-                                measureCLS: { type: "boolean", default: true, description: "Measure Cumulative Layout Shift" }
-                            },
-                            required: ["projectRoot"]
-                        }
-                    }
-                ]
-            };
-        });
-        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-            const { name, arguments: args } = request.params;
-            try {
-                switch (name) {
-                    case "profile-application":
-                        return await this.handleProfileApplication(args);
-                    case "analyze-memory":
-                        return await this.handleAnalyzeMemory(args);
-                    case "benchmark-code":
-                        return await this.handleBenchmarkCode(args);
-                    case "suggest-optimizations":
-                        return await this.handleSuggestOptimizations(args);
-                    case "measure-core-web-vitals":
-                        return await this.handleMeasureCoreWebVitals(args);
-                    default:
-                        throw new Error(`Unknown tool: ${name}`);
+                    required: ["projectRoot"]
                 }
             }
-            catch (error) {
-                frameworkLogger.log("mcp/performance-optimization", "tool-handler", "error", { tool: name, error: String(error) });
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Error executing tool "${name}": ${error instanceof Error ? error.message : String(error)}`
-                        }]
-                };
-            }
-        });
+        ];
+        this.handlers = {
+            "profile-application": async (args) => this.handleProfileApplication(args),
+            "analyze-memory": async (args) => this.handleAnalyzeMemory(args),
+            "benchmark-code": async (args) => this.handleBenchmarkCode(args),
+            "suggest-optimizations": async (args) => this.handleSuggestOptimizations(args),
+            "measure-core-web-vitals": async (args) => this.handleMeasureCoreWebVitals(args),
+        };
+        this.setupToolHandlers();
     }
     async handleProfileApplication(args) {
         const { projectRoot, scope = "full", duration = 30, includeHotPaths = true } = args;
@@ -1566,17 +1527,6 @@ ${result.recommendations.slice(0, 5).map((r, i) => `${i + 1}. ${r}`).join("\n")
         }
         return files.slice(0, 100);
     }
-    async run() {
-        const transport = new StdioServerTransport();
-        await this.server.connect(transport);
-        createGracefulShutdown({
-            serverName: "performance-optimization.server",
-            server: this.server,
-        });
-        frameworkLogger.log("mcp/performance-optimization", "server-started", "info", {
-            uptime: Date.now() - this.startTime
-        });
-    }
 }
 if (import.meta.url === `file://${fs.realpathSync(process.argv[1])}`) {
     const server = new XrayPerformanceOptimizationServer();