FEAT: iteration

issue: #173

Author: iwakitakuma

index.ts

@@ -181,6 +181,8 @@ import {
   type GetCommitOptions,
   type GetCommitDiffOptions,
   ListMergeRequestDiffsSchema,
+  ListGroupIterationsSchema,
+  GroupIteration,
 } from "./schemas.js";
 
 import { randomUUID } from "crypto";
@@ -736,6 +738,11 @@ const allTools = [
     description: "Get changes/diffs of a specific commit",
     inputSchema: zodToJsonSchema(GetCommitDiffSchema),
   },
+  {
+    name: "list_group_iterations",
+    description: "List group iterations with filtering options",
+    inputSchema: zodToJsonSchema(ListGroupIterationsSchema),
+  },
 ];
 
 // Define which tools are read-only
@@ -777,6 +784,8 @@ const readOnlyTools = [
   "list_commits",
   "get_commit",
   "get_commit_diff",
+  "list_group_iterations",
+  "get_group_iteration",
 ];
 
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
@@ -3382,6 +3391,41 @@ async function getCommitDiff(
   return z.array(GitLabDiffSchema).parse(data);
 }
 
+/**
+ * list group iterations
+ *
+ * @param {string} groupId 
+ * @param {Omit<ListGroupIterationsOptions, "group_id">} options
+ * @returns {Promise<GetIt[]>}
+ */
+async function listGroupIterations(
+  groupId: string,
+  options: Omit<z.infer<typeof ListGroupIterationsSchema>, "group_id"> = {}
+): Promise<GroupIteration[]> {
+  groupId = decodeURIComponent(groupId);
+  const url = new URL(`${GITLAB_API_URL}/groups/${encodeURIComponent(groupId)}/iterations`);
+
+  // クエリパラメータの追加
+  if (options.state) url.searchParams.append("state", options.state);
+  if (options.search) url.searchParams.append("search", options.search);
+  if (options.in) url.searchParams.append("in", options.in.join(","));
+  if (options.include_ancestors !== undefined) url.searchParams.append("include_ancestors", options.include_ancestors.toString());
+  if (options.include_descendants !== undefined) url.searchParams.append("include_descendants", options.include_descendants.toString());
+  if (options.updated_before) url.searchParams.append("updated_before", options.updated_before);
+  if (options.updated_after) url.searchParams.append("updated_after", options.updated_after);
+  if (options.page) url.searchParams.append("page", options.page.toString());
+  if (options.per_page) url.searchParams.append("per_page", options.per_page.toString());
+
+  const response = await fetch(url.toString(), DEFAULT_FETCH_CONFIG);
+
+  if (!response.ok) {
+    await handleGitLabError(response);
+  }
+
+  const data = await response.json();
+  return z.array(GroupIteration).parse(data);
+}
+
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   // Apply read-only filter first
   const tools0 = GITLAB_READ_ONLY_MODE
@@ -4326,6 +4370,14 @@ server.setRequestHandler(CallToolRequestSchema, async request => {
         };
       }
 
+      case "list_group_iterations": {
+        const args = ListGroupIterationsSchema.parse(request.params.arguments);
+        const iterations = await listGroupIterations(args.group_id, args);
+        return {
+          content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
+        };
+      }
+
       default:
         throw new Error(`Unknown tool: ${request.params.name}`);
     }

schemas.ts

@@ -935,6 +935,8 @@ export const ListIssuesSchema = z.object({
   due_date: z.string().optional().describe("Return issues that have the due date"),
   labels: z.array(z.string()).optional().describe("Array of label names"),
   milestone: z.string().optional().describe("Milestone title"),
+  issue_type: z.string().optional().nullable().describe("Filter to a given type of issue. One of issue, incident, test_case or task"),
+  iteration_id: z.coerce.string().optional().nullable().describe("Return issues assigned to the given iteration ID. None returns issues that do not belong to an iteration. Any returns issues that belong to an iteration. "),
   scope: z
     .enum(["created_by_me", "assigned_to_me", "all"])
     .optional()
@@ -1361,6 +1363,32 @@ export const GetCommitDiffSchema = z.object({
   sha: z.string().describe("The commit hash or name of a repository branch or tag"),
 });
 
+export const GroupIteration = z.object({
+  id: z.coerce.string(),
+  iid: z.coerce.string(),
+  sequence: z.number(),
+  group_id: z.coerce.string(),
+  title: z.string().optional().nullable(),
+  description: z.string().optional().nullable(),
+  state: z.number(),
+  created_at: z.string(),
+  updated_at: z.string(),
+  due_date: z.string().optional().nullable(),
+  start_date: z.string().optional().nullable(),
+  web_url: z.string().optional().nullable(),
+});
+
+export const ListGroupIterationsSchema = z.object({
+  group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+  state: z.enum(["opened", "upcoming", "current", "closed", "all"]).optional().describe("Return opened, upcoming, current, closed, or all iterations."),
+  search: z.string().optional().describe("Return only iterations with a title matching the provided string."),
+  in: z.array(z.enum(["title", "cadence_title"])).optional().describe("Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title]."),
+  include_ancestors: flexibleBoolean.optional().describe("Include iterations for group and its ancestors. Defaults to true."),
+  include_descendants: flexibleBoolean.optional().describe("Include iterations for group and its descendants. Defaults to false."),
+  updated_before: z.string().optional().describe("Return only iterations updated before the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z)."),
+  updated_after: z.string().optional().describe("Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z)."),
+}).merge(PaginationOptionsSchema);
+
 // Export types
 export type GitLabAuthor = z.infer<typeof GitLabAuthorSchema>;
 export type GitLabFork = z.infer<typeof GitLabForkSchema>;
@@ -1430,3 +1458,5 @@ export type PaginationOptions = z.infer<typeof PaginationOptionsSchema>;
 export type ListCommitsOptions = z.infer<typeof ListCommitsSchema>;
 export type GetCommitOptions = z.infer<typeof GetCommitSchema>;
 export type GetCommitDiffOptions = z.infer<typeof GetCommitDiffSchema>;
+export type GroupIteration = z.infer<typeof GroupIteration>;
+export type ListGroupIterationsOptions = z.infer<typeof ListGroupIterationsSchema>;