commands

type ConvertFlags struct {
	Target     string
	Output     string
	Strict     bool
	NoWarnings bool
	Quiet      bool
	SourceMap  bool
}

type DiffFlags struct {
	Breaking  bool
	NoInfo    bool
	Format    string
	SourceMap bool
}

type ExtensionExpr struct {
	Key     string  // e.g., "x-audited-by"
	Value   *string // nil = existence check only
	Negated bool    // ! prefix or != operator
}

type ExtensionFilter struct {
	Groups [][]ExtensionExpr
}

type FixFlags struct {
	Output    string
	Infer     bool
	Quiet     bool
	SourceMap bool

	// Schema name fixing flags
	FixSchemaNames        bool
	GenericNaming         string
	GenericSeparator      string
	GenericParamSeparator string
	PreserveCasing        bool

	// Pruning flags
	PruneSchemas bool
	PrunePaths   bool
	PruneAll     bool

	// Duplicate operationId fixing flags
	FixDuplicateOperationIds bool
	OperationIdTemplate      string
	OperationIdPathSep       string
	OperationIdTagSep        string

	// Stub missing refs flags
	StubMissingRefs  bool
	StubResponseDesc string

	// Dry run flag
	DryRun bool
}

type GenerateFlags struct {
	Output       string
	PackageName  string
	Client       bool
	Server       bool
	Types        bool
	NoPointers   bool
	NoValidation bool
	Strict       bool
	NoWarnings   bool
	SourceMap    bool

	// Security generation options
	NoSecurity      bool
	OAuth2Flows     bool
	CredentialMgmt  bool
	SecurityEnforce bool
	OIDCDiscovery   bool
	NoReadme        bool

	// File splitting options
	MaxLinesPerFile int
	MaxTypesPerFile int
	MaxOpsPerFile   int
	SplitByTag      bool
	NoSplitByTag    bool
	SplitByPath     bool
	NoSplitByPath   bool

	// Server generation options
	ServerRouter     string
	ServerMiddleware bool
	ServerBinder     bool
	ServerResponses  bool
	ServerStubs      bool
	ServerEmbedSpec  bool
	ServerAll        bool
}

type JoinFlags struct {
	Output            string
	PathStrategy      string
	SchemaStrategy    string
	ComponentStrategy string
	NoMergeArrays     bool
	NoDedupTags       bool
	Quiet             bool
	SourceMap         bool
	// Advanced collision strategies
	RenameTemplate  string
	EquivalenceMode string
	CollisionReport bool
	SemanticDedup   bool
	// Namespace prefix configuration
	NamespacePrefix namespacePrefixFlag
	AlwaysPrefix    bool
	// Operation context configuration
	OperationContext       bool
	PrimaryOperationPolicy string
	// Overlay configuration
	PreOverlays stringSliceFlag
	PostOverlay string
}

type OverlayApplyFlags struct {
	Spec   string
	Output string
	Strict bool
	Quiet  bool
	DryRun bool
}

type OverlayValidateFlags struct {
	Quiet bool
}

type ParseFlags struct {
	ResolveRefs       bool
	ResolveHTTPRefs   bool
	Insecure          bool
	ValidateStructure bool
	Quiet             bool
}

type ValidateFlags struct {
	Strict            bool
	ValidateStructure bool
	NoWarnings        bool
	Quiet             bool
	Format            string
	SourceMap         bool
	IncludeDocument   bool
}

type WalkFlags struct {
	Format      string // Output format: text, json, yaml.
	Quiet       bool   // Suppress headers and decoration for piping.
	Detail      bool   // Show full node instead of summary table.
	Extension   string // Extension filter expression (e.g., "x-internal=true").
	ResolveRefs bool   // Resolve $ref pointers before output.
}