viewgate-mcp 1.0.9 → 1.0.11

package/dist/index.js

@@ -48,7 +48,7 @@ function createMcpServer(apiKey) {
             tools: [
                 {
                     name: "get_annotations",
-                    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.",
+                    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: {},
@@ -56,7 +56,7 @@ function createMcpServer(apiKey) {
                 },
                 {
                     name: "mark_annotation_ready",
-                    description: "CRITICAL: Call this tool AFTER applying code fixes for annotations. It marks tickets as 'Ready for Review' in the ViewGate dashboard and stores your AI-generated change summary. Support batch processing of multiple tickets at once. IMPORTANT: The 'appliedChanges' summary MUST be written in the 'preferredLanguage' specified by 'get_annotations' output.",
+                    description: "CRITICAL: Call this tool AFTER applying code fixes for annotations. It marks tickets as 'Ready for Review' in the ViewGate dashboard and stores your AI-generated change summary. Support batch processing of multiple tickets at once. IMPORTANT: The 'appliedChanges' summary MUST be written in the 'preferredLanguage' specified by 'get_annotations' output. DO NOT use English if the preferred language is Spanish.",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -66,7 +66,7 @@ function createMcpServer(apiKey) {
                                     type: "object",
                                     properties: {
                                         id: { type: "string", description: "The ID of the annotation to mark as ready" },
-                                        appliedChanges: { type: "string", description: "Descriptive summary of what was changed in the code for this specific ticket" }
+                                        appliedChanges: { type: "string", description: "Descriptive summary of what was changed in the code for this specific ticket. MUST be in the preferredLanguage." }
                                     },
                                     required: ["id", "appliedChanges"]
                                 }
@@ -77,7 +77,7 @@ function createMcpServer(apiKey) {
                 },
                 {
                     name: "planning",
-                    description: "Planning tool for backlog tickets. CALL WITHOUT ARGUMENTS to fetch backlog tickets that need analysis. CALL WITH 'results' to submit AI analysis in batch. Rules: complejidad (1-3), incertidumbre (1-3), impacto (1-3), riesgo (1-3), tipo (AI-friendly|AI-assisted|Human-critical). IMPORTANT: All AI analysis and comments MUST be in the 'preferredLanguage' specified in the output.",
+                    description: "Planning tool for backlog tickets. CALL WITHOUT ARGUMENTS to fetch backlog tickets that need analysis. CALL WITH 'results' to submit AI analysis in batch. Rules: complejidad (1-3), incertidumbre (1-3), impacto (1-3), riesgo (1-3), tipo (AI-friendly|AI-assisted|Human-critical). IMPORTANT: All AI analysis, 'aiAnalysis' descriptions, and comments MUST be in the 'preferredLanguage' specified in the output.",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -92,7 +92,7 @@ function createMcpServer(apiKey) {
                                         impacto: { type: "number", minimum: 1, maximum: 3 },
                                         riesgo: { type: "number", minimum: 1, maximum: 3 },
                                         tipo: { type: "string", enum: ["AI-friendly", "AI-assisted", "Human-critical"] },
-                                        aiAnalysis: { type: "string", description: "Reasoning or summary of the analysis" }
+                                        aiAnalysis: { type: "string", description: "Reasoning or summary of the analysis. MUST be in the preferredLanguage." }
                                     },
                                     required: ["id", "complejidad", "incertidumbre", "impacto", "riesgo", "tipo", "aiAnalysis"]
                                 }
@@ -106,7 +106,7 @@ function createMcpServer(apiKey) {
                 },
                 {
                     name: "sync_endpoints",
-                    description: "Synchronizes a batch of backend endpoints with the ViewGate server. High-performance batch processing for language-agnostic mapping (Express, Java, .NET, Python, etc.).",
+                    description: "Synchronizes a batch of backend endpoints with the ViewGate server. High-performance batch processing for language-agnostic mapping (Express, Java, .NET, Python, etc.). IMPORTANT: The 'description' for each endpoint MUST be written in the project's preferred language (e.g., Spanish if preferredLanguage is 'es').",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -117,14 +117,31 @@ function createMcpServer(apiKey) {
                                     properties: {
                                         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" }
+                                        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." }
                                     },
                                     required: ["path", "method", "description"]
                                 }
+                            },
+                            clean: {
+                                type: "boolean",
+                                description: "If true, clears all existing endpoints before adding the new ones. Useful for the first batch of a fresh scan."
+                            },
+                            globalHash: {
+                                type: "string",
+                                description: "Optional SHA256 hash of the entire endpoint set. If provided and matches the backend, the entire sync is skipped for performance."
                             }
                         },
                         required: ["endpoints"]
                     }
+                },
+                {
+                    name: "get_synced_endpoints",
+                    description: "Retrieves the list of endpoints currently synchronized in the backend for this project. Use this to perform diffing and avoid redundant synchronization calls.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
                 }
             ],
         };
@@ -196,12 +213,15 @@ function createMcpServer(apiKey) {
                             componentPath: ann.reference?.componentPath,
                             selector: ann.reference?.selector,
                             tag: ann.reference?.tag,
-                            _ia_fix_instruction: `### 🔬 SURGICAL FIX PROTOCOL
+                            backendEndpoints: ann.backendEndpoints || [ann.backendEndpoint].filter(Boolean),
+                            _ia_fix_instruction: `### 🔬 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).
 3. **TERTIARY**: Match Tag(\`${ann.reference?.tag}\`) + Role(\`${ann.reference?.fingerprint?.role}\`) + Text("${ann.reference?.text?.slice(0, 30)}").
 4. **VALIDATE**: Confirm parent context matches \`${ann.reference?.parentContext?.slice(0, 50).replace(/`/g, "'")}...\`.
 
+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}`
                         };
@@ -316,14 +336,18 @@ Instruction: ${ann.message}`
                             'Content-Type': 'application/json',
                             'x-api-key': apiKey
                         },
-                        body: JSON.stringify({ endpoints: args.endpoints })
+                        body: JSON.stringify({
+                            endpoints: args.endpoints,
+                            clean: args.clean,
+                            globalHash: args.globalHash
+                        })
                     });
                     if (!response.ok) {
                         throw new Error(`Backend responded with ${response.status}`);
                     }
                     const result = (await response.json());
                     return {
-                        content: [{ type: "text", text: `Endpoints synchronized successfully: ${result.count} routes mapped.` }]
+                        content: [{ type: "text", text: `Endpoints synchronized successfully: ${result.count} routes processed. ${result.saved ? 'Changes saved.' : 'No changes detected.'}` }]
                     };
                 }
                 catch (error) {
@@ -333,6 +357,31 @@ Instruction: ${ann.message}`
                     };
                 }
             }
+            case "get_synced_endpoints": {
+                try {
+                    const response = await fetch(`${BACKEND_URL}/api/projects/endpoints`, {
+                        headers: {
+                            'x-api-key': apiKey
+                        }
+                    });
+                    if (!response.ok) {
+                        throw new Error(`Backend responded with ${response.status}`);
+                    }
+                    const data = (await response.json());
+                    return {
+                        content: [{
+                                type: "text",
+                                text: JSON.stringify(data.endpoints || [], null, 2)
+                            }]
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: "text", text: `Error fetching synced endpoints: ${error.message}` }],
+                        isError: true
+                    };
+                }
+            }
             default:
                 throw new Error("Unknown tool");
         }

package/package.json

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