mcpinstall

type ClientConfig struct {
	// Name is the human-readable client name (e.g., "Claude Code")
	Name string
	// ID is the CLI identifier (e.g., "claude-code")
	ID string
	// ConfigPaths maps platform to config file path (for file-based install)
	ConfigPaths map[string]string
	// ServerKey is the key used in the mcpServers object
	ServerKey string
	// ConfigFormat specifies the config file format
	ConfigFormat ConfigFormat
	// InstallMethod specifies how to install (file or CLI)
	InstallMethod InstallMethod
	// CLICommand is the command to use for CLI-based install (e.g., "claude")
	CLICommand string
	// SkillsPaths maps platform to the directory agent skills are installed
	// into. Empty means this client has no skills mechanism -- skills are a
	// Claude Code construct, and the other supported editors have no equivalent,
	// so installing files for them would just litter the disk.
	SkillsPaths map[string]string
}

type ClientStatus struct {
	// ClientName is the human-readable client name.
	ClientName string
	// ClientID is the CLI identifier.
	ClientID string
	// Installed indicates whether kusari-inspector is configured.
	Installed bool
	// ConfigPath is the path to the config file (empty for CLI-based).
	ConfigPath string
	// InstallMethod indicates how the client is configured.
	InstallMethod InstallMethod
}

type ConfigFormat int

type InstallMethod int

type InstallOptions struct {
	// WithCommitHook installs a PreToolUse hook that scans before Claude commits.
	// Off by default: unlike a skill file, a hook is a shell command that runs on
	// the user's machine, so it has to be asked for explicitly.
	WithCommitHook bool
}

type InstallationResult struct {
	// Success indicates whether the operation succeeded.
	Success bool
	// ClientName is the client that was configured.
	ClientName string
	// ConfigPath is the path to the config file modified (empty for CLI-based).
	ConfigPath string
	// Message contains success or error message.
	Message string
	// NeedsRestart indicates whether the client needs restart.
	NeedsRestart bool
	// SkillsPath is the directory skills were installed into, empty if none were.
	SkillsPath string
	// Skills lists the skill names installed or removed.
	Skills []string
	// SkillsSupported reports whether the client has a skills mechanism at all;
	// false means the caller should say so rather than imply skills were set up.
	SkillsSupported bool
	// SkillsError is set when MCP configuration succeeded but skills did not.
	// Skills are an enhancement, so this does not fail the install.
	SkillsError error
	// CommitHookRequested reports whether the caller asked for the commit hook.
	CommitHookRequested bool
	// CommitHookInstalled reports whether it was actually installed or removed.
	CommitHookInstalled bool
	// CommitHookScript is the path of the installed hook script.
	CommitHookScript string
	// CommitHookSettings is the settings file the hook was registered in.
	CommitHookSettings string
	// CommitHookBinary is the kusari executable the hook will invoke. Reported
	// because the hook records whichever binary installed it, which may be a
	// throwaway build rather than the installed one.
	CommitHookBinary string
	// CommitHookError is set when the hook could not be installed or removed.
	CommitHookError error
}

type Platform string

type Skill struct {
	// Name is the directory name the skill is installed under.
	Name string
	// Files maps a path relative to the skill directory to its contents.
	Files map[string][]byte
}