adapter

type Adapter interface {
	Ecosystem() string
	Detect(root string) (bool, Variant, error)
	// Capability is a read-only check that rejects only source shapes this
	// concrete variant cannot represent. Tool and network checks are separate.
	Capability(root string, dep Dependency, exp Export) error
	// Pull edits the native declaration and makes the dependency usable locally.
	// It must also repair missing materialization when the declaration is current.
	Pull(ctx context.Context, root string, dep Dependency, exp Export, locked Locked) (Change, error)
	// Remove converges the native declaration, lock and project-local installed state.
	Remove(ctx context.Context, root string, dep Dependency, exp Export, locked Locked) (Change, error)
	// Inspect is local and read-only.
	Inspect(ctx context.Context, root string, dep Dependency, exp Export, locked Locked) ([]Finding, error)
}

type Change struct {
	File, Entry, Warning string
	Changed              bool
}

type Dependency = manifest.Dependency

type Export = manifest.Export

type Finding struct {
	File, Entry, Want, Got string
	// Repairable distinguishes manager-owned lock/materialization drift from
	// declaration drift that may be a user edit. Pull may converge repairable
	// findings; it must stop before overwriting non-repairable findings.
	Repairable bool
}

type Locked = manifest.LockedDependency

type MissingToolError struct{ Requirement ToolRequirement }

type NotWirableError struct{ Reason string }

type ToolRequirement struct {
	Ecosystem  string   `json:"ecosystem"`
	Command    string   `json:"command"`
	VersionArg []string `json:"versionArgs"`
	Minimum    string   `json:"minimum,omitempty"`
	Install    string   `json:"install"`
}

type ToolStatus struct {
	ToolRequirement
	Found   bool   `json:"found"`
	Path    string `json:"path,omitempty"`
	Version string `json:"version,omitempty"`
	Ready   bool   `json:"ready"`
}

type ToolVersionError struct {
	Requirement ToolRequirement
	Version     string
}

type Variant string