@usine/core/attempt/salvage

Classes

SalvagePushed

The Attempt’s unfinished work was committed and pushed to ref; commit is the pushed head.

Extends

• Schema.Class

Constructors

Constructor

new SalvagePushed(…args): SalvagePushed

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

SalvagePushed

Properties

commit

readonly commit: string & Brand<"CommitSha">

ref

readonly ref: string & Brand<"SalvageRef">

---

SalvageRetained

Salvage failed; path stays on the Worker for reconciliation. commit is the last known commit, or absent when inspection failed.

Extends

• Schema.Class

Constructors

Constructor

new SalvageRetained(…args): SalvageRetained

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

SalvageRetained

Properties

commit

readonly commit: Option<string & Brand<"CommitSha">>

message

readonly message: string

path

readonly path: string

Interfaces

AttemptRecovery

Identifies a persisted Attempt whose Worker may still hold a checkout.

Properties

attemptId

readonly attemptId: string & Brand<"AttemptId">

open

readonly open: boolean

The Attempt has no outcome yet: an orchestrator restart may reattach it if its parent task is still live.

ref

readonly ref: string & Brand<"SalvageRef">

repository

readonly repository: string & Brand<"RepositoryName">

succeeded

readonly succeeded: boolean

The Attempt delivered its result, so a leftover checkout is removed rather than salvaged.

worker

readonly worker: string & Brand<"WorkerName">

Type Aliases

AttemptSalvage

AttemptSalvage = typeof AttemptSalvage.Type

What the executor preserved of an Attempt’s workspace when the Attempt ended without a Succeeded outcome.

---

SalvageRef

SalvageRef = typeof SalvageRef.Type

The remote branch name that holds one Attempt’s unfinished work, usine/salvage/<run>/<attempt>.

Variables

AttemptSalvage

const AttemptSalvage: Schema.Union<readonly [typeof SalvagePushed, typeof SalvageRetained]>

What the executor preserved of an Attempt’s workspace when the Attempt ended without a Succeeded outcome.

---

SalvageRef

const SalvageRef: Schema.brand<Schema.NonEmptyString, "SalvageRef">

The remote branch name that holds one Attempt’s unfinished work, usine/salvage/<run>/<attempt>.

---

salvageRefFor

const salvageRefFor: (runId, number) => SalvageRef

The salvage branch an Attempt pushes to when it ends without success.

Parameters

Parameter	Type
runId	RunId
number	AttemptNumber

Returns

SalvageRef