@veracity/codeguardian-mcp 0.2.3 → 0.2.4

package/dist/index.js

@@ -5,7 +5,7 @@ import { createAuthenticator } from "./auth.js";
 import { configureAllTools } from "./tools.js";
 import { configurePrompts } from "./prompts.js";
 import { configureResources } from "./resources.js";
-const packageVersion = "0.2.3";
+const packageVersion = "0.2.4";
 try {
     const server = new McpServer({
         name: "CodeGuardian MCP Server",

package/dist/tools/search.d.ts

@@ -0,0 +1,2 @@
+export declare function configureSearchTools(server: any, tokenProvider: () => Promise<string>): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAmEA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,QA0FrF"}

package/dist/tools/search.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { VersionControlRecursionType } from "azure-devops-node-api/interfaces/GitInterfaces.js";
+import { getAzureDevOpsConnection } from '../utils.js';
+const apiVersion = "7.1";
+/**
+ * Fetches full file content for each search result by calling the Git API.
+ * The Code Search API only returns metadata; this enriches results with the
+ * actual file content at the matched commit so callers can read the code.
+ */
+async function fetchCombinedResults(topSearchResults, gitApi) {
+    const combinedResults = [];
+    for (const searchResult of topSearchResults) {
+        try {
+            const projectId = searchResult.project?.id;
+            const repositoryId = searchResult.repository?.id;
+            const filePath = searchResult.path;
+            const changeId = Array.isArray(searchResult.versions) && searchResult.versions.length > 0
+                ? searchResult.versions[0].changeId
+                : undefined;
+            if (!projectId || !repositoryId || !filePath || !changeId) {
+                combinedResults.push({
+                    error: `Missing projectId, repositoryId, filePath, or changeId in the result: ${JSON.stringify(searchResult)}`,
+                });
+                continue;
+            }
+            const versionDescriptor = changeId ? { version: changeId, versionType: 2, versionOptions: 0 } : undefined;
+            const item = await gitApi.getItem(repositoryId, filePath, projectId, undefined, VersionControlRecursionType.None, true, // includeContentMetadata
+            false, // latestProcessedChange
+            false, // download
+            versionDescriptor, true, // includeContent
+            true, // resolveLfs
+            true // sanitize
+            );
+            combinedResults.push({
+                gitItem: item,
+            });
+        }
+        catch (err) {
+            combinedResults.push({
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return combinedResults;
+}
+export function configureSearchTools(server, tokenProvider) {
+    server.tool("search_code", "Search Azure DevOps Repositories for a given search text. Returns matching files along with their content fetched from the repository at the matched commit.", {
+        organization: z.string().describe("Azure DevOps organization name (e.g., 'myorg')"),
+        searchText: z.string().describe("Keywords to search for in code repositories"),
+        project: z
+            .union([z.string().transform((value) => [value]), z.array(z.string())])
+            .describe("The project(s) to search within. Accepts a single project name or an array of project names. Required to scope the search for PR review."),
+        repository: z.array(z.string()).describe("The repository(ies) to search within. Required to scope the search for PR review."),
+        path: z.array(z.string()).optional().describe("Filter by paths"),
+        branch: z.array(z.string()).describe("The branch(es) to search within. Required to scope the search for PR review."),
+        includeFacets: z.boolean().default(false).describe("Include facets in the search results"),
+        skip: z.coerce.number().default(0).describe("Number of results to skip"),
+        top: z.coerce.number().default(5).describe("Maximum number of results to return"),
+    }, async (args) => {
+        try {
+            const { organization, searchText, project, repository, path, branch, includeFacets, skip, top } = args;
+            if (!organization || !searchText || !project || project.length === 0 || !repository || repository.length === 0 || !branch || branch.length === 0) {
+                throw new Error('Missing required parameters. Please provide organization, searchText, project, repository, and branch.');
+            }
+            const accessToken = await tokenProvider();
+            const connection = await getAzureDevOpsConnection(organization, tokenProvider);
+            const url = `https://almsearch.dev.azure.com/${organization}/_apis/search/codesearchresults?api-version=${apiVersion}`;
+            const requestBody = {
+                searchText,
+                includeFacets,
+                $skip: skip,
+                $top: top,
+            };
+            const filters = {};
+            if (project && project.length > 0)
+                filters.Project = project;
+            if (repository && repository.length > 0)
+                filters.Repository = repository;
+            if (path && path.length > 0)
+                filters.Path = path;
+            if (branch && branch.length > 0)
+                filters.Branch = branch;
+            if (Object.keys(filters).length > 0) {
+                requestBody.filters = filters;
+            }
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${accessToken}`,
+                },
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                throw new Error(`Azure DevOps Code Search API error: ${response.status} ${response.statusText}`);
+            }
+            const resultText = await response.text();
+            const resultJson = JSON.parse(resultText);
+            const gitApi = await connection.getGitApi();
+            const combinedResults = await fetchCombinedResults(resultJson.results ?? [], gitApi);
+            return {
+                content: [{ type: "text", text: resultText + JSON.stringify(combinedResults) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error searching code: ${errorMessage}`
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,2BAA2B,EAAW,MAAM,mDAAmD,CAAC;AACzG,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,UAAU,GAAG,KAAK,CAAC;AAYzB;;;;GAIG;AACH,KAAK,UAAU,oBAAoB,CAAC,gBAAgC,EAAE,MAAe;IACjF,MAAM,eAAe,GAAqB,EAAE,CAAC;IAC7C,KAAK,MAAM,YAAY,IAAI,gBAAgB,EAAE,CAAC;QAC1C,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC;YACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACrF,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;gBACnC,CAAC,CAAC,SAAS,CAAC;YAChB,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACxD,eAAe,CAAC,IAAI,CAAC;oBACjB,KAAK,EAAE,yEAAyE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE;iBACjH,CAAC,CAAC;gBACH,SAAS;YACb,CAAC;YAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAE1G,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAC7B,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,2BAA2B,CAAC,IAAI,EAChC,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,wBAAwB;YAC/B,KAAK,EAAE,WAAW;YAClB,iBAAiB,EACjB,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,aAAa;YACnB,IAAI,CAAC,WAAW;aACnB,CAAC;YACF,eAAe,CAAC,IAAI,CAAC;gBACjB,OAAO,EAAE,IAAI;aAChB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,eAAe,CAAC,IAAI,CAAC;gBACjB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAW,EAAE,aAAoC;IAClF,MAAM,CAAC,IAAI,CACP,aAAa,EACb,8JAA8J,EAC9J;QACI,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QACnF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC9E,OAAO,EAAE,CAAC;aACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;aACtE,QAAQ,CAAC,0IAA0I,CAAC;QACzJ,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,mFAAmF,CAAC;QAC7H,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAChE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,8EAA8E,CAAC;QACpH,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC1F,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACxE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACpF,EACD,KAAK,EAAE,IAUN,EAAE,EAAE;QACD,IAAI,CAAC;YACD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAEvG,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/I,MAAM,IAAI,KAAK,CAAC,wGAAwG,CAAC,CAAC;YAC9H,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,aAAa,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAC/E,MAAM,GAAG,GAAG,mCAAmC,YAAY,+CAA+C,UAAU,EAAE,CAAC;YAEvH,MAAM,WAAW,GAA4B;gBACzC,UAAU;gBACV,aAAa;gBACb,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,GAAG;aACZ,CAAC;YAEF,MAAM,OAAO,GAA6B,EAAE,CAAC;YAC7C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;YAC7D,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;YACzE,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACjD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;YAEzD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;YAClC,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACL,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,WAAW,EAAE;iBAC3C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;aACpC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACrG,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAiC,CAAC;YAE1E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,eAAe,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YAErF,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;aAClF,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACH,OAAO,EAAE,CAAC;wBACN,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yBAAyB,YAAY,EAAE;qBAChD,CAAC;gBACF,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAM/F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAS/F"}

package/dist/tools.js

@@ -1,9 +1,12 @@
 import { configureAdoTools } from "./tools/ado.js";
 import { configureAssaTools } from "./tools/assa.js";
+import { configureSearchTools } from "./tools/search.js";
 export function configureAllTools(server, tokenProvider) {
     // Configure Azure DevOps tools
     configureAdoTools(server, tokenProvider);
     // Configure ASSA tools
     configureAssaTools(server, tokenProvider);
+    // Configure search tools
+    configureSearchTools(server, tokenProvider);
 }
 //# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,aAAoC;IACvF,+BAA+B;IAC/B,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEzC,uBAAuB;IACvB,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,aAAoC;IACvF,+BAA+B;IAC/B,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEzC,uBAAuB;IACvB,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE1C,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veracity/codeguardian-mcp",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "A Model Context Protocol (MCP) server for CodeGuardian",
   "type": "module",
   "main": "dist/index.js",