install

type Options struct {
	// Target is one of Targets. It picks the destination (when Path is
	// empty) and the formatting (cursor wraps the body in mdc frontmatter).
	// An empty Target with a Path writes the body verbatim to Path.
	Target string
	// Path, when set, overrides the target's conventional destination.
	Path string
	// SoulName fills the cursor frontmatter description.
	SoulName string
	// Cwd and Home anchor the conventional paths (injected for tests).
	Cwd, Home string
	// Force overwrites an existing file without asking.
	Force bool
	// Link, with Target "claude", appends the @-import line to
	// ~/.claude/CLAUDE.md when not already present.
	Link bool
	// Interactive enables the Confirm prompt for overwrites.
	Interactive bool
	// Confirm asks the user to approve overwriting the named file. Required
	// when Interactive and the destination exists.
	Confirm func(prompt string) (bool, error)
	// OverwriteHint names the flag suggested when refusing to overwrite
	// non-interactively; defaults to "--force".
	OverwriteHint string
	// Fetch returns the verbatim SOUL.md body. It is called only after the
	// overwrite gate passes: the server's .md endpoint bumps the public
	// download counter, and a refused install is not a download.
	Fetch func() (string, error)
}

type Receipt struct {
	Method  string `json:"method"`
	Version string `json:"version"`
}

type Result struct {
	Path  string
	Bytes int
}