templates

type CommandData struct {
	Package                  string
	PascalName               string
	Name                     string
	Aliases                  []string
	Args                     string
	Short                    string
	Long                     string
	Hidden                   bool
	WithAssets               bool
	Flags                    []CommandFlag
	PersistentFlags          []CommandFlag
	AncestralPersistentFlags []CommandFlag
	MutuallyExclusive        [][]string
	RequiredTogether         [][]string
	Logic                    string
	Imports                  []string
	FullFileContent          string
	TestCode                 string
	Recommendations          []string
	PersistentPreRun         bool
	PreRun                   bool
	HasSubcommands           bool
	// PureGroup marks a command that only groups its subcommands and so has no
	// run logic of its own — see Generator.pureGroup for how it is decided.
	// Such a command gets no Run<Name>, and its RunE is the framework's.
	PureGroup            bool
	WithInitializer      bool
	WithConfigValidation bool
	Hashes               map[string]string
	// MCPExposure controls whether the generated command stamps a
	// setup.ExcludeFromMCP / setup.IncludeInMCP marker. The zero value
	// (Inherit) emits nothing.
	MCPExposure setup.MCPExposure
}

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

type FeatureDescriptor struct {
	// Cmd is the feature's props.FeatureID; its string value is the
	// config/manifest name (e.g. "ai").
	Cmd props.FeatureID
	// ConstPackage is the import path of the package declaring ConstName.
	// Built-ins live in props; forge features live in pkg/setup/forge. The
	// emitter qualifies against this rather than assuming props, which is what
	// previously made forge features unemittable.
	ConstPackage string
	// ConstName is the exported Go identifier of the constant as it appears in
	// generated source, e.g. "AiCmd". It cannot be derived reliably from the
	// value (mcp -> McpCmd), so it is recorded explicitly.
	ConstName string
	// Default is the framework default-enabled state, mirroring
	// props.DefaultFeatures. Forge features are never default-enabled: a blank
	// import changes what is available, never what is on.
	Default bool
}

type SkeletonExternalCommand struct {
	ImportPath  string   // e.g. "gitlab.com/phpboyscout/go/signing-cli"
	PkgAlias    string   // e.g. "signingcli"
	Constructor string   // e.g. "NewCmdSign"
	Args        []string // injection tokens, e.g. ["logger"]
	Wrap        bool     // wrap in setup.Wrap("", …)
}

type SkeletonRootData struct {
	Name                  string
	Description           string
	ReleaseProvider       string
	Host                  string
	Org                   string
	RepoName              string
	Private               bool
	DisabledFeatures      []string
	EnabledFeatures       []string
	HelpType              string // "slack", "teams", or ""
	SlackChannel          string
	SlackTeam             string
	TeamsChannel          string
	TeamsTeam             string
	TelemetryEndpoint     string
	TelemetryOTelEndpoint string
	EnvPrefix             string
	// ConfigLayers wires props.Tool.ConfigLayers in the generated root. Empty
	// means the project states nothing and inherits the framework default, so
	// no field is emitted — keeping generated output byte-identical for every
	// project that does not care.
	ConfigLayers []string
	// UpdatePolicy wires props.Tool.UpdatePolicy in the generated root. Empty
	// (or "disabled") leaves the field off so the framework default applies;
	// "prompt"/"enabled" emit the matching props.UpdatePolicy* constant.
	UpdatePolicy string
	// UpdateCheckInterval wires props.Tool.UpdateCheckInterval as a Go duration
	// string (e.g. "24h"). Empty, unparseable, or non-positive values leave the
	// field off so the framework default (24h) applies.
	UpdateCheckInterval string
	// SigningEnabled gates the Signing: props.SigningConfig{...} block.
	// When true the generated tool wires trustkeys.Keys() as its embedded
	// trust anchor; ModulePath supplies the import path for that package.
	SigningEnabled bool
	ModulePath     string
	// AutoInitialise wires props.Tool.Bootstrap.AutoInitialise. When true the
	// generated tool auto-runs a non-interactive init if config is missing.
	AutoInitialise bool
	// SkipConfigCheck wires props.Tool.Bootstrap.SkipConfigCheck — commands
	// (by Name() or full CommandPath()) whose missing-config gate is relaxed.
	SkipConfigCheck []string
	Subcommands     []SkeletonSubcommand
	// ExternalCommands are declarative external-module attachments rendered as
	// additional NewCmdRoot arguments (see the external-command-attachment spec).
	ExternalCommands []SkeletonExternalCommand
	// ExternalAdapter, when true, spreads external.Commands(p) — the user-owned
	// adapter escape hatch at <ModulePath>/pkg/cmd/external — into NewCmdRoot.
	ExternalAdapter bool
}

type SkeletonSigningData struct {
	ExternalKeyEmail          string
	RequireSignature          bool
	KeySource                 string // "embedded" | "external" | "both"; empty → framework default
	RequireExternalCrosscheck bool
}

type SkeletonSubcommand struct {
	ImportPath  string // e.g. "github.com/org/repo/pkg/cmd/serve"
	PkgAlias    string // e.g. "serve"
	Constructor string // e.g. "NewCmdServe"
}