runlineage

package
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

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

View Source
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

type PlannedInput struct {
	Name         string
	FromStepSlug string
}

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

func Unavailable(message string) View

Unavailable returns a nonfatal lineage state. Run facts outside the graph remain usable when the exact historical topology cannot be loaded.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL