ci

type ActiveFacet struct {
	Name      string
	Subsystem string
	NeedsDinD bool
}

type CIContext struct {
	Provider      string // gitlab, github, gitea, forgejo, jenkins
	Event         string // push, tag, merge_request, schedule
	Branch        string // current branch (empty on tags)
	Tag           string // current tag (empty on branches)
	SHA           string // full commit SHA
	DefaultBranch string // repo default branch name
	RepoURL       string // repository URL
	Workspace     string // working directory
	PipelineID    string // provider pipeline/run ID (for cancel API)
}

type ExecutionGraph struct {
	Nodes []GraphNode
}

type FacetDef struct {
	Name      string                    // "build", "security", "gitops-reconcile", etc.
	Subsystem string                    // what `ci run <x>` dispatches to
	NeedsDinD bool                      // requires Docker-in-Docker transport
	Predicate func(*config.Config) bool // config-driven activation check
}

type GraphNode struct {
	ID        string   // "build", "security", "reconcile"
	Subsystem string   // what `ci run <x>` dispatches to
	Needs     []string // explicit dependency IDs (not position-based)
	NeedsDinD bool
	Active    bool   // from facet detection
	Reason    string // why active ("builds configured") or inactive ("no builds")
}

type HandoffDecision int

type HandoffResult struct {
	Decision  HandoffDecision
	CommitSHA string // SHA of the new commit deps created
	Triggered bool   // true if a new pipeline was triggered via provider API
	Stale     bool   // true if current pipeline SHA != branch HEAD (should stop shipping)
	Depth     int    // current handoff depth from SF_CI_HANDOFF_DEPTH
}

type Registry map[string]Runner

type RunOptions struct {
	Tag     string // for release subsystem
	Verbose bool
}

type Runner func(ctx context.Context, cfg *config.Config, ciCtx *CIContext, opts RunOptions) error

type SkeletonVariant struct {
	Name     string   // "standard", "lightweight"
	Provider string   // "gitlab"
	Supports []string // facet subsystems this skeleton can run
	Content  []byte   // raw YAML
}