tools

type ClaudeTool struct{}

type CodexTool struct{}

type CommandTool struct {
	ToolName         string
	DetectCommand    string
	InstallCommand   string
	UninstallCommand string
	PathTemplate     string
}

type CursorTool struct {
	// WorkDir is the project root. Defaults to os.Getwd() if empty.
	WorkDir string
}

type GeminiTool struct{}

type SkillFile struct {
	Path    string // relative to the skill root (e.g. "scripts/deploy.sh")
	Content []byte
}

type Status struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Enabled     bool   `json:"enabled"`
	Detected    bool   `json:"detected"`
	DetectKnown bool   `json:"detect_known"`
	Source      string `json:"source"`
}

type Tool interface {
	// Name returns the tool identifier (e.g. "claude", "cursor").
	Name() string
	// Install creates a link from the agent's expected directory into canonicalDir
	// (~/.scribe/skills/<name>). projectRoot scopes tools that support
	// project-local projections; an empty projectRoot preserves legacy global
	// projection behavior. Returns the paths of the links created.
	Install(skillName, canonicalDir, projectRoot string) (paths []string, err error)
	// Uninstall removes the links for a skill.
	Uninstall(skillName string) error
	// Detect reports whether this tool is installed on the machine.
	Detect() bool
	// SkillPath returns the absolute path where this tool expects the skill
	// symlink (or link file) to live. Used by adoption to remove the old
	// real directory before Install replaces it with a symlink.
	SkillPath(skillName, projectRoot string) (string, error)
	// CanonicalTarget returns the path inside canonicalDir that this tool's
	// on-disk projection mirrors (e.g. claude → canonicalDir/SKILL.md; codex
	// → canonicalDir itself). When ok is false, the tool manages its skills
	// opaquely (e.g. via a CLI) and reconcile skips drift inspection.
	CanonicalTarget(canonicalDir string) (path string, ok bool)
}