viewgate-mcp 1.0.21 → 1.0.23

package/dist/index.js

@@ -52,13 +52,16 @@ function createMcpServer(apiKey, personalKey) {
                     inputSchema: {
                         type: "object",
                         properties: {
-                            limit: { type: "number", description: "Maximum number of annotations to retrieve (default: 3)", default: 3 }
+                            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 (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: {
@@ -108,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: {
@@ -174,8 +177,20 @@ function createMcpServer(apiKey, personalKey) {
                 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}&limit=${limit}&lock=true`, {
+                    const statuses = args.status || 'pending,bug_fixing';
+                    const search = args.search || '';
+                    const key = args.key || '';
+                    const url = new URL(`${BACKEND_URL}/api/mcp/annotations`);
+                    if (statuses && statuses !== 'all')
+                        url.searchParams.append('status', statuses);
+                    if (limit)
+                        url.searchParams.append('limit', limit.toString());
+                    if (search)
+                        url.searchParams.append('search', search);
+                    if (key)
+                        url.searchParams.append('key', key);
+                    url.searchParams.append('lock', 'true');
+                    const response = await fetch(url.toString(), {
                         headers: {
                             'x-api-key': apiKey,
                             ...(personalKey ? { 'x-personal-key': personalKey } : {})
@@ -184,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,
@@ -253,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}` : ''}`
@@ -270,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),
                             },

package/package.json

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

package/dist/test_fix.js

@@ -1,59 +0,0 @@
-import fetch from "node-fetch";
-async function test() {
-    console.log("1. Connecting to http://localhost:3333/sse...");
-    const response = await fetch("http://localhost:3333/sse?apiKey=2af5628c9442f10b93cfe6970897d4de26578d958ba43a4e3bcb684fe0f92668");
-    if (!response.ok) {
-        console.error("Failed to connect to SSE:", response.status, await response.text());
-        return;
-    }
-    console.log("SSE connected. Reading stream for sessionId...");
-    const body = response.body;
-    let sessionId = null;
-    body.on("data", async (chunk) => {
-        const text = chunk.toString();
-        console.log("SSE Data:", text);
-        // Example event: 
-        // event: endpoint
-        // data: /message?sessionId=...
-        const match = text.match(/sessionId=([a-f0-9-]+)/);
-        if (match && !sessionId) {
-            sessionId = match[1];
-            console.log("FOUND SESSION ID:", sessionId);
-            // 2. Test POST to /message
-            console.log(`2. Testing POST to /message?sessionId=${sessionId}...`);
-            const postResponse = await fetch(`http://localhost:3333/message?sessionId=${sessionId}`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json'
-                },
-                body: JSON.stringify({
-                    jsonrpc: "2.0",
-                    id: 1,
-                    method: "initialize",
-                    params: {
-                        clientInfo: { name: "test-client", version: "1.0.0" },
-                        protocolVersion: "2024-11-05",
-                        capabilities: {}
-                    }
-                })
-            });
-            console.log("POST Response Status:", postResponse.status);
-            const responseText = await postResponse.text();
-            console.log("POST Response Body:", responseText);
-            if (postResponse.status === 200 || postResponse.status === 202) {
-                console.log("SUCCESS: Stream was readable and message was accepted.");
-            }
-            else {
-                console.error("FAILURE: Server returned error status.");
-            }
-            process.exit(0);
-        }
-    });
-    setTimeout(() => {
-        if (!sessionId) {
-            console.error("TIMEOUT: Did not receive sessionId from SSE.");
-            process.exit(1);
-        }
-    }, 10000);
-}
-test();

package/dist/test_sse.js

@@ -1,23 +0,0 @@
-import fetch from "node-fetch";
-async function test() {
-    console.log("Connecting to http://localhost:3333/sse...");
-    const response = await fetch("http://localhost:3333/sse?apiKey=test-key");
-    if (!response.ok) {
-        console.error("Failed to connect:", response.status, await response.text());
-        return;
-    }
-    console.log("Headers:", response.headers.raw());
-    const body = response.body;
-    body.on("data", (chunk) => {
-        console.log("Chunk received:", chunk.toString());
-        if (chunk.toString().includes("event: endpoint")) {
-            console.log("FOUND ENDPOINT EVENT!");
-        }
-    });
-    body.on("end", () => console.log("Connection closed"));
-    setTimeout(() => {
-        console.log("Closing test...");
-        process.exit(0);
-    }, 5000);
-}
-test();