source's input branch is optional; given none it answers branches, the branch of each source key the gate keeps. Fixtures and generated code follow. Builds: design 47 G §690, §614 Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
765 lines
25 KiB
Go
765 lines
25 KiB
Go
// Code generated by seatgen from the seat definitions; DO NOT EDIT.
|
|
|
|
// Package meshdelivery is the contract of the seat "mesh-delivery", defined whole (seats/mesh-delivery/seat.json): The delivery gate: reads and steers deliveries, merges and the checks that decide them; the merge is made on the operator's Approve once both checks passed.
|
|
package meshdelivery
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/json"
|
|
"errors"
|
|
"strings"
|
|
"time"
|
|
)
|
|
|
|
// Seat is the seat's name.
|
|
const Seat = "mesh-delivery"
|
|
|
|
const (
|
|
VerbDeliveries = "deliveries"
|
|
VerbShow = "show"
|
|
VerbGroups = "groups"
|
|
VerbSource = "source"
|
|
VerbStalled = "stalled"
|
|
VerbRecovery = "recovery"
|
|
)
|
|
|
|
const (
|
|
EventOwed = "owed"
|
|
EventPinned = "pinned"
|
|
EventFreed = "freed"
|
|
EventHeadsReplaced = "heads-replaced"
|
|
EventRecordOpened = "record-opened"
|
|
EventRecordEnded = "record-ended"
|
|
EventFilling = "filling"
|
|
EventFull = "full"
|
|
EventRoom = "room"
|
|
EventSourceMoved = "source-moved"
|
|
EventRecoveryMerged = "recovery-merged"
|
|
EventApprovalCarried = "approval-carried"
|
|
EventPinsStated = "pins-stated"
|
|
)
|
|
|
|
// Verbs is every verb the seat serves, in its definition's order: a new copy each call.
|
|
func Verbs() []string {
|
|
return []string{VerbDeliveries, VerbShow, VerbGroups, VerbSource, VerbStalled, VerbRecovery}
|
|
}
|
|
|
|
// Events is every event published on the seat's subject: a new copy each call.
|
|
func Events() []string {
|
|
return []string{EventOwed, EventPinned, EventFreed, EventHeadsReplaced, EventRecordOpened, EventRecordEnded, EventFilling, EventFull, EventRoom, EventSourceMoved, EventRecoveryMerged, EventApprovalCarried, EventPinsStated}
|
|
}
|
|
|
|
// Family is where the seat's events are kept: the shared events stream, filtered to the seat's subjects.
|
|
const (
|
|
Family = "mesh-delivery.events"
|
|
FamilyMaxAgeDays = 7
|
|
)
|
|
|
|
// StreamOwed is the stream owed is kept in.
|
|
const StreamOwed = "SEAT_mesh-delivery_owed"
|
|
|
|
// SubjectOwed is where owed is published, on mesh.seat.mesh-delivery.event.owed.<repository>.<number>.
|
|
func SubjectOwed(repository, number string) string {
|
|
return "mesh.seat.mesh-delivery.event.owed." + repository + "." + number
|
|
}
|
|
|
|
// SubjectOwedAll hears every owed.
|
|
const SubjectOwedAll = "mesh.seat.mesh-delivery.event.owed.*.*"
|
|
|
|
// SubjectPinned is where pinned is published.
|
|
const SubjectPinned = "mesh.seat.mesh-delivery.event.pinned"
|
|
|
|
// SubjectFreed is where freed is published.
|
|
const SubjectFreed = "mesh.seat.mesh-delivery.event.freed"
|
|
|
|
// SubjectHeadsReplaced is where heads-replaced is published.
|
|
const SubjectHeadsReplaced = "mesh.seat.mesh-delivery.event.heads-replaced"
|
|
|
|
// SubjectRecordOpened is where record-opened is published.
|
|
const SubjectRecordOpened = "mesh.seat.mesh-delivery.event.record-opened"
|
|
|
|
// SubjectRecordEnded is where record-ended is published.
|
|
const SubjectRecordEnded = "mesh.seat.mesh-delivery.event.record-ended"
|
|
|
|
// SubjectFilling is where filling is published.
|
|
const SubjectFilling = "mesh.seat.mesh-delivery.event.filling"
|
|
|
|
// SubjectFull is where full is published.
|
|
const SubjectFull = "mesh.seat.mesh-delivery.event.full"
|
|
|
|
// SubjectRoom is where room is published.
|
|
const SubjectRoom = "mesh.seat.mesh-delivery.event.room"
|
|
|
|
// SubjectSourceMoved is where source-moved is published, on mesh.seat.mesh-delivery.event.source-moved.<branch>.
|
|
func SubjectSourceMoved(branch string) string {
|
|
return "mesh.seat.mesh-delivery.event.source-moved." + branch
|
|
}
|
|
|
|
// SubjectSourceMovedAll hears every source-moved.
|
|
const SubjectSourceMovedAll = "mesh.seat.mesh-delivery.event.source-moved.*"
|
|
|
|
// SubjectRecoveryMerged is where recovery-merged is published.
|
|
const SubjectRecoveryMerged = "mesh.seat.mesh-delivery.event.recovery-merged"
|
|
|
|
// StreamApprovalCarried is the stream approval-carried is kept in.
|
|
const StreamApprovalCarried = "SEAT_mesh-delivery_approval-carried"
|
|
|
|
// SubjectApprovalCarried is where approval-carried is published, on mesh.seat.mesh-delivery.event.approval-carried.<repository>.<pull>.
|
|
func SubjectApprovalCarried(repository, pull string) string {
|
|
return "mesh.seat.mesh-delivery.event.approval-carried." + repository + "." + pull
|
|
}
|
|
|
|
// SubjectApprovalCarriedAll hears every approval-carried.
|
|
const SubjectApprovalCarriedAll = "mesh.seat.mesh-delivery.event.approval-carried.*.*"
|
|
|
|
// SubjectPinsStated is where pins-stated is published.
|
|
const SubjectPinsStated = "mesh.seat.mesh-delivery.event.pins-stated"
|
|
|
|
const (
|
|
StateSource = "source"
|
|
StateMerges = "merges"
|
|
StateAsks = "asks"
|
|
StateOwed = "owed"
|
|
StateTurns = "turns"
|
|
)
|
|
|
|
// SourceByBranchKey is the key of one value of the state source under the form "<branch>".
|
|
func SourceByBranchKey(branch string) string { return branch }
|
|
|
|
// ParseSourceByBranchKey reads the parts of a key of the form "<branch>", in the order of the form; the last result is false for a key of another form.
|
|
func ParseSourceByBranchKey(key string) (string, bool) {
|
|
rest := key
|
|
if rest == "" {
|
|
return "", false
|
|
}
|
|
v0 := rest
|
|
rest = ""
|
|
if rest != "" {
|
|
return "", false
|
|
}
|
|
return v0, true
|
|
}
|
|
|
|
// DecodeSourceByBranchValue reads one value of the state source under the form "<branch>", refusing a field SourceByBranchValue does not know and any text after the value.
|
|
func DecodeSourceByBranchValue(raw []byte) (SourceByBranchValue, error) {
|
|
var v SourceByBranchValue
|
|
dec := json.NewDecoder(bytes.NewReader(raw))
|
|
dec.DisallowUnknownFields()
|
|
if err := dec.Decode(&v); err != nil {
|
|
return v, err
|
|
}
|
|
if dec.More() {
|
|
return v, errors.New("text after the value")
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
// MergesByGroupKey is the key of one value of the state merges under the form "<group>".
|
|
func MergesByGroupKey(group string) string { return group }
|
|
|
|
// ParseMergesByGroupKey reads the parts of a key of the form "<group>", in the order of the form; the last result is false for a key of another form.
|
|
func ParseMergesByGroupKey(key string) (string, bool) {
|
|
rest := key
|
|
if rest == "" {
|
|
return "", false
|
|
}
|
|
v0 := rest
|
|
rest = ""
|
|
if rest != "" {
|
|
return "", false
|
|
}
|
|
return v0, true
|
|
}
|
|
|
|
// DecodeMergesByGroupValue reads one value of the state merges under the form "<group>", refusing a field MergesByGroupValue does not know and any text after the value.
|
|
func DecodeMergesByGroupValue(raw []byte) (MergesByGroupValue, error) {
|
|
var v MergesByGroupValue
|
|
dec := json.NewDecoder(bytes.NewReader(raw))
|
|
dec.DisallowUnknownFields()
|
|
if err := dec.Decode(&v); err != nil {
|
|
return v, err
|
|
}
|
|
if dec.More() {
|
|
return v, errors.New("text after the value")
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
// AsksByMergeGroupHeadsKey is the key of one value of the state asks under the form "merge.<group>.<heads>".
|
|
func AsksByMergeGroupHeadsKey(group, heads string) string { return "merge." + group + "." + heads }
|
|
|
|
// ParseAsksByMergeGroupHeadsKey reads the parts of a key of the form "merge.<group>.<heads>", in the order of the form; the last result is false for a key of another form.
|
|
func ParseAsksByMergeGroupHeadsKey(key string) (string, string, bool) {
|
|
rest := key
|
|
if !strings.HasPrefix(rest, "merge.") {
|
|
return "", "", false
|
|
}
|
|
rest = rest[6:]
|
|
v1, after1, found1 := strings.Cut(rest, ".")
|
|
if !found1 || v1 == "" {
|
|
return "", "", false
|
|
}
|
|
rest = after1
|
|
if rest == "" {
|
|
return "", "", false
|
|
}
|
|
v3 := rest
|
|
rest = ""
|
|
if rest != "" {
|
|
return "", "", false
|
|
}
|
|
return v1, v3, true
|
|
}
|
|
|
|
// DecodeAsksByMergeGroupHeadsValue reads one value of the state asks under the form "merge.<group>.<heads>", refusing a field AsksByMergeGroupHeadsValue does not know and any text after the value.
|
|
func DecodeAsksByMergeGroupHeadsValue(raw []byte) (AsksByMergeGroupHeadsValue, error) {
|
|
var v AsksByMergeGroupHeadsValue
|
|
dec := json.NewDecoder(bytes.NewReader(raw))
|
|
dec.DisallowUnknownFields()
|
|
if err := dec.Decode(&v); err != nil {
|
|
return v, err
|
|
}
|
|
if dec.More() {
|
|
return v, errors.New("text after the value")
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
// OwedByRepositoryNumberHeadActKey is the key of one value of the state owed under the form "<repository>.<number>.<head>.<act>".
|
|
func OwedByRepositoryNumberHeadActKey(repository, number, head, act string) string {
|
|
return repository + "." + number + "." + head + "." + act
|
|
}
|
|
|
|
// ParseOwedByRepositoryNumberHeadActKey reads the parts of a key of the form "<repository>.<number>.<head>.<act>", in the order of the form; the last result is false for a key of another form.
|
|
func ParseOwedByRepositoryNumberHeadActKey(key string) (string, string, string, string, bool) {
|
|
rest := key
|
|
v0, after0, found0 := strings.Cut(rest, ".")
|
|
if !found0 || v0 == "" {
|
|
return "", "", "", "", false
|
|
}
|
|
rest = after0
|
|
v2, after2, found2 := strings.Cut(rest, ".")
|
|
if !found2 || v2 == "" {
|
|
return "", "", "", "", false
|
|
}
|
|
rest = after2
|
|
v4, after4, found4 := strings.Cut(rest, ".")
|
|
if !found4 || v4 == "" {
|
|
return "", "", "", "", false
|
|
}
|
|
rest = after4
|
|
if rest == "" {
|
|
return "", "", "", "", false
|
|
}
|
|
v6 := rest
|
|
rest = ""
|
|
if rest != "" {
|
|
return "", "", "", "", false
|
|
}
|
|
return v0, v2, v4, v6, true
|
|
}
|
|
|
|
// DecodeOwedByRepositoryNumberHeadActValue reads one value of the state owed under the form "<repository>.<number>.<head>.<act>", refusing a field OwedByRepositoryNumberHeadActValue does not know and any text after the value.
|
|
func DecodeOwedByRepositoryNumberHeadActValue(raw []byte) (OwedByRepositoryNumberHeadActValue, error) {
|
|
var v OwedByRepositoryNumberHeadActValue
|
|
dec := json.NewDecoder(bytes.NewReader(raw))
|
|
dec.DisallowUnknownFields()
|
|
if err := dec.Decode(&v); err != nil {
|
|
return v, err
|
|
}
|
|
if dec.More() {
|
|
return v, errors.New("text after the value")
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
// TurnsByRepositoryKey is the key of one value of the state turns under the form "<repository>".
|
|
func TurnsByRepositoryKey(repository string) string { return repository }
|
|
|
|
// ParseTurnsByRepositoryKey reads the parts of a key of the form "<repository>", in the order of the form; the last result is false for a key of another form.
|
|
func ParseTurnsByRepositoryKey(key string) (string, bool) {
|
|
rest := key
|
|
if rest == "" {
|
|
return "", false
|
|
}
|
|
v0 := rest
|
|
rest = ""
|
|
if rest != "" {
|
|
return "", false
|
|
}
|
|
return v0, true
|
|
}
|
|
|
|
// DecodeTurnsByRepositoryValue reads one value of the state turns under the form "<repository>", refusing a field TurnsByRepositoryValue does not know and any text after the value.
|
|
func DecodeTurnsByRepositoryValue(raw []byte) (TurnsByRepositoryValue, error) {
|
|
var v TurnsByRepositoryValue
|
|
dec := json.NewDecoder(bytes.NewReader(raw))
|
|
dec.DisallowUnknownFields()
|
|
if err := dec.Decode(&v); err != nil {
|
|
return v, err
|
|
}
|
|
if dec.More() {
|
|
return v, errors.New("text after the value")
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
// Act is an act the gate said for a group, with its recorded outcome once the forge bridge said one.
|
|
type Act struct {
|
|
// when the outcome was recorded
|
|
At *time.Time `json:"at,omitempty"`
|
|
// the outcome the forge bridge said as owed.ended and the gate recorded; absent while unanswered
|
|
Outcome string `json:"outcome,omitempty"`
|
|
Owed Owed `json:"owed"`
|
|
// the forge's own words for a refusal, the error for an act that could not be performed, why one is undecodable or dropped
|
|
Words string `json:"words,omitempty"`
|
|
}
|
|
|
|
// The values of Act's outcome.
|
|
const (
|
|
ActOutcomePerformed = "performed"
|
|
ActOutcomeRefused = "refused"
|
|
ActOutcomeCouldNotBePerformed = "could not be performed"
|
|
ActOutcomeUndecodable = "undecodable"
|
|
ActOutcomeDropped = "dropped"
|
|
)
|
|
|
|
// Ask is the one Approve ask of a milestone (ADR 0493 §9), said apart from each delivery's transition.
|
|
type Ask struct {
|
|
// on answered: approve or decline
|
|
Answer string `json:"answer,omitempty"`
|
|
// the ask's id
|
|
Ask string `json:"ask"`
|
|
// when
|
|
At *time.Time `json:"at,omitempty"`
|
|
// on answered: who answered
|
|
By string `json:"by,omitempty"`
|
|
// its delivery group
|
|
Group string `json:"group"`
|
|
// repository to the head asked
|
|
Heads map[string]string `json:"heads,omitempty"`
|
|
// the milestone
|
|
Milestone string `json:"milestone"`
|
|
// on withdrawn: why, such as a new head of a member
|
|
Why string `json:"why,omitempty"`
|
|
}
|
|
|
|
// Fill is the delivery records' ledger's fill against its cap.
|
|
type Fill struct {
|
|
// when
|
|
At *time.Time `json:"at,omitempty"`
|
|
Bytes int64 `json:"bytes"`
|
|
// bytes
|
|
Cap int64 `json:"cap"`
|
|
// what full refuses, such as the next record
|
|
Refused string `json:"refused,omitempty"`
|
|
// the kept data, by its name in the holder's manifest
|
|
Store string `json:"store"`
|
|
}
|
|
|
|
// Group is one delivery group: its members, its derived state and the acts the gate said for it.
|
|
type Group struct {
|
|
// the acts the gate said for it, each with its id and its recorded outcome; an id said and not answered is the forge bridge's to perform
|
|
Acts []Act `json:"acts"`
|
|
// the group's check: its verdict, or asked as <id>
|
|
Check string `json:"check,omitempty"`
|
|
// the group's id, its branch
|
|
ID string `json:"id"`
|
|
// its members in merge order
|
|
Members []Member `json:"members"`
|
|
// its state, derived from its members
|
|
State string `json:"state"`
|
|
// why it is in that state
|
|
Why string `json:"why,omitempty"`
|
|
}
|
|
|
|
// Member is one member of a group: a pull request.
|
|
type Member struct {
|
|
// the branch it merges into
|
|
Base string `json:"base,omitempty"`
|
|
// its head
|
|
Head string `json:"head"`
|
|
// the member's delivery id
|
|
ID string `json:"id"`
|
|
// the pull request's number
|
|
Number int64 `json:"number"`
|
|
// the pull request is open: not merged, closed or final
|
|
Open bool `json:"open,omitempty"`
|
|
// the repository, <owner>/<name>
|
|
Repository string `json:"repository"`
|
|
// the member's delivery state
|
|
State string `json:"state"`
|
|
}
|
|
|
|
// Owed is one act the gate owes the forge, said once under its id and safe to repeat at the forge (design 47 *What the gate owes the forge*); the forge bridge performs it through the seat git's verb of the same act.
|
|
type Owed struct {
|
|
// the act: merge (the seat git's merge-pull), status, view, comment or note
|
|
Act string `json:"act"`
|
|
// the operator's ask that approved the heads, for a merge
|
|
Ask string `json:"ask,omitempty"`
|
|
// the commit a status or a note line is on; the head when absent
|
|
Commit string `json:"commit,omitempty"`
|
|
// a status: its context, such as mesh/merge-gate
|
|
Context string `json:"context,omitempty"`
|
|
// a status: what it says
|
|
Description string `json:"description,omitempty"`
|
|
// the delivery group the pull request is a member of, for a merge
|
|
Group string `json:"group,omitempty"`
|
|
// the pull request's head the act is for
|
|
Head string `json:"head"`
|
|
// the act's id, the same each time it is said again; a comment and a note line carry it, so the forge holds it once
|
|
ID string `json:"id"`
|
|
// a note line: the one line
|
|
Line string `json:"line,omitempty"`
|
|
// the pull request's number
|
|
Number int64 `json:"number"`
|
|
// the repository, <owner>/<name>
|
|
Repository string `json:"repository"`
|
|
// when the gate first said it
|
|
Said *time.Time `json:"said,omitempty"`
|
|
// a status: its state, pending, success, failure or error
|
|
State string `json:"state,omitempty"`
|
|
// a status: the page it links to
|
|
Target string `json:"target,omitempty"`
|
|
// a comment or the view: the text, markdown
|
|
Text string `json:"text,omitempty"`
|
|
}
|
|
|
|
// The values of Owed's act.
|
|
const (
|
|
OwedActMerge = "merge"
|
|
OwedActStatus = "status"
|
|
OwedActView = "view"
|
|
OwedActComment = "comment"
|
|
OwedActNote = "note"
|
|
)
|
|
|
|
// Pins is the graph revisions a delivery record starts or stops pointing at.
|
|
type Pins struct {
|
|
// assignment graph revisions, by their number on the seat mesh-wants
|
|
Assignment []int64 `json:"assignment,omitempty"`
|
|
// catalog graph revisions, by their number on the seat mesh-catalog
|
|
Catalog []int64 `json:"catalog,omitempty"`
|
|
// the record's milestone
|
|
Milestone string `json:"milestone"`
|
|
// the record's id
|
|
Record string `json:"record"`
|
|
// on freed: the record ended past its retention, or was removed by hand
|
|
Why string `json:"why,omitempty"`
|
|
}
|
|
|
|
// SourceHead is one repository of the source revision: its trunk branch and that trunk's head.
|
|
type SourceHead struct {
|
|
// the trunk's head the source revision names
|
|
Head string `json:"head"`
|
|
// the repository, <owner>/<name>
|
|
Repository string `json:"repository"`
|
|
// its trunk branch, such as main
|
|
Trunk string `json:"trunk"`
|
|
}
|
|
|
|
// DeliveriesInput is what deliveries takes.
|
|
type DeliveriesInput struct {
|
|
// "true": the final ones of the last thirty days too
|
|
All string `json:"all,omitempty"`
|
|
// a group's id (its branch name)
|
|
Group string `json:"group,omitempty"`
|
|
// owner/repository
|
|
Repository string `json:"repository,omitempty"`
|
|
// one state, e.g. delivering or held
|
|
State string `json:"state,omitempty"`
|
|
}
|
|
|
|
// The values of DeliveriesInput's all.
|
|
const (
|
|
DeliveriesInputAllTrue = "true"
|
|
DeliveriesInputAllFalse = "false"
|
|
)
|
|
|
|
// DeliveriesAnswer is what deliveries answers.
|
|
type DeliveriesAnswer = map[string]any
|
|
|
|
// ShowInput is what show takes.
|
|
type ShowInput struct {
|
|
// a delivery's id, or a group's
|
|
ID string `json:"id"`
|
|
}
|
|
|
|
// ShowAnswer is what show answers.
|
|
type ShowAnswer = map[string]any
|
|
|
|
// GroupsInput is what groups takes.
|
|
type GroupsInput struct {
|
|
// "true": the groups that ended too
|
|
All string `json:"all,omitempty"`
|
|
// one group's id: that group alone, ended or not
|
|
Group string `json:"group,omitempty"`
|
|
}
|
|
|
|
// The values of GroupsInput's all.
|
|
const (
|
|
GroupsInputAllTrue = "true"
|
|
GroupsInputAllFalse = "false"
|
|
)
|
|
|
|
// GroupsAnswer is what groups answers.
|
|
type GroupsAnswer struct {
|
|
// why it could not answer at all; a group it does not know is answered with no groups, never an error
|
|
Error string `json:"error,omitempty"`
|
|
Groups []Group `json:"groups,omitempty"`
|
|
}
|
|
|
|
// SourceInput is what source takes.
|
|
type SourceInput struct {
|
|
// the watched branch, escaped as a key name is; absent: the answer is the list of the branches the gate keeps a source revision of (design 47 G section 690)
|
|
Branch string `json:"branch,omitempty"`
|
|
}
|
|
|
|
// SourceAnswer is what source answers.
|
|
type SourceAnswer struct {
|
|
// the watched branch the source revision is of
|
|
Branch string `json:"branch,omitempty"`
|
|
// given no branch: the branch name of each source.<branch> key the gate keeps, which every reader of the catalog half follows before the first registrations (design 47 G section 614, section 690)
|
|
Branches []string `json:"branches,omitempty"`
|
|
// why it could not be read
|
|
Error string `json:"error,omitempty"`
|
|
// the group that moved the source revision last; absent before the first
|
|
Group string `json:"group,omitempty"`
|
|
// every repository the source revision names, by name
|
|
Repositories []SourceHead `json:"repositories,omitempty"`
|
|
// the source revision's number on the bus; 0 before the first
|
|
Revision int64 `json:"revision,omitempty"`
|
|
}
|
|
|
|
// StalledInput is what stalled takes.
|
|
type StalledInput struct {
|
|
}
|
|
|
|
// StalledAnswer is what stalled answers.
|
|
type StalledAnswer = map[string]any
|
|
|
|
// RecoveryInput is what recovery takes.
|
|
type RecoveryInput struct {
|
|
// the merge commit
|
|
Commit string `json:"commit"`
|
|
// the repository, <owner>/<name>
|
|
Repository string `json:"repository"`
|
|
// why the merge is a recovery
|
|
Why string `json:"why"`
|
|
}
|
|
|
|
// RecoveryAnswer is what recovery answers.
|
|
type RecoveryAnswer struct {
|
|
// the caller the runtime proved
|
|
By string `json:"by,omitempty"`
|
|
// the merge commit
|
|
Commit string `json:"commit"`
|
|
Recovery bool `json:"recovery"`
|
|
// the repository
|
|
Repository string `json:"repository,omitempty"`
|
|
}
|
|
|
|
// OwedEvent is the body of the event owed.
|
|
type OwedEvent = Owed
|
|
|
|
// PinnedEvent is the body of the event pinned.
|
|
type PinnedEvent = Pins
|
|
|
|
// FreedEvent is the body of the event freed.
|
|
type FreedEvent = Pins
|
|
|
|
// HeadsReplacedEvent is the body of the event heads-replaced.
|
|
type HeadsReplacedEvent struct {
|
|
// when
|
|
At *time.Time `json:"at,omitempty"`
|
|
// the pull request closed
|
|
Closed bool `json:"closed,omitempty"`
|
|
// the group
|
|
Group string `json:"group"`
|
|
// its new head; absent when it closed
|
|
Head string `json:"head,omitempty"`
|
|
// the candidate's heads, 12 hex digits, as its revisions are keyed
|
|
Heads string `json:"heads"`
|
|
// its pull request's number
|
|
Number int64 `json:"number"`
|
|
// the member whose head moved or which closed
|
|
Repository string `json:"repository"`
|
|
}
|
|
|
|
// RecordOpenedEvent is the body of the event record-opened.
|
|
type RecordOpenedEvent struct {
|
|
// when
|
|
At *time.Time `json:"at,omitempty"`
|
|
// a merge made at the forge, with no Approve
|
|
ForgeMade bool `json:"forge-made,omitempty"`
|
|
// its milestone
|
|
Milestone string `json:"milestone"`
|
|
// the record's id
|
|
Record string `json:"record"`
|
|
}
|
|
|
|
// RecordEndedEventAwayItem is a type of the contract.
|
|
type RecordEndedEventAwayItem struct {
|
|
// a node away
|
|
Node string `json:"node"`
|
|
// since when
|
|
Since *time.Time `json:"since,omitempty"`
|
|
}
|
|
|
|
// RecordEndedEvent is the body of the event record-ended.
|
|
type RecordEndedEvent struct {
|
|
// when
|
|
At *time.Time `json:"at,omitempty"`
|
|
// the nodes away, each with since when; it ends without them
|
|
Away []RecordEndedEventAwayItem `json:"away,omitempty"`
|
|
// a merge made at the forge, with no Approve
|
|
ForgeMade bool `json:"forge-made,omitempty"`
|
|
// its milestone
|
|
Milestone string `json:"milestone"`
|
|
// the record's id
|
|
Record string `json:"record"`
|
|
}
|
|
|
|
// FillingEvent is the body of the event filling.
|
|
type FillingEvent = Fill
|
|
|
|
// FullEvent is the body of the event full.
|
|
type FullEvent = Fill
|
|
|
|
// RoomEvent is the body of the event room.
|
|
type RoomEvent = Fill
|
|
|
|
// SourceMovedEvent is the body of the event source-moved.
|
|
type SourceMovedEvent struct {
|
|
At *time.Time `json:"at,omitempty"`
|
|
Branch string `json:"branch"`
|
|
// the group that moved it, when one did
|
|
Group string `json:"group,omitempty"`
|
|
Revision int64 `json:"revision"`
|
|
V int64 `json:"v,omitempty"`
|
|
}
|
|
|
|
// RecoveryMergedEvent is the body of the event recovery-merged.
|
|
type RecoveryMergedEvent struct {
|
|
At *time.Time `json:"at,omitempty"`
|
|
// the caller the runtime proved
|
|
By string `json:"by,omitempty"`
|
|
// the merge commit
|
|
Commit string `json:"commit"`
|
|
// the repository
|
|
Repository string `json:"repository"`
|
|
V int64 `json:"v"`
|
|
// why
|
|
Why string `json:"why"`
|
|
}
|
|
|
|
// ApprovalCarriedEvent is the body of the event approval-carried.
|
|
type ApprovalCarriedEvent struct {
|
|
// who approved: the operator
|
|
Approver string `json:"approver"`
|
|
// when it was said, RFC 3339
|
|
At time.Time `json:"at"`
|
|
// the head the Approve named
|
|
Commit string `json:"commit"`
|
|
// the pull request's number
|
|
Pull int64 `json:"pull"`
|
|
// the repository
|
|
Repository string `json:"repository"`
|
|
}
|
|
|
|
// PinsStatedEvent is the body of the event pins-stated.
|
|
type PinsStatedEvent struct {
|
|
// when it was said, RFC 3339
|
|
At time.Time `json:"at"`
|
|
}
|
|
|
|
// SourceByBranchValue is one value of the state source under the key <branch>.
|
|
type SourceByBranchValue struct {
|
|
// the group that moved it
|
|
Group string `json:"group"`
|
|
// repository to the merged head, a full commit
|
|
Heads map[string]string `json:"heads"`
|
|
// the layout version
|
|
V int64 `json:"v,omitempty"`
|
|
}
|
|
|
|
// MergesByGroupValuePullsItem is a type of the contract.
|
|
type MergesByGroupValuePullsItem struct {
|
|
Commit string `json:"commit,omitempty"`
|
|
Head string `json:"head"`
|
|
Number int64 `json:"number"`
|
|
Repository string `json:"repository"`
|
|
// merging, merged or refused
|
|
State string `json:"state"`
|
|
Words string `json:"words,omitempty"`
|
|
}
|
|
|
|
// MergesByGroupValue is one value of the state merges under the key <group>.
|
|
type MergesByGroupValue struct {
|
|
// <repository>@<number> to the approved head
|
|
Approved map[string]string `json:"approved,omitempty"`
|
|
// the ask key
|
|
Ask string `json:"ask"`
|
|
Group string `json:"group"`
|
|
Pulls []MergesByGroupValuePullsItem `json:"pulls"`
|
|
// the layout version
|
|
V int64 `json:"v,omitempty"`
|
|
}
|
|
|
|
// AsksByMergeGroupHeadsValueHeadsItem is a type of the contract.
|
|
type AsksByMergeGroupHeadsValueHeadsItem struct {
|
|
// the full commit
|
|
Head string `json:"head"`
|
|
Number int64 `json:"number"`
|
|
// <owner>/<name>
|
|
Repository string `json:"repository"`
|
|
}
|
|
|
|
// AsksByMergeGroupHeadsValue is one value of the state asks under the key merge.<group>.<heads>.
|
|
type AsksByMergeGroupHeadsValue struct {
|
|
// the operator-channel ask as raised
|
|
Ask any `json:"ask"`
|
|
// the number of times it was asked
|
|
Asking int64 `json:"asking,omitempty"`
|
|
Group string `json:"group"`
|
|
Heads []AsksByMergeGroupHeadsValueHeadsItem `json:"heads"`
|
|
// the layout version
|
|
V int64 `json:"v,omitempty"`
|
|
}
|
|
|
|
// OwedByRepositoryNumberHeadActValue is one value of the state owed under the key <repository>.<number>.<head>.<act>.
|
|
type OwedByRepositoryNumberHeadActValue struct {
|
|
// status=<context>, view, note or comment.<seq>
|
|
Act string `json:"act"`
|
|
Context string `json:"context,omitempty"`
|
|
Ref string `json:"ref,omitempty"`
|
|
State string `json:"state,omitempty"`
|
|
Target string `json:"target,omitempty"`
|
|
Text string `json:"text,omitempty"`
|
|
// the layout version
|
|
V int64 `json:"v,omitempty"`
|
|
}
|
|
|
|
// TurnsByRepositoryValueWaitingItem is a type of the contract.
|
|
type TurnsByRepositoryValueWaitingItem struct {
|
|
// when (RFC 3339 time)
|
|
Approved time.Time `json:"approved"`
|
|
Ask string `json:"ask,omitempty"`
|
|
Group string `json:"group"`
|
|
Heads string `json:"heads"`
|
|
// when (RFC 3339 time)
|
|
Since time.Time `json:"since"`
|
|
Step string `json:"step,omitempty"`
|
|
WaitsFor string `json:"waits-for,omitempty"`
|
|
// when (RFC 3339 time)
|
|
WaitsSince *time.Time `json:"waits-since,omitempty"`
|
|
}
|
|
|
|
// TurnsByRepositoryValue is one value of the state turns under the key <repository>.
|
|
type TurnsByRepositoryValue struct {
|
|
Repository string `json:"repository"`
|
|
// the layout version
|
|
V int64 `json:"v,omitempty"`
|
|
Waiting []TurnsByRepositoryValueWaitingItem `json:"waiting"`
|
|
}
|