docs/conflict_generator.md

conflict_generator.md — Conflict Generator Reference

agent/conflict_generator.py — ConflictEvent templates and TaskGenerator.

---

Overview

Two parallel systems for generating crises:

System	Purpose
ConflictEvent + TEMPLATES	15 handcrafted conflicts at difficulty 1–5
TaskGenerator	Generates long-horizon Task objects (two domains)

---

ConflictEvent (Legacy)

@dataclass
class ConflictEvent:
    id: str
    title: str
    story: str
    primary_disruption: dict   # Metric deltas applied on env reset
    decisions_required: list[str]
    resource_budget: dict      # {"time", "money", "energy"}
    difficulty: int            # 1–5

Helper functions

conflict = generate_conflict()              # random from all 15
conflict = generate_conflict(difficulty=3)  # difficulty-3 pool
escalated = escalate_conflict(conflict)     # 1.4× disruption, 0.7× budget
new, reason = adaptive_escalate(conflict, agent_history)  # auto-tune

---

TaskGenerator

generator = TaskGenerator()
task = generator.generate()
task = generator.generate(domain="flight_crisis", difficulty=4)
task = generator.generate(domain="code_merge_crisis")

Supported Domains

Domain	Goal
flight_crisis	Survive Airport Cancellation
code_merge_crisis	Resolve Production Outage

Unknown domains fall back to flight_crisis.

---

Adding a New Domain

1. Add generate_<domain>(self, difficulty) -> Task to TaskGenerator.
2. Add to the if/elif in generate().
3. Update this file and docs/INDEX.md and README.md.

---

Change Log

Date	Change
2026-04-23	Initial doc created