viewgate-mcp 1.0.10 → 1.0.12

package/dist/index.js

@@ -34,7 +34,7 @@ const sessions = new Map();
 /**
  * Create a new MCP server instance for a specific context.
  */
-function createMcpServer(apiKey) {
+function createMcpServer(apiKey, personalKey) {
     const server = new Server({
         name: "viewgate-mcp",
         version: "1.0.0",
@@ -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: {},
+                    },
                 }
             ],
         };
@@ -136,7 +153,8 @@ function createMcpServer(apiKey) {
                     const statuses = 'pending,bug_fixing';
                     const response = await fetch(`${BACKEND_URL}/api/mcp/annotations?status=${statuses}`, {
                         headers: {
-                            'x-api-key': apiKey
+                            'x-api-key': apiKey,
+                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
                         }
                     });
                     if (!response.ok) {
@@ -196,12 +214,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}`
                         };
@@ -237,7 +258,8 @@ Instruction: ${ann.message}`
                         method: 'PATCH',
                         headers: {
                             'Content-Type': 'application/json',
-                            'x-api-key': apiKey
+                            'x-api-key': apiKey,
+                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
                         },
                         body: JSON.stringify({ results: args.results })
                     });
@@ -262,7 +284,10 @@ Instruction: ${ann.message}`
                     if (!args.results) {
                         // Fetch Backlog Mode
                         const response = await fetch(`${BACKEND_URL}/api/mcp/backlog`, {
-                            headers: { 'x-api-key': apiKey }
+                            headers: {
+                                'x-api-key': apiKey,
+                                ...(personalKey ? { 'x-personal-key': personalKey } : {})
+                            }
                         });
                         if (!response.ok) {
                             throw new Error(`Backend responded with ${response.status}`);
@@ -284,7 +309,8 @@ Instruction: ${ann.message}`
                             method: 'PATCH',
                             headers: {
                                 'Content-Type': 'application/json',
-                                'x-api-key': apiKey
+                                'x-api-key': apiKey,
+                                ...(personalKey ? { 'x-personal-key': personalKey } : {})
                             },
                             body: JSON.stringify({ results: args.results, force: args.force })
                         });
@@ -314,16 +340,21 @@ Instruction: ${ann.message}`
                         method: 'POST',
                         headers: {
                             'Content-Type': 'application/json',
-                            'x-api-key': apiKey
+                            'x-api-key': apiKey,
+                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
                         },
-                        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 +364,32 @@ Instruction: ${ann.message}`
                     };
                 }
             }
+            case "get_synced_endpoints": {
+                try {
+                    const response = await fetch(`${BACKEND_URL}/api/projects/endpoints`, {
+                        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.endpoints || [], null, 2)
+                            }]
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: "text", text: `Error fetching synced endpoints: ${error.message}` }],
+                        isError: true
+                    };
+                }
+            }
             default:
                 throw new Error("Unknown tool");
         }
@@ -345,11 +402,12 @@ if (!useSSE) {
     // STDIO Mode (NPM Package Default)
     // In Stdio mode, we use the API key from environment variable
     const apiKey = process.env.VIEWGATE_API_KEY || process.env.API_KEY || "";
+    const personalKey = process.env.VIEWGATE_PERSONAL_KEY || "";
     if (!apiKey) {
         console.error("Error: VIEWGATE_API_KEY environment variable is required in STDIO mode.");
         process.exit(1);
     }
-    const server = createMcpServer(apiKey);
+    const server = createMcpServer(apiKey, personalKey);
     const transport = new StdioServerTransport();
     server.connect(transport).catch((error) => {
         console.error("Failed to start Stdio transport:", error);
@@ -373,12 +431,13 @@ else {
     });
     app.get("/sse", async (req, res) => {
         const apiKey = req.query.apiKey || req.headers['x-api-key'];
+        const personalKey = req.query.personalKey || req.headers['x-personal-key'];
         if (!apiKey) {
             res.status(401).send("API Key is required");
             return;
         }
         const transport = new SSEServerTransport("/message", res);
-        const server = createMcpServer(apiKey);
+        const server = createMcpServer(apiKey, personalKey);
         await server.connect(transport);
         const sessionId = transport.sessionId;
         sessions.set(sessionId, { server, transport });
@@ -394,6 +453,5 @@ else {
         await session.transport.handlePostMessage(req, res);
     });
     app.listen(port, () => {
-        console.log(`ViewGate MCP (SSE) listening on port ${port}`);
     });
 }

package/package.json

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