viewgate-mcp 1.0.27 → 1.0.29

package/dist/index.js

@@ -48,16 +48,16 @@ function createMcpServer(apiKey, personalKey) {
             tools: [
                 {
                     name: "get_annotations",
-                    description: "Retrieves all feedback annotations. Use 'status' to filter (e.g. 'pending,bug_fixing'). WORKFLOW: 1. Read these annotations, 2. Open the source files and apply SURGICAL fixes. 3. Call 'mark_annotation_ready' for EACH ticket. IMPORTANT: Tickets already resolved by the AI in the current sprint are automatically filtered out to prevent redundant work.",
+                    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.",
                     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, automatically increased if specific keys are provided)", default: 3 },
                             status: { type: "string", description: "Comma-separated list (e.g. 'pending,bug_fixing'). Use 'all' for any state.", 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 to find specific annotations." },
-                            ids: { type: "string", description: "Comma-separated internal IDs 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." }
                         },
                     },
                 },
@@ -192,14 +192,17 @@ function createMcpServer(apiKey, personalKey) {
                         fetchUrl += `&key=${encodeURIComponent(combinedKey)}`;
                     if (idsToFetch)
                         fetchUrl += `&ids=${encodeURIComponent(idsToFetch)}`;
+                    console.error(`[MCP] Fetching: ${fetchUrl}`);
                     const response = await fetch(fetchUrl, {
                         headers: {
                             'x-api-key': apiKey,
                             ...(personalKey ? { 'x-personal-key': personalKey } : {})
                         }
                     });
-                    if (!response.ok)
-                        throw new Error(`Backend responded with ${response.status}`);
+                    if (!response.ok) {
+                        const errorBody = await response.text();
+                        throw new Error(`Backend responded with ${response.status}: ${errorBody}`);
+                    }
                     const rawData = (await response.json());
                     let rawAnnotations = Array.isArray(rawData) ? rawData : (rawData?.data || rawData?.annotations || []);
                     if (!Array.isArray(rawAnnotations)) {
@@ -268,13 +271,16 @@ Instruction: ${ann.message}`
                 case "mark_annotation_ready": {
                     const args = request.params.arguments;
                     console.error(`[MCP] Marking ${args.results.length} annotations as ready.`);
+                    console.error(`[MCP] Batch ready update: ${BACKEND_URL}/api/mcp/annotations/batch-ready`);
                     const response = await fetch(`${BACKEND_URL}/api/mcp/annotations/batch-ready`, {
                         method: 'PATCH',
                         headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey, ...(personalKey ? { 'x-personal-key': personalKey } : {}) },
                         body: JSON.stringify({ results: args.results })
                     });
-                    if (!response.ok)
-                        throw new Error(`Backend responded with ${response.status}`);
+                    if (!response.ok) {
+                        const errorBody = await response.text();
+                        throw new Error(`Backend responded with ${response.status}: ${errorBody}`);
+                    }
                     const result = await response.json();
                     return { content: [{ type: "text", text: `Processed: ${JSON.stringify(result, null, 2)}` }] };
                 }

package/package.json

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