Documentation
¶
Overview ¶
Package runlineage projects an immutable pipeline version and persisted run facts into the read-only lineage shown on run detail surfaces.
Index ¶
Constants ¶
const ( StatusPending = "pending" StatusNotReached = "not_reached" StatusUnknown = "unknown" StatusRunning = "running" StatusSucceeded = "succeeded" StatusFailed = "failed" StatusCanceled = "canceled" )
Variables ¶
This section is empty.
Functions ¶
func ChronologicalEvents ¶
func ChronologicalEvents(events []api.PipelineRunTimelineEvent) []api.PipelineRunTimelineEvent
ChronologicalEvents orders original instants without mutating retained API evidence.
Types ¶
type Edge ¶
type Edge struct {
Href string
FromSlug string
ToSlug string
Kinds []string
InputNames []string
Tone string
Dashed bool
Path string
ArrowPoints string
Label string
LabelX int
LabelY int
}
Edge is one normalized dependency between two lineage nodes.
type Node ¶
type Node struct {
Blocked bool
Slug string
Name string
Kind string
Planned PlannedEvidence
Status string
Href string
X int
Y int
DurationMs int64
StartedAt *time.Time
EndedAt *time.Time
Snapshot *api.PipelineRunStepSnapshot
FailedCheck *api.PipelineRunStructuralCheck
Boundary string
FailureInput string
FailureFrom string
Failure *api.PipelineRunFailureContext
Incremental *api.PipelineRunIncrementalSourceDiagnostic
Upstream []string
Downstream []string
Selected bool
}
Node combines one exact-version pipeline step with persisted facts for that step. Planned steps with no facts remain explicitly marked not reached.
type PlannedEvidence ¶
type PlannedEvidence struct {
DataSourceRef string
OperationType string
OperationRef string
UsesInline bool
Inputs []PlannedInput
OutputKind string
ParameterKeys []string
}
PlannedEvidence is the secret-safe step configuration from the exact immutable pipeline version executed by the run.
type PlannedInput ¶
PlannedInput identifies one named upstream binding without its payload.
type View ¶
type View struct {
Available bool
Message string
VersionHash string
VersionShortHash string
Nodes []Node
Edges []Edge
SelectedIndex int
CanvasWidth int
CanvasHeight int
}
View is the complete, secret-safe projection used by run lineage templates.
func Build ¶
func Build(version api.PipelineVersion, run api.PipelineRunRecord, requestedStepSlug, baseHref string) (View, error)
Build derives lineage from the exact immutable version recorded on the run. It intentionally does not validate the historical spec against today's full authoring schema; graph normalization supplies the topology contract needed by this read-only projection.
func Unavailable ¶
Unavailable returns a nonfatal lineage state. Run facts outside the graph remain usable when the exact historical topology cannot be loaded.