scaffold

type GeneratedFile struct {
	RelPath string
	AbsPath string
	Content []byte
}

type HookResult struct {
	Description string
	Cmd         string
	Success     bool
	Output      string
}

type PostInitHook struct {
	Description string `toml:"description"`
	Cmd         string `toml:"cmd"`
}

type Result struct {
	Template string
	Vars     map[string]string
	Files    []GeneratedFile
	// Hooks reports which post-init hooks were executed (nil unless
	// RunPostInit was set).
	Hooks []HookResult
}

type ScaffoldOptions struct {
	// Template is the directory name under templates/.
	Template string

	// OutputDir is the absolute path to write files into. If empty, the
	// engine returns generated files in Result.Files without touching disk.
	OutputDir string

	// Vars are caller-provided variable overrides. They take precedence
	// over template defaults and EnvHint lookups.
	Vars map[string]string

	// Interactive, when true, prompts on stdin for any required variable
	// not satisfied by Vars / EnvHint / Default.
	Interactive bool

	// In and Out are used for interactive prompting and progress output.
	// When nil they default to os.Stdin and os.Stdout.
	In  io.Reader
	Out io.Writer

	// RunPostInit, when true, executes PostInitHook commands after files
	// are written. Disabled by default; hosts opt in.
	RunPostInit bool
}

type TemplateMeta struct {
	Name             string         `toml:"name"`
	Description      string         `toml:"description"`
	MinServerVersion string         `toml:"min_server_version"`
	Vars             []VarSpec      `toml:"vars"`
	PostInit         []PostInitHook `toml:"post_init"`
	NextSteps        []string       `toml:"next_steps"`
}

type VarSpec struct {
	Name        string `toml:"name"`
	Description string `toml:"description"`
	Default     string `toml:"default"`
	EnvHint     string `toml:"env_hint"`
	Optional    bool   `toml:"optional"`
}