viewgate-mcp 1.0.18 → 1.0.21

package/dist/index.js

@@ -51,7 +51,9 @@ function createMcpServer(apiKey, personalKey) {
                     description: "Retrieves all feedback annotations. WORKFLOW: 1. Read these annotations, 2. Open the source files and apply SURGICAL fixes based on '_ia_fix_instruction'. 3. IMMEDIATELY call 'mark_annotation_ready' with the results for EACH ticket you fixed. Use 'outerHtml' and 'source' (file:line) to locate the exact code block without manual searching. IMPORTANT: All AI analysis and comments MUST be in the 'preferredLanguage' specified in the output. Failure to follow the language setting is UNACCEPTABLE.",
                     inputSchema: {
                         type: "object",
-                        properties: {},
+                        properties: {
+                            limit: { type: "number", description: "Maximum number of annotations to retrieve (default: 3)", default: 3 }
+                        },
                     },
                 },
                 {
@@ -118,7 +120,8 @@ function createMcpServer(apiKey, personalKey) {
                                         path: { type: "string", description: "The relative path of the endpoint" },
                                         method: { type: "string", description: "HTTP method (GET, POST, etc.)" },
                                         description: { type: "string", description: "Human-readable description of what the endpoint does. MUST be in the preferredLanguage." },
-                                        hash: { type: "string", description: "Optional SHA256 hash of the endpoint definition for efficient diffing." }
+                                        hash: { type: "string", description: "Optional SHA256 hash of the endpoint definition for efficient diffing." },
+                                        contract: { type: "string", description: "Optional JSON string or description of the request/response contract (payload)." }
                                     },
                                     required: ["path", "method", "description"]
                                 }
@@ -142,6 +145,25 @@ function createMcpServer(apiKey, personalKey) {
                         type: "object",
                         properties: {},
                     },
+                },
+                {
+                    name: "get_optimizations",
+                    description: "Retrieves reported JSON payload optimizations (unused fields). WORKFLOW: 1. Get optimizations, 2. Locate the backend code for the endpoint, 3. Remove unused fields from the response, 4. Call 'mark_optimization_applied' with the ID.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                {
+                    name: "mark_optimization_applied",
+                    description: "Marks a payload optimization as applied in the backend after you have modified the code to remove unused fields.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "The ID of the optimization report to mark as applied" }
+                        },
+                        required: ["id"]
+                    },
                 }
             ],
         };
@@ -150,8 +172,10 @@ function createMcpServer(apiKey, personalKey) {
         switch (request.params.name) {
             case "get_annotations": {
                 try {
+                    const args = request.params.arguments;
+                    const limit = args.limit || 3;
                     const statuses = 'pending,bug_fixing';
-                    const response = await fetch(`${BACKEND_URL}/api/mcp/annotations?status=${statuses}`, {
+                    const response = await fetch(`${BACKEND_URL}/api/mcp/annotations?status=${statuses}&limit=${limit}&lock=true`, {
                         headers: {
                             'x-api-key': apiKey,
                             ...(personalKey ? { 'x-personal-key': personalKey } : {})
@@ -193,9 +217,12 @@ function createMcpServer(apiKey, personalKey) {
                         return prioB - prioA;
                     });
                     const annotationsWithTips = sortedAnnotations.map((ann) => {
+                        const file = ann.reference?.source?.split(':')[0];
+                        const line = ann.reference?.source?.split(':')[1];
                         const source = ann.reference?.source;
-                        const hasSource = source && source !== 'unknown:0';
-                        const [file, line] = hasSource ? source.split(':') : [null, null];
+                        const pendingCorrection = Array.isArray(ann.corrections)
+                            ? ann.corrections.find((c) => c.status === 'pending')
+                            : (typeof ann.corrections === 'string' ? { text: ann.corrections } : null);
                         // Essential fields for the AI to perform a surgical fix
                         return {
                             id: ann._id,
@@ -203,6 +230,7 @@ function createMcpServer(apiKey, personalKey) {
                             priority: ann.priority,
                             status: ann.status,
                             message: ann.message,
+                            corrections: ann.corrections, // Include full history
                             source: source,
                             filePath: ann.filePath || file,
                             line: ann.line || (line ? parseInt(line) : undefined),
@@ -219,6 +247,12 @@ function createMcpServer(apiKey, personalKey) {
                             _ia_fix_instruction: `### 🎨 DESIGN CONTEXT (Figma)
 ${ann.figmaReference ? `A design reference is available: ${ann.figmaReference}. Use the Figma link to understand the UX requirements.` : 'No explicit figma design linked.'}
 
+${pendingCorrection ? `### ⚠️ PENDING CORRECTION (FEEDBACK)
+The user has requested the following corrections:
+"${pendingCorrection.text}"
+${pendingCorrection.author ? `Requested by: ${pendingCorrection.author.name}` : ''}
+PLEASE ENSURE THESE SPECIFIC ISSUES ARE ADDRESSED IN YOUR FIX.` : ''}
+
 ### 🔬 SURGICAL FIX PROTOCOL (Language: ${data.preferredLanguage || 'en'})
 1. **PRIMARY**: Search for \`data-vg-id="${ann.reference?.vgId}"\`.
 2. **SECONDARY**: Check \`${file}\` L${line} (Fiber Source).
@@ -228,7 +262,7 @@ ${ann.figmaReference ? `A design reference is available: ${ann.figmaReference}.
 IMPORTANT: All your analysis and implementation comments MUST BE IN ${data.preferredLanguage === 'es' ? 'SPANISH' : 'ENGLISH'}.
 
 Confidence: [vgId: ${ann.reference?.confidence?.vgId || 0}, Fiber: ${ann.reference?.confidence?.fiber || 0}, Fingerprint: ${ann.reference?.confidence?.fingerprint || 0}]
-Instruction: ${ann.message}`
+Instruction: ${ann.message}${pendingCorrection ? `\nCorrection Needed: ${pendingCorrection.text}` : ''}`
                         };
                     });
                     return {
@@ -258,22 +292,34 @@ Instruction: ${ann.message}`
             case "mark_annotation_ready": {
                 try {
                     const args = request.params.arguments;
-                    const response = await fetch(`${BACKEND_URL}/api/mcp/annotations/batch-ready`, {
-                        method: 'PATCH',
-                        headers: {
-                            'Content-Type': 'application/json',
-                            'x-api-key': apiKey,
-                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
-                        },
-                        body: JSON.stringify({ results: args.results })
-                    });
-                    if (!response.ok) {
-                        throw new Error(`Backend responded with ${response.status} when updating annotations`);
+                    let lastError = null;
+                    for (let attempt = 1; attempt <= 3; attempt++) {
+                        try {
+                            const response = await fetch(`${BACKEND_URL}/api/mcp/annotations/batch-ready`, {
+                                method: 'PATCH',
+                                headers: {
+                                    'Content-Type': 'application/json',
+                                    'x-api-key': apiKey,
+                                    ...(personalKey ? { 'x-personal-key': personalKey } : {})
+                                },
+                                body: JSON.stringify({ results: args.results })
+                            });
+                            if (!response.ok) {
+                                throw new Error(`Backend responded with ${response.status}`);
+                            }
+                            const result = await response.json();
+                            return {
+                                content: [{ type: "text", text: `Successfully processed batch update: ${JSON.stringify(result, null, 2)}` }],
+                            };
+                        }
+                        catch (error) {
+                            lastError = error;
+                            console.error(`[MCP] mark_annotation_ready attempt ${attempt} failed:`, error.message);
+                            if (attempt < 3)
+                                await new Promise(resolve => setTimeout(resolve, 1000 * attempt));
+                        }
                     }
-                    const result = await response.json();
-                    return {
-                        content: [{ type: "text", text: `Successfully processed batch update: ${JSON.stringify(result, null, 2)}` }],
-                    };
+                    throw lastError || new Error('Unknown error during batch update');
                 }
                 catch (error) {
                     return {
@@ -394,6 +440,52 @@ Instruction: ${ann.message}`
                     };
                 }
             }
+            case "get_optimizations": {
+                try {
+                    const response = await fetch(`${BACKEND_URL}/api/mcp/optimizations`, {
+                        headers: {
+                            'x-api-key': apiKey,
+                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
+                        }
+                    });
+                    if (!response.ok)
+                        throw new Error(`Backend responded with ${response.status}`);
+                    const data = await response.json();
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: "text", text: `Error fetching optimizations: ${error.message}` }],
+                        isError: true
+                    };
+                }
+            }
+            case "mark_optimization_applied": {
+                try {
+                    const args = request.params.arguments;
+                    const response = await fetch(`${BACKEND_URL}/api/mcp/optimizations/${args.id}/applied`, {
+                        method: 'PATCH',
+                        headers: {
+                            'x-api-key': apiKey,
+                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
+                        }
+                    });
+                    if (!response.ok)
+                        throw new Error(`Backend responded with ${response.status}`);
+                    const result = await response.json();
+                    return {
+                        content: [{ type: "text", text: `Optimization marked as applied: ${JSON.stringify(result)}` }]
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: "text", text: `Error marking optimization: ${error.message}` }],
+                        isError: true
+                    };
+                }
+            }
             default:
                 throw new Error("Unknown tool");
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viewgate-mcp",
-  "version": "1.0.18",
+  "version": "1.0.21",
   "main": "dist/index.js",
   "bin": {
     "viewgate-mcp": "./dist/index.js"