generator

type CommandContext struct {
	// Identity
	Name       string
	ParentPath []string // empty = direct child of root

	// Display
	Short string
	Long  string

	// Routing / feature options
	Aliases          []string
	Args             string
	WithAssets       bool
	WithInitializer  bool
	PersistentPreRun bool
	PreRun           bool
	Protected        *bool
	Hidden           bool

	// Project-level settings (carried from the originating generator)
	ProjectPath string
	Force       bool
	UpdateDocs  bool
}

type CommandFlag struct {
	Default       string
	DefaultIsCode bool
	Description   string
	Hidden        bool
	Name          string
	Persistent    bool
	Required      bool
	Shorthand     string
	Type          string
}

type CommandPipeline struct {
	// contains filtered or unexported fields
}

type Config struct {
	Agentless        bool
	AIModel          string
	AIProvider       string
	Aliases          []string
	Args             string
	Flags            []string
	Force            bool
	Hidden           bool
	Overwrite        string // allow, deny, or ask (default ask)
	Long             string
	Name             string
	Parent           string
	Path             string
	PersistentPreRun bool
	PreRun           bool
	Prompt           string
	Protected        *bool
	ScriptPath       string
	Short            string
	UpdateDocs       bool
	WithAssets       bool
	WithInitializer  bool
}

type Generator struct {
	// contains filtered or unexported fields
}

type Manifest struct {
	Properties    ManifestProperties    `yaml:"properties"`
	ReleaseSource ManifestReleaseSource `yaml:"release_source"`
	Version       ManifestVersion       `yaml:"version"`
	Hashes        map[string]string     `yaml:"hashes,omitempty"` // project-level file hashes (relative path → SHA256)
	Commands      []ManifestCommand     `yaml:"commands,omitempty"`
}

type ManifestCommand struct {
	Name              string            `yaml:"name"`
	Description       MultilineString   `yaml:"description"`
	LongDescription   MultilineString   `yaml:"long_description,omitempty"`
	Aliases           []string          `yaml:"aliases,omitempty"`
	Hidden            bool              `yaml:"hidden,omitempty"`
	Args              string            `yaml:"args,omitempty"`
	Hash              string            `yaml:"hash,omitempty"` // Deprecated: use Hashes
	Hashes            map[string]string `yaml:"hashes,omitempty"`
	WithAssets        bool              `yaml:"with_assets,omitempty"`
	WithInitializer   bool              `yaml:"with_initializer,omitempty"`
	Protected         *bool             `yaml:"protected,omitempty"`
	PersistentPreRun  bool              `yaml:"persistent_pre_run,omitempty"`
	PreRun            bool              `yaml:"pre_run,omitempty"`
	MutuallyExclusive [][]string        `yaml:"mutually_exclusive,omitempty"`
	RequiredTogether  [][]string        `yaml:"required_together,omitempty"`
	Flags             []ManifestFlag    `yaml:"flags,omitempty"`
	Commands          []ManifestCommand `yaml:"commands,omitempty"`
	Warning           string            `yaml:"-"` // Used for comments
}

type ManifestCommandUpdate struct {
	Name             string
	Description      string
	LongDescription  string
	Aliases          []string
	Args             string
	Hashes           map[string]string
	Flags            []ManifestFlag
	WithAssets       bool
	WithInitializer  bool
	PersistentPreRun bool
	PreRun           bool
	Protected        *bool
	Hidden           bool
}

type ManifestFeature struct {
	Name    string `yaml:"name"`
	Enabled bool   `yaml:"enabled"`
}

type ManifestFlag struct {
	Name          string          `yaml:"name"`
	Type          string          `yaml:"type"`
	Description   MultilineString `yaml:"description"`
	Persistent    bool            `yaml:"persistent,omitempty"`
	Shorthand     string          `yaml:"shorthand,omitempty"`
	Default       string          `yaml:"default,omitempty"`
	DefaultIsCode bool            `yaml:"default_is_code,omitempty"`
	Required      bool            `yaml:"required,omitempty"`
	Hidden        bool            `yaml:"hidden,omitempty"`
	Warning       string          `yaml:"-"` // Used for comments
}

type ManifestHelp struct {
	Type         string `yaml:"type,omitempty"`
	SlackChannel string `yaml:"slack_channel,omitempty"`
	SlackTeam    string `yaml:"slack_team,omitempty"`
	TeamsChannel string `yaml:"teams_channel,omitempty"`
	TeamsTeam    string `yaml:"teams_team,omitempty"`
}

type ManifestProperties struct {
	Name        string            `yaml:"name"`
	Description MultilineString   `yaml:"description"`
	Features    []ManifestFeature `yaml:"features"`
	Help        ManifestHelp      `yaml:"help,omitempty"`
}

type ManifestReleaseSource struct {
	Type    string `yaml:"type"`
	Host    string `yaml:"host"`
	Owner   string `yaml:"owner"`
	Repo    string `yaml:"repo"`
	Private bool   `yaml:"private,omitempty"`
}

type ManifestVersion struct {
	GoToolBase string `yaml:"gtb"`
}

type MultilineString string

type PipelineOptions struct {
	SkipAssets        bool // do not generate asset files
	SkipDocumentation bool // do not run documentation generation
	SkipRegistration  bool // do not modify the parent cmd.go
}

type PipelineResult struct {
	Warnings []StepWarning
}

type SkeletonConfig struct {
	Name         string
	Repo         string
	Host         string
	Description  string
	Path         string
	GoVersion    string // overrides autodetected version when set
	Features     []ManifestFeature
	Private      bool   // true if the repository requires authentication to access
	HelpType     string // "slack", "teams", or ""
	SlackChannel string
	SlackTeam    string
	TeamsChannel string
	TeamsTeam    string
}

type StepWarning struct {
	Step string
	Err  error
}