Function createIterationField

pkg/github/projects.go:1624–1766

createIterationField handles the create_iteration_field method for ProjectsWrite. GitHub's GraphQL API requires two mutations to fully configure an iteration field: 1. createProjectV2Field creates the field with DataType=ITERATION (no schedule yet). 2. updateProjectV2Field sets the start date, dura

(ctx context.Context, gqlClient *githubv4.Client, owner, ownerType string, projectNumber int, args map[string]any)

// by calling this method again (the create will fail with a duplicate-name error, which
// surfaces clearly) or by deleting the field via the GitHub UI.
func createIterationField(ctx context.Context, gqlClient *githubv4.Client, owner, ownerType string, projectNumber int, args map[string]any) (*mcp.CallToolResult, any, error) {
	fieldName, err := RequiredParam[string](args, "field_name")
	if err != nil {
		return utils.NewToolResultError(err.Error()), nil, nil
	}
	duration, err := RequiredInt(args, "iteration_duration")
	if err != nil {
		return utils.NewToolResultError(err.Error()), nil, nil
	}
	startDateStr, err := RequiredParam[string](args, "start_date")
	if err != nil {
		return utils.NewToolResultError(err.Error()), nil, nil
	}

	projectID, err := resolveProjectNodeID(ctx, gqlClient, owner, ownerType, projectNumber)
	if err != nil {
		return utils.NewToolResultError(fmt.Sprintf("failed to get project ID: %v", err)), nil, nil
	}

	// Step 1: Create the iteration field.
	var createMutation struct {
		CreateProjectV2Field struct {
			ProjectV2Field struct {
				ProjectV2IterationField struct {
					ID   string
					Name string
				} `graphql:"... on ProjectV2IterationField"`
			} `graphql:"projectV2Field"`
		} `graphql:"createProjectV2Field(input: $input)"`
	}

	createInput := githubv4.CreateProjectV2FieldInput{
		ProjectID: githubv4.ID(projectID),
		DataType:  githubv4.ProjectV2CustomFieldType("ITERATION"),
		Name:      githubv4.String(fieldName),
	}

	err = gqlClient.Mutate(ctx, &createMutation, createInput, nil)
	if err != nil {
		return utils.NewToolResultError(fmt.Sprintf("failed to create iteration field: %v", err)), nil, nil
	}

	fieldID := createMutation.CreateProjectV2Field.ProjectV2Field.ProjectV2IterationField.ID

	// Step 2: Configure the iteration field with start date and duration.
	var updateMutation struct {
		UpdateProjectV2Field struct {
			ProjectV2Field struct {
				ProjectV2IterationField struct {
					ID            string
					Name          string
					Configuration struct {
						Iterations []struct {
							ID        string
							Title     string
							StartDate string
							Duration  int
						}