cmd

type EntityDef[T any] struct {
	Type        client.EntityType
	PrimaryFlag string           // positional-name flag, e.g. "title"
	PrimaryAttr string           // its payload key
	PrimarySet  func(*T, string) // writes the positional name onto the VO
	Flags       []FlagDef[T]
	Relations   []Relation
	Label       func(*T) string // display label for pickers and output
	Detail      func(*T) string // distinguishing info shown beside labels
}

type ExitCoder interface {
	error
	ExitCode() int
}

type ExitError struct {
	Code int
	Err  error
}

type FlagDef[T any] struct {
	Name     string // flag spelling, e.g. "short-title"
	Attr     string // payload key sent to catalog-api (json tag)
	Usage    string
	Repeated bool // flag may appear multiple times; value is a slice
	Set      func(v *T, vals []string) (any, error)
}

type Relation struct {
	Type     string // counterpart entity type name
	WireName string // relation key on the wire, e.g. "publisher"
	Many     bool
}