engine

type CheckoutAction struct {
	Path   string
	Branch string // Branch checked out (or empty if skipped)
	Action string // e.g. "checked out develop", "skipped (not detached)", "skipped (no matching branch)"
	Error  error
}

type CheckoutOpts struct {
	RootDir     string
	Concurrency int
	BranchOpts  git.BranchCheckoutOpts
	OnProgress  ProgressFunc
}

type CheckoutResult struct {
	Actions []CheckoutAction
}

type Engine struct {
	// contains filtered or unexported fields
}

type ProgressEvent struct {
	Type   ProgressEventType // Started, Completed, or Failed
	Path   string            // Submodule path (or "." for root)
	Phase  string            // "fetch", "status", "update", "push"
	Error  error             // Non-nil for EventFailed
	Total  int               // Total number of items being processed
	Done   int               // Number of items completed so far
	Action string            // Human-readable result (e.g. "pushed", "merged 3 commits")
}

type ProgressEventType int

type ProgressFunc func(ProgressEvent)

type PushAction struct {
	Path   string
	Branch string
	Action string // e.g. "pushed", "set-upstream", "skipped", "error"
	Error  error
}

type PushOpts struct {
	RootDir     string
	Concurrency int
	OnProgress  ProgressFunc
}

type PushResult struct {
	Actions []PushAction
}

type ScanOpts struct {
	RootDir     string               // Absolute path to the project root
	SkipList    []string             // Submodule paths to exclude
	Concurrency int                  // Max parallel goroutines (0 = runtime.NumCPU())
	BranchOpts  git.BranchDetectOpts // Passed to DetectBestBranch per submodule
	OnProgress  ProgressFunc         // Optional callback for progress events
}

type ScanResult struct {
	Root       *SubmoduleInfo   // Root repository info (display-only, nil if scan failed)
	Submodules []*SubmoduleInfo // Per-submodule scan results, sorted by path
}

type SubmoduleInfo struct {
	Path          string                // Relative path from root (e.g. "plugins/auth"), or "." for root
	IsRoot        bool                  // True for root repository
	Statuses      []git.SubmoduleStatus // Compound status set (can have multiple)
	CurrentBranch string                // Branch name, or empty if detached
	TargetBranch  string                // Branch detected by DetectBestBranch
	DetachedHead  bool                  // True if HEAD is detached
	CommitsBehind int                   // Number of commits behind remote
	CommitsAhead  int                   // Number of unpushed commits
	HasChanges    bool                  // Uncommitted local changes exist
	Changelog     []string              // Incoming commit summaries (oneline format)
	Error         error                 // Non-nil if scan failed for this submodule
}

type UpdateAction struct {
	Path         string
	BeforeStatus []git.SubmoduleStatus
	AfterStatus  []git.SubmoduleStatus
	Action       string // e.g. "merged", "conflict-resolved", "skipped", "error"
	Error        error
	ConflictHint string // Human-readable hint if conflict occurred
}

type UpdateOpts struct {
	RootDir     string
	Concurrency int
	OnProgress  ProgressFunc
}

type UpdateResult struct {
	Actions []UpdateAction
}