cmdutil

Jul 23, 2026

Changes in this version

+ func ExtendFlagEnum(flag *pflag.Flag, enum, enumTerse []string)

+ func JiraClientForProfileContext(ctx context.Context, cmd *cobra.Command, profile config.Profile) (*jira.Client, config.Profile, bool, error)

Jul 21, 2026

Changes in this version

+ type IssueRef struct

+ ID string

+ Key string

+ Self string

+ func (r IssueRef) String() string

Jul 12, 2026

Changes in this version

type ServiceFactory

+ func (f *ServiceFactory) Rank() jira.RankService

Jul 12, 2026

Changes in this version

+ func RecordIssueKeys(cmd *cobra.Command, keys ...string)

+ func RecordIssuesSeen(cmd *cobra.Command, issues []*jira.Issue)

Jul 12, 2026

Changes in this version

+ func APIElapsedFor(cmd *cobra.Command) time.Duration

+ func WithAPIElapsedSink(ctx context.Context) context.Context

Jul 12, 2026

Changes in this version

+ func SpinPreview(cmd *cobra.Command, op string, fn func(context.Context) error) error

type KeyResult

+ func FanOutKeysProgressPreview[T any](ctx context.Context, op string, keys []string, parallelism int, ...) ([]KeyResult[T], error)

Jul 6, 2026

Changes in this version

+ func IssueOutputFields(issues []*jira.Issue, fields []string) []map[string]any

Jul 3, 2026

Changes in this version

+ func DrainTruncationWarnings(info jira.DrainInfo) []map[string]any

+ func PaginationFromResponse(resp *jira.Response) *cli.Pagination

Jul 3, 2026

Changes in this version

+ func AddMarkdownFlag(cmd *cobra.Command, p, file *string, usage, alias string)

+ func MarkdownFlagChanged(cmd *cobra.Command, alias string) bool

+ func ResolveMarkdownInput(inline, file string) (string, error)

Jun 30, 2026

Changes in this version

+ func AddBool(fs *pflag.FlagSet, name string, value bool, usage string, extra clib.FlagExtra) *bool

+ func AddBoolP(fs *pflag.FlagSet, name, shorthand string, value bool, usage string, ...) *bool

+ func AddBoolVar(fs *pflag.FlagSet, p *bool, name string, value bool, usage string, ...)

+ func AddDryRunFlag(flags *pflag.FlagSet, p *bool, usage string)

+ func AddDuration(fs *pflag.FlagSet, name string, value time.Duration, usage string, ...) *time.Duration

+ func AddFileFlag(flags *pflag.FlagSet, p *string, name, value, usage, group, placeholder string)

+ func AddForceFlag(flags *pflag.FlagSet, p *bool, usage string)

+ func AddInt(fs *pflag.FlagSet, name string, value int, usage string, extra clib.FlagExtra) *int

+ func AddIntVar(fs *pflag.FlagSet, p *int, name string, value int, usage string, ...)

+ func AddString(fs *pflag.FlagSet, name, value, usage string, extra clib.FlagExtra) *string

+ func AddStringArrayVar(fs *pflag.FlagSet, p *[]string, name string, value []string, usage string, ...)

+ func AddStringP(fs *pflag.FlagSet, name, shorthand, value, usage string, extra clib.FlagExtra) *string

+ func AddStringSliceVar(fs *pflag.FlagSet, p *[]string, name string, value []string, usage string, ...)

+ func AddStringVar(fs *pflag.FlagSet, p *string, name, value, usage string, extra clib.FlagExtra)

+ func GroupRank(title string) int

Jun 9, 2026

Changes in this version

+ func RecordRateNearLimit(ctx context.Context, rate jira.Rate)

+ func WithRateWarnSink(ctx context.Context) context.Context

Jun 9, 2026

Changes in this version

+ const DefaultMaxRetryWait

+ func MaxRetryWaitFor(cmd *cobra.Command) time.Duration

Jun 8, 2026

Changes in this version

+ func HumanJSONPrintTheme(cmd *cobra.Command) *clogtheme.Theme

+ func Spin(cmd *cobra.Command, op string, fn func(context.Context) error) error

type KeyResult

+ func FanOutKeysProgress[T any](ctx context.Context, op string, keys []string, parallelism int, ...) ([]KeyResult[T], error)

Jun 4, 2026

Changes in this version

+ func WriteEnvelopeWithPaginationAndRawWarnings(cmd *cobra.Command, command string, data any, pagination *cli.Pagination, ...) error

type ServiceFactory

+ func (f *ServiceFactory) JQL() jira.JQLService

Jun 1, 2026

Changes in this version

+ func AddIssueColumnFlags(flags *pflag.FlagSet, columns *[]string, tsv *bool)

+ func PrimeAndCacheBoards(ctx context.Context, cacheKey string, client *jira.Client, ttlMinutes int, ...) (jira.BoardsCacheFile, cache.Entry, []map[string]any, error)

+ func WriteWebEnvelope(cmd *cobra.Command, command, url string, extra map[string]any) error

+ type ServiceFactory struct

+ func (f *ServiceFactory) Attachment() jira.AttachmentService

+ func (f *ServiceFactory) Board() jira.BoardService

+ func (f *ServiceFactory) Comment() jira.CommentService

+ func (f *ServiceFactory) Epic() jira.EpicService

+ func (f *ServiceFactory) Issue() jira.IssueService

+ func (f *ServiceFactory) IssueLink() jira.IssueLinkService

+ func (f *ServiceFactory) IssueLinkType() jira.IssueLinkTypeService

+ func (f *ServiceFactory) Label() jira.LabelService

+ func (f *ServiceFactory) Project(ttl time.Duration) jira.ProjectService

+ func (f *ServiceFactory) Search() jira.SearchService

+ func (f *ServiceFactory) User() jira.UserService

+ func (f *ServiceFactory) Watcher() jira.WatcherService

+ func (f *ServiceFactory) Worklog() jira.WorklogService

May 29, 2026

Changes in this version

+ func AddParallelismFlag(cmd *cobra.Command, target *int)

+ func DiagnosticWritten(err error) error

+ func KeyedDataWithWarnings(warnings []adf.Warning) func(string, map[string]any) any

+ func WriteEnvelopeWithResponseAndErrors(cmd *cobra.Command, command string, data any, resp *jira.Response, ...) error

+ func WriteKeyedResultsEnvelope[T any](cmd *cobra.Command, command string, results []KeyResult[T], ...) error

+ type DiagnosticWrittenError struct

+ Inner error

+ func (e DiagnosticWrittenError) Error() string

+ func (e DiagnosticWrittenError) Unwrap() error

+ type KeyResult struct

+ Err error

+ Key string

+ Value T

+ func FanOutKeys[T any](ctx context.Context, keys []string, parallelism int, ...) ([]KeyResult[T], error)

+ type KeyedResult struct

+ Data any

+ Error *cli.Error

+ Key string

+ OK bool

+ type KeyedResultsData struct

+ Failed int

+ Results []KeyedResult

+ Succeeded int

May 28, 2026

Changes in this version

+ func IsStructuredAgentCommand(cmd *cobra.Command) bool

+ func UseHumanJSONOutput(cmd *cobra.Command) bool

May 28, 2026

Changes in this version

+ const CacheStateEmpty

+ const CacheStateFresh

+ const CacheStateMalformed

+ const CacheStateMissing

+ const CacheStateRefresh

+ const CacheStateStale

+ func ADFModeFor(cmd *cobra.Command, mutation bool) adfmode.Mode

+ func ActiveProfile(cmd *cobra.Command, cfg *config.Config) config.Profile

+ func AddCacheStateFields(data map[string]any, sourceState string, count int)

+ func AssigneeSummary(user *jira.User) map[string]any

+ func CacheConfigPath(cmd *cobra.Command) string

+ func CacheKeyForProfile(cmd *cobra.Command, profile config.Profile) string

+ func CacheKeyFromStartup(globals startup.Globals, cfg *config.Config, profileName string) string

+ func CacheReadOrFetch(profile, resource string, ttl time.Duration, refresh bool, ...) (json.RawMessage, bool, time.Time, string, error)

+ func CacheStateForCount(sourceState string, count int) string

+ func CompleteProfileNames(cmd *cobra.Command, _ []string, _ string) ([]string, cobra.ShellCompDirective)

+ func ConfigPath(cmd *cobra.Command) string

+ func ConfiguredEditorFor(cmd *cobra.Command) string

+ func CopyAnyMap(in map[string]any) map[string]any

+ func CredentialStoreFor(backend config.SecretBackend) config.CredentialStore

+ func DetectorFromContext(cmd *cobra.Command) cli.Detection

+ func EnvelopeWritten(err error) error

+ func ExistingProfileOrDefault(cfg *config.Config, name string) config.Profile

+ func ExtendDryRunFlag(flags *pflag.FlagSet)

+ func ExtendFileFlag(flags *pflag.FlagSet, name, group, placeholder string)

+ func ExtendFlag(flags *pflag.FlagSet, name string, extra clib.FlagExtra)

+ func ExtendForceFlag(flags *pflag.FlagSet)

+ func ExtendPaginationFlags(flags *pflag.FlagSet)

+ func ExtendRefreshFlags(flags *pflag.FlagSet)

+ func ExtendSafetyFlag(flags *pflag.FlagSet, name string)

+ func ExtendWatcherUserFlag(flags *pflag.FlagSet)

+ func ExtendWatcherValidationFlags(flags *pflag.FlagSet)

+ func FirstNonEmpty(values ...string) string

+ func FoldRawWarningsIntoData(data any, warnings []map[string]any) any

+ func FoldWarningsIntoData(data any, warnings []cli.Warning) any

+ func GroupCommand(use, short, group string) *cobra.Command

+ func IssueOutput(issues []*jira.Issue, detail bool) any

+ func IssueService(client *jira.Client) jira.IssueService

+ func IssueSummary(issue *jira.Issue) map[string]any

+ func JiraClientForCommand(cmd *cobra.Command) (*jira.Client, config.Profile, bool, error)

+ func JiraClientForProfile(cmd *cobra.Command, profile config.Profile) (*jira.Client, config.Profile, bool, error)

+ func MarshalNonNilSlice(v any) (json.RawMessage, error)

+ func MirrorADFWarningsToStderr(stderr io.Writer, warnings []cli.Warning) error

+ func NewHelpRenderer() *help.Renderer

+ func NoInputRequested(cmd *cobra.Command) bool

+ func PlainOptionsForCommand(cmd *cobra.Command) []cli.PlainOption

+ func PrimeBoards(ctx context.Context, client *jira.Client, ttlMinutes int, unbounded bool) (jira.BoardsCacheFile, []map[string]any, error)

+ func ProfileForCommand(cmd *cobra.Command) (config.Profile, error)

+ func ProfileForEnvelope(cmd *cobra.Command) string

+ func RawWarningsToCLI(warnings []map[string]any) []cli.Warning

+ func ReadJSONFile(path string, dst any) error

+ func ReadOnlyEnabled(cmd *cobra.Command) bool

+ func RecordCredentialWarnings(cmd *cobra.Command, warns []string)

+ func RequestedProfile(cmd *cobra.Command) string

+ func SearchService(client *jira.Client) jira.SearchService

+ func SecretRefFor(profile config.Profile, backend config.SecretBackend) (config.SecretRef, error)

+ func StandardHelpSections(cmd *cobra.Command) []help.Section

+ func StringFromAny(v any) string

+ func UpsertProfile(cfg *config.Config, profile config.Profile)

+ func UseCompactOutput(cmd *cobra.Command) bool

+ func UsePlainOutput(cmd *cobra.Command) bool

+ func WireObjectString(v any, key string) string

+ func WithCredentialWarnSink(ctx context.Context) context.Context

+ func WithDetector(ctx context.Context, det cli.Detection) context.Context

+ func WorklogService(client *jira.Client) jira.WorklogService

+ func WriteEnvelope(cmd *cobra.Command, command string, data any) error

+ func WriteEnvelopeWithErrors(cmd *cobra.Command, command string, data any, errorsOut []cli.Error) error

+ func WriteEnvelopeWithRawWarnings(cmd *cobra.Command, command string, data any, warnings []map[string]any) error

+ func WriteEnvelopeWithResponse(cmd *cobra.Command, command string, data any, resp *jira.Response) error

+ func WriteEnvelopeWithResponseAndWarnings(cmd *cobra.Command, command string, data any, resp *jira.Response, ...) error

+ func WriteEnvelopeWithWarnings(cmd *cobra.Command, command string, data any, warnings []adf.Warning) error

+ type EnvelopeWrittenError struct

+ Inner error

+ func (e EnvelopeWrittenError) Error() string

+ func (e EnvelopeWrittenError) Unwrap() error

+ type JiraServiceFactory interface

+ Issue func() jira.IssueService

+ Project func(time.Duration) jira.ProjectService

+ Search func() jira.SearchService

+ Worklog func() jira.WorklogService

+ func ServicesForClient(client *jira.Client) JiraServiceFactory