feat: Support Conflicting JSON Fields

- Adds support for --filter with --json so you can specify conflicting customfields
- Adds --no-warnings with --json if you don't care about conflicts

Co-authored by Claude AI

Author: SudoBrendan

README.md

@@ -195,6 +195,18 @@ $ jira issue list --plain
 # List recent issues in raw JSON format
 $ jira issue list --raw
 
+# List issues in JSON with human-readable custom field names
+$ jira issue list --json
+
+# Filter JSON output to specific fields
+$ jira issue list --json --filter "key,fields.summary,fields.status.name,fields.storyPoints"
+
+# Use customfield IDs in filter to bypass naming collisions
+$ jira issue list --json --filter "key,fields.customfield_10001"
+
+# Suppress collision warnings if you don't care about skipped fields
+$ jira issue list --json --no-warnings
+
 # List recent issues in csv format
 $ jira issue list --csv
 
@@ -437,6 +449,15 @@ not be the latest one if you for some reason have more than 5k comments in a tic
 ```sh
 # Show 5 recent comments when viewing the issue
 $ jira issue view ISSUE-1 --comments 5
+
+# Get JSON output with human-readable custom field names
+$ jira issue view ISSUE-1 --json
+
+# Filter JSON to specific fields
+$ jira issue view ISSUE-1 --json --filter "key,fields.summary,fields.storyPoints,fields.status.name"
+
+# Suppress collision warnings
+$ jira issue view ISSUE-1 --json --no-warnings
 ```
 
 #### Link

internal/cmd/issue/list/list.go

@@ -144,7 +144,23 @@ func loadList(cmd *cobra.Command, args []string) {
 	cmdutil.ExitIfError(err)
 
 	if jsonOutput {
-		outputJSON(issues)
+		// Get filter fields
+		filterStr, err := cmd.Flags().GetString("filter")
+		cmdutil.ExitIfError(err)
+
+		var filterFields []string
+		if filterStr != "" {
+			filterFields = strings.Split(filterStr, ",")
+			// Trim whitespace from each field
+			for i := range filterFields {
+				filterFields[i] = strings.TrimSpace(filterFields[i])
+			}
+		}
+
+		noWarnings, err := cmd.Flags().GetBool("no-warnings")
+		cmdutil.ExitIfError(err)
+
+		outputJSON(issues, filterFields, noWarnings)
 		return
 	}
 
@@ -220,7 +236,7 @@ func outputRawJSON(issues []*jira.Issue) {
 	fmt.Println(string(data))
 }
 
-func outputJSON(issues []*jira.Issue) {
+func outputJSON(issues []*jira.Issue, filter []string, noWarnings bool) {
 	// Marshal issues to JSON first
 	rawJSON, err := json.Marshal(issues)
 	if err != nil {
@@ -235,14 +251,21 @@ func outputJSON(issues []*jira.Issue) {
 		fieldMappings = []jira.IssueTypeField{}
 	}
 
-	// Convert custom field IDs to readable names
-	jsonOutput, err := jira.TransformIssueFields(rawJSON, fieldMappings)
+	// Convert custom field IDs to readable names and apply filter
+	result, err := jira.TransformIssueFields(rawJSON, fieldMappings, filter)
 	if err != nil {
 		cmdutil.Failed("Failed to format JSON output: %s", err)
 		return
 	}
 
-	fmt.Println(string(jsonOutput))
+	// Display warnings if any (unless suppressed)
+	if !noWarnings {
+		for _, warning := range result.Warnings {
+			cmdutil.Warn(warning)
+		}
+	}
+
+	fmt.Println(string(result.Data))
 }
 
 // SetFlags sets flags supported by a list command.
@@ -283,6 +306,8 @@ func SetFlags(cmd *cobra.Command) {
 	cmd.Flags().Uint("comments", 1, "Show N comments when viewing the issue")
 	cmd.Flags().Bool("raw", false, "Print raw JSON output")
 	cmd.Flags().Bool("json", false, "Print JSON output with human-readable custom field names")
+	cmd.Flags().String("filter", "", "Comma-separated list of fields to include in JSON output (e.g., 'key,fields.summary,fields.status.name'). Only works with --json")
+	cmd.Flags().Bool("no-warnings", false, "Suppress warnings about field name collisions. Only works with --json")
 	cmd.Flags().Bool("csv", false, "Print output in CSV format")
 
 	if cmd.HasParent() && cmd.Parent().Name() != "sprint" {

internal/cmd/issue/view/view.go

@@ -2,6 +2,7 @@ package view
 
 import (
 	"fmt"
+	"strings"
 
 	"github.com/spf13/cobra"
 	"github.com/spf13/viper"
@@ -27,11 +28,12 @@ $ jira issue view ISSUE-1 --raw
 # Get JSON output with human-readable custom field names
 $ jira issue view ISSUE-1 --json`
 
-	flagRaw      = "raw"
-	flagJSON     = "json"
-	flagDebug    = "debug"
-	flagComments = "comments"
-	flagPlain    = "plain"
+	flagRaw        = "raw"
+	flagJSON       = "json"
+	flagDebug      = "debug"
+	flagComments   = "comments"
+	flagPlain      = "plain"
+	flagNoWarnings = "no-warnings"
 
 	configProject = "project.key"
 	configServer  = "server"
@@ -58,6 +60,8 @@ func NewCmdView() *cobra.Command {
 	cmd.Flags().Bool(flagPlain, false, "Display output in plain mode")
 	cmd.Flags().Bool(flagRaw, false, "Print raw Jira API response")
 	cmd.Flags().Bool(flagJSON, false, "Print JSON output with human-readable custom field names")
+	cmd.Flags().String("filter", "", "Comma-separated list of fields to include in JSON output (e.g., 'key,fields.summary,fields.status.name'). Only works with --json")
+	cmd.Flags().Bool(flagNoWarnings, false, "Suppress warnings about field name collisions. Only works with --json")
 
 	return &cmd
 }
@@ -121,14 +125,37 @@ func viewJSON(cmd *cobra.Command, args []string) {
 		fieldMappings = []jira.IssueTypeField{}
 	}
 
-	// Convert custom field IDs to readable names
-	jsonOutput, err := jira.TransformIssueFields([]byte(apiResp), fieldMappings)
+	// Get filter fields
+	filterStr, err := cmd.Flags().GetString("filter")
+	cmdutil.ExitIfError(err)
+
+	var filterFields []string
+	if filterStr != "" {
+		filterFields = strings.Split(filterStr, ",")
+		// Trim whitespace from each field
+		for i := range filterFields {
+			filterFields[i] = strings.TrimSpace(filterFields[i])
+		}
+	}
+
+	// Convert custom field IDs to readable names and apply filter
+	result, err := jira.TransformIssueFields([]byte(apiResp), fieldMappings, filterFields)
 	if err != nil {
 		cmdutil.Failed("Failed to format JSON output: %s", err)
 		return
 	}
 
-	fmt.Println(string(jsonOutput))
+	// Display warnings if any (unless suppressed)
+	noWarnings, err := cmd.Flags().GetBool(flagNoWarnings)
+	cmdutil.ExitIfError(err)
+
+	if !noWarnings {
+		for _, warning := range result.Warnings {
+			cmdutil.Warn(warning)
+		}
+	}
+
+	fmt.Println(string(result.Data))
 }
 
 func viewPretty(cmd *cobra.Command, args []string) {