Add Jira custom field support for push (#3678)

Allow Jira push to include configured project-specific fields such as Team. Custom field values can be plain strings or JSON objects/arrays for Jira field types that require structured payloads, and per-type config overrides global values after the Beads issue type is mapped to a Jira issue type.

Author: medhatgalal

docs/CONFIG.md

@@ -663,8 +663,18 @@ bd config set jira.status_map.closed "Done"
 bd config set jira.type_map.bug "Bug"
 bd config set jira.type_map.feature "Story"
 bd config set jira.type_map.task "Task"
+
+# Set Jira custom fields on pushed issues
+bd config set jira.custom_fields.customfield_10042 '{"value":"AI Platform"}'
+bd config set jira.custom_fields.Story.customfield_10042 '{"value":"AI Platform"}'
 ```
 
+`jira.custom_fields.<field>` applies to every issue pushed to Jira.
+`jira.custom_fields.<JiraType>.<field>` applies only when the mapped Jira issue
+type matches `<JiraType>`; per-type fields override global fields with the same
+field key. Values beginning with `{` or `[` are sent as JSON, which is useful
+for select-like fields. Other values are sent as strings.
+
 ### Example: Linear Integration
 
 Linear integration provides bidirectional sync between bd and Linear via GraphQL API.

internal/jira/fieldmapper.go

@@ -10,10 +10,12 @@ import (
 
 // jiraFieldMapper implements tracker.FieldMapper for Jira.
 type jiraFieldMapper struct {
-	apiVersion  string            // "2" or "3" (default: "3")
-	statusMap   map[string]string // beads status → Jira status name (from jira.status_map.* config)
-	typeMap     map[string]string // beads type → Jira type (from jira.type_map.* config)
-	priorityMap map[string]string // beads priority (as string "0"-"4") → Jira priority name (from jira.priority_map.* config)
+	apiVersion       string                            // "2" or "3" (default: "3")
+	statusMap        map[string]string                 // beads status → Jira status name (from jira.status_map.* config)
+	typeMap          map[string]string                 // beads type → Jira type (from jira.type_map.* config)
+	priorityMap      map[string]string                 // beads priority (as string "0"-"4") → Jira priority name (from jira.priority_map.* config)
+	customFields     map[string]interface{}            // Jira field name/id → value (from jira.custom_fields.* config)
+	typeCustomFields map[string]map[string]interface{} // Jira issue type → field name/id → value
 }
 
 func (m *jiraFieldMapper) PriorityToBeads(trackerPriority interface{}) int {
@@ -216,6 +218,21 @@ func (m *jiraFieldMapper) IssueToTracker(issue *types.Issue) map[string]interfac
 		fields["labels"] = issue.Labels
 	}
 
+	for fieldName, value := range m.customFields {
+		fields[fieldName] = value
+	}
+
+	if name, ok := typeName.(string); ok {
+		for jiraType, customFields := range m.typeCustomFields {
+			if !strings.EqualFold(jiraType, name) {
+				continue
+			}
+			for fieldName, value := range customFields {
+				fields[fieldName] = value
+			}
+		}
+	}
+
 	return fields
 }
 

internal/jira/tracker.go

@@ -2,6 +2,7 @@ package jira
 
 import (
 	"context"
+	"encoding/json"
 	"fmt"
 	"os"
 	"strconv"
@@ -22,14 +23,16 @@ func init() {
 
 // Tracker implements tracker.IssueTracker for Jira.
 type Tracker struct {
-	client      *Client
-	store       storage.Storage
-	jiraURL     string
-	projectKeys []string          // one or more project keys (first is primary)
-	apiVersion  string            // "2" or "3" (default: "3")
-	statusMap   map[string]string // beads status → Jira status name (from jira.status_map.* config)
-	typeMap     map[string]string // beads type → Jira type (from jira.type_map.* config)
-	priorityMap map[string]string // beads priority → Jira priority name (from jira.priority_map.* config)
+	client           *Client
+	store            storage.Storage
+	jiraURL          string
+	projectKeys      []string                          // one or more project keys (first is primary)
+	apiVersion       string                            // "2" or "3" (default: "3")
+	statusMap        map[string]string                 // beads status → Jira status name (from jira.status_map.* config)
+	typeMap          map[string]string                 // beads type → Jira type (from jira.type_map.* config)
+	priorityMap      map[string]string                 // beads priority → Jira priority name (from jira.priority_map.* config)
+	customFields     map[string]interface{}            // Jira field name/id → value (from jira.custom_fields.* config)
+	typeCustomFields map[string]map[string]interface{} // Jira issue type → Jira field name/id → value
 }
 
 // SetProjectKeys sets project keys before Init(). When set, Init() uses these
@@ -124,6 +127,44 @@ func (t *Tracker) Init(ctx context.Context, store storage.Storage) error {
 		if len(priorityMap) > 0 {
 			t.priorityMap = priorityMap
 		}
+
+		const customFieldPrefix = "jira.custom_fields."
+		customFields := make(map[string]interface{})
+		typeCustomFields := make(map[string]map[string]interface{})
+		for key, val := range allConfig {
+			if !strings.HasPrefix(key, customFieldPrefix) || strings.TrimSpace(val) == "" {
+				continue
+			}
+
+			suffix := strings.TrimPrefix(key, customFieldPrefix)
+			if suffix == "" {
+				continue
+			}
+
+			parsed, err := parseJiraCustomFieldValue(val)
+			if err != nil {
+				return fmt.Errorf("parse %s: %w", key, err)
+			}
+
+			parts := strings.SplitN(suffix, ".", 2)
+			if len(parts) == 2 {
+				if parts[0] == "" || parts[1] == "" {
+					continue
+				}
+				if typeCustomFields[parts[0]] == nil {
+					typeCustomFields[parts[0]] = make(map[string]interface{})
+				}
+				typeCustomFields[parts[0]][parts[1]] = parsed
+				continue
+			}
+			customFields[suffix] = parsed
+		}
+		if len(customFields) > 0 {
+			t.customFields = customFields
+		}
+		if len(typeCustomFields) > 0 {
+			t.typeCustomFields = typeCustomFields
+		}
 	}
 
 	return nil
@@ -273,7 +314,14 @@ func (t *Tracker) applyTransition(ctx context.Context, key string, status types.
 }
 
 func (t *Tracker) FieldMapper() tracker.FieldMapper {
-	return &jiraFieldMapper{apiVersion: t.apiVersion, statusMap: t.statusMap, typeMap: t.typeMap, priorityMap: t.priorityMap}
+	return &jiraFieldMapper{
+		apiVersion:       t.apiVersion,
+		statusMap:        t.statusMap,
+		typeMap:          t.typeMap,
+		priorityMap:      t.priorityMap,
+		customFields:     t.customFields,
+		typeCustomFields: t.typeCustomFields,
+	}
 }
 
 func (t *Tracker) IsExternalRef(ref string) bool {
@@ -318,6 +366,21 @@ func (t *Tracker) getConfig(ctx context.Context, key, envVar string) (string, er
 	return "", nil
 }
 
+func parseJiraCustomFieldValue(value string) (interface{}, error) {
+	trimmed := strings.TrimSpace(value)
+	if trimmed == "" {
+		return "", nil
+	}
+	if strings.HasPrefix(trimmed, "{") || strings.HasPrefix(trimmed, "[") {
+		var parsed interface{}
+		if err := json.Unmarshal([]byte(trimmed), &parsed); err != nil {
+			return nil, err
+		}
+		return parsed, nil
+	}
+	return trimmed, nil
+}
+
 // jiraToTrackerIssue converts a Jira API Issue to the generic TrackerIssue format.
 // priorityMap is optional (nil uses hardcoded defaults).
 func jiraToTrackerIssue(ji *Issue, priorityMap map[string]string) tracker.TrackerIssue {