fleetgoal

type Action struct {
	Kind  string
	To    string // pane id
	Label string // display name of To
	// About is the agent the directive concerns (== To unless it is a copy
	// to a parent or the head).
	About string
	Text  string
	// Ask: the recipient's next `fleet status` answers it (HURRY, REALIGN,
	// SEQUENCE to the breaker). Otherwise informational: `board ack` closes it.
	Ask   bool
	Level int
	Key   string
}

type Assessment struct {
	Fleet   string
	BoardID string
	State   string
	Why     []string

	// Pct is the mean declared pct over members with one; -1 when none.
	Pct int
	// Finish is the critical-path finish of the fleet; 0 when unknown.
	// Unknown counts the open paths with no estimate.
	Finish  int64
	Unknown int
	DueAt   int64

	Bottleneck        string // pane id ("" none)
	BottleneckWaiting int

	// Members in chain order — the team view's order.
	Members []MemberAssessment
	// Cycles are deadlocks, each in blocked_by order (pane ids).
	Cycles [][]string
	// Deps is the dependency tree exactly as the views render it.
	Deps []string
	// BoardOK is false when pressure could not be read.
	BoardOK bool
}

type Input struct {
	Fleet fleet.Fleet
	// Threads is the fleet board's recent window; nil with BoardOK false when
	// the recorder did not answer — pressure is then UNKNOWN, never zero.
	Threads []board.Thread
	BoardOK bool
	Now     int64
	Config  fleet.GoalExec // resolved
}

type MemberAssessment struct {
	PaneID string
	Label  string
	Role   string
	Parent string // pane id; may be outside the fleet

	Primary    string
	Conditions []string

	Work, Task, Activity, Health string
	Pct                          *int
	EtaAt                        int64
	Goal                         *fleet.Goal

	// Waiting is how many distinct agents wait on this one, directly or not —
	// the dependency tree's count.
	Waiting int
	// Waiters are the agents blocked directly on this one (pane ids).
	Waiters []string
	// BlockedBy are its blockers (pane ids, "human", "ext:…").
	BlockedBy []string

	// Pressure, from the board. -1 when the board could not be read.
	OpenPrompts   int
	RecentPrompts int

	StressScore int
	StressWhy   []string
	StrayWhy    []string

	// Finish is when it is expected to be done (critical path); 0 = unknown.
	Finish int64
}

type Memory struct {
	Samples map[string][]Sample
	Ladder  map[string]*Rung
	Sent    map[string][]int64 // pane -> send times within the last hour
	Cycles  int

	LastState    string
	LastReport   string // the last report's fingerprint
	LastReportAt int64
	IntervalSec  int // the adaptive cadence's current interval
}

type Plan struct {
	Actions []Action
	// Alerts are board `goal-alert` posts (level-3 escalations, waits on the
	// human) — for the human, who reads the board.
	Alerts []string
	// Report is a `goal-report` status post, or "" when nothing changed.
	Report string
	// NextSec is when to look again.
	NextSec int
	// Held counts directives the budget deferred to a later cycle.
	Held int
}

type Rung struct {
	Fingerprint string
	Level       int
	SentAt      int64
}

type Sample struct {
	At       int64
	Work     string
	Task     string
	Activity string
	Pct      int // -1 when none declared
	Updated  int64
}