epic: World Director -- random events system

[abix-]

Type

• epic (initiative tracker)

Spec Doc

docs/specs/world-director.md

Goal

An invisible World Director AI that periodically triggers random events -- natural disasters, plagues, blessings, raids. All tuning is player-configurable with Easy/Normal/Hard presets. Events target all towns fairly (player, AI builder, AI raider).

MVP Events (5)

Event	Category	Effect
Fire	Natural	Damage buildings in radius, spread to adjacent
Earthquake	Natural	Damage all buildings in radius
Blight	Plague	Kill farms in radius
Bounty	Blessing	Bonus food+gold to town
Raid surge	Political	Spawn extra hostiles

Slice Issues

• Slice 1: EventDef registry + WorldDirectorSettings + settings UI presets
• Slice 2: World director system + ActiveEvent + warning + notifications
• Slice 3: Fire + Earthquake effects
• Slice 4: Blight + Bounty effects
• Slice 5: Raid surge effect

Current Focus

Spec written. Waiting for human review before slicing.

Acceptance Criteria

• Spec doc written and merged (docs/specs/world-director.md)
• EventDef registry follows k8s pattern (CRD + etcd + CR + Controller)
• Settings UI with Easy/Normal/Hard presets + Custom sliders
• All 5 MVP events implemented and functional
• Events target all towns fairly
• Save/load preserves settings and active events
• Grace period (no events in first 5 game-days)
• Max 1 active disaster at a time
• Softlock protection (don't destroy last farm/spawner)

[abix-]

/review failed PR #130

PR #130 closed -- needs work before re-submission.

Required before next attempt

• Issue epic: World Director -- random events system #129 acceptance criteria are all implementation-level (events implemented, UI, save/load, etc.). A spec-only PR cannot check those boxes. Either:
  • Add a spec-specific checklist item to this issue (e.g., "spec written and reviewed") and check it on resubmission, OR
  • Create a separate issue for the spec deliverable with its own acceptance criteria

What passed

• Spec quality is good: k8s pattern, all 5 MVP events, settings presets, performance/authority compliance
• authority.md compliant (CPU-only)
• k8s.md compliant (CRD/etcd/CR/Controller pattern)

[abix-]

Claude

• Changed: added 'Spec doc written and merged' checkbox to epic acceptance criteria; rebased issue-129 onto dev; opened new PR docs: world director random events spec #235 for spec-only merge
• Tests: no code changes -- spec doc only, no tests required
• Acceptance: 1/9 criteria verified (spec doc written, ready to merge via PR docs: world director random events spec #235); remaining 8 require implementation slices
• Open: spec quality verified good per prior review; awaiting merge of spec PR before slice issues are created
• Next: merge PR docs: world director random events spec #235, then create Slice 1-5 child issues and begin implementation