taskid

type DependencyConfig struct {
	// Cardinality specifies whether the dependency is a 1:1 reference or a 1:N fan-in reference.
	Cardinality EdgeCardinality
	// Scope specifies the task search and binding scope for resolving the dependency.
	Scope DependencyScope
}

type DependencyDescriptor interface {
	// DescriptorCardinality returns whether this dependency is point-to-point or fan-in.
	DescriptorCardinality() EdgeCardinality
	// DescriptorScope returns the effective dependency resolution scope.
	DescriptorScope() DependencyScope
	// ResultType returns the reflection Type for the expected result type of this dependency.
	ResultType() reflect.Type
}

type DependencyScope int

type EdgeCardinality int

type FanInDescriptor interface {
	DependencyDescriptor
	// Tag returns the tag identifier to match against producer tasks.
	Tag() string
}

type FanInOption interface {
	// contains filtered or unexported methods
}

type PointToPointDescriptor interface {
	DependencyDescriptor
	// ReferenceID returns the target task's reference ID without any implementation hash.
	ReferenceID() string
}

type ReferenceOption interface {
	// contains filtered or unexported methods
}

type TaskEdge struct {
	// SourceRefID is the reference ID of the upstream producer task.
	SourceRefID string
	// SourceImplID is the implementation ID of the upstream producer task.
	SourceImplID string
	// TargetImplID is the implementation ID of the downstream consumer task.
	TargetImplID string
	// Cardinality indicates whether this edge originated from a point-to-point or fan-in dependency.
	Cardinality EdgeCardinality
	// Tag is the tag identifier if this edge originated from a fan-in dependency.
	Tag string
	// Priority specifies the precedence weight of this edge during graph resolution and cycle pruning.
	Priority int
	// OutputType is the string representation of the data type transported over this edge.
	OutputType string
}

type TaskImplementationID[TaskResult any] interface {
	UntypedTaskImplementationID
	// Ref returns the typed reference associated with this implementation ID.
	Ref(opts ...ReferenceOption) TaskReference[TaskResult]
}

type TaskReference[TaskResult any] interface {
	UntypedTaskReference
	// GetZeroValue returns a zero value of the TaskResult type.
	// This is used to maintain type safety by ensuring TaskReference[A] and TaskReference[B]
	// are considered different types when A and B are different.
	GetZeroValue() TaskResult
	// Ref returns a new TaskReference with the specified dependency options applied.
	Ref(opts ...ReferenceOption) TaskReference[TaskResult]
}

type UntypedTaskImplementationID interface {
	// String returns the full string representation of the task implementation ID (ReferenceID#ImplementationHash).
	String() string
	// ReferenceIDString returns only the reference ID portion without the implementation hash.
	ReferenceIDString() string
	// GetUntypedReference returns the reference ID associated with this implementation ID.
	GetUntypedReference() UntypedTaskReference
}

type UntypedTaskReference interface {
	PointToPointDescriptor
	// String returns the string representation of the reference ID.
	String() string
	// ReferenceIDString returns the reference ID portion without any implementation hash.
	ReferenceIDString() string
	// contains filtered or unexported methods
}