task

type BeatRequest struct {
	Sprint string
	ID     string
	Token  string
	Actor  string
	Idem   string
}

type BeatStatus string

type BlockedError struct {
	Sprint string
	ID     string
	Needs  []string
}

type CancelRequest struct {
	Sprint string
	ID     string
	Token  string
	Reason string
	Actor  string
	Idem   string
}

type CancelStatus string

type Claim struct {
	Sprint  string
	ID      string
	Attempt int
	Token   string
	// Kind, Ref and Title come from the claim reply itself, so the CLI's
	// TASK line costs no extra round trip (#2929).
	Kind  string
	Ref   string
	Title string
}

type Cost struct {
	Metered   bool
	USDMicro  int64
	TokensIn  int64
	TokensOut int64
	Model     string
	Route     string
	// Reason says why an unmetered cost was not measured (for example
	// "plan-billed": a main-session read on a plan has no per-read $).
	Reason string
}

type DoneOutcome struct {
	Status DoneStatus
	Why    string
	Record []string
}

type DoneRequest struct {
	Sprint   string
	ID       string
	Token    string
	Evidence string
	Verdict  string
	Score    string
	Head     string
	Actor    string
	Idem     string
	// Cost, when set, is appended to Evidence as its cost clause (#3105).
	// A read done without one is unmetered in the fold, never $0.
	Cost *Cost
	// Typed, when set, is the review's typed DISPOSITION line as the shared
	// parser (internal/nsprint/disposition) read it from the posted comment
	// (task done --body-file, nova-tools #3092 rev 7). Its head, verdict and
	// score are the close's; ns_task_done records it through
	// ns_ingest_disposition's body in the same atomic call as the close.
	Typed *TypedLine
	// As closes without a token when As owns the claimed or working lease
	// (#3206 PR A, the friend-queue `done --as` shape).
	As string
}

type DoneStatus string

type Effects string

type Field struct {
	Value string
	Set   bool
}

type Kind string

type ListRequest struct {
	Sprint string
	As     string
	State  string
}

type Overlap struct {
	ID        string
	With      string
	Path      string
	OtherPath string
}

type PushRequest struct {
	Sprint     string
	ID         string
	Kind       Kind
	Title      string
	Effects    Effects
	Repo       string
	PR         int
	Head       string
	Ref        string
	To         string
	Front      bool
	Priority   int
	PayloadSHA string
	Actor      string
	Idem       string
	Est        string
	// Needs are the ids in Sprint that must be closed before this task can
	// be claimed (#2939). Empty needs leave PayloadSHA as it was.
	Needs []string
	// DependsOn is the task's DEPENDS-ON list (#3206 PR A, ruling #3516):
	// conditions joined by ';' ("none" or empty for none). While any is
	// unmet the task is waiting and in no ready queue.
	DependsOn string
	// Author is the read rule's author (rebalance never moves a read to it).
	Author string
	ErrOut io.Writer
	// Initiator is the seat running the verb ($NOVA_FRIEND). Only
	// deprecated/cmd/nova-sprint sets it: when set, PushChecked reads its `friends`
	// membership in its first round trip and returns ErrNotFriend on a 0,
	// before any write (#2929 rev 6). With Sprint empty, the same round trip
	// reads the default sprint (lowest-score member of sprint:order). A library
	// caller leaves it empty and keeps dev's behaviour.
	Initiator string
}

type PushResult struct {
	Status  PushStatus
	Overlap *Overlap
	// Down is the friend:<to>:down marker value when Status is DOWN.
	Down string
	// Reason is the function's reason word on INVALID, when it gave one
	// (`unknown friend` for a --to not in friends).
	Reason string
	// Sprint is the sprint the push went to (the default when none was given).
	Sprint string
	// Waiting is the number of unmet DEPENDS-ON conditions of a CREATED task
	// that is waiting; 0 when it is ready.
	Waiting int
	// OnMet is a CREATED task whose DEPENDS-ON conditions all held at push.
	OnMet bool
}

type PushStatus string

type Reply struct {
	Status string
	Args   []string
}

type Row struct {
	Sprint string
	ID     string
	State  string
}

type TakeRequest struct {
	Sprint string
	ID     string
	As     string
	Actor  string
	Idem   string
}

type TypedLine struct {
	Type        string // DISPOSITION (a REPAIR refuses a review close)
	Who         string
	Head        string // 40 hex
	Verdict     string // APPROVE | HOLD
	Score       string // 1-10
	Kind        string // explicit kind=, or empty
	KindDerived string // the classifier's kind for a HOLD with no kind=
	Scope       string
	Reason      string
	URL         string // the comment as posted
	CommentID   string
}

type Width struct {
	Desired int
	Leased  int
	CI      int
	Free    int
}