generate

type AddFlagOptions struct {
	CommandName string
	FlagName    string
	FlagType    string
	Description string
	Persistent  bool
	Shorthand   string
	Path        string
}

type CommandOptions struct {
	Name                 string
	Short                string
	Long                 string
	Path                 string
	WithAssets           bool
	Parent               string
	Args                 string
	Flags                []string
	AliasesInput         string // For form input
	Aliases              []string
	ScriptPath           string
	Prompt               string
	MaxSteps             int
	NonInteractive       bool
	PersistentPreRun     bool
	PreRun               bool
	Force                bool
	WithInitializer      bool
	WithConfigValidation bool
	Protected            *bool
	MCPEnabled           *bool    // tri-state MCP exposure; nil = default (exposed)
	ExposeToMCP          bool     // interactive-form value; true = exposed (default)
	Options              []string // For MultiSelect
	AddFlags             bool     // Whether to show the flag entry stage
	AddPrompt            bool     // Whether to show the AI prompt stage
	// contains filtered or unexported fields
}

type DocsOptions struct {
	Name            string
	Path            string
	Parent          string
	CommandName     string
	PackagePath     string
	LegacySrc       string
	PublicAPI       bool
	NoAIAttribution bool
	// contains filtered or unexported fields
}

type FlagFormInput struct {
	Name          string
	Type          string
	Description   string
	Persistent    bool
	Shorthand     string
	Required      bool
	Default       string
	DefaultIsCode bool
	AddAnother    bool
}

type ManOptions struct {
	Dir     string
	Section string
	Source  string
	Manual  string
	Date    string
	// contains filtered or unexported fields
}

type SharedFlags struct {
	AIProvider string
	AIModel    string
	DryRun     bool
	AI         bool
	NoAI       bool
}

type SkeletonOptions struct {
	Name         string
	ForgeBackend string
	Repo         string
	Host         string
	Private      bool
	Description  string
	Path         string
	GoVersion    string
	Features     []string
	HelpType     string
	Overwrite    string
	SlackChannel string
	SlackTeam    string
	TeamsChannel string
	TeamsTeam    string
	EnvPrefix    string

	// UpdatePolicy is the generated tool's self-update posture baseline
	// (disabled / prompt / enabled). Empty leaves it unset so the framework
	// default (disabled) applies.
	UpdatePolicy string
	// MCPMode is the MCP publication mode (spec 0201 D3).
	MCPMode string
	// MCPExposed are the command paths ticked on the revisit wizard's surface
	// page; mcpCommands is what the page offers, loaded from the manifest
	// (spec 0202 D9).
	MCPExposed []string

	// UpdateCheckInterval is the generated tool's baseline self-update-check
	// throttle as a Go duration string (e.g. "24h"). Empty leaves it unset so
	// the framework default (24h) applies.
	UpdateCheckInterval string

	// NoForge marks a project that is not hosted on a forge (spec 0195 D3):
	// no backend, no repository, and Module names the Go module path.
	NoForge bool

	// Module is the Go module path; required with NoForge, an override of
	// <host>/<org>/<repo> otherwise (spec 0195 D5, OQ6).
	Module string
	// ForgeCredentials are further forges enabled for their credential
	// wizard and adapter only (spec 0195 D6).
	ForgeCredentials []string
	// ReleaseChannel is forge or static when update is enabled (spec 0195
	// D7, spec 0203 D1); empty resolves to forge for a hosted project.
	ReleaseChannel string
	// ReleaseBaseURL is the static channel's location (spec 0203 D1).
	ReleaseBaseURL string

	// CIComponentSource overrides the phpboyscout/cicd include base in the
	// scaffolded GitLab pipeline (GitLab backend only). Empty uses the
	// framework default, gitlab.com/phpboyscout/cicd.
	CIComponentSource string

	// Git post-generation step. NoGit opts out of the default init + initial
	// commit; Push (opt-in) additionally adds the derived remote and pushes;
	// GitBranch overrides the default branch the initial commit lands on.
	NoGit     bool
	Push      bool
	GitBranch string

	// Signing (off by default). When Signing is true the generated tool
	// scaffolds internal/trustkeys and wires props.Signing. require_signature
	// is intentionally not collectable here — it stays false until a signed
	// release has shipped and is only ever flipped via `gtb enable signing`.
	Signing                          bool
	SigningEmail                     string
	SigningKeySource                 string
	SigningRequireExternalCrosscheck bool
	// Release-pipeline fields. Recording a key id wires the generated
	// GoReleaser signs block; backend/region/public-key default in the
	// generator when a key id is set.
	SigningBackend   string
	SigningKeyID     string
	SigningKMSRegion string
	SigningPublicKey string

	// ChatProviders is what cmd/<name>/chat.go links, as chat.Provider names:
	// a shortcut for wiring go/chat modules, recorded whether or not the ai
	// feature is on (#94). Nothing by default; ai with no explicit list takes
	// every provider the framework can configure, and an explicit empty list
	// with ai is refused (spec 0194 D5, D7, OQ4, OQ5).
	ChatProviders []string
	// ChatProvidersSet records that the list was given, so ai can tell an
	// omitted list (take the defaults) from an empty one (refused).
	ChatProvidersSet bool

	// TelemetryEndpoint and TelemetryOTelEndpoint are where the telemetry
	// feature sends; recorded under properties.telemetry (spec 0197 D4).
	TelemetryEndpoint     string
	TelemetryOTelEndpoint string
	// Bootstrap is the config-bootstrap posture (auto-initialise, the commands
	// that skip the config check, the auxiliary fast-path commands).
	Bootstrap generator.ManifestBootstrap
	// ConfigLayers declares which config-stack layers the tool wires; empty
	// inherits the framework default.
	ConfigLayers []string
	// ConfigFormats are the config formats the tool links beyond YAML, and
	// ConfigFormat its own (spec 0204 D2).
	ConfigFormats []string
	ConfigFormat  string
	// ConfigKeyCase is the config stack's key mode, folded or exact (spec 0209).
	ConfigKeyCase string
	// ConfigSources are the declared source slots as name=kind, and the two
	// lists name the optional and the writable ones (spec 0204 D15).
	ConfigSources         []string
	ConfigSourcesOptional []string
	ConfigSourcesWritable []string

	// SigningRequireSignature and SigningRequireChecksum are the enforcement
	// baselines. Only the checksum one is asked on a first run; the signature
	// one is a footgun before a signed release has shipped (0071), so the
	// wizard asks it only on a revisit (spec 0197 D5).
	SigningRequireSignature bool
	SigningRequireChecksum  bool

	// NoVerify skips go mod tidy and golangci-lint after generation; the run
	// then exits 0 having emitted files it did not verify (spec 0197 D10).
	NoVerify bool

	// ChatDefault is the author's default provider, model and addressing,
	// recorded in the manifest and shipped as the tool's lowest config layer.
	// Required when several providers are linked (spec 0196 D1, D9).
	ChatDefault generator.ManifestChatDefault
	// ChatToolBridge false opts out of linking the tool bridge a local-CLI
	// provider needs; nil keeps the default rule (#104).
	ChatToolBridge *bool
	// GeneratorAI is the project's recorded choice on gtb calling a model
	// while generating it; nil defers to the person's generator.ai (spec 0211).
	GeneratorAI *bool

	// Templates carries the custom template-overlay specs (<src>@<ref>)
	// supplied via --template (repeatable). Each is parsed into a manifest
	// TemplateSource and layered over the embedded skeleton.
	Templates []string
	// contains filtered or unexported fields
}

type WizardOptions struct {
	Path   string
	DryRun bool
	// contains filtered or unexported fields
}