viewgate-mcp 1.0.35 → 1.0.37

package/dist/index.js

@@ -51,22 +51,22 @@ function createMcpServer(apiKey, personalKey) {
             tools: [
                 {
                     name: "get_annotations",
-                    description: "Retrieves feedback annotations. You can fetch specific tickets by providing their human keys (e.g., 'VG-XXXX') or internal IDs. By default, it returns pending annotations for the current sprint. WORKFLOW: 1. Fetch annotations, 2. Apply surgical fixes, 3. Mark as ready.",
+                    description: "Fetch feedback. Keys ('VG-XXXX') or IDs. Workflow: 1. Fetch, 2. Fix, 3. Mark Ready.",
                     inputSchema: {
                         type: "object",
                         properties: {
-                            limit: { type: "number", description: "Maximum number of annotations to retrieve (default: 3, automatically increased if specific keys are provided)", default: 3 },
-                            status: { type: "string", description: "Comma-separated list (e.g. 'pending,bug_fixing'). Only 'pending' and 'bug_fixing' are allowed for MCP resolution flow.", default: "pending,bug_fixing" },
-                            search: { type: "string", description: "Search term to filter by message or file." },
-                            key: { type: "string", description: "Human key (e.g. VG-XXXX) or comma-separated keys to find specific annotations." },
-                            keys: { type: "array", items: { type: "string" }, description: "List of human keys (e.g. VG-XXXX) to find specific annotations." },
-                            ids: { type: "string", description: "Comma-separated internal database IDs." }
+                            limit: { type: "number", description: "Max results.", default: 3 },
+                            status: { type: "string", description: "Comma list (pending,bug_fixing).", default: "pending,bug_fixing" },
+                            search: { type: "string", description: "Search message/file." },
+                            key: { type: "string", description: "VG-XXXX key." },
+                            keys: { type: "array", items: { type: "string" }, description: "Keys array." },
+                            ids: { type: "string", description: "Internal IDs." }
                         },
                     },
                 },
                 {
                     name: "mark_annotation_ready",
-                    description: "CRITICAL: Call this tool AFTER applying code fixes. This also registers the tickets as resolved by the AI for the current sprint to avoid re-fetching them. REQUIREMENT: Use the internal database ID (e.g. 675ba...), NOT the human key (VG-XXXX).",
+                    description: "Mark as ready/applied. Use internal IDs.",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -75,8 +75,8 @@ function createMcpServer(apiKey, personalKey) {
                                 items: {
                                     type: "object",
                                     properties: {
-                                        id: { type: "string", description: "The ID of the annotation to mark as ready" },
-                                        appliedChanges: { type: "string", description: "Descriptive summary of changes in the preferredLanguage." }
+                                        id: { type: "string", description: "Internal ID." },
+                                        appliedChanges: { type: "string", description: "Summary." }
                                     },
                                     required: ["id", "appliedChanges"]
                                 }
@@ -87,14 +87,14 @@ function createMcpServer(apiKey, personalKey) {
                 },
                 {
                     name: "mark_annotations_as_live",
-                    description: "Transitions annotations from 'applied' (local fix) to 'ready_for_review' (live on server). Call this tool ONLY after you have successfully deployed/uploaded your code changes.",
+                    description: "Mark as live (ready_for_review). IDs required.",
                     inputSchema: {
                         type: "object",
                         properties: {
                             ids: {
                                 type: "array",
                                 items: { type: "string" },
-                                description: "List of internal database IDs to mark as live."
+                                description: "Internal IDs."
                             }
                         },
                         required: ["ids"]
@@ -282,23 +282,21 @@ function createMcpServer(apiKey, personalKey) {
                             componentName: ann.componentName,
                             figmaReference: ann.figmaReference,
                             backendEndpoints: ann.backendEndpoints || [],
-                            _ia_fix_instruction: `### 🎯 DESIGN CONTEXT (Figma)
-${figmaLinks ? `Design references: ${figmaLinks}` : 'No explicit design linked.'}
-
-${ann.backendEndpoints?.length ? `### 🔌 BACKEND CONTEXT\nRelated endpoints: ${ann.backendEndpoints.join(', ')}` : ''}
-
-${ann.corrections && Array.isArray(ann.corrections) && ann.corrections.length > 0 ? `### ⚠️ CORRECTION HISTORY\n${ann.corrections.map((c, i) => `Correction ${i + 1}: "${c.text}" (Status: ${c.status})`).join('\n')}` : ''}
-
-### 🔬 FIX PROTOCOL
-1. **Target**: \`data-vg-id="${ann.reference?.vgId}"\` in \`${file}\`.
-2. **Context**: \`${ann.reference?.parentContext?.slice(0, 50)}...\`
-
-IMPORTANT: Respond in ${rawData.preferredLanguage === 'es' ? 'SPANISH' : 'ENGLISH'}.
-Instruction: ${ann.message}`
+                            _ia_fix_instruction: `[AUTONOMOUS_MODE: TRUE]
+Target: ${file} (data-vg-id="${ann.reference?.vgId}")
+Context: ${ann.reference?.parentContext?.slice(0, 40)}...
+${figmaLinks ? `Figma: ${figmaLinks}` : ''}
+${ann.backendEndpoints?.length ? `Endpoints: ${ann.backendEndpoints.join(', ')}` : ''}
+${ann.corrections && Array.isArray(ann.corrections) && ann.corrections.length > 0 ? `Feedback: ${ann.corrections[ann.corrections.length - 1].text}` : ''}
+Task: ${ann.message}
+Lang: ${rawData.preferredLanguage === 'es' ? 'ES' : 'EN'}`
                         };
                     });
+                    const langHint = rawData.preferredLanguage === 'es'
+                        ? "[INSTRUCTION: Project is in SPANISH. Provide all comments and aiAnalysis in SPANISH.]\n\n"
+                        : "[INSTRUCTION: Provide all comments and aiAnalysis in English.]\n\n";
                     return {
-                        content: [{ type: "text", text: JSON.stringify({ preferredLanguage: rawData.preferredLanguage || 'en', annotations: annotationsWithTips }, null, 2) }],
+                        content: [{ type: "text", text: langHint + JSON.stringify({ preferredLanguage: rawData.preferredLanguage || 'en', annotations: annotationsWithTips }, null, 2) }],
                     };
                 }
                 case "mark_annotation_ready": {
@@ -318,7 +316,7 @@ Instruction: ${ann.message}`
                     });
                     if (!response.ok)
                         throw new Error(`Backend responded with ${response.status}`);
-                    const data = await response.json();
+                    const data = (await response.json());
                     return {
                         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
                     };
@@ -338,7 +336,7 @@ Instruction: ${ann.message}`
                     });
                     if (!response.ok)
                         throw new Error(`Backend responded with ${response.status}`);
-                    const data = await response.json();
+                    const data = (await response.json());
                     return {
                         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
                     };
@@ -354,8 +352,11 @@ Instruction: ${ann.message}`
                     });
                     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) }] };
+                    const data = (await response.json());
+                    const langHint = data.preferredLanguage === 'es'
+                        ? "[INSTRUCTION: Project is in SPANISH. Provide all comments and aiAnalysis in SPANISH.]\n\n"
+                        : (data.preferredLanguage === 'en' ? "[INSTRUCTION: Provide all comments and aiAnalysis in English.]\n\n" : "");
+                    return { content: [{ type: "text", text: langHint + JSON.stringify(data, null, 2) }] };
                 }
                 case "sync_endpoints": {
                     const args = request.params.arguments;
@@ -375,7 +376,7 @@ Instruction: ${ann.message}`
                     });
                     if (!response.ok)
                         throw new Error(`Backend responded with ${response.status}`);
-                    const data = await response.json();
+                    const data = (await response.json());
                     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
                 }
                 case "get_ai_resolved_tickets": {
@@ -384,8 +385,11 @@ Instruction: ${ann.message}`
                     });
                     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) }] };
+                    const data = (await response.json());
+                    const langHint = data.preferredLanguage === 'es'
+                        ? "[INSTRUCTION: Project is in SPANISH. Provide all comments and aiAnalysis in SPANISH.]\n\n"
+                        : (data.preferredLanguage === 'en' ? "[INSTRUCTION: Provide all comments and aiAnalysis in English.]\n\n" : "");
+                    return { content: [{ type: "text", text: langHint + JSON.stringify(data, null, 2) }] };
                 }
                 default:
                     throw new Error("Unknown tool");

package/package.json

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