pipeline

type CustomFieldDecision struct {
	Fatal   bool
	Forward bool
	Warning string
}

type CustomFieldError struct {
	Field  string
	Reason string
}

type FieldValidationError struct {
	Field     string
	Project   string
	IssueType string
	Operation string
	Reason    string
}

type Input struct {
	Mode adfmode.Mode

	// Stage 1 — parse.
	ParseError string

	// Stage 2 — ADF.
	ADFInvalid bool   // strict: fatal; best-effort: degradable iff ADFWarning set
	ADFWarning string // if non-empty, surfaces as a stage-2 warning

	// Stage 3 — field schema.
	FieldOnScreen bool

	// Stage 4 — customfield encoding.
	CustomEncodeOK bool

	// Stage 5.
	DryRun bool
}

type MutationInput struct {
	Mode adfmode.Mode

	// Stage 1 — parse / shape. Set by the caller after pulling values
	// out of cobra flags + --json-input. Empty means parse succeeded.
	ParseError string

	// Stage 2 — ADF + compatibility. The Document the caller built
	// (typically via adf.FromMarkdown for --description-markdown, or
	// via --json-input for raw ADF). FieldCompat selects per-field
	// compatibility (inlineCard rules).
	ADFDoc      *adf.Document
	FieldCompat *adf.FieldCompatibility

	// NamedADFDocs holds additional ADF substructures keyed by their
	// field name (e.g. "description_adf"). All are validated through
	// ValidateDoc at stage 2 with the same mode as ADFDoc. This is the
	// hook used by issue create --json-input to catch garbage ADF in
	// payload subfields.
	NamedADFDocs map[string]adf.Document

	// MarkdownWarnings carries warnings produced when the caller
	// converted Markdown input to ADF (adf.FromMarkdownLossy). A lossy
	// conversion means user content was dropped before the document
	// even reached the pipeline. In strict mode any lossy warning here
	// aborts the mutation at stage 2; in best-effort mode the warnings
	// are surfaced and the partial document proceeds.
	MarkdownWarnings []adf.Warning

	// Stage 3 — field schema / screen. Either Schema (preloaded) or
	// SchemaFetcher (lazy with refresh-once + known-safe fallback).
	Schema        ScreenSchema
	SchemaFetcher SchemaFetcher
	// ScreenValidationExemptFields skips stage 3 only for native fields
	// that are already in Jira's API-ready shape. customfield_NNNNN keys
	// still go through screen validation so their schema-backed encoding
	// remains available in stage 4.
	ScreenValidationExemptFields map[string]bool

	// Stage 4 — customfield encoding. The Fields map is what the caller
	// would post to Jira's REST API. Each customfield_xxxxx value is
	// validated through pkg/jira/customfield.Registry.
	Fields map[string]any

	// Stage 5.
	DryRun bool
}

type MutationResult struct {
	Aborted      bool
	AbortedAt    Stage
	Submitted    bool
	PreviewReady bool

	// SubmitFields is the post-validation, post-encoding fields map the
	// caller should send to Jira. In strict-abort cases this is nil.
	SubmitFields map[string]any
	// SubmitADF is the post-validation ADF doc (after compatibility
	// passes). nil if no doc was supplied.
	SubmitADF *adf.Document
	// Warnings collected from every stage that ran. Non-empty even when
	// a later stage aborted — earlier-stage observations always survive.
	Warnings []adf.Warning
	Err      error
}

type Result struct {
	Aborted      bool
	AbortedAt    Stage
	Submitted    bool
	PreviewReady bool
	Warnings     []adf.Warning
	Err          error
}

type SchemaFetcher func() (ScreenSchema, error)

type ScreenSchema struct {
	Project     string
	IssueType   string
	ValidFields map[string]bool
	FieldTypes  map[string]string
}

type Stage int