runbuild

type Build struct {
	// Version is version.String(): "v0.0.4", "dev+g4e35bf6".
	Version string `json:"version"`
	// Commit is the full commit the build was made from, when it knows it.
	Commit string `json:"commit,omitempty"`
	// Sequence is the commit's first-parent position on main (Task 20380),
	// zero for a build that was not stamped with one. It is the only ordering
	// two builds of main have: two "dev+g<sha>" versions do not compare.
	Sequence int `json:"sequence,omitempty"`
	// Schema is the newest database migration the build embeds, zero when the
	// build did not say (`cloop version --json` reports it since Task 20389).
	Schema int `json:"schema,omitempty"`
}

type Candidate struct {
	Path string
	// contains filtered or unexported fields
}

type Child struct {
	PID  int
	Comm string
}

type FileID struct {
	Dev, Ino uint64
	Size     int64
	MTime    int64
}

type Handoff struct {
	Format int `json:"format"`
	// Run is the process that wrote the file — and, since an exec keeps the
	// process, the one that must read it.
	Run       Ident     `json:"run"`
	WrittenAt time.Time `json:"written_at"`
	// Reason says why the run adopted: who requested it, or that the project
	// follows new builds. RequestID and RequestedBy name a request.
	Reason      string `json:"reason"`
	RequestID   string `json:"request_id,omitempty"`
	RequestedBy string `json:"requested_by,omitempty"`
	// From is the image that wrote this, To what its probe reported for the
	// binary it executed, and Exe the path that binary was found at.
	From Build  `json:"from"`
	To   Build  `json:"to"`
	Exe  string `json:"exe"`
	// RunID is the execution id the run's tasks are stamped with; the new
	// image keeps it so the run's audit rows still join to its leases.
	RunID string `json:"run_id,omitempty"`
	// ProcessStart is when the process first started. The placement record
	// the hub wrote is judged stale against it, so a new image that took its
	// own start time instead would stop attributing its tasks to the executor
	// and identity the hub dispatched them under.
	ProcessStart time.Time `json:"process_start"`
	// SessionStart and SessionStartStep are where this session began, for
	// --steps and the session summary; Deadline is --timeout's.
	SessionStart     time.Time `json:"session_start"`
	SessionStartStep int       `json:"session_start_step"`
	Deadline         time.Time `json:"deadline,omitzero"`
	// The run's counters: the evolve iteration it had reached, the failures
	// and aborts in a row its stop rule counts, and the empty evolve rounds in
	// a row.
	EvolveStep              int `json:"evolve_step"`
	ConsecutiveErrors       int `json:"consecutive_errors"`
	ConsecutiveEmptyEvolves int `json:"consecutive_empty_evolves"`
	// Status and PauseReason are the run's status as it handed over.
	Status      string          `json:"status"`
	PauseReason json.RawMessage `json:"pause_reason,omitempty"`
	// Reexecs is how many adoptions preceded this one.
	Reexecs int `json:"reexecs"`
	// Parallel says which loop handed over.
	Parallel bool `json:"parallel,omitempty"`
}

type Ident struct {
	PID        int    `json:"pid"`
	StartTicks uint64 `json:"start_ticks"`
	BootID     string `json:"boot_id"`
}

type Owner struct {
	Ident
	// Host is the machine the process runs on. Its identity can only be
	// checked from the same machine.
	Host string `json:"host,omitempty"`
	// Exe is the path the run was started from: what a deploy replaces and
	// what adoption validates (see StartPath).
	Exe string `json:"exe,omitempty"`
	// Executor is the kind of executor the run was placed on, as the
	// placement record says ("localprocess" for a run on this host).
	Executor string `json:"executor,omitempty"`
	// Adoptable says the run can adopt a newer build at a task boundary: a
	// host-process run of a build that knows how. Device and container runs
	// keep their own upgrade paths.
	Adoptable bool `json:"adoptable,omitempty"`
	// RunID is the execution id the run's tasks are stamped with.
	RunID string `json:"run_id,omitempty"`
	// StartedAt is when the process started. It survives adoptions, as the
	// pid does.
	StartedAt time.Time `json:"started_at"`
	// Build is the build the process runs now, and BuildSince when that image
	// took over: StartedAt for the first, the adoption for later ones.
	Build      Build     `json:"build"`
	BuildSince time.Time `json:"build_since"`
	// Reexecs counts the adoptions, and Previous is the build the last one
	// replaced.
	Reexecs  int    `json:"reexecs,omitempty"`
	Previous *Build `json:"previous,omitempty"`
}

type Request struct {
	ID          string    `json:"id"`
	RequestedAt time.Time `json:"requested_at"`
	// RequestedBy is the identity that asked, as the hub's audit trail names it.
	RequestedBy string `json:"requested_by,omitempty"`
	// Run is the process the request is for.
	Run Ident `json:"run"`
	// Hub is the build of the hub that asked: what the requester expected
	// the run to move to.
	Hub Build `json:"hub"`
}

type Status struct {
	Build Build `json:"build"`
	// Reference is the build the record is compared with: the reading
	// process's own.
	Reference Build `json:"reference"`
	// Behind is how many builds the run trails Reference; Comparable says
	// whether that could be told (see Behind).
	Behind     int  `json:"behind"`
	Comparable bool `json:"comparable"`
	// Live says the recorded process is still running; LiveKnown is false
	// when that could not be checked from here.
	Live      bool `json:"live"`
	LiveKnown bool `json:"live_known"`
	PID       int  `json:"pid,omitempty"`
	// Since is when the running image took over (BuildSince).
	Since     time.Time `json:"since,omitzero"`
	StartedAt time.Time `json:"started_at,omitzero"`
	Reexecs   int       `json:"reexecs,omitempty"`
	Previous  *Build    `json:"previous,omitempty"`
	Executor  string    `json:"executor,omitempty"`
	Adoptable bool      `json:"adoptable"`
}