Files
mesh-delivery/contracts/go/seats/meshdelivery/contract.go
T
jschoubben f9df426396 §690 the seat mesh-delivery's source takes no branch and answers the branches it keeps
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
2026-11-11 21:30:49 +01:00

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"`
}