gorunner

type Containment string

type CoverageCompleteness string

type CoverageMode string

type CoverageObservation struct {
	ArtifactSHA256 string
	Completeness   CoverageCompleteness
	Mode           string
	Packages       []string
	RawRootSHA256  string
}

type CoveragePackage struct {
	ImportPath string
	Files      []CoverageSourceFile
}

type CoverageRequest struct {
	Directory      string
	ProfilePath    string
	RepositoryRoot string
	Mode           CoverageMode
	Packages       []CoveragePackage
}

type CoverageSourceFile struct {
	ProfilePath string
	SourcePath  string
	RawSHA256   string
}

type EnvironmentVariable struct {
	Name  string
	Value string
}

type Plan struct {
	// GoExecutable and WorkingDirectory must be clean absolute paths whose final
	// components are not symlinks. Mandatory parent-component, source, toolchain,
	// and environment identity checks belong to the coordinator immediately
	// before and after Run; Run exposes no potentially unbounded callbacks.
	GoExecutable     string
	WorkingDirectory string
	Environment      []EnvironmentVariable
	Packages         []string
	OutputLimitBytes int64
	// RetainOutput keeps at most OutputLimitBytes across both Result Data fields.
	// Data is transient caller-owned output and is nil when RetainOutput is false.
	// Bounded retention deliberately replaces arbitrary streaming callbacks: an
	// uncooperative callback could defeat the hard return bound.
	RetainOutput bool
	Timeout      time.Duration
	// Coverage is an opt-in combined-run coverage request. Nil preserves the
	// exact non-coverage invocation and result.
	Coverage *CoverageRequest
}

type Result struct {
	Argv                []string
	Cancelled           bool
	Containment         Containment
	Duration            time.Duration
	ExitCode            int
	Exited              bool
	OutputLimitExceeded bool
	PipeWaitExpired     bool
	ProcessCleanupDone  bool
	Started             bool
	Stderr              StreamResult
	Stdout              StreamResult
	TimedOut            bool
	Coverage            CoverageObservation
}

type StreamResult struct {
	Bytes uint64
	// Data is a transient bounded copy and is nil unless Plan.RetainOutput is true.
	Data      []byte
	Drained   bool
	RawSHA256 string
}