compat

type CommandFactory func(runner executor.Runner) *cobra.Command

type FlagBinding struct {
	FlagName string
	Alias    string
	// Aliases are additional hidden flag names that map to the same MCP
	// parameter. Any of them being set satisfies Required, and the value
	// is resolved via firstChangedFlag(FlagName, Alias, Aliases...).
	// Mirrors cmdutil.ValidateRequiredFlagWithAliases / FlagOrFallback.
	Aliases []string
	// PipelineLocal, when true, marks this binding as CLI-side only — its
	// value is consumed by the pipeline executor (e.g. as an HTTP
	// download destination) and NOT forwarded to any MCP tool's params.
	PipelineLocal bool
	Short         string
	Property      string
	Kind          ValueKind
	Usage         string
	Required      bool
	// Default is the cobra-level flag default value as a string. Parsed
	// into the Kind-appropriate primitive at registration time. Empty
	// string keeps the existing zero-value default. This only affects
	// what cobra renders in --help (the "(default ...)" suffix); it does
	// NOT inject the value into MCP params on its own — CollectBindings
	// still gates writes by user-changed flags via firstChangedFlag.
	Default string
	// Positional binds this parameter to a positional CLI argument rather
	// than a --flag. PositionalIndex is the 0-based slot.
	Positional      bool
	PositionalIndex int
}

type Normalizer func(cmd *cobra.Command, params map[string]any) error

type Route struct {
	Use      string
	Aliases  []string
	Short    string
	Long     string
	Example  string
	Hidden   bool
	Target   Target
	Bindings []FlagBinding
	// Pipeline, when non-empty, replaces the single-tool dispatch with a
	// multi-step orchestration. NewDirectCommand sees this and wires the
	// pipeline executor into RunE instead of the standard
	// invoke-then-output flow. See internal/compat/pipeline.go.
	Pipeline   []market.PipelineStep
	Normalizer Normalizer
	// OutputTransform, when non-nil, post-processes the MCP response payload
	// (rename / drop / columns) before the formatter emits it. Wired up from
	// CLIToolOverride.OutputFormat. See discovery-schema-v3 §2.5.
	OutputTransform func(map[string]any) map[string]any
	// RejectPositional forces cobra.NoArgs on the generated leaf when no
	// positional bindings exist, so stray positional tokens (e.g.
	// `dws contact label list unexpected`) exit non-zero. Sourced from
	// CLIToolOverride.RejectPositional. Ignored when the leaf already
	// declares positional bindings — their arity validator wins.
	RejectPositional bool
	// RequireTogether groups flag aliases that must all be set together (or
	// all left unset). Each inner slice produces one PreRunE cross-field
	// check. Sourced from CLIToolOverride.RequireTogether. Unknown flag
	// names are logged and skipped at command-build time (consistent with
	// applyFlagConstraints semantics).
	RequireTogether [][]string
}

type Target struct {
	CanonicalProduct string
	Tool             string
}

type ValueKind string