class_name Job extends RefCounted
## A sequence of Toils that describes a pawn's current task (walk to, haul,
## build, rest, etc.). Job is plain data; JobRunner is the state machine that
## drives execution tick-by-tick.
##
## Save/load contract:
##   var j2 := Job.from_dict(j.to_dict())
##   assert(j2.label == j.label)
##   assert(j2.current_toil_index == j.current_toil_index)
##   assert(j2.toils.size() == j.toils.size())
##   # Each toil round-trips per Toil's own invariant.

var label: String = ""
var toils: Array[Toil] = []
var current_toil_index: int = 0


# ── queries ──────────────────────────────────────────────────────────────────

## Returns the currently-executing Toil, or null when the job is done.
func active_toil() -> Toil:
	if is_complete():
		return null
	return toils[current_toil_index]


## True once every toil has been completed.
func is_complete() -> bool:
	return current_toil_index >= toils.size()


# ── state mutation ───────────────────────────────────────────────────────────

## Called by JobRunner after the current toil finishes. Steps the index forward.
func advance() -> void:
	current_toil_index += 1


# ── save / load ──────────────────────────────────────────────────────────────

func to_dict() -> Dictionary:
	var toil_list: Array = []
	for toil in toils:
		toil_list.append(toil.to_dict())
	return {
		"label": label,
		"current_toil_index": current_toil_index,
		"toils": toil_list,
	}


static func from_dict(d: Dictionary) -> Job:
	var j := Job.new()
	j.label = d.get("label", "")
	j.current_toil_index = d.get("current_toil_index", 0)
	var raw_toils: Array = d.get("toils", [])
	for raw in raw_toils:
		j.toils.append(Toil.from_dict(raw))
	return j