setup

type AlwaysInstall struct{}

type AlwaysSkip struct{}

type ApplyOptions struct {
	// Repo is the absolute path to the target repository.
	Repo string
	// RecipeOptions is the per-recipe parameter bag (vault path,
	// license SPDX id, etc.).
	RecipeOptions Options
	// Prompter handles missing prereqs. Required.
	Prompter Prompter
	// Runner executes install commands. Required if any prereq
	// has an Install entry.
	Runner CommandRunner
}

type ApplyResult struct {
	Recipe       string
	Category     Category
	Skipped      bool
	SkipReason   string
	Installed    []string // prereq names that were auto-installed
	ManualHints  []string // prereq names where the user picked manual
	UpstreamUsed string
	VerifyOK     bool
	VerifyErr    error
}

type Category string

type ClawtoolMeta struct {
	// Version is the clawtool semver that wrote this file.
	Version string `toml:"version"`
}

type CommandRunner interface {
	Run(ctx context.Context, command []string) error
}

type Options map[string]any

type Platform string

type Prereq struct {
	// Name is human-readable: "Node.js 18+", "GitHub CLI", "Obsidian".
	Name string

	// Check returns nil if the prereq is satisfied. Implementations
	// typically exec.LookPath the binary or shell out a version
	// probe.
	Check func(ctx context.Context) error

	// Install is the command (or commands) clawtool offers to run
	// if Check fails and the user consents. Empty means "manual
	// install only" — the wizard will print ManualHint instead.
	Install map[Platform][]string

	// ManualHint is shown when no Install entry matches the host
	// platform or when the user picks the manual route. One short
	// paragraph; usually a URL plus one-liner.
	ManualHint string
}

type PrereqOutcome struct {
	Prereq    Prereq
	Satisfied bool
	Err       error
}

type PromptDecision int

type Prompter interface {
	OnMissingPrereq(ctx context.Context, recipe Recipe, p Prereq, checkErr error) (PromptDecision, error)
}

type Recipe interface {
	// Meta returns the static descriptor. Called at registration
	// (validated for required fields) and on every list call.
	Meta() RecipeMeta

	// Detect probes the repo at `repo` and returns the recipe's
	// current state plus an explanation string the wizard prints.
	// Returning StatusError surfaces the error verbatim.
	Detect(ctx context.Context, repo string) (Status, string, error)

	// Prereqs lists what must exist on the host before Apply is
	// safe to call. Empty slice = no prereqs.
	Prereqs() []Prereq

	// Apply executes the recipe against repo with opts. May shell
	// out, write files, fetch network resources. Atomic in the
	// success case; on partial-fail the error wraps what was done
	// so the user can recover.
	Apply(ctx context.Context, repo string, opts Options) error

	// Verify is the post-Apply sanity check, also re-runnable
	// later. Returns nil if the recipe's installed state is
	// healthy; otherwise an error describing what's missing.
	Verify(ctx context.Context, repo string) error
}

type RecipeEntry struct {
	Name            string         `toml:"name"`
	Category        Category       `toml:"category"`
	AppliedAt       time.Time      `toml:"applied_at"`
	UpstreamVersion string         `toml:"upstream_version,omitempty"`
	Options         map[string]any `toml:"options,omitempty"`
}

type RecipeMeta struct {
	// Name is kebab-case, unique within the category. Surfaced as
	// the CLI selector and the MCP recipe_apply argument.
	Name string

	// Category is the typed enum. Registry refuses unknown values.
	Category Category

	// Description is one line shown in the wizard and recipe_list.
	Description string

	// Upstream is the canonical URL of the project this recipe
	// wraps. REQUIRED — registry refuses an empty Upstream so a
	// from-scratch reimplementation can't be smuggled in.
	//
	// Use the project's primary repo URL (e.g.
	// "https://github.com/googleapis/release-please") or — for
	// recipes that wrap a spec rather than a project — the spec
	// URL with a "spec:" prefix (e.g.
	// "spec:https://www.conventionalcommits.org").
	Upstream string

	// Stability defaults to StabilityStable if zero-valued.
	Stability Stability

	// Core marks a recipe as part of clawtool's curated default
	// install. When true, the setup wizard pre-checks the row and
	// `clawtool init --all` applies it without prompting (regardless
	// of Stability — Beta recipes can be Core too). Defaults to
	// false so unset / experimental recipes stay opt-in.
	Core bool
}

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

type RepoConfig struct {
	Clawtool ClawtoolMeta  `toml:"clawtool"`
	Recipes  []RecipeEntry `toml:"recipe,omitempty"`
}

type Stability string

type Status string