workflow

type ChangeDetectionRequest struct {
	WorkDir      string
	BaseRef      string
	ModuleIndex  *discovery.ModuleIndex
	LibraryPaths []string
}

type ChangeDetectionResult struct {
	Modules      []*discovery.Module
	Files        []string
	LibraryPaths []string
}

type ChangeDetector interface {
	DetectChanges(ctx context.Context, req ChangeDetectionRequest) (*ChangeDetectionResult, error)
}

type ChangeDetectorResolver func() (ChangeDetector, error)

type LibrarySummary struct {
	ConfiguredPaths int
	Discovered      int
	Consumers       int
	Orphans         []string
}

type LibraryUsage struct {
	Path         string
	RelativePath string
	UsedBy       int
}

type ModuleSet struct {
	Modules []*discovery.Module
	Index   *discovery.ModuleIndex
}

type Options struct {
	WorkDir  string
	Segments []string

	Excludes       []string
	Includes       []string
	SegmentFilters map[string][]string

	// LibraryPaths are project-relative roots whose discovered modules will be
	// flagged Module.IsLibrary=true and routed into Result.Libraries instead
	// of the executable target sets. Empty/nil disables the feature.
	LibraryPaths []string
}

type ProjectRequest struct {
	WorkDir   string
	Config    config.Snapshot
	Filters   filter.Flags
	Targeting TargetRequest
}

type ProjectResult struct {
	Workflow       *Result
	Targets        []*discovery.Module
	LibraryUsages  []LibraryUsage
	LibrarySummary *LibrarySummary
}

type Result struct {
	// All contains every discovered module (executable + library), in scan
	// order. Use Filtered for execution targets and Libraries for reporting.
	All ModuleSet
	// Filtered is the executable subset after filters; library modules are
	// always excluded regardless of filters.
	Filtered ModuleSet
	// Libraries holds modules under any configured library_modules.paths.
	// They are not included in Filtered and never become execution targets,
	// but are tracked here for diagnostics (validate/graph).
	Libraries ModuleSet

	Graph        *graph.DependencyGraph
	Dependencies map[string]*parser.ModuleDependencies
	Warnings     []error
}

type TargetRequest struct {
	Enabled bool

	ModulePath  string
	ChangedOnly bool
	BaseRef     string

	ChangeDetectorResolver ChangeDetectorResolver
}

type TargetSelectionOptions struct {
	ModulePath  string
	ChangedOnly bool
	BaseRef     string
	Filters     *filter.Flags

	ChangeDetectorResolver ChangeDetectorResolver
}