analyzer

type AnalysisResult struct {
	// Language is the detected language ecosystem
	Language string

	// Dependencies maps a unique identifier to dependency information
	// For Maven: "groupId:artifactId"
	// For Go: "module/path"
	// For Rust: "crate_name"
	Dependencies map[string]*DependencyInfo

	// Properties maps property names to their current values
	Properties map[string]string

	// PropertySources maps property names to the manifest file that declares them,
	// expressed as a path relative to the analyzed project root (e.g. "pom.xml",
	// "build/config/pom.xml"). Only populated for language ecosystems that support it.
	PropertySources map[string]string

	// PropertyUsage tracks how many dependencies use each property
	PropertyUsage map[string]int

	// Metadata stores language-specific analysis data
	Metadata map[string]any
}

type Analyzer interface {
	// Analyze performs dependency analysis on a project.
	// Returns detailed information about how dependencies are defined.
	Analyze(ctx context.Context, projectPath string) (*AnalysisResult, error)

	// AnalyzeRemote performs dependency analysis on remotely-fetched manifest files.
	// For multi-module repos (e.g., kubernetes with multiple go.mod files),
	// this analyzes each manifest file separately and returns a list of results.
	// files is a map of file path to content (e.g., "go.mod" -> content, "api/go.mod" -> content)
	AnalyzeRemote(ctx context.Context, files map[string][]byte) (*RemoteAnalysisResult, error)

	// RecommendStrategy suggests the best update strategy for given dependencies.
	// For example, Maven: should we update via properties or direct patches?
	RecommendStrategy(ctx context.Context, analysis *AnalysisResult, deps []Dependency) (*Strategy, error)
}

type Dependency struct {
	Name     string
	Version  string
	Scope    string
	Type     string
	Metadata map[string]any
}

type DependencyInfo struct {
	// Name is the dependency identifier
	Name string

	// Version is the current version
	Version string

	// UsesProperty indicates if this dependency's version comes from a property
	UsesProperty bool

	// PropertyName is the name of the property (if UsesProperty is true)
	PropertyName string

	// Transitive indicates if this is a transitive dependency
	Transitive bool

	// UpdateStrategy suggests how this dependency should be updated
	// Values: "direct", "property", "locked", "inherited"
	UpdateStrategy string

	// Metadata stores additional language-specific information
	Metadata map[string]any
}

type FileAnalysis struct {
	// FilePath is the path to the manifest file (e.g., "go.mod", "api/go.mod")
	FilePath string

	// Analysis is the dependency analysis for this file
	Analysis *AnalysisResult
}

type RemoteAnalysisResult struct {
	// Language is the detected language ecosystem
	Language string

	// FileAnalyses contains analysis results for each manifest file.
	// Ordered list to preserve discovery order.
	FileAnalyses []FileAnalysis

	// Metadata stores language-specific analysis data
	Metadata map[string]any
}

type Strategy struct {
	// DirectUpdates lists dependencies that should be updated directly
	DirectUpdates []Dependency

	// PropertyUpdates maps property names to their new values
	PropertyUpdates map[string]string

	// Warnings contains any issues or recommendations
	Warnings []string

	// AffectedDependencies shows which dependencies will be affected by property updates
	AffectedDependencies map[string][]string
}