protopb

type MergeRequest struct {

	// id is the client-owned correlation id for this request (one per request).
	// Runway echoes it back on the result unchanged.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// queue_name is the caller-provided queue name the request belongs to.
	// Runway resolves the merge target and provider config per-queue from this
	// name; no target ref is passed.
	QueueName string `protobuf:"bytes,2,opt,name=queue_name,json=queueName,proto3" json:"queue_name,omitempty"`
	// steps is the ordered application sequence: in-flight steps first, the
	// candidate last. A single-element list expresses "candidate vs merge
	// target".
	Steps []*MergeStep `protobuf:"bytes,3,rep,name=steps,proto3" json:"steps,omitempty"`
	// contains filtered or unexported fields
}

type MergeResult struct {

	// id echoes the client-owned correlation id from the request.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// outcome is SUCCEEDED if the whole ordered step sequence applied cleanly
	// (mergeable for a dry-run check, merged for a committing merge), FAILED
	// otherwise.
	Outcome Outcome `protobuf:"varint,2,opt,name=outcome,proto3,enum=uber.runway.messagequeue.Outcome" json:"outcome,omitempty"`
	// reason is a human-readable explanation when outcome is FAILED. Empty on
	// success.
	Reason string `protobuf:"bytes,3,opt,name=reason,proto3" json:"reason,omitempty"`
	// steps optionally reports per-step outcomes, in request order. A committing
	// merge populates each step's outputs with the revisions it produced; a
	// dry-run check leaves them empty.
	Steps []*StepResult `protobuf:"bytes,4,rep,name=steps,proto3" json:"steps,omitempty"`
	// queue_name echoes the caller-provided queue name from the request, so the
	// consumer can route the result by queue without loading state first.
	QueueName string `protobuf:"bytes,5,opt,name=queue_name,json=queueName,proto3" json:"queue_name,omitempty"`
	// contains filtered or unexported fields
}

type MergeStep struct {

	// step_id is an opaque, caller-assigned identifier for this step. Runway
	// treats it as an attribution token only -- it echoes it back per-step in
	// StepResult so a multi-step result is attributable -- and never interprets
	// its contents.
	StepId string `protobuf:"bytes,1,opt,name=step_id,json=stepId,proto3" json:"step_id,omitempty"`
	// change is the code change to apply for this step. It may carry multiple
	// URIs, which are a stack: each URI is its own unit of change, applied in
	// the order given, each on top of the last.
	Change *protopb.Change `protobuf:"bytes,2,opt,name=change,proto3" json:"change,omitempty"`
	// strategy is how this step's change is integrated into the merge target.
	// It applies to every URI the change carries, the same way to each, so a
	// step is never a mix of strategies. PROMOTE is the exception that admits
	// only a single URI.
	Strategy protopb1.Strategy `protobuf:"varint,3,opt,name=strategy,proto3,enum=uber.base.mergestrategy.Strategy" json:"strategy,omitempty"`
	// contains filtered or unexported fields
}

type Outcome int32

type StepOutput struct {

	// id is the VCS-neutral revision identifier -- a git commit SHA, a Mercurial
	// changeset hash, a Subversion revision number, a Perforce changelist, and so
	// on.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"` // (room to grow: author, committed_at, parent, ...)
	// contains filtered or unexported fields
}

type StepResult struct {

	// step_id echoes the step_id of the step this result is for.
	StepId string `protobuf:"bytes,1,opt,name=step_id,json=stepId,proto3" json:"step_id,omitempty"`
	// outputs are the revisions this step produced on the merge target, in
	// application order (the order the step created them on the target). Empty
	// for a dry-run check, for a change already present on the target, or for a
	// step that failed to apply.
	Outputs []*StepOutput `protobuf:"bytes,2,rep,name=outputs,proto3" json:"outputs,omitempty"`
	// reason is a human-readable explanation when the step failed to apply.
	// Empty on success.
	Reason string `protobuf:"bytes,3,opt,name=reason,proto3" json:"reason,omitempty"`
	// contains filtered or unexported fields
}