managers

type Bun struct{}

type Cargo struct{}

type InstallMode int

type Manager interface {
	// Name returns the canonical name used in CLI output ("npm", "pip", …).
	Name() string

	// Binaries returns the executable names this manager owns.
	// Used to determine which shims to write.
	Binaries() []string

	// FindReal locates the real binary on PATH, skipping the shims directory.
	FindReal(shimsDir string) (string, error)

	// ParseInstall inspects the command-line arguments and returns the list of
	// packages the user intends to install, plus the install mode.
	// It must never return an error for unknown/passthrough subcommands —
	// those should return ModePassthrough with a nil package list.
	ParseInstall(args []string) ([]Pkg, InstallMode, error)

	// ResolveVersion contacts the package registry to find the latest published
	// version for a package whose version was not pinned on the command line.
	// Returns empty string if resolution fails — the shim should proceed
	// without a version check rather than block on a registry error.
	ResolveVersion(name string) (string, error)
}

type NPM struct{}

type Pip struct{}

type Pkg struct {
	Name    string
	Version string // empty = unresolved; shim will resolve via registry
}