move

type Request struct {
	To           string
	Actor        string
	ActorAliases []string
	// Interactive marks a human pressing a key — the one thing an agent
	// cannot claim, and the signal requires-human-exit listens for.
	Interactive bool
	// Force writes despite refusals; what was overridden is returned, the
	// caller says it out loud. Nothing marks the ticket itself (deliberate).
	Force bool
	// Question and Reason ride into the gate check: entering a question lane
	// or a parking lane is judged on what the move brings along.
	Question string
	Reason   string
	// Stage is applied and PERSISTED before the gate runs — the CLI stages
	// outcome, question and commits this way, and a refused move keeps them:
	// requiring two commands to satisfy one move would be a poor contract for
	// an agent. nil skips it.
	Stage func(*ticket.Ticket) error
	// Reload re-reads the gate env after Stage wrote to the board. nil keeps
	// the env the caller passed.
	Reload func() (gate.Env, error)
	// ClaimOnPull stages assignee=Actor in memory for the gate and writes it
	// in the move when the ticket is unassigned — capture belongs to nobody,
	// the pull claims (invariant 12). The CLI claims inside Stage instead.
	ClaimOnPull bool
	// Folder is the logbook folder a settle files into (initials-date).
	Folder string
	// Prepare runs on each ticket a doorway files — the callers stamp commits
	// there. nil skips it.
	Prepare func(*ticket.Ticket) error
}

type Result struct {
	Ticket   *ticket.Ticket
	Refused  gate.Violations
	Overrode gate.Violations
	Claimed  bool
	// The lane's settle, straight from lane.Settle: what left for the
	// logbook, whether the doorway (true) or the cap ran, the cap's size for
	// the caller's wording, and the never-silent partial error.
	Trimmed   []ticket.Trimmed
	Filed     bool
	Holds     int
	SettleErr error
}