mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:464-507 (handler)

  Core implementation of getMilestoneMetrics: fetches milestone, filters associated issues, calculates metrics like completion percentage, open/closed counts, overdue status, and optionally includes issue details.

  // Milestone Management
  async getMilestoneMetrics(id: string, includeIssues: boolean = false): Promise<MilestoneMetrics> {
    try {
      const milestone = await this.milestoneRepo.findById(id);
      if (!milestone) {
        throw new ResourceNotFoundError(ResourceType.MILESTONE, id);
      }
  
      const allIssues = await this.issueRepo.findAll();
      const issues = allIssues.filter(issue => issue.milestoneId === milestone.id);
  
      const totalIssues = issues.length;
      const closedIssues = issues.filter(
        issue => issue.status === ResourceStatus.CLOSED || issue.status === ResourceStatus.COMPLETED
      ).length;
      const openIssues = totalIssues - closedIssues;
      const completionPercentage = totalIssues > 0 ? Math.round((closedIssues / totalIssues) * 100) : 0;
  
      const now = new Date();
      let isOverdue = false;
      let daysRemaining: number | undefined = undefined;
  
      if (milestone.dueDate) {
        const dueDate = new Date(milestone.dueDate);
        isOverdue = now > dueDate;
        daysRemaining = Math.ceil((dueDate.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
      }
  
      return {
        id: milestone.id,
        title: milestone.title,
        dueDate: milestone.dueDate,
        openIssues,
        closedIssues,
        totalIssues,
        completionPercentage,
        status: milestone.status,
        issues: includeIssues ? issues : undefined,
        isOverdue,
        daysRemaining: daysRemaining && daysRemaining > 0 ? daysRemaining : undefined
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }

• src/index.ts:246-247 (handler)

  MCP tool dispatcher handler that routes 'get_milestone_metrics' calls to ProjectManagementService.getMilestoneMetrics

  case "get_milestone_metrics":
    return await this.service.getMilestoneMetrics(args.milestoneId, args.includeIssues);

• src/infrastructure/tools/ToolSchemas.ts:954-968 (schema)

  ToolDefinition for get_milestone_metrics including Zod input schema, description, and usage examples

  export const getMilestoneMetricsTool: ToolDefinition<GetMilestoneMetricsArgs> = {
    name: "get_milestone_metrics",
    description: "Get progress metrics for a specific milestone",
    schema: getMilestoneMetricsSchema as unknown as ToolSchema<GetMilestoneMetricsArgs>,
    examples: [
      {
        name: "Get milestone progress",
        description: "Get progress metrics for milestone #2",
        args: {
          milestoneId: "2",
          includeIssues: true,
        },
      },
    ],
  };

• src/infrastructure/tools/ToolSchemas.ts:57-62 (schema)

  Zod input validation schema for get_milestone_metrics tool parameters

  export const getMilestoneMetricsSchema = z.object({
    milestoneId: z.string().min(1, "Milestone ID is required"),
    includeIssues: z.boolean(),
  });
  
  export type GetMilestoneMetricsArgs = z.infer<typeof getMilestoneMetricsSchema>;

• src/infrastructure/tools/ToolRegistry.ts:187-187 (registration)

  Registers the getMilestoneMetricsTool in the central ToolRegistry singleton

  this.registerTool(getMilestoneMetricsTool);