viewgate-mcp 1.0.22 → 1.0.24

package/dist/index.js

@@ -53,13 +53,15 @@ function createMcpServer(apiKey, personalKey) {
                         type: "object",
                         properties: {
                             limit: { type: "number", description: "Maximum number of annotations to retrieve (default: 3)", default: 3 },
-                            status: { type: "string", description: "Comma-separated list of statuses to fetch (default: 'pending,bug_fixing')", default: "pending,bug_fixing" }
+                            status: { type: "string", description: "Comma-separated list of statuses to fetch (e.g. 'pending,bug_fixing,in_progress'). Use 'all' to fetch from any state.", default: "pending,bug_fixing" },
+                            search: { type: "string", description: "Search term to filter annotations by text in message or file paths." },
+                            key: { type: "string", description: "Human-readable key (e.g. VG-B62B4E) to find a specific annotation ID." }
                         },
                     },
                 },
                 {
                     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. DO NOT use English if the preferred language is Spanish.",
+                    description: "CRITICAL: Call this tool AFTER applying code fixes for annotations. It marks tickets as 'Ready for Review'. REQUIREMENT: Use the internal database ID (e.g. 675ba...), NOT the human key (VG-XXXX). If you only have the key, use 'get_annotations' with 'key' filter first. IMPORTANT: The 'appliedChanges' summary MUST be written in the 'preferredLanguage' specified by 'get_annotations'.",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -109,7 +111,7 @@ function createMcpServer(apiKey, personalKey) {
                 },
                 {
                     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.). IMPORTANT: The 'description' for each endpoint MUST be written in the project's preferred language (e.g., Spanish if preferredLanguage is 'es').",
+                    description: "Manually synchronizes backend endpoints. Call ONLY if the user explicitly asks to 'sync endpoints' or 'update routes'. DO NOT call this automatically during other workflows.",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -176,7 +178,19 @@ function createMcpServer(apiKey, personalKey) {
                     const args = request.params.arguments;
                     const limit = args.limit || 3;
                     const statuses = args.status || 'pending,bug_fixing';
-                    const response = await fetch(`${BACKEND_URL}/api/mcp/annotations?status=${statuses}&limit=${limit}&lock=true`, {
+                    const search = args.search || '';
+                    const key = args.key || '';
+                    let fetchUrl = `${BACKEND_URL}/api/mcp/annotations?lock=true`;
+                    if (statuses && statuses !== 'all')
+                        fetchUrl += `&status=${statuses}`;
+                    if (limit)
+                        fetchUrl += `&limit=${limit}`;
+                    if (search)
+                        fetchUrl += `&search=${encodeURIComponent(search)}`;
+                    if (key)
+                        fetchUrl += `&key=${encodeURIComponent(key)}`;
+                    console.error(`[MCP] Fetching annotations from: ${fetchUrl}`);
+                    const response = await fetch(fetchUrl, {
                         headers: {
                             'x-api-key': apiKey,
                             ...(personalKey ? { 'x-personal-key': personalKey } : {})
@@ -185,14 +199,24 @@ function createMcpServer(apiKey, personalKey) {
                     if (!response.ok) {
                         throw new Error(`Backend responded with ${response.status}`);
                     }
-                    const data = (await response.json());
-                    const rawAnnotations = Array.isArray(data) ? data : (data?.data || data?.annotations || []);
+                    const rawData = (await response.json());
+                    let rawAnnotations = Array.isArray(rawData) ? rawData : (rawData?.data || rawData?.annotations || []);
                     if (!Array.isArray(rawAnnotations)) {
                         return {
-                            content: [{ type: "text", text: "Error: Invalid format" }],
+                            content: [{ type: "text", text: "Error: Invalid format from backend" }],
                             isError: true
                         };
                     }
+                    // Local filtering fallback for search and key (in case backend doesn't support them yet)
+                    if (search) {
+                        const lowSearch = search.toLowerCase();
+                        rawAnnotations = rawAnnotations.filter((ann) => (ann.message && ann.message.toLowerCase().includes(lowSearch)) ||
+                            (ann.reference?.source && ann.reference.source.toLowerCase().includes(lowSearch)) ||
+                            (ann.key && ann.key.toLowerCase().includes(lowSearch)));
+                    }
+                    if (key) {
+                        rawAnnotations = rawAnnotations.filter((ann) => ann.key === key || ann._id === key);
+                    }
                     const priorityMap = {
                         'urgente': 4,
                         'urgent': 4,
@@ -254,13 +278,13 @@ The user has requested the following corrections:
 ${pendingCorrection.author ? `Requested by: ${pendingCorrection.author.name}` : ''}
 PLEASE ENSURE THESE SPECIFIC ISSUES ARE ADDRESSED IN YOUR FIX.` : ''}
 
-### 🔬 SURGICAL FIX PROTOCOL (Language: ${data.preferredLanguage || 'en'})
+### 🔬 SURGICAL FIX PROTOCOL (Language: ${rawData.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'}.
+IMPORTANT: All your analysis and implementation comments MUST BE IN ${rawData.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}${pendingCorrection ? `\nCorrection Needed: ${pendingCorrection.text}` : ''}`
@@ -271,7 +295,7 @@ Instruction: ${ann.message}${pendingCorrection ? `\nCorrection Needed: ${pending
                             {
                                 type: "text",
                                 text: JSON.stringify({
-                                    preferredLanguage: data.preferredLanguage || 'en',
+                                    preferredLanguage: rawData.preferredLanguage || 'en',
                                     annotations: annotationsWithTips
                                 }, null, 2),
                             },
@@ -344,12 +368,13 @@ Instruction: ${ann.message}${pendingCorrection ? `\nCorrection Needed: ${pending
                             throw new Error(`Backend responded with ${response.status}`);
                         }
                         const data = (await response.json());
+                        const backlogNodes = Array.isArray(data) ? data : (data.data || data.backlog || []);
                         return {
                             content: [{
                                     type: "text",
                                     text: JSON.stringify({
                                         preferredLanguage: data.preferredLanguage || 'en',
-                                        backlog: data.data || []
+                                        backlog: backlogNodes
                                     }, null, 2)
                                 }]
                         };
@@ -427,10 +452,11 @@ Instruction: ${ann.message}${pendingCorrection ? `\nCorrection Needed: ${pending
                         throw new Error(`Backend responded with ${response.status}`);
                     }
                     const data = (await response.json());
+                    const endpointsList = Array.isArray(data) ? data : (data.endpoints || data.routes || data.data || []);
                     return {
                         content: [{
                                 type: "text",
-                                text: JSON.stringify(data.endpoints || [], null, 2)
+                                text: JSON.stringify(endpointsList, null, 2)
                             }]
                     };
                 }

package/package.json

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