mcp-server-azure-devops 1.1.0

package/dist/features/projects/list-projects/feature.js

@@ -0,0 +1,22 @@
+import { AzureDevOpsError } from '../../../shared/errors';
+/**
+ * List all projects in the organization
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param options Optional parameters for listing projects
+ * @returns Array of projects
+ */
+export async function listProjects(connection, options = {}) {
+    try {
+        const coreApi = await connection.getCoreApi();
+        const projects = await coreApi.getProjects(options.stateFilter, options.top, options.skip, options.continuationToken);
+        return projects;
+    }
+    catch (error) {
+        if (error instanceof AzureDevOpsError) {
+            throw error;
+        }
+        throw new Error(`Failed to list projects: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=feature.js.map

package/dist/features/projects/list-projects/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/features/projects/list-projects/feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,UAA+B,EAAE;IAEjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CACxC,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,iBAAiB,CAC1B,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/features/projects/list-projects/feature.spec.int.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/projects/list-projects/feature.spec.int.js

@@ -0,0 +1,52 @@
+import { listProjects } from './feature';
+import { getTestConnection, shouldSkipIntegrationTest, } from '@/shared/test/test-helpers';
+const shouldSkip = shouldSkipIntegrationTest();
+const describeOrSkip = shouldSkip ? describe.skip : describe;
+describeOrSkip('listProjects integration', () => {
+    let connection;
+    beforeAll(async () => {
+        // Get a real connection using environment variables
+        const testConnection = await getTestConnection();
+        if (!testConnection) {
+            throw new Error('Connection should be available when integration tests are enabled');
+        }
+        connection = testConnection;
+    });
+    test('should list projects in the organization', async () => {
+        // Act - make an actual API call to Azure DevOps
+        const result = await listProjects(connection);
+        // Assert on the actual response
+        expect(result).toBeDefined();
+        expect(Array.isArray(result)).toBe(true);
+        // Check structure of returned items (even if empty)
+        if (result.length > 0) {
+            const firstProject = result[0];
+            expect(firstProject.id).toBeDefined();
+            expect(firstProject.name).toBeDefined();
+            expect(firstProject.url).toBeDefined();
+            expect(firstProject.state).toBeDefined();
+        }
+    });
+    test('should apply pagination options', async () => {
+        const options = {
+            top: 2, // Only get up to 2 projects
+        };
+        // Act - make an actual API call to Azure DevOps
+        const result = await listProjects(connection, options);
+        // Assert on the actual response
+        expect(result).toBeDefined();
+        expect(Array.isArray(result)).toBe(true);
+        expect(result.length).toBeLessThanOrEqual(2);
+        // If we have projects, check for correct limit
+        if (result.length > 0) {
+            // Get all projects to compare
+            const allProjects = await listProjects(connection);
+            // If we have more than 2 total projects, pagination should have limited results
+            if (allProjects.length > 2) {
+                expect(result.length).toBe(2);
+                expect(result.length).toBeLessThan(allProjects.length);
+            }
+        }
+    });
+});
+//# sourceMappingURL=feature.spec.int.js.map

package/dist/features/projects/list-projects/feature.spec.int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.spec.int.js","sourceRoot":"","sources":["../../../../src/features/projects/list-projects/feature.spec.int.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAGpC,MAAM,UAAU,GAAG,yBAAyB,EAAE,CAAC;AAC/C,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAE7D,cAAc,CAAC,0BAA0B,EAAE,GAAG,EAAE;IAC9C,IAAI,UAAkB,CAAC;IAEvB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,oDAAoD;QACpD,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,UAAU,GAAG,cAAc,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QAC1D,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;QAE9C,gCAAgC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzC,oDAAoD;QACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAwB;YACnC,GAAG,EAAE,CAAC,EAAE,4BAA4B;SACrC,CAAC;QAEF,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEvD,gCAAgC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QAE7C,+CAA+C;QAC/C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,8BAA8B;YAC9B,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;YAEnD,gFAAgF;YAChF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/features/projects/list-projects/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './feature';

package/dist/features/projects/list-projects/index.js

@@ -0,0 +1,3 @@
+export * from './schema';
+export * from './feature';
+//# sourceMappingURL=index.js.map

package/dist/features/projects/list-projects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/projects/list-projects/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/features/projects/list-projects/schema.d.ts

@@ -0,0 +1,2 @@
+import { ListProjectsSchema } from '../schemas';
+export { ListProjectsSchema };

package/dist/features/projects/list-projects/schema.js

@@ -0,0 +1,3 @@
+import { ListProjectsSchema } from '../schemas';
+export { ListProjectsSchema };
+//# sourceMappingURL=schema.js.map

package/dist/features/projects/list-projects/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/projects/list-projects/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/features/projects/schemas.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+/**
+ * Schema for getting a project
+ */
+export declare const GetProjectSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}, {
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}>;
+/**
+ * Schema for getting detailed project information
+ */
+export declare const GetProjectDetailsSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    includeProcess: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeWorkItemTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeFields: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeTeams: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    expandTeamIdentity: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    includeProcess: boolean;
+    includeWorkItemTypes: boolean;
+    includeFields: boolean;
+    includeTeams: boolean;
+    expandTeamIdentity: boolean;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}, {
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    includeProcess?: boolean | undefined;
+    includeWorkItemTypes?: boolean | undefined;
+    includeFields?: boolean | undefined;
+    includeTeams?: boolean | undefined;
+    expandTeamIdentity?: boolean | undefined;
+}>;
+/**
+ * Schema for listing projects
+ */
+export declare const ListProjectsSchema: z.ZodObject<{
+    organizationId: z.ZodOptional<z.ZodString>;
+    stateFilter: z.ZodOptional<z.ZodNumber>;
+    top: z.ZodOptional<z.ZodNumber>;
+    skip: z.ZodOptional<z.ZodNumber>;
+    continuationToken: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    organizationId?: string | undefined;
+    top?: number | undefined;
+    skip?: number | undefined;
+    stateFilter?: number | undefined;
+    continuationToken?: number | undefined;
+}, {
+    organizationId?: string | undefined;
+    top?: number | undefined;
+    skip?: number | undefined;
+    stateFilter?: number | undefined;
+    continuationToken?: number | undefined;
+}>;

package/dist/features/projects/schemas.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { defaultProject, defaultOrg } from '../../utils/environment';
+/**
+ * Schema for getting a project
+ */
+export const GetProjectSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+});
+/**
+ * Schema for getting detailed project information
+ */
+export const GetProjectDetailsSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    includeProcess: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include process information in the project result'),
+    includeWorkItemTypes: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include work item types and their structure'),
+    includeFields: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include field information for work item types'),
+    includeTeams: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include associated teams in the project result'),
+    expandTeamIdentity: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Expand identity information in the team objects'),
+});
+/**
+ * Schema for listing projects
+ */
+export const ListProjectsSchema = z.object({
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    stateFilter: z
+        .number()
+        .optional()
+        .describe('Filter on team project state (0: all, 1: well-formed, 2: creating, 3: deleting, 4: new)'),
+    top: z.number().optional().describe('Maximum number of projects to return'),
+    skip: z.number().optional().describe('Number of projects to skip'),
+    continuationToken: z
+        .number()
+        .optional()
+        .describe('Gets the projects after the continuation token provided'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/features/projects/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/features/projects/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,cAAc,GAAG,CAAC;IACzE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,UAAU,GAAG,CAAC;CAC3E,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,cAAc,GAAG,CAAC;IACzE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,UAAU,GAAG,CAAC;IAC1E,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,mDAAmD,CAAC;IAChE,oBAAoB,EAAE,CAAC;SACpB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,YAAY,EAAE,CAAC;SACZ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,kBAAkB,EAAE,CAAC;SAClB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,iDAAiD,CAAC;CAC/D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,UAAU,GAAG,CAAC;IAC1E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;IACH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAClE,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC"}

package/dist/features/projects/tool-definitions.d.ts

@@ -0,0 +1,5 @@
+import { ToolDefinition } from '../../shared/types/tool-definition';
+/**
+ * List of projects tools
+ */
+export declare const projectsTools: ToolDefinition[];

package/dist/features/projects/tool-definitions.js

@@ -0,0 +1,23 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ListProjectsSchema, GetProjectSchema, GetProjectDetailsSchema, } from './schemas';
+/**
+ * List of projects tools
+ */
+export const projectsTools = [
+    {
+        name: 'list_projects',
+        description: 'List all projects in an organization',
+        inputSchema: zodToJsonSchema(ListProjectsSchema),
+    },
+    {
+        name: 'get_project',
+        description: 'Get details of a specific project',
+        inputSchema: zodToJsonSchema(GetProjectSchema),
+    },
+    {
+        name: 'get_project_details',
+        description: 'Get comprehensive details of a project including process, work item types, and teams',
+        inputSchema: zodToJsonSchema(GetProjectDetailsSchema),
+    },
+];
+//# sourceMappingURL=tool-definitions.js.map

package/dist/features/projects/tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definitions.js","sourceRoot":"","sources":["../../../src/features/projects/tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,eAAe,CAAC,kBAAkB,CAAC;KACjD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,mCAAmC;QAChD,WAAW,EAAE,eAAe,CAAC,gBAAgB,CAAC;KAC/C;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,sFAAsF;QACxF,WAAW,EAAE,eAAe,CAAC,uBAAuB,CAAC;KACtD;CACF,CAAC"}

package/dist/features/projects/types.d.ts

@@ -0,0 +1,11 @@
+import { TeamProject } from 'azure-devops-node-api/interfaces/CoreInterfaces';
+/**
+ * Options for listing projects
+ */
+export interface ListProjectsOptions {
+    stateFilter?: number;
+    top?: number;
+    skip?: number;
+    continuationToken?: number;
+}
+export type { TeamProject };

package/dist/features/projects/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/projects/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/projects/types.ts"],"names":[],"mappings":""}

package/dist/features/pull-requests/add-pull-request-comment/feature.d.ts

@@ -0,0 +1,13 @@
+import { WebApi } from 'azure-devops-node-api';
+import { AddPullRequestCommentOptions, AddCommentResponse } from '../types';
+/**
+ * Add a comment to a pull request
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param projectId The ID or name of the project
+ * @param repositoryId The ID or name of the repository
+ * @param pullRequestId The ID of the pull request
+ * @param options Options for adding the comment
+ * @returns The created comment or thread
+ */
+export declare function addPullRequestComment(connection: WebApi, projectId: string | undefined, repositoryId: string | undefined, pullRequestId: number, options: AddPullRequestCommentOptions): Promise<AddCommentResponse>;

package/dist/features/pull-requests/add-pull-request-comment/feature.js

@@ -0,0 +1,127 @@
+import { CommentThreadStatus, CommentType, } from 'azure-devops-node-api/interfaces/GitInterfaces';
+import { AzureDevOpsError } from '../../../shared/errors';
+import { transformCommentThreadStatus, transformCommentType, } from '../../../shared/enums';
+/**
+ * Add a comment to a pull request
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param projectId The ID or name of the project
+ * @param repositoryId The ID or name of the repository
+ * @param pullRequestId The ID of the pull request
+ * @param options Options for adding the comment
+ * @returns The created comment or thread
+ */
+export async function addPullRequestComment(connection, projectId, repositoryId, pullRequestId, options) {
+    try {
+        const gitApi = await connection.getGitApi();
+        const project = projectId || undefined;
+        let resolvedRepositoryId = repositoryId;
+        if (!resolvedRepositoryId) {
+            const pr = await gitApi.getPullRequestById(pullRequestId, project);
+            resolvedRepositoryId = pr?.repository?.id;
+        }
+        if (!resolvedRepositoryId) {
+            throw new Error('repositoryId is required (or must be derivable from pullRequestId)');
+        }
+        // Create comment object
+        const comment = {
+            content: options.content,
+            commentType: CommentType.Text, // Default to Text type
+            parentCommentId: options.parentCommentId,
+        };
+        // Case 1: Add comment to an existing thread
+        if (options.threadId) {
+            const createdComment = await gitApi.createComment(comment, resolvedRepositoryId, pullRequestId, options.threadId, project);
+            if (!createdComment) {
+                throw new Error('Failed to create pull request comment');
+            }
+            return {
+                comment: {
+                    ...createdComment,
+                    commentType: transformCommentType(createdComment.commentType),
+                },
+            };
+        }
+        // Case 2: Create new thread with comment
+        else {
+            // Map status string to CommentThreadStatus enum
+            let threadStatus;
+            if (options.status) {
+                switch (options.status) {
+                    case 'active':
+                        threadStatus = CommentThreadStatus.Active;
+                        break;
+                    case 'fixed':
+                        threadStatus = CommentThreadStatus.Fixed;
+                        break;
+                    case 'wontFix':
+                        threadStatus = CommentThreadStatus.WontFix;
+                        break;
+                    case 'closed':
+                        threadStatus = CommentThreadStatus.Closed;
+                        break;
+                    case 'pending':
+                        threadStatus = CommentThreadStatus.Pending;
+                        break;
+                    case 'byDesign':
+                        threadStatus = CommentThreadStatus.ByDesign;
+                        break;
+                    case 'unknown':
+                        threadStatus = CommentThreadStatus.Unknown;
+                        break;
+                }
+            }
+            // Create thread with comment
+            const thread = {
+                comments: [comment],
+                status: threadStatus,
+            };
+            // Add file context if specified (file comment)
+            if (options.filePath) {
+                thread.threadContext = {
+                    filePath: options.filePath,
+                    // Only add line information if provided
+                    rightFileStart: options.lineNumber
+                        ? {
+                            line: options.lineNumber,
+                            offset: 1, // Default to start of line
+                        }
+                        : undefined,
+                    rightFileEnd: options.lineNumber
+                        ? {
+                            line: options.lineNumber,
+                            offset: 1, // Default to start of line
+                        }
+                        : undefined,
+                };
+            }
+            const createdThread = await gitApi.createThread(thread, resolvedRepositoryId, pullRequestId, project);
+            if (!createdThread ||
+                !createdThread.comments ||
+                createdThread.comments.length === 0) {
+                throw new Error('Failed to create pull request comment thread');
+            }
+            return {
+                comment: {
+                    ...createdThread.comments[0],
+                    commentType: transformCommentType(createdThread.comments[0].commentType),
+                },
+                thread: {
+                    ...createdThread,
+                    status: transformCommentThreadStatus(createdThread.status),
+                    comments: createdThread.comments?.map((comment) => ({
+                        ...comment,
+                        commentType: transformCommentType(comment.commentType),
+                    })),
+                },
+            };
+        }
+    }
+    catch (error) {
+        if (error instanceof AzureDevOpsError) {
+            throw error;
+        }
+        throw new Error(`Failed to add pull request comment: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=feature.js.map

package/dist/features/pull-requests/add-pull-request-comment/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/features/pull-requests/add-pull-request-comment/feature.ts"],"names":[],"mappings":"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"}

package/dist/features/pull-requests/add-pull-request-comment/feature.spec.int.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/pull-requests/add-pull-request-comment/feature.spec.int.js

@@ -0,0 +1,184 @@
+import { ItemContentType, VersionControlChangeType, } from 'azure-devops-node-api/interfaces/GitInterfaces';
+import { addPullRequestComment } from './feature';
+import { createPullRequest } from '../create-pull-request/feature';
+import { getTestConnection, shouldSkipIntegrationTest, } from '@/shared/test/test-helpers';
+const shouldSkip = shouldSkipIntegrationTest();
+const describeOrSkip = shouldSkip ? describe.skip : describe;
+describeOrSkip('addPullRequestComment integration', () => {
+    let connection;
+    let projectName;
+    let repositoryId;
+    let defaultBranchRef;
+    let pullRequestId;
+    let changedFilePath;
+    const timestamp = Date.now();
+    const randomSuffix = Math.floor(Math.random() * 1000);
+    const uniqueBranchName = `comment-test-branch-${timestamp}-${randomSuffix}`;
+    beforeAll(async () => {
+        projectName = process.env.AZURE_DEVOPS_DEFAULT_PROJECT || '';
+        if (!projectName) {
+            throw new Error('AZURE_DEVOPS_DEFAULT_PROJECT must be set for this test');
+        }
+        const testConnection = await getTestConnection();
+        if (!testConnection) {
+            throw new Error('Connection should be available when integration tests are enabled');
+        }
+        connection = testConnection;
+        const gitApi = await connection.getGitApi();
+        repositoryId = process.env.AZURE_DEVOPS_DEFAULT_REPOSITORY || '';
+        if (!repositoryId) {
+            const repos = await gitApi.getRepositories(projectName);
+            if (!repos || repos.length === 0 || !repos[0].id) {
+                throw new Error('No repositories found. Set AZURE_DEVOPS_DEFAULT_REPOSITORY to run pull request integration tests.');
+            }
+            repositoryId = repos[0].id;
+        }
+        const repository = await gitApi.getRepository(repositoryId, projectName);
+        defaultBranchRef = repository.defaultBranch || 'refs/heads/main';
+        // Find the latest commit on the default branch
+        const defaultBranchName = defaultBranchRef.replace('refs/heads/', '');
+        const commits = await gitApi.getCommits(repositoryId, {
+            $top: 1,
+            itemVersion: {
+                version: defaultBranchName,
+                versionType: 0,
+            },
+        }, projectName);
+        if (!commits || commits.length === 0 || !commits[0].commitId) {
+            throw new Error('No commits found in repository');
+        }
+        const baseCommitId = commits[0].commitId;
+        // Create the branch
+        const refUpdate = {
+            name: `refs/heads/${uniqueBranchName}`,
+            oldObjectId: '0000000000000000000000000000000000000000',
+            newObjectId: baseCommitId,
+        };
+        const updateResult = await gitApi.updateRefs([refUpdate], repositoryId, projectName);
+        if (!updateResult ||
+            updateResult.length === 0 ||
+            !updateResult[0].success) {
+            throw new Error('Failed to create new branch');
+        }
+        // Add a commit that introduces a new file so we can comment on it
+        changedFilePath = `/mcp-pr-comment-test-${timestamp}.md`;
+        await gitApi.createPush({
+            refUpdates: [
+                {
+                    name: `refs/heads/${uniqueBranchName}`,
+                    oldObjectId: baseCommitId,
+                },
+            ],
+            commits: [
+                {
+                    comment: 'Add file for PR comment integration tests',
+                    changes: [
+                        {
+                            changeType: VersionControlChangeType.Add,
+                            item: { path: changedFilePath },
+                            newContent: {
+                                content: `# Test File\n\nCreated at ${new Date().toISOString()}\n`,
+                                contentType: ItemContentType.RawText,
+                            },
+                        },
+                    ],
+                },
+            ],
+        }, repositoryId, projectName);
+        const pr = await createPullRequest(connection, projectName, repositoryId, {
+            title: `PR comments test ${timestamp}-${randomSuffix}`,
+            description: 'PR created for comment integration tests',
+            sourceRefName: `refs/heads/${uniqueBranchName}`,
+            targetRefName: defaultBranchRef,
+            isDraft: true,
+        });
+        pullRequestId = pr.pullRequestId;
+    });
+    afterAll(async () => {
+        const gitApi = await connection.getGitApi();
+        if (pullRequestId) {
+            try {
+                await gitApi.updatePullRequest({
+                    status: 2,
+                }, repositoryId, pullRequestId, projectName);
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (_) {
+                // ignore cleanup errors
+            }
+        }
+        // Best-effort: delete the temporary branch
+        try {
+            const refs = await gitApi.getRefs(repositoryId, projectName, `heads/${uniqueBranchName}`);
+            const branchObjectId = refs?.[0]?.objectId;
+            if (branchObjectId) {
+                await gitApi.updateRefs([
+                    {
+                        name: `refs/heads/${uniqueBranchName}`,
+                        oldObjectId: branchObjectId,
+                        newObjectId: '0000000000000000000000000000000000000000',
+                    },
+                ], repositoryId, projectName);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (_) {
+            // ignore cleanup errors
+        }
+    });
+    test('should add a new comment thread to pull request', async () => {
+        const commentContent = `Test comment ${timestamp}-${randomSuffix}`;
+        const result = await addPullRequestComment(connection, projectName, repositoryId, pullRequestId, {
+            projectId: projectName,
+            repositoryId,
+            pullRequestId,
+            content: commentContent,
+            status: 'active',
+        });
+        expect(result.comment).toBeDefined();
+        expect(result.comment.content).toBe(commentContent);
+        expect(result.thread).toBeDefined();
+        expect(result.thread.status).toBe('active');
+    }, 30000);
+    test('should add a file comment to pull request', async () => {
+        const commentContent = `File comment ${timestamp}-${randomSuffix}`;
+        const lineNumber = 1;
+        const result = await addPullRequestComment(connection, projectName, repositoryId, pullRequestId, {
+            projectId: projectName,
+            repositoryId,
+            pullRequestId,
+            content: commentContent,
+            filePath: changedFilePath,
+            lineNumber,
+            status: 'active',
+        });
+        expect(result.comment).toBeDefined();
+        expect(result.comment.content).toBe(commentContent);
+        expect(result.thread).toBeDefined();
+        expect(result.thread.threadContext).toBeDefined();
+        expect(result.thread.threadContext.filePath).toBe(changedFilePath);
+        expect(result.thread.threadContext.rightFileStart.line).toBe(lineNumber);
+    }, 30000);
+    test('should add a reply to an existing comment thread', async () => {
+        const initialComment = await addPullRequestComment(connection, projectName, repositoryId, pullRequestId, {
+            projectId: projectName,
+            repositoryId,
+            pullRequestId,
+            content: `Initial comment ${timestamp}-${randomSuffix}`,
+            status: 'active',
+        });
+        const threadId = initialComment.thread.id;
+        const replyContent = `Reply comment ${timestamp}-${randomSuffix}`;
+        const result = await addPullRequestComment(connection, projectName, repositoryId, pullRequestId, {
+            projectId: projectName,
+            repositoryId,
+            pullRequestId,
+            content: replyContent,
+            threadId,
+        });
+        expect(result.comment).toBeDefined();
+        expect(result.comment.content).toBe(replyContent);
+        expect(result.thread).toBeUndefined();
+    }, 30000);
+});
+//# sourceMappingURL=feature.spec.int.js.map