feat: implement get_project_details core functionality

Implements handler for detailed project information including process, work item types, and teams.

Closes #101

Author: openhands-agent

project-management/task-management/done.md

@@ -1,5 +1,27 @@
 ## Completed Tasks
 
+- [x] **Task**: Implement get_project_details core functionality (GitHub Issue #101)
+  - **Role**: Full-Stack Developer
+  - **Phase**: Completed
+  - **Notes**:
+    - Implemented a handler for the `get_project_details` functionality
+    - Added support for retrieving comprehensive project information including:
+      - Basic project metadata
+      - Process information
+      - Work item types and their structure
+      - Fields applicable to each work item type
+      - Project teams
+    - Created unit tests and integration tests
+    - Registered the handler in the server
+  - **Sub-tasks**:
+    - [x] Created schema for get_project_details
+    - [x] Created tests for get_project_details
+    - [x] Implemented get_project_details feature
+    - [x] Registered the handler in server.ts
+    - [x] Updated exports in projects/index.ts
+  - **Completed**: April 2, 2025
+  - **Pull Request**: [#111](https://github.com/Tiberriver256/mcp-server-azure-devops/pull/111)
+
 - [x] **Task 3.1**: Implement get_repository_details core functionality
   - **Role**: Full-Stack Developer
   - **Phase**: Completed

src/features/projects/get-project-details/feature.spec.int.ts

@@ -0,0 +1,212 @@
+import { WebApi } from 'azure-devops-node-api';
+import { getProjectDetails } from './feature';
+import {
+  getTestConnection,
+  shouldSkipIntegrationTest,
+} from '@/shared/test/test-helpers';
+
+describe('getProjectDetails integration', () => {
+  let connection: WebApi | null = null;
+  let projectName: string;
+
+  beforeAll(async () => {
+    // Get a real connection using environment variables
+    connection = await getTestConnection();
+    projectName = process.env.AZURE_DEVOPS_DEFAULT_PROJECT || 'DefaultProject';
+  });
+
+  test('should retrieve basic project details from Azure DevOps', async () => {
+    // Skip if no connection is available
+    if (shouldSkipIntegrationTest()) {
+      return;
+    }
+
+    // This connection must be available if we didn't skip
+    if (!connection) {
+      throw new Error(
+        'Connection should be available when test is not skipped',
+      );
+    }
+
+    // Act - make an actual API call to Azure DevOps
+    const result = await getProjectDetails(connection, {
+      projectId: projectName,
+    });
+
+    // Assert on the actual response
+    expect(result).toBeDefined();
+    expect(result.name).toBe(projectName);
+    expect(result.id).toBeDefined();
+    expect(result.url).toBeDefined();
+    expect(result.state).toBeDefined();
+
+    // Verify basic project structure
+    expect(result.visibility).toBeDefined();
+    expect(result.lastUpdateTime).toBeDefined();
+    expect(result.capabilities).toBeDefined();
+  });
+
+  test('should retrieve project details with teams from Azure DevOps', async () => {
+    // Skip if no connection is available
+    if (shouldSkipIntegrationTest()) {
+      return;
+    }
+
+    // This connection must be available if we didn't skip
+    if (!connection) {
+      throw new Error(
+        'Connection should be available when test is not skipped',
+      );
+    }
+
+    // Act - make an actual API call to Azure DevOps
+    const result = await getProjectDetails(connection, {
+      projectId: projectName,
+      includeTeams: true,
+    });
+
+    // Assert on the actual response
+    expect(result).toBeDefined();
+    expect(result.teams).toBeDefined();
+    expect(Array.isArray(result.teams)).toBe(true);
+
+    // There should be at least one team (the default team)
+    if (result.teams && result.teams.length > 0) {
+      const team = result.teams[0];
+      expect(team.id).toBeDefined();
+      expect(team.name).toBeDefined();
+      expect(team.url).toBeDefined();
+    }
+  });
+
+  test('should retrieve project details with process information from Azure DevOps', async () => {
+    // Skip if no connection is available
+    if (shouldSkipIntegrationTest()) {
+      return;
+    }
+
+    // This connection must be available if we didn't skip
+    if (!connection) {
+      throw new Error(
+        'Connection should be available when test is not skipped',
+      );
+    }
+
+    // Act - make an actual API call to Azure DevOps
+    const result = await getProjectDetails(connection, {
+      projectId: projectName,
+      includeProcess: true,
+    });
+
+    // Assert on the actual response
+    expect(result).toBeDefined();
+    expect(result.process).toBeDefined();
+    expect(result.process?.name).toBeDefined();
+  });
+
+  test('should retrieve project details with work item types from Azure DevOps', async () => {
+    // Skip if no connection is available
+    if (shouldSkipIntegrationTest()) {
+      return;
+    }
+
+    // This connection must be available if we didn't skip
+    if (!connection) {
+      throw new Error(
+        'Connection should be available when test is not skipped',
+      );
+    }
+
+    // Act - make an actual API call to Azure DevOps
+    const result = await getProjectDetails(connection, {
+      projectId: projectName,
+      includeProcess: true,
+      includeWorkItemTypes: true,
+    });
+
+    // Assert on the actual response
+    expect(result).toBeDefined();
+    expect(result.process).toBeDefined();
+    expect(result.process?.workItemTypes).toBeDefined();
+    expect(Array.isArray(result.process?.workItemTypes)).toBe(true);
+
+    // There should be at least one work item type
+    if (
+      result.process?.workItemTypes &&
+      result.process.workItemTypes.length > 0
+    ) {
+      const workItemType = result.process.workItemTypes[0];
+      expect(workItemType.name).toBeDefined();
+      expect(workItemType.description).toBeDefined();
+      expect(workItemType.states).toBeDefined();
+    }
+  });
+
+  test('should retrieve project details with fields from Azure DevOps', async () => {
+    // Skip if no connection is available
+    if (shouldSkipIntegrationTest()) {
+      return;
+    }
+
+    // This connection must be available if we didn't skip
+    if (!connection) {
+      throw new Error(
+        'Connection should be available when test is not skipped',
+      );
+    }
+
+    // Act - make an actual API call to Azure DevOps
+    const result = await getProjectDetails(connection, {
+      projectId: projectName,
+      includeProcess: true,
+      includeWorkItemTypes: true,
+      includeFields: true,
+    });
+
+    // Assert on the actual response
+    expect(result).toBeDefined();
+    expect(result.process).toBeDefined();
+    expect(result.process?.workItemTypes).toBeDefined();
+
+    // There should be at least one work item type with fields
+    if (
+      result.process?.workItemTypes &&
+      result.process.workItemTypes.length > 0
+    ) {
+      const workItemType = result.process.workItemTypes[0];
+      expect(workItemType.fields).toBeDefined();
+      expect(Array.isArray(workItemType.fields)).toBe(true);
+
+      // There should be at least one field (like Title)
+      if (workItemType.fields && workItemType.fields.length > 0) {
+        const field = workItemType.fields[0];
+        expect(field.name).toBeDefined();
+        expect(field.referenceName).toBeDefined();
+      }
+    }
+  });
+
+  test('should throw error when project is not found', async () => {
+    // Skip if no connection is available
+    if (shouldSkipIntegrationTest()) {
+      return;
+    }
+
+    // This connection must be available if we didn't skip
+    if (!connection) {
+      throw new Error(
+        'Connection should be available when test is not skipped',
+      );
+    }
+
+    // Use a non-existent project name
+    const nonExistentProjectName = 'non-existent-project-' + Date.now();
+
+    // Act & Assert - should throw an error for non-existent project
+    await expect(
+      getProjectDetails(connection, {
+        projectId: nonExistentProjectName,
+      }),
+    ).rejects.toThrow(/not found|Failed to get project/);
+  });
+});