Accept Issue Field option database IDs

Attached Issue Field options are surfaced to callers through the REST field
metadata, which reports the numeric database ID (2068) rather than the
GraphQL node ID (IFSSO_kgDNCBQ). An agent that discovered options via
list_project_fields and wrote back the ID it was shown got option_not_found,
because only the node ID and the option name were accepted.

IssueFieldSingleSelectOption exposes databaseId alongside id, so select it
and match either form, resolving to the node ID the mutation requires.
Standard project fields are unaffected: their REST and GraphQL option IDs are
already identical, and they carry no database ID, so an unmatched numeric
value still surfaces option_not_found.

Verified against the live API: an option ID taken from list_project_fields
output now writes the matching option.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 4b95d817-7807-428a-95ce-8d8fe42b5d5b

Author: zwick

pkg/github/projects_resolver.go

@@ -17,8 +17,11 @@ const resolverFieldsPageSize = 100
 
 // ResolvedFieldOption is one option on a SINGLE_SELECT project field.
 type ResolvedFieldOption struct {
-	ID   string
-	Name string
+	ID string
+	// DatabaseID is the numeric option ID. Attached Issue Fields surface it
+	// through the REST field metadata, so writes must accept it alongside ID.
+	DatabaseID string
+	Name       string
 }
 
 // ResolvedField contains a project's numeric database ID, GraphQL node ID, and
@@ -46,8 +49,9 @@ type projectIssueFieldMetadata struct {
 	SingleSelect struct {
 		ID      githubv4.ID
 		Options []struct {
-			ID   githubv4.ID
-			Name githubv4.String
+			ID         githubv4.ID
+			DatabaseID githubv4.Int `graphql:"databaseId"`
+			Name       githubv4.String
 		}
 	} `graphql:"... on IssueFieldSingleSelect"`
 }
@@ -269,7 +273,14 @@ func listAllProjectFieldsWithIssueFieldMetadata(ctx context.Context, gqlClient *
 				field.IssueFieldNodeID = issueFieldNodeIDForType(field.DataType, node.ProjectV2SingleSelectField.IssueField)
 				field.Options = field.Options[:0]
 				for _, option := range node.ProjectV2SingleSelectField.IssueField.SingleSelect.Options {
-					field.Options = append(field.Options, ResolvedFieldOption{ID: fmt.Sprintf("%v", option.ID), Name: string(option.Name)})
+					resolvedOption := ResolvedFieldOption{
+						ID:   fmt.Sprintf("%v", option.ID),
+						Name: string(option.Name),
+					}
+					if option.DatabaseID != 0 {
+						resolvedOption.DatabaseID = fmt.Sprintf("%d", option.DatabaseID)
+					}
+					field.Options = append(field.Options, resolvedOption)
 				}
 			} else if bool(node.ProjectV2Field.IsIssueField) {
 				field.IsIssueField = true
@@ -470,10 +481,12 @@ func resolveSingleSelectOptionByName(field *ResolvedField, optionName string) (s
 	}
 }
 
+// resolveSingleSelectOptionByNameOrID accepts an option's node ID, its numeric
+// database ID as surfaced by the REST field metadata, or its name.
 func resolveSingleSelectOptionByNameOrID(field *ResolvedField, value string) (string, error) {
 	for _, option := range field.Options {
-		if option.ID == value {
-			return value, nil
+		if option.ID == value || (option.DatabaseID != "" && option.DatabaseID == value) {
+			return option.ID, nil
 		}
 	}
 	return resolveSingleSelectOptionByName(field, value)

pkg/github/projects_resolver_test.go

@@ -103,7 +103,8 @@ func Test_ResolveProjectFieldByID_AttachedIssueFieldMetadata(t *testing.T) {
 			fieldsQueryVars("octo-org", 7),
 			githubv4mock.DataResponse(fieldsResponse([]map[string]any{
 				attachedIssueFieldNode("PVTSSF_risk", 702, "IF_risk", "Risk", "SINGLE_SELECT", []map[string]any{
-					{"id": "IFO_low", "name": "Low"}, {"id": "IFO_high", "name": "High"},
+					{"id": "IFO_low", "databaseId": 2068, "name": "Low"},
+					{"id": "IFO_high", "databaseId": 2069, "name": "High"},
 				}),
 			})),
 		),
@@ -122,10 +123,48 @@ func Test_ResolveProjectFieldByID_AttachedIssueFieldMetadata(t *testing.T) {
 	assert.Equal(t, "IF_risk", field.IssueFieldNodeID)
 	assert.True(t, field.IsIssueField)
 	assert.Equal(t, []ResolvedFieldOption{
-		{ID: "IFO_low", Name: "Low"}, {ID: "IFO_high", Name: "High"},
+		{ID: "IFO_low", DatabaseID: "2068", Name: "Low"},
+		{ID: "IFO_high", DatabaseID: "2069", Name: "High"},
 	}, field.Options)
 }
 
+// Attached Issue Field options surface their numeric database ID through the
+// REST field metadata, so a write must accept that form as well as the node ID.
+func Test_ResolveSingleSelectOptionByNameOrID_AcceptsIssueFieldOptionForms(t *testing.T) {
+	field := &ResolvedField{
+		Name:         "Risk",
+		DataType:     "SINGLE_SELECT",
+		IsIssueField: true,
+		Options: []ResolvedFieldOption{
+			{ID: "IFSSO_low", DatabaseID: "2068", Name: "Low"},
+			{ID: "IFSSO_high", DatabaseID: "2069", Name: "High"},
+		},
+	}
+
+	for _, tt := range []struct{ name, value, want string }{
+		{"node ID", "IFSSO_high", "IFSSO_high"},
+		{"database ID from REST metadata", "2069", "IFSSO_high"},
+		{"option name", "high", "IFSSO_high"},
+	} {
+		t.Run(tt.name, func(t *testing.T) {
+			got, err := resolveSingleSelectOptionByNameOrID(field, tt.value)
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, got)
+		})
+	}
+
+	// Standard project fields carry no database ID, so an unmatched numeric
+	// value must still surface as a normal option-not-found error.
+	standard := &ResolvedField{
+		Name:     "Status",
+		DataType: "SINGLE_SELECT",
+		Options:  []ResolvedFieldOption{{ID: "f75ad846", Name: "Todo"}},
+	}
+	_, err := resolveSingleSelectOptionByNameOrID(standard, "2069")
+	require.Error(t, err)
+	assert.Contains(t, err.Error(), `"error":"option_not_found"`)
+}
+
 func Test_ResolveProjectFieldForUpdateByName_Success(t *testing.T) {
 	mocked := githubv4mock.NewMockedHTTPClient(
 		githubv4mock.NewQueryMatcher(