get_upcoming_milestones

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:536-568 (handler)

  Core handler implementation: Fetches all milestones, filters those due within 'daysAhead' that are still open, sorts by due date ascending, limits to 'limit' results, and enriches each with metrics (including optional issues). Calls getMilestoneMetrics helper.

  async getUpcomingMilestones(daysAhead: number = 30, limit: number = 10, includeIssues: boolean = false): Promise<MilestoneMetrics[]> {
    try {
      const milestones = await this.milestoneRepo.findAll();
      const now = new Date();
      const futureDate = new Date(now);
      futureDate.setDate(now.getDate() + daysAhead);
  
      const upcomingMilestones = milestones.filter(milestone => {
        if (!milestone.dueDate) return false;
        const dueDate = new Date(milestone.dueDate);
        return dueDate > now && dueDate <= futureDate &&
               milestone.status !== ResourceStatus.COMPLETED &&
               milestone.status !== ResourceStatus.CLOSED;
      });
  
      upcomingMilestones.sort((a, b) => {
        if (!a.dueDate || !b.dueDate) return 0;
        return new Date(a.dueDate).getTime() - new Date(b.dueDate).getTime();
      });
  
      const limitedMilestones = upcomingMilestones.slice(0, limit);
  
      const milestoneMetrics = await Promise.all(
        limitedMilestones.map(milestone =>
          this.getMilestoneMetrics(milestone.id, includeIssues)
        )
      );
  
      return milestoneMetrics;
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/index.ts:236-237 (handler)

  MCP tool dispatcher in server index: Routes 'get_upcoming_milestones' tool calls to ProjectManagementService.getUpcomingMilestones with validated args.

  case "get_upcoming_milestones":
    return await this.service.getUpcomingMilestones(args.daysAhead, args.limit, args.includeIssues);

• src/infrastructure/tools/ToolSchemas.ts:80-87 (schema)

  Zod input schema validation for tool parameters: daysAhead (positive int), limit (positive int), includeIssues (boolean). Exports TypeScript type.

  // Schema for get_upcoming_milestones tool
  export const getUpcomingMilestonesSchema = z.object({
    daysAhead: z.number().int().positive(),
    limit: z.number().int().positive(),
    includeIssues: z.boolean(),
  });
  
  export type GetUpcomingMilestonesArgs = z.infer<typeof getUpcomingMilestonesSchema>;

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

  Registers the getUpcomingMilestonesTool in the central ToolRegistry singleton during built-in tools initialization.

  this.registerTool(getUpcomingMilestonesTool);

• src/infrastructure/tools/ToolSchemas.ts:626-641 (schema)

  ToolDefinition export including name, description, schema reference, and example usage for MCP tool listing.

  export const getUpcomingMilestonesTool: ToolDefinition<GetUpcomingMilestonesArgs> = {
    name: "get_upcoming_milestones",
    description: "Get a list of upcoming milestones within a time frame",
    schema: getUpcomingMilestonesSchema as unknown as ToolSchema<GetUpcomingMilestonesArgs>,
    examples: [
      {
        name: "List upcoming milestones",
        description: "Get milestones due in the next 14 days",
        args: {
          daysAhead: 14,
          limit: 10,
          includeIssues: true,
        },
      },
    ],
  };