Update project options

Author: JoannaaKL

pkg/github/projects.go

@@ -876,16 +876,55 @@ type updateProjectItem struct {
 	ID    int `json:"id"`
 	Value any `json:"value"`
 }
+type OptionDescription struct {
+	Raw  string `json:"raw,omitempty"`
+	HTML string `json:"html,omitempty"`
+}
+
+func (d *OptionDescription) UnmarshalJSON(data []byte) error {
+	if string(data) == "null" { // nothing to do
+		return nil
+	}
+	// Try string
+	var asString string
+	if err := json.Unmarshal(data, &asString); err == nil {
+		d.Raw = asString
+		return nil
+	}
+	// Try object form
+	type alias OptionDescription
+	var a alias
+	if err := json.Unmarshal(data, &a); err != nil {
+		return err
+	}
+	d.Raw = a.Raw
+	d.HTML = a.HTML
+	return nil
+}
+
+func (d OptionDescription) String() string {
+	if d.Raw != "" {
+		return d.Raw
+	}
+	return d.HTML
+}
+
+type projectV2FieldOption struct {
+	ID          string             `json:"id,omitempty"`          // Unique identifier for this option (string like "option_1").
+	Name        string             `json:"name,omitempty"`        // Display name of the option.
+	Color       string             `json:"color,omitempty"`       // Uppercase color name or hex code as returned by the API.
+	Description *OptionDescription `json:"description,omitempty"` // Optional human-friendly description (raw or html form).
+}
 
 type projectV2Field struct {
-	ID        *int64            `json:"id,omitempty"`         // The unique identifier for this field.
-	NodeID    string            `json:"node_id,omitempty"`    // The GraphQL node ID for this field.
-	Name      string            `json:"name,omitempty"`       // The display name of the field.
-	DataType  string            `json:"data_type,omitempty"`  // The data type of the field (e.g., "text", "number", "date", "single_select", "multi_select").
-	URL       string            `json:"url,omitempty"`        // The API URL for this field.
-	Options   []*any            `json:"options,omitempty"`    // Available options for single_select and multi_select fields.
-	CreatedAt *github.Timestamp `json:"created_at,omitempty"` // The time when this field was created.
-	UpdatedAt *github.Timestamp `json:"updated_at,omitempty"` // The time when this field was last updated.
+	ID        *int64                  `json:"id,omitempty"`         // The unique identifier for this field.
+	NodeID    string                  `json:"node_id,omitempty"`    // The GraphQL node ID for this field.
+	Name      string                  `json:"name,omitempty"`       // The display name of the field.
+	DataType  string                  `json:"data_type,omitempty"`  // The data type of the field (e.g., "text", "number", "date", "single_select", "multi_select").
+	URL       string                  `json:"url,omitempty"`        // The API URL for this field.
+	Options   []*projectV2FieldOption `json:"options,omitempty"`    // Available options for single_select and multi_select fields.
+	CreatedAt *github.Timestamp       `json:"created_at,omitempty"` // The time when this field was created.
+	UpdatedAt *github.Timestamp       `json:"updated_at,omitempty"` // The time when this field was last updated.
 }
 
 type projectV2Item struct {

pkg/github/projects_options_test.go

@@ -0,0 +1,56 @@
+package github
+
+import (
+	"encoding/json"
+	"testing"
+)
+
+func TestOptionDescription_Unmarshal_String(t *testing.T) {
+	input := `"Simple description"`
+	var d OptionDescription
+	if err := json.Unmarshal([]byte(input), &d); err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+	if d.Raw != "Simple description" || d.HTML != "" {
+		t.Fatalf("unexpected values: %+v", d)
+	}
+	if d.String() != "Simple description" {
+		t.Fatalf("String() mismatch: %s", d.String())
+	}
+}
+
+func TestOptionDescription_Unmarshal_Object(t *testing.T) {
+	input := `{"raw": "Raw desc", "html": "<p>Raw desc</p>"}`
+	var d OptionDescription
+	if err := json.Unmarshal([]byte(input), &d); err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+	if d.Raw != "Raw desc" || d.HTML != "<p>Raw desc</p>" {
+		t.Fatalf("unexpected values: %+v", d)
+	}
+	if d.String() != "Raw desc" { // prefers Raw
+		t.Fatalf("String() mismatch: %s", d.String())
+	}
+}
+
+func TestProjectV2FieldOption_Unmarshal_WithStringDescription(t *testing.T) {
+	input := `{"id":"option_1","name":"Low","color":"GREEN","description":"Low priority"}`
+	var opt projectV2FieldOption
+	if err := json.Unmarshal([]byte(input), &opt); err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+	if opt.Description == nil || opt.Description.Raw != "Low priority" {
+		t.Fatalf("expected raw description, got %+v", opt.Description)
+	}
+}
+
+func TestProjectV2FieldOption_Unmarshal_WithObjectDescription(t *testing.T) {
+	input := `{"id":"option_1","name":"Low","color":"GREEN","description":{"raw":"Low priority","html":"<p>Low priority</p>"}}`
+	var opt projectV2FieldOption
+	if err := json.Unmarshal([]byte(input), &opt); err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+	if opt.Description == nil || opt.Description.Raw != "Low priority" || opt.Description.HTML != "<p>Low priority</p>" {
+		t.Fatalf("expected structured description, got %+v", opt.Description)
+	}
+}