feat: Support JSON Output Format

- Adds --json parameter to view and list commands
- Output contains formatted camelCase custom field names
- Limitation: without filtering, you may see customfield name conflict errors

Co-authored by Claude AI

Author: SudoBrendan

internal/cmd/issue/list/list.go

@@ -9,6 +9,7 @@ import (
 	"github.com/spf13/viper"
 
 	"github.com/ankitpokhrel/jira-cli/api"
+	"github.com/ankitpokhrel/jira-cli/internal/cmdcommon"
 	"github.com/ankitpokhrel/jira-cli/internal/cmdutil"
 	"github.com/ankitpokhrel/jira-cli/internal/query"
 	"github.com/ankitpokhrel/jira-cli/internal/view"
@@ -56,6 +57,9 @@ $ jira issue list --plain --delimeter "|"
 # List issues as raw JSON data
 $ jira issue list --raw
 
+# List issues in JSON with human-readable custom field names
+$ jira issue list --json
+
 # List issues of type "Epic" in status "Done"
 $ jira issue list -tEpic -sDone
 
@@ -133,9 +137,17 @@ func loadList(cmd *cobra.Command, args []string) {
 		return
 	}
 
+	jsonOutput, err := cmd.Flags().GetBool("json")
+	cmdutil.ExitIfError(err)
+
 	raw, err := cmd.Flags().GetBool("raw")
 	cmdutil.ExitIfError(err)
 
+	if jsonOutput {
+		outputJSON(issues)
+		return
+	}
+
 	if raw {
 		outputRawJSON(issues)
 		return
@@ -208,6 +220,31 @@ func outputRawJSON(issues []*jira.Issue) {
 	fmt.Println(string(data))
 }
 
+func outputJSON(issues []*jira.Issue) {
+	// Marshal issues to JSON first
+	rawJSON, err := json.Marshal(issues)
+	if err != nil {
+		cmdutil.Failed("Failed to marshal issues: %s", err)
+		return
+	}
+
+	// Get field mappings
+	fieldMappings, err := cmdcommon.GetConfiguredCustomFields()
+	if err != nil {
+		cmdutil.Warn("Unable to load custom field mappings: %s", err)
+		fieldMappings = []jira.IssueTypeField{}
+	}
+
+	// Convert custom field IDs to readable names
+	jsonOutput, err := jira.TransformIssueFields(rawJSON, fieldMappings)
+	if err != nil {
+		cmdutil.Failed("Failed to format JSON output: %s", err)
+		return
+	}
+
+	fmt.Println(string(jsonOutput))
+}
+
 // SetFlags sets flags supported by a list command.
 func SetFlags(cmd *cobra.Command) {
 	cmd.Flags().SortFlags = false
@@ -245,6 +282,7 @@ func SetFlags(cmd *cobra.Command) {
 	cmd.Flags().String("delimiter", "\t", "Custom delimeter for columns in plain mode. Works only with --plain")
 	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().Bool("csv", false, "Print output in CSV format")
 
 	if cmd.HasParent() && cmd.Parent().Name() != "sprint" {

internal/cmd/issue/view/view.go

@@ -7,6 +7,7 @@ import (
 	"github.com/spf13/viper"
 
 	"github.com/ankitpokhrel/jira-cli/api"
+	"github.com/ankitpokhrel/jira-cli/internal/cmdcommon"
 	"github.com/ankitpokhrel/jira-cli/internal/cmdutil"
 	tuiView "github.com/ankitpokhrel/jira-cli/internal/view"
 	"github.com/ankitpokhrel/jira-cli/pkg/jira"
@@ -21,9 +22,13 @@ const (
 $ jira issue view ISSUE-1 --comments 5
 
 # Get the raw JSON data
-$ jira issue view ISSUE-1 --raw`
+$ 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"
@@ -52,14 +57,22 @@ func NewCmdView() *cobra.Command {
 	cmd.Flags().Uint(flagComments, 1, "Show N comments")
 	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")
 
 	return &cmd
 }
 
 func view(cmd *cobra.Command, args []string) {
+	jsonOutput, err := cmd.Flags().GetBool(flagJSON)
+	cmdutil.ExitIfError(err)
+
 	raw, err := cmd.Flags().GetBool(flagRaw)
 	cmdutil.ExitIfError(err)
 
+	if jsonOutput {
+		viewJSON(cmd, args)
+		return
+	}
 	if raw {
 		viewRaw(cmd, args)
 		return
@@ -85,6 +98,39 @@ func viewRaw(cmd *cobra.Command, args []string) {
 	fmt.Println(apiResp)
 }
 
+func viewJSON(cmd *cobra.Command, args []string) {
+	debug, err := cmd.Flags().GetBool(flagDebug)
+	cmdutil.ExitIfError(err)
+
+	key := cmdutil.GetJiraIssueKey(viper.GetString(configProject), args[0])
+
+	// Get raw JSON
+	apiResp, err := func() (string, error) {
+		s := cmdutil.Info(messageFetchingData)
+		defer s.Stop()
+
+		client := api.DefaultClient(debug)
+		return api.ProxyGetIssueRaw(client, key)
+	}()
+	cmdutil.ExitIfError(err)
+
+	// Get custom field mappings from config
+	fieldMappings, err := cmdcommon.GetConfiguredCustomFields()
+	if err != nil {
+		cmdutil.Warn("Unable to load custom field mappings: %s", err)
+		fieldMappings = []jira.IssueTypeField{}
+	}
+
+	// Convert custom field IDs to readable names
+	jsonOutput, err := jira.TransformIssueFields([]byte(apiResp), fieldMappings)
+	if err != nil {
+		cmdutil.Failed("Failed to format JSON output: %s", err)
+		return
+	}
+
+	fmt.Println(string(jsonOutput))
+}
+
 func viewPretty(cmd *cobra.Command, args []string) {
 	debug, err := cmd.Flags().GetBool(flagDebug)
 	cmdutil.ExitIfError(err)