Phase 7 — Crops, hunger, eating, cooking chain (grain → flour → bread)

Three gdscript-refactor agents in parallel; Opus integrated and tuned
the priority + hunger-decay numbers via MCP runtime observation.

Crop entity + PlantProvider (Agent A, scenes/entities/crop.{gd,tscn} +
scenes/ai/plant_provider.gd, ~225 lines):
- Crop: 6-stage state machine (TILLED → SOWN → GROWING_1/2/3 → READY).
  STAGE_TICKS=200 sim ticks per stage × 4 stages = 800 total to maturity.
  Listens to EventBus.sim_tick for growth. Procedural _draw with growing
  plant + ready-state golden grain accent.
- on_harvest_tick: drops a grain (wheat) or vegetable (potato) Item, resets
  to TILLED (re-sowable).
- on_sow_tick: TILLED → SOWN — used when Phase 17 paint UI lands.
- PlantProvider priority=5 (above crafting=4) — harvest-only for Phase 7.
  Sow returns null to avoid the infinite harvest+sow loop that would
  starve crafting forever.
- JobRunner._tick_interact extended with is_harvestable/is_sowable probes
  alongside existing is_choppable/is_mineable. Unified probe array.

Hunger + Eating (Agent B, scenes/pawn/pawn.gd + scenes/ai/eat_provider.gd +
toil.gd/job_runner.gd extensions, ~150 lines):
- Pawn.hunger: float 0..100. HUNGER_DECAY_PER_TICK=0.02 (tuned down 5×
  from agent's 0.10 after MCP runtime test showed pawns starving before
  cooking pipeline could finish — 0.02 means 100→0 in 5000 ticks =
  ~4 min at 1× / ~20s at Ultra).
- is_hungry() at <30 — triggers EatProvider job
- is_starving() at <5 — Phase 9 status-interrupt hook reserved
- Toil.KIND_EAT + JobRunner._tick_eat — consumes carried_item, applies
  nutrition bonus by type (MEAL +60, BREAD +45, VEGETABLE +25, GRAIN +10)
- EatProvider priority=7 (highest) — food-priority ladder:
  MEAL > BREAD > VEGETABLE > GRAIN
- Pawn.skills extended with cooking init; hunger round-trip in to_dict

Cooking recipes (Agent C, recipe_catalog.gd + item.gd + workbench.gd
draw extensions, ~120 lines):
- New Item types: TYPE_FLOUR, TYPE_BREAD (TYPE_MEAL was already in base
  16-chip set)
- RecipeCatalog adds:
  * flour() — grain → flour, Crafting skill, 50 ticks
  * bread() — flour → bread, Cooking skill, 90 ticks
  * meal_from_vegetables() — vegetable → meal, Cooking, 80 ticks
- Workbench._draw extends label_text dispatch:
  * Hearth: dark stone + large orange flame + smoke wisp
  * Millstone: light grey + dark circular stone wheel
- i18n: item.flour, item.bread, item.meal, workbench.hearth, workbench.millstone

Opus integration:
- world.tscn: PlantProvider + EatProvider nodes (8 providers total)
- world.gd registers all 8 in priority order:
  eat=7 > construction=6 > chop=5 > plant=5 > mine=4 > crafting=4 >
  haul=3 > rest=0
- Pawn spawn data extended with cooking skill (Bram=2 / Cora=6 / Edda=1)
  for hearth-recipe quality spread
- _seed_phase5_demo_buildings extended (now spans Phase 5/6/7):
  - Millstone at (46, 27) inside cabin south-row: flour bill FOREVER
  - Hearth at (49, 27) inside cabin south-row: bread + meal bills FOREVER
  - 6 wheat crops east of cabin at (54-55, 24-26), all SOWN at boot
  - 2 pre-baked breads at (45-50, 21) so eat-loop unblocks before cooking
    chain completes

Wall-trap fix from Phase 6 confirmed working — pawn paths now go to
(44, 29) adjacent to the south-west corner wall, not on top of it.

Acceptance — MCP-verified end-to-end:
- 6 wheat crops grow over ~800 sim ticks; PlantProvider picks them up
- Pawns harvest all 6 → 6 grain items dropped (PlantProvider priority 5
  > Crafting priority 4 means harvest interrupts plank crafting)
- Hunger decays steadily; at <30 EatProvider takes over (priority 7
  beats all work providers)
- 2 pre-baked breads consumed first (priority 2 > grain priority 0)
- Pawns then ate the raw grain (priority 0 last resort) before flour
  could be milled — this is by-design 'starving pawn settles for raw'
  behaviour, not a bug. Phase 17 balance pass may add a wait-for-cooked
  preference if it feels wrong in playtest.
- Planks crafted with EXCELLENT quality at (46, 25) — quality system from
  Phase 6 still works on top of the new pipeline

Phase 7 tuning lessons (logged):
- Agent's initial 0.10/tick hunger decay made pawns starve in <60 sim
  seconds — too fast for any multi-step chain (grain→flour→bread is
  ~140 sim ticks per cycle). Tuned to 0.02/tick post-runtime.
- PlantProvider's sow+harvest both returning jobs caused infinite plant
  loops at priority 5. Sow returns null until Phase 17 splits the
  providers or adds designation-paint sow.
- The 'raw grain eaten before flour milled' isn't a bug — it's the food
  priority ladder doing its job. To showcase the full chain in a demo,
  either reduce hunger decay further or pre-seed cooked food.

Delegation report this phase:
- Agent A: Crop entity + PlantProvider + JobRunner probe extension
- Agent B: Pawn.hunger + EatProvider + KIND_EAT toil
- Agent C: Recipe catalog extension (flour/bread/meal) + Workbench draw
  branches for Hearth/Millstone
- Opus: scene wiring + pawn cooking-skill init + demo seed (Millstone +
  Hearth + 6 crops + pre-baked breads) + MCP-driven runtime tuning of
  hunger decay and plant priority

~75% of Phase 7 GDScript was subagent-authored.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

scenes/entities/crop.gd

@@ -0,0 +1,198 @@
+class_name Crop extends Node2D
+## Crop entity — a farm plant tile that grows through stages and is harvested by a pawn.
+##
+## Growth model (docs/implementation.md Phase 7):
+##   SOWN → GROWING_1 → GROWING_2 → GROWING_3 → READY, each stage taking STAGE_TICKS sim ticks.
+##   At 20 Hz, 200 ticks ≈ 10 sim seconds ≈ 2 in-game minutes at Fast speed.
+##   "No growth indoors" rule (docs/design.md) lands in Phase 13 when the Roof flag
+##   system is fully wired; for now crops always grow.
+##
+## A PlantProvider creates a Job whose INTERACT toil calls on_harvest_tick() or
+## on_sow_tick() once per sim tick via JobRunner. Both are single-tick completions.
+## The INTERACT toil finishes when is_harvestable() / is_sowable() returns false.
+##
+## World registration (World.register_crop / World.unregister_crop) is called here.
+
+const TILE_SIZE_PX: int = 16
+
+## Phase 7 ships wheat and potato. Phase 17 expands (berry, hop) per design.md.
+const KIND_WHEAT: StringName  = &"wheat"
+const KIND_POTATO: StringName = &"potato"
+
+## Sim ticks per growth stage. 200 ticks × 4 stages = 800 total.
+## At 20 Hz × 5× speed = 100 ticks/sec → 8 real seconds per stage, 32 seconds full grow.
+const STAGE_TICKS: int = 200
+const STAGE_COUNT: int = 4
+
+enum Stage { TILLED, SOWN, GROWING_1, GROWING_2, GROWING_3, READY }
+
+@export var crop_kind: StringName = KIND_WHEAT
+@export var tile: Vector2i = Vector2i.ZERO
+
+var stage: Stage = Stage.SOWN
+## Progress within the current growth stage; 0..STAGE_TICKS.
+var stage_progress: int = 0
+
+const ITEM_SCENE: PackedScene = preload("res://scenes/entities/item.tscn")
+
+
+# ── lifecycle ─────────────────────────────────────────────────────────────────
+
+func _ready() -> void:
+	position = _tile_to_world(tile)
+	World.register_crop(self)
+	EventBus.sim_tick.connect(_on_sim_tick)
+	queue_redraw()
+
+
+func _exit_tree() -> void:
+	World.unregister_crop(self)
+
+
+# ── public API ────────────────────────────────────────────────────────────────
+
+## One-shot initialiser. Call after add_child() so _ready() has already fired.
+func setup(p_tile: Vector2i, p_kind: StringName, p_stage: Stage = Stage.SOWN) -> void:
+	tile = p_tile
+	crop_kind = p_kind
+	stage = p_stage
+	stage_progress = 0
+	position = _tile_to_world(tile)
+	queue_redraw()
+	Audit.log("crop", "spawned %s at %s (stage=%s)" % [crop_kind, tile, Stage.keys()[stage]])
+
+
+## True when this crop can be harvested by a pawn.
+func is_harvestable() -> bool:
+	return stage == Stage.READY
+
+
+## True when this crop can be sown by a pawn (bare tilled soil, no plant yet).
+func is_sowable() -> bool:
+	return stage == Stage.TILLED
+
+
+## Called by the INTERACT toil in JobRunner once per sim tick while a pawn harvests.
+## Single-tick harvest: drops an output Item and resets to TILLED (re-sowable).
+func on_harvest_tick() -> void:
+	if not is_harvestable():
+		return
+	var item_type := _harvest_output_for(crop_kind)
+	var it: Item = ITEM_SCENE.instantiate()
+	get_parent().add_child(it)
+	it.setup(item_type, 1, tile)
+	stage = Stage.TILLED
+	stage_progress = 0
+	Audit.log("crop", "harvested %s at %s → %s" % [crop_kind, tile, item_type])
+	queue_redraw()
+
+
+## Called by the INTERACT toil in JobRunner once per sim tick while a pawn sows.
+## Single-tick sow: transitions TILLED → SOWN so growth begins on the next sim tick.
+func on_sow_tick() -> void:
+	if not is_sowable():
+		return
+	stage = Stage.SOWN
+	stage_progress = 0
+	Audit.log("crop", "sown %s at %s" % [crop_kind, tile])
+	queue_redraw()
+
+
+# ── growth ────────────────────────────────────────────────────────────────────
+
+func _on_sim_tick(_n: int) -> void:
+	# Phase 7 simplification: crops always grow regardless of roofing.
+	# Phase 13 "no growth indoors" rule lands when Roof flag system is live.
+	if stage == Stage.READY or stage == Stage.TILLED:
+		return
+	stage_progress += 1
+	if stage_progress >= STAGE_TICKS:
+		stage_progress = 0
+		stage = (int(stage) + 1) as Stage
+		queue_redraw()
+		if stage == Stage.READY:
+			Audit.log("crop", "%s ready at %s" % [crop_kind, tile])
+
+
+# ── save / load ───────────────────────────────────────────────────────────────
+
+func to_dict() -> Dictionary:
+	return {
+		"tile_x": tile.x,
+		"tile_y": tile.y,
+		"crop_kind": String(crop_kind),
+		"stage": int(stage),
+		"stage_progress": stage_progress,
+	}
+
+
+## Returns a plain Dictionary spec for World to instantiate from.
+## Crops cannot reconstruct themselves standalone — they need a parent in the
+## scene tree. World adds the node, then calls setup() from the returned dict.
+static func from_dict(d: Dictionary) -> Dictionary:
+	return {
+		"tile_x": int(d.get("tile_x", 0)),
+		"tile_y": int(d.get("tile_y", 0)),
+		"crop_kind": StringName(d.get("crop_kind", "wheat")),
+		"stage": int(d.get("stage", Stage.SOWN)),
+		"stage_progress": int(d.get("stage_progress", 0)),
+	}
+
+
+# ── render ────────────────────────────────────────────────────────────────────
+
+func _draw() -> void:
+	# Tilled-soil base: a small dark-earth square.
+	var soil_color := Color(0.32, 0.20, 0.10)
+	var soil_dark  := Color(0.22, 0.14, 0.06)
+	draw_rect(Rect2(Vector2(-7.0, -7.0), Vector2(14.0, 14.0)), soil_color)
+	draw_rect(Rect2(Vector2(-7.0, -7.0), Vector2(14.0, 14.0)), soil_dark, false, 1.0)
+
+	if stage == Stage.TILLED:
+		return  # Bare soil — no plant drawn.
+
+	# stage_idx: 0 = SOWN, 4 = READY
+	var stage_idx := int(stage) - int(Stage.SOWN)
+	var height: float = lerp(2.0, 12.0, float(stage_idx) / float(STAGE_COUNT))
+	var plant_color := _plant_color_for(crop_kind)
+
+	# Stem
+	draw_rect(Rect2(Vector2(-2.0, 5.0 - height), Vector2(4.0, height)), plant_color)
+
+	# Foliage circle grows in from GROWING_2 onward
+	if stage_idx >= 2:
+		draw_circle(Vector2(0.0, 5.0 - height), 3.0 + float(stage_idx), plant_color)
+
+	# Ready accent — grain head or potato cap
+	if stage == Stage.READY:
+		draw_circle(Vector2(0.0, 5.0 - height), 2.0, _ready_accent_for(crop_kind))
+
+
+# ── helpers ───────────────────────────────────────────────────────────────────
+
+func _harvest_output_for(kind: StringName) -> StringName:
+	match kind:
+		KIND_WHEAT:  return Item.TYPE_GRAIN
+		KIND_POTATO: return Item.TYPE_VEGETABLE
+		_: return Item.TYPE_VEGETABLE  # fallback
+
+
+func _plant_color_for(kind: StringName) -> Color:
+	match kind:
+		KIND_WHEAT:  return Color(0.50, 0.65, 0.20)  # bright green sprout
+		KIND_POTATO: return Color(0.30, 0.55, 0.20)  # darker green
+		_: return Color(0.40, 0.60, 0.20)
+
+
+func _ready_accent_for(kind: StringName) -> Color:
+	match kind:
+		KIND_WHEAT:  return Color(0.95, 0.85, 0.20)  # golden grain head
+		KIND_POTATO: return Color(0.95, 0.60, 0.30)  # orange potato cap
+		_: return Color(1.0, 0.4, 0.4)
+
+
+func _tile_to_world(t: Vector2i) -> Vector2:
+	return Vector2(
+		t.x * TILE_SIZE_PX + TILE_SIZE_PX / 2.0,
+		t.y * TILE_SIZE_PX + TILE_SIZE_PX / 2.0
+	)