adapter

type Adapter interface {
	Kind() string
	// List returns all nodes matching sel across all namespaces.
	List(ctx context.Context, r client.Reader, sel labels.Selector) ([]Node, error)
	// Get fetches a single node (used for dependsOn targets outside the selector).
	// Returns (Node{}, false, nil) when the resource does not exist.
	Get(ctx context.Context, r client.Reader, ref NodeRef) (Node, bool, error)
}

type Node struct {
	Ref       NodeRef
	DependsOn []NodeRef             // same-kind, namespace-defaulted to the node's
	SourceRef *types.NamespacedName // referenced GitRepository; nil when sourceRef is not a GitRepository
	Readiness Readiness
	Labels    map[string]string
}

type NodeRef struct {
	Kind      string `json:"kind"`
	Namespace string `json:"namespace"`
	Name      string `json:"name"`
}

type Readiness struct {
	Ready      bool   // Ready condition True AND status.observedGeneration == metadata.generation
	Failing    bool   // Ready condition explicitly False (unhealthy, not merely converging)
	Message    string // Ready condition message (for status attribution)
	AppliedSHA string // 40-hex SHA parsed from status.lastAppliedRevision ("" if none)
}