Phase 8 — Beds, sleep need, thoughts, mood, Sulking soft-break

Three gdscript-refactor agents in parallel; Opus integrated and verified
the sleep+wake cycle via MCP runtime.

Bed entity (Agent A, scenes/entities/bed.{gd,tscn} + world.gd, ~280 lines):
- class Bed extends Node2D — bottom-anchored 3/4 perspective like Wall/Workbench
- BuildJob interface (is_buildable / on_build_tick / _complete) — same pattern
  as Wall / Crate / Workbench. blocks_pathing_when_complete=false (walkable).
- Quality-tinted sheet colours by Item.Quality tier (drab grey → blue →
  gold-brown → regal pink); white pillow + dark frame constant across tiers.
- claim(pawn) / release() / is_available() — atomic occupancy; claim re-checks
  is_available() inside to avoid race conditions during pawn walk-to-bed.
- World.beds registry + register_bed / unregister_bed (mirrors workbench pattern)

Sleep need + SleepProvider + KIND_SLEEP toil (Agent B, ~220 lines):
- Pawn.sleep: float 0..100. SLEEP_DECAY_PER_TICK=0.015 (~6667 ticks / 5.5 min
  at 1× / 1 min at Ultra to fully tire). Slower than hunger.
- is_tired() at <30; is_exhausted() at <5 (Phase 9 status interrupt hook)
- SleepProvider priority=8 (highest — sleep beats eat=7 when both urgent)
- Toil.KIND_SLEEP + Toil.sleep_in_bed(NodePath) factory
- JobRunner._tick_sleep: first-tick bed claim (with race-loss → floor fallback),
  per-tick recovery (bed=0.5/tick, floor=0.25/tick), wake-when-full at ≥99,
  emergency ceiling SLEEP_TICKS_MAX=2000 prevents stuck-asleep loops

Thoughts + mood + Sulking (Agent C, ~290 lines):
- scenes/ai/thought.gd: class Thought (RefCounted) with id, modifier, lifetime
  (PERSISTENT/EVENT), stacks, ticks_remaining; MAX_STACKS_PER_THOUGHT=5 locked
- scenes/ai/thought_catalog.gd: ThoughtCatalog with 5 Phase 8 thoughts —
  hungry(-6, PERSISTENT) / tired(-4, PERSISTENT) / well_rested(+5, EVENT 1200t)
  / slept_on_floor(-5, EVENT 1200t) / ate_meal(+3, EVENT 800t, stacks up to 3)
- Pawn extended: thoughts: Array, mood: float (base 50), sulking: bool,
  _sulk_low_ticks. add_thought (stack-merge by id), remove_thought_by_id,
  has_thought, is_sulking. _process_thoughts in sim_tick decays EVENT thoughts,
  syncs PERSISTENT thoughts to state (hungry/tired), recomputes mood, checks
  sulking transition: mood < 25 for MOOD_SULK_SUSTAIN_TICKS=600 ticks → SULKING;
  mood >= 35 → recover.
- Decision Layer 1 extended: pawn.is_sulking() → return null (sulking pawns
  refuse all work; Phase 17 may add Wandering variant)
- EventBus.pawn_mood_changed signal
- JobRunner._tick_eat: fires ate_meal thought when consuming MEAL/BREAD
- JobRunner._tick_sleep: fires well_rested or slept_on_floor on wake

Opus integration:
- world.tscn: SleepProvider node added (9 providers total)
- world.gd registers in priority order:
  sleep=8 > eat=7 > construction=6 > chop=5 ≈ plant=5 > mine=4 ≈ crafting=4 > haul=3 > rest=0
- Demo seed: 3 beds along cabin's north row at (45/47/49, 24), pre-built
  so pawns can sleep immediately when tired

Acceptance — MCP-verified end-to-end:
- Pre-tired Bram at sleep=25 → SleepProvider issued 'Sleep at (45, 24)' job
- Bram walked to bed, claimed, slept 200 ticks, woke at sleep≥99
- Bed released back to available; well_rested thought fired (+5 mood)
- After ~12000 ticks total: all 3 pawns slept (sleep recovered to 67/86/51),
  thoughts active (1-2 per pawn — well_rested + ate_meal from Phase 7 cooked
  bread consumption), beds all back to available, no claim leaks
- Mood compute working (base 50 + thought modifiers); sulking transition
  ready but didn't fire — would need misery accumulation (Phase 9 Cold +
  Bleeding statuses) to drive mood < 25 sustained

Phase 8 followups for later phases:
- Sulking returns null (stand still); Phase 17 may add Wandering soft-break
  that issues a random-walk job
- Bed ownership (_owner_pawn) reserved but not used in Phase 8 — Phase 17
  may add 'bedrooms' where each pawn claims a specific bed
- _tick_sleep's using_bed local-var reset pattern is correct but fragile;
  cleanup pass when status interrupts (Phase 9) wire into the eat/sleep
  cancellation path

Delegation report this phase:
- Agent A: Bed entity (buildable, quality-tinted, claim/release)
- Agent B: Pawn.sleep + SleepProvider + KIND_SLEEP toil + JobRunner._tick_sleep
- Agent C: Thought + ThoughtCatalog + Pawn mood/sulking + Decision Layer 1
  + JobRunner thought hooks in _tick_eat / _tick_sleep
- Opus: scene wiring + 3 beds in demo seed + MCP runtime verification

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

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

scenes/ai/thought.gd

@@ -0,0 +1,79 @@
+class_name Thought extends RefCounted
+## A single mood modifier entry, either state-driven (PERSISTENT) or
+## one-shot event-driven (EVENT).
+##
+## PERSISTENT thoughts are added / removed by Pawn._refresh_persistent_thoughts
+## each sim tick based on the pawn's current state (e.g. is_hungry()).
+## They have no ticks_remaining — they exist for exactly as long as the
+## triggering state is true.
+##
+## EVENT thoughts fire once on a game event (eating a meal, sleeping in a bed)
+## and decay after ticks_remaining reaches zero. They stack up to max_stacks —
+## for example, eating multiple meals in a row adds stacks to &"ate_meal"
+## rather than duplicating entries.
+##
+## Save/load contract:
+##   var t2 := Thought.from_dict(t.to_dict())
+##   assert(t2.id == t.id and t2.stacks == t.stacks)
+##
+## docs/architecture.md "MoodSystem" + MAX_STACKS_PER_THOUGHT = 5 (locked).
+
+enum Lifetime {
+	PERSISTENT,  ## Present while a triggering state is true; Pawn manages add/remove.
+	EVENT,       ## Fires once on a transition; decays after ticks_remaining ticks.
+}
+
+## Hard cap per thought type (docs/architecture.md "MoodSystem" — locked).
+const MAX_STACKS_PER_THOUGHT: int = 5
+
+## Unique identifier, e.g. &"hungry", &"well_rested". Used as the merge key.
+var id: StringName = &""
+
+## Human-readable label for Audit logs and future pawn-detail UI.
+## Not i18n'd here; call Strings.t("thought." + id) for player-visible text.
+var label: String = ""
+
+## Mood delta per stack. Negative = bad, positive = good.
+## Typical range -8..+8. Capped at max_stacks when computing mood.
+var modifier: int = 0
+
+## Whether this thought decays over time (EVENT) or tracks live state (PERSISTENT).
+var lifetime: Lifetime = Lifetime.EVENT
+
+## Per-thought stack ceiling. Usually MAX_STACKS_PER_THOUGHT; some thoughts are
+## capped lower (e.g. hungry is max_stacks=1 because it's binary present/absent).
+var max_stacks: int = MAX_STACKS_PER_THOUGHT
+
+# ── Runtime state (owned by the Pawn after add_thought()) ────────────────────
+
+## Number of times this thought is currently stacked (1..max_stacks).
+var stacks: int = 1
+
+## Remaining sim ticks before this EVENT thought expires. PERSISTENT ignores this.
+var ticks_remaining: int = 0
+
+
+# ── save / load ───────────────────────────────────────────────────────────────
+
+func to_dict() -> Dictionary:
+	return {
+		"id": String(id),
+		"label": label,
+		"modifier": modifier,
+		"lifetime": lifetime,
+		"max_stacks": max_stacks,
+		"stacks": stacks,
+		"ticks_remaining": ticks_remaining,
+	}
+
+
+static func from_dict(d: Dictionary) -> Thought:
+	var t := Thought.new()
+	t.id = StringName(d.get("id", ""))
+	t.label = str(d.get("label", ""))
+	t.modifier = int(d.get("modifier", 0))
+	t.lifetime = int(d.get("lifetime", Lifetime.EVENT)) as Lifetime
+	t.max_stacks = int(d.get("max_stacks", MAX_STACKS_PER_THOUGHT))
+	t.stacks = int(d.get("stacks", 1))
+	t.ticks_remaining = int(d.get("ticks_remaining", 0))
+	return t