A Civilization-style strategy game about governing Israel from 15 May 1948. Real ministers, real map, every fact sourced. Unity + deterministic C# sim.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text.RegularExpressions;
namespace Statecraft.Sim
{
/// <summary>Load-time checks for events, including the sensitive-content rule.</summary>
static class EventRules
{
public static readonly HashSet<string> SensitiveTags = new HashSet<string>(StringComparer.OrdinalIgnoreCase) { "holocaust", "terror", "massacre", "war-casualties", "displacement" };
public static readonly HashSet<string> SpecialTargets = new HashSet<string> { "treasury", "fx_reserves", Pools.FoodTarget, Pools.ArmsTarget };
/// <summary>Targets a sensitive event's options may not raise (CONTENT_POLICY section 4: no mechanic rewards violence against
/// civilians). Owner decision of 15 October 2026 on Q-EFX-2, "Extend it": every resource, not money alone. Until the
/// GDD resources exist as targets the legacy indicators stand for them: Money (treasury, fx_reserves), Food
/// (food_supply), Social cohesion (morale) and International Support (intl_standing). Food also has its own target
/// (`food`, R-EFX-001); Arms joins the rule with its pool (#781).</summary>
public static readonly HashSet<string> NoGainTargets = new HashSet<string> { "treasury", "fx_reserves", Pools.FoodTarget, Pools.ArmsTarget, "food_supply", "morale", "intl_standing" };
public static void Validate(Content c, HashSet<string> offices, HashSet<string> indicators)
{
var ids = new HashSet<string>();
foreach (var e in c.Events)
{
string F(string field) => $"events[{e.Id}].{field}";
ContentLoader.RequiredText(e.File, F("title"), e.Title);
ContentLoader.RequiredText(e.File, F("text"), e.Text);
ContentLoader.RequiredSources(e.File, F("sources"), e.Sources);
if (!Offices.OfficeId.IsMatch(e.Id)) throw new ContentException(e.File, F("id"), ContentLoader.IdRule);
if (!ids.Add(e.Id)) throw new ContentException(e.File, F("id"), "duplicate event id");
if (e.Anchor != "hard" && e.Anchor != "soft") throw new ContentException(e.File, F("anchor"), $"unknown anchor '{e.Anchor}' (must be hard or soft)");
ContentLoader.Status(e.File, F("status"), e.Status);
ContentLoader.Review(e.File, $"events[{e.Id}]", e.ReviewedBy, e.ReviewedByGiven, e.ReviewedOn, e.ReviewedOnGiven);
ContentLoader.Period(e.File, $"events[{e.Id}]", e.From, e.To);
// Chapters design 9: an event may not span a boundary; it is split. An open window (no `to`) is allowed only in
// the last era, since EventSystem keeps an open event eligible to the end of the game.
var era = c.Eras.FirstOrDefault(x => x.From <= e.From && e.From < x.To);
if (era != null && (e.To.HasValue ? e.To.Value > era.To : era.To < c.Eras.Max(x => x.To)))
throw new ContentException(e.File, F("to"), FormattableString.Invariant($"the window runs past the end of era '{era.Id}' ({era.To:yyyy-MM-dd}); an event may not span a boundary, split it"));
if (e.Office != "" && !offices.Contains(e.Office)) throw new ContentException(e.File, F("office"), $"unknown office '{e.Office}'");
if (c.Offices.Any(o => o.Id == e.Office && o.HistoricalOnly))
throw new ContentException(e.File, F("office"), "historical-only titles cannot be delegated events");
// R-ENEMY-007 (#2621): an objective, exchange or Deport card is answered with its single option even when it is
// delegated (EventSystem's delegation step resolves it at once), so R-ENEMY-007's placement check never runs for
// it. Such a card cannot also give unit orders. GDD loop only, as the order checks (CheckOrders): legacy content
// loads as before.
var single = !c.IsGdd ? null
: e.Objective != "" ? "objective" : e.Prisoners != "" ? "prisoners" : e.Deported != "" ? "deported" : null;
if (single != null)
foreach (var o in e.Options.Where(o => o.UnitOrders.Count != 0))
throw new ContentException(e.File, F($"options[{o.Id}].unit_orders"), $"a card with {single} cannot give unit_orders (R-ENEMY-007)");
CheckPlaceholders(c, e, F("title"), e.Title, offices);
CheckPlaceholders(c, e, F("text"), e.Text, offices);
CheckHebrew(c, e, offices);
// R-ENEMY-007: late text, only on a card that can be shown after its window closes (a following card or an
// operation), with a window to close, and in Hebrew exactly when the card's text is.
if (e.LateText != "" || e.LateTextHe != "")
{
if (!e.Follows && !e.Options.Any(o => o.RequiresUnitRegions.Count != 0))
throw new ContentException(e.File, F("late_text"), "only a following card or an operation card, which can be shown after its window, has late text");
if (!e.To.HasValue) throw new ContentException(e.File, F("late_text"), "a card with late text has a `to`");
if (e.LateText.Trim() == "") throw new ContentException(e.File, F("late_text"), "required: late_text_he is set but late_text is not");
CheckPlaceholders(c, e, F("late_text"), e.LateText, offices);
if (e.TextHe == "" && e.LateTextHe != "") throw new ContentException(e.File, F("late_text_he"), "only a card with Hebrew text has late_text_he");
if (e.TextHe != "")
{
if (e.LateTextHe == "") throw new ContentException(e.File, F("late_text_he"), "required: the card's text is in Hebrew too");
if (!e.LateTextHe.Any(ch => ch >= '\u05D0' && ch <= '\u05EA')) throw new ContentException(e.File, F("late_text_he"), "must be Hebrew, in Hebrew letters");
CheckPlaceholders(c, e, F("late_text_he"), e.LateTextHe, offices);
}
}
// R-WAR-008 (#1709; owner, 9 November 2026: "Separate early text (Recommended)"): early text, only on a
// front_quiet card, the only kind the quiet path can show before its `from` (so EventSystem.ShowsEarly, which reads
// the date alone, never shows it on another card), in Hebrew exactly when the card's text is. It can be shown from
// the first early offer (Armistice.EarliestOffer), so its office placeholders must have a holder from then.
if (e.EarlyText != "" || e.EarlyTextHe != "")
{
if (e.FrontQuiet == "")
throw new ContentException(e.File, F("early_text"), "only an armistice card with front_quiet, which can be shown before its `from`, has early text");
if (e.EarlyText.Trim() == "") throw new ContentException(e.File, F("early_text"), "required: early_text_he is set but early_text is not");
var earliest = Armistice.EarliestOffer < e.From ? Armistice.EarliestOffer : e.From;
CheckPlaceholders(c, e, F("early_text"), e.EarlyText, offices, earliest);
if (e.TextHe == "" && e.EarlyTextHe != "") throw new ContentException(e.File, F("early_text_he"), "only a card with Hebrew text has early_text_he");
if (e.TextHe != "")
{
if (e.EarlyTextHe == "") throw new ContentException(e.File, F("early_text_he"), "required: the card's text is in Hebrew too");
if (!e.EarlyTextHe.Any(ch => ch >= '\u05D0' && ch <= '\u05EA')) throw new ContentException(e.File, F("early_text_he"), "must be Hebrew, in Hebrew letters");
CheckPlaceholders(c, e, F("early_text_he"), e.EarlyTextHe, offices, earliest);
}
}
// Chapters design 3.2: an event may only name model records that are active for its whole window.
void Active(string field, string id)
{
var ind = c.Indicators.FirstOrDefault(x => x.Id == id);
var pol = c.Policies.FirstOrDefault(x => x.Id == id);
var (rf, rt) = ind != null ? (ind.From, ind.To) : pol != null ? (pol.From, pol.To) : ((DateTime?)null, (DateTime?)null);
if (!Window.Covers(rf, rt, e.From, e.To)) throw new ContentException(e.File, field, $"'{id}' is not active for the whole window of this event");
}
foreach (var cond in e.Conditions)
{
Active(F($"conditions.{cond.Indicator}"), cond.Indicator);
if (!indicators.Contains(cond.Indicator)) throw new ContentException(e.File, F($"conditions.{cond.Indicator}"), "unknown indicator");
// Indicators live in [0,1], so a bound outside it (or min above max) could never be met.
if (cond.Min.HasValue) { ContentLoader.Finite(e.File, F($"conditions.{cond.Indicator}.min"), cond.Min.Value); ContentLoader.Unit(e.File, F($"conditions.{cond.Indicator}.min"), cond.Min.Value); }
if (cond.Max.HasValue) { ContentLoader.Finite(e.File, F($"conditions.{cond.Indicator}.max"), cond.Max.Value); ContentLoader.Unit(e.File, F($"conditions.{cond.Indicator}.max"), cond.Max.Value); }
if (cond.Min > cond.Max) throw new ContentException(e.File, F($"conditions.{cond.Indicator}.min"), "must not exceed max");
}
for (int i = 0; i < e.Requires.Count; i++)
{
CheckRequirement(c, e, $"requires[{i}]", e.Requires[i]);
// Two entries on one event can never both hold, or one makes the other redundant: either way it is a slip.
if (e.Requires.Take(i).Any(r => r.Event == e.Requires[i].Event))
throw new ContentException(e.File, F($"requires[{i}].event"), $"event '{e.Requires[i].Event}' is already required; give it one entry");
}
if (e.Options.Count == 0) throw new ContentException(e.File, F("options"), "at least one option required");
if (e.Options.Count(o => o.Historical) > 1) throw new ContentException(e.File, F("options"), "at most one option can be historical");
if (e.Anchor == "hard" && !e.Options.Any(o => o.Historical)) throw new ContentException(e.File, F("options"), "hard anchor needs a historical option");
bool sensitive = e.Tags.Any(SensitiveTags.Contains);
var optionIds = new HashSet<string>();
foreach (var o in e.Options)
{
ContentLoader.RequiredText(e.File, F($"options[{o.Id}].text"), o.Text);
if (!Offices.OfficeId.IsMatch(o.Id)) throw new ContentException(e.File, F($"options[{o.Id}].id"), ContentLoader.IdRule);
if (!optionIds.Add(o.Id)) throw new ContentException(e.File, F($"options[{o.Id}].id"), "duplicate option id");
CheckPlaceholders(c, e, F($"options[{o.Id}].text"), o.Text, offices);
if (o.Alternative != null) CheckAlternative(e, o, F($"options[{o.Id}].alternative"));
// R-ALT-004: an option that did not happen says who proposed it, or that it is a design assumption.
if (!o.Historical && e.Options.Any(x => x.Historical) && o.Alternative == null)
throw new ContentException(e.File, F($"options[{o.Id}].alternative"), "an option that did not happen says who proposed it, or basis: design");
foreach (var kv in o.SetPolicy)
{
if (c.Policies.All(p => p.Id != kv.Key)) throw new ContentException(e.File, F($"options[{o.Id}].set_policy.{kv.Key}"), "unknown policy");
ContentLoader.Unit(e.File, F($"options[{o.Id}].set_policy.{kv.Key}"), kv.Value);
Active(F($"options[{o.Id}].set_policy.{kv.Key}"), kv.Key);
}
if (o.SetRung.HasValue && (o.SetRung < 1 || o.SetRung > 5)) throw new ContentException(e.File, F($"options[{o.Id}].set_rung"), "must be 1-5");
foreach (var fx in o.Effects)
{
// Check before general indicator acceptance: compatibility ids cannot enable commands or readout writes.
if (c.Ruleset == SaveGame.Gdd03Ruleset && RetiredGdd03Target(fx.Target))
throw new ContentException(e.File, F($"options[{o.Id}].effects.{fx.Target}"), "unsupported event target under gdd-0.3 (R-EFX-001)");
if (!indicators.Contains(fx.Target) && !SpecialTargets.Contains(fx.Target))
throw new ContentException(e.File, F($"options[{o.Id}].effects.{fx.Target}"), "unknown target");
Active(F($"options[{o.Id}].effects.{fx.Target}"), fx.Target);
if (!fx.HasDelta) throw new ContentException(e.File, F($"options[{o.Id}].effects.{fx.Target}.delta"), "required");
ContentLoader.Finite(e.File, F($"options[{o.Id}].effects.{fx.Target}.delta"), fx.Delta);
if ((fx.Target == Pools.FoodTarget || fx.Target == Pools.ArmsTarget) && Math.Abs(fx.Delta) > int.MaxValue)
throw new ContentException(e.File, F($"options[{o.Id}].effects.{fx.Target}"), $"{fx.Target} delta out of range");
if (sensitive && NoGainTargets.Contains(fx.Target) && fx.Delta > 0)
throw new ContentException(e.File, F($"options[{o.Id}].effects.{fx.Target}"), $"sensitive events cannot reward {fx.Target}");
}
// R-EFX-009: checked in every ruleset, since every ruleset reads the same cards; only gdd-0.3 applies it.
if (o.DebtDollars is double debt && !(double.IsFinite(debt) && debt > 0))
throw new ContentException(e.File, F($"options[{o.Id}].debt_dollars"), "must be a finite number > 0 (US$ millions)");
}
}
CheckRequirementCycles(c);
CheckKinds(c, offices);
CheckObjectives(c);
}
// #1718 D1/Q1/Q2 (owner, 1 November 2026): the passive budget, the monthly Food refill and the foreign-currency
// ledger stay, so their targets load as under gdd-0.1; of the economy's command targets only Attention retires.
// #2483 (owner, 4 November 2026): events write the food_supply and housing readouts again, as under gdd-0.1.
static bool RetiredGdd03Target(string target) =>
target == "attention" || target.StartsWith("attention_", StringComparison.Ordinal) ||
target == "defeat" || target == "city_loss_defeat" || target == "any_city_loss";
/// <summary>The options' structured effects (D-H2): R-EFX-006 refuses a target that does not exist at load, so Resolve
/// never skips one; R-EFX-005 refuses any gain from them on a sensitive event, as R-EFX-002 does for the resources.
/// Called once the GDD files (cities, unit types, sites) are read, so after <see cref="Validate"/>.</summary>
public static void ValidateStructured(Content c)
{
foreach (var e in c.Events)
foreach (var o in e.Options)
{
CheckStructured(c, e, o, e.Tags.Any(SensitiveTags.Contains), field => $"events[{e.Id}].{field}");
CheckOrders(c, e, o, field => $"events[{e.Id}].{field}");
}
CheckOperationHexes(c);
}
/// <summary>R-ENEMY-009: the operation a unit is in is the card whose decided option sent its row to the hex it is going
/// to (<see cref="EventSystem.OperationOf"/>), so no two cards send one row to one hex. The options of one card may: only
/// one of them is decided. GDD only, as <see cref="CheckOrders"/>'s hex checks are.</summary>
static void CheckOperationHexes(Content c)
{
if (!c.IsGdd) return;
var sent = new Dictionary<(string Row, int Q, int R), string>();
foreach (var e in c.Events)
{
var mine = new HashSet<(string Row, int Q, int R)>();
foreach (var o in e.Options)
for (int i = 0; i < o.UnitOrders.Count; i++)
{
var x = o.UnitOrders[i];
if (x.Order != Movement.GoTo) continue;
var key = (x.Unit, x.Q, x.R);
if (sent.TryGetValue(key, out var other) && other != e.Id)
throw new ContentException(e.File, FormattableString.Invariant($"events[{e.Id}].options[{o.Id}].unit_orders[{i}]"),
FormattableString.Invariant($"events[{other}] already sends '{x.Unit}' to hex q={x.Q} r={x.R}: a unit's operation is found from its order (R-ENEMY-009)"));
mine.Add(key);
}
foreach (var key in mine) sent[key] = e.Id;
}
}
/// <summary>R-ENEMY-005 (Q-ENEMY-5), R-ENEMY-008: an option's go-to and attack orders name a map/units_1948.yaml row and
/// one of that row's own anchor or order target hexes, so a card never sends a unit to a position no source gives it (owner, 31 October 2026,
/// #749: sourced anchors only; 2 November 2026, #2087: order targets, option 1). They are checked and applied under
/// both GDD identities. R-ENEMY-007 also requires every operation option to author its allowed player regions. The legacy loop reads the
/// same real cards but no units file, so it has nothing to check them against and no unit to order.</summary>
static void CheckOrders(Content c, GameEvent e, EventOption o, Func<string, string> F)
{
for (int i = 0; i < o.UnitOrders.Count; i++)
{
var x = o.UnitOrders[i];
var at = F(FormattableString.Invariant($"options[{o.Id}].unit_orders[{i}]"));
if (x.Unit.Trim() == "") throw new ContentException(e.File, at + ".unit", "required");
if (!x.QGiven) throw new ContentException(e.File, at + ".q", "required");
if (!x.RGiven) throw new ContentException(e.File, at + ".r", "required");
if (x.Order != Movement.GoTo && x.Order != Combat.Attack) // R-ENEMY-008
throw new ContentException(e.File, at + ".order", $"'{x.Order}' is not an operation order: go_to or attack");
}
if (!c.IsGdd) return;
var requirementField = F(FormattableString.Invariant($"options[{o.Id}].requires_unit_regions"));
if (o.UnitOrders.Count == 0)
{
if (o.RequiresUnitRegions.Count != 0)
throw new ContentException(e.File, requirementField, "requires unit_orders on the same option");
return;
}
if (o.RequiresUnitRegions.Count == 0)
throw new ContentException(e.File, requirementField, "required for an option with unit_orders (R-ENEMY-007)");
var regions = new HashSet<string>(StringComparer.Ordinal);
for (int i = 0; i < o.RequiresUnitRegions.Count; i++)
{
var id = o.RequiresUnitRegions[i];
var at = requirementField + FormattableString.Invariant($"[{i}]");
if (!regions.Add(id)) throw new ContentException(e.File, at, "duplicate region id");
if (!c.PlayerRegions.Regions.ContainsKey(id)) throw new ContentException(e.File, at, $"unknown player region '{id}' ({PlayerRegionCatalogue.FileName})");
}
// R-ENEMY-008: a row may move and then attack, so a row may appear once per order.
var rows = new HashSet<(string Row, string Order)>();
for (int i = 0; i < o.UnitOrders.Count; i++)
{
var x = o.UnitOrders[i];
var at = F(FormattableString.Invariant($"options[{o.Id}].unit_orders[{i}]"));
if (!rows.Add((x.Unit, x.Order))) throw new ContentException(e.File, at + ".unit", "duplicate operation unit row");
if (!c.UnitAnchorHexes.Keys.Any(k => k.Row == x.Unit))
throw new ContentException(e.File, at + ".unit", $"unknown unit row '{x.Unit}' ({StartingForces.FileName})");
if (!c.UnitAnchorHexes.Any(k => k.Key.Row == x.Unit && k.Value == (x.Q, x.R))
&& !c.UnitOrderTargets.Any(k => k.Key.Row == x.Unit && (k.Value.Q, k.Value.R) == (x.Q, x.R)))
throw new ContentException(e.File, at, FormattableString.Invariant($"hex q={x.Q} r={x.R} is not an anchor or an order target of '{x.Unit}' in {StartingForces.HexesFileName}"));
// The order ends with its anchor's window (the owner's answer 1 on #2087), so the anchor needs an end. An attack
// is fought when the card is decided (R-ENEMY-008) and outlasts nothing.
if (x.Order == Movement.GoTo && EventSystem.OrderEnds(c, x) == null)
throw new ContentException(e.File, at, FormattableString.Invariant($"the anchor of '{x.Unit}' on hex q={x.Q} r={x.R} has no 'to' date in {StartingForces.FileName}"));
}
}
static void CheckStructured(Content c, GameEvent e, EventOption o, bool sensitive, Func<string, string> F)
{
if (o.GrantUnits.Count + o.CityEffects.Count + o.UnlockProjects.Count == 0) return;
// No approved population/facility accounting adapter exists yet. Do not use the raw legacy mutations.
if (c.Ruleset == SaveGame.Gdd03Ruleset)
throw new ContentException(e.File, F($"options[{o.Id}].{(o.GrantUnits.Count > 0 ? "grant_units" : o.CityEffects.Count > 0 ? "city_effects" : "unlock_projects")}"), "requires an approved gdd-0.3 accounting contract (R-EFX-001/005)");
// They act on the GDD records (cities.yaml, unit_types.yaml, sites.yaml, projects.yaml), which the legacy loop does not load.
if (!c.IsGdd)
throw new ContentException(e.File, F($"options[{o.Id}].{(o.GrantUnits.Count > 0 ? "grant_units" : o.CityEffects.Count > 0 ? "city_effects" : "unlock_projects")}"), "needs the GDD loop (eras.yaml systems.loop: gdd)");
for (int i = 0; i < o.GrantUnits.Count; i++)
{
var g = o.GrantUnits[i];
string G(string field) => F(FormattableString.Invariant($"options[{o.Id}].grant_units[{i}]{field}"));
if (sensitive) throw new ContentException(e.File, G(""), "sensitive events cannot reward units");
var type = c.UnitTypes.FirstOrDefault(t => t.Id == g.Type)
?? throw new ContentException(e.File, G(".type"), $"unknown unit type '{g.Type}'");
if (type.Kind != "unit") throw new ContentException(e.File, G(".type"), $"'{g.Type}' is not a unit type (kind {type.Kind})");
// R-EFX-003: this schema has neither strength nor a sourced military formation. Do not turn a recruit
// into a default-side, zero-strength unit now that training produces military units (R-UNIT-003).
if (type.Side != "") throw new ContentException(e.File, G(".type"), "grant_units does not specify military strength; use recruit training instead");
if (g.N < 1) throw new ContentException(e.File, G(".n"), "must be at least 1");
if (g.At == "" && c.Cities.Count(x => x.Facilities.Contains(EventSystem.MilitaryCamp)) != 1)
throw new ContentException(e.File, G(".at"), "required: no single city has the military camp, so name a city");
// R-EFX-006: a target must exist on the event's date. Every cities.yaml city is in the game from the first
// turn; a site has no window and starts unbuilt, so it cannot be checked against a date yet.
if (g.At != "" && c.Cities.All(x => x.Id != g.At))
throw new ContentException(e.File, G(".at"), c.Sites.Any(x => x.Id == g.At)
? $"'{g.At}' is a site: sites cannot be grant targets until they carry a date (R-EFX-006)"
: $"unknown city '{g.At}'");
}
for (int i = 0; i < o.CityEffects.Count; i++)
{
var x = o.CityEffects[i];
string X(string field) => F(FormattableString.Invariant($"options[{o.Id}].city_effects[{i}]{field}"));
if (c.Cities.All(k => k.Id != x.City)) throw new ContentException(e.File, X(".city"), $"unknown city '{x.City}'");
if (x.Field != EventSystem.HousingField && x.Field != EventSystem.JobsField && x.Field != EventSystem.ConditionField)
throw new ContentException(e.File, X(".field"), $"unknown field '{x.Field}' (housing_capacity, job_slots or condition)");
if (x.Delta == 0) throw new ContentException(e.File, X(".delta"), "must not be 0");
// The condition is from 0 to 1 (R-HOUSE-001), so no change can exceed 1 either way; capacity and slots are whole
// units that Resolve adds as an int. The negated range test also refuses NaN.
if (x.Field == EventSystem.ConditionField)
{
if (!(x.Delta >= -1 && x.Delta <= 1)) throw new ContentException(e.File, X(".delta"), "must be a number from -1 to 1");
}
else if (!(Math.Abs(x.Delta) <= int.MaxValue) || x.Delta != Math.Floor(x.Delta))
throw new ContentException(e.File, X(".delta"), "must be a whole number in the int range");
if (sensitive && x.Delta > 0) throw new ContentException(e.File, X(""), $"sensitive events cannot reward {x.Field}");
}
for (int i = 0; i < o.UnlockProjects.Count; i++)
{
// R-EFX-008. Unlocking a kind that starts unlocked would do nothing, so it is a mistake, as an unknown kind is.
var kind = o.UnlockProjects[i];
var field = F(FormattableString.Invariant($"options[{o.Id}].unlock_projects[{i}]"));
if (sensitive) throw new ContentException(e.File, field, "sensitive events cannot reward a project unlock");
var k = c.ProjectKinds.FirstOrDefault(x => x.Id == kind)
?? throw new ContentException(e.File, field, $"unknown city project '{kind}'");
if (!k.Locked) throw new ContentException(e.File, field, $"'{kind}' is not locked in projects.yaml");
}
}
/// <summary>Objectives and their cards name each other (R-OBJ-003): an event's `objective` names an objective whose
/// `card` is that event, and an objective's card exists, names it back and has exactly one option (the card reports a
/// result; there is nothing to choose).</summary>
static void CheckObjectives(Content c)
{
const string file = ContentLoader.ObjectivesFileName;
var seen = new HashSet<string>();
foreach (var o in c.Objectives)
{
string F(string field) => $"objectives[{o.Id}].{field}";
if (!Offices.OfficeId.IsMatch(o.Id)) throw new ContentException(file, F("id"), ContentLoader.IdRule);
if (!seen.Add(o.Id)) throw new ContentException(file, F("id"), "duplicate id");
ContentLoader.Named(file, F("name"), o.Name);
// The Hebrew name (#1187): an agent translation of the English until a native speaker, or an AI-assisted
// contributor who discloses it, has read it (#564; owner, 4 November 2026: "AI-assisted can clear it"), so
// it needs no sources of its own; the flag is agent-checked or absent, and the name is Hebrew letters.
if (o.NameHeReviewGiven && o.NameHeReview != HebrewReview.AgentChecked)
throw new ContentException(file, F("name_he_review"), $"must be {HebrewReview.AgentChecked} (until a native speaker, or an AI-assisted contributor who discloses it, has read the name, #564), or left out once it has been read");
if (o.NameHe == "")
{
if (o.NameHeReviewGiven) throw new ContentException(file, F("name_he"), "required: name_he_review is set but the name is empty");
}
else if (!o.NameHe.Any(ch => ch >= '\u05D0' && ch <= '\u05EA'))
throw new ContentException(file, F("name_he"), "must be Hebrew, in Hebrew letters");
if (o.PartOf != "" && !Offices.OfficeId.IsMatch(o.PartOf))
throw new ContentException(file, F("part_of"), ContentLoader.IdRule);
var conditionKinds = o.CompletesWhen == null ? 0
: (o.CompletesWhen.SiteBuilt == "" ? 0 : 1)
+ (o.CompletesWhen.Absorbed == null ? 0 : 1)
+ (o.CompletesWhen.CorridorComplete == "" ? 0 : 1)
+ (o.CompletesWhen.SitesBuilt.Count == 0 ? 0 : 1);
if (conditionKinds != 1)
throw new ContentException(file, F("completes_when"), "required, exactly one of: { site_built: <site id> }, { absorbed: { ... } }, { corridor_complete: <corridor id> }, { sites_built: [<site id>, ...] }");
// R-OBJ-005: only parts use corridor/list conditions; PartOf also controls their base-score award.
var partCondition = o.CompletesWhen!.CorridorComplete != "" || o.CompletesWhen.SitesBuilt.Count > 0;
if (o.PartOf != "" && !partCondition)
throw new ContentException(file, F("completes_when"), "part_of is set: requires corridor_complete or sites_built");
if (o.PartOf == "" && partCondition)
throw new ContentException(file, F("completes_when"), "part_of is not set: requires site_built or absorbed");
if (o.CompletesWhen!.Absorbed is AbsorbCondition a)
{
if (a.PopulationAtLeast <= 0) throw new ContentException(file, F("completes_when.absorbed.population_at_least"), "must be above 0");
if (a.OverflowAtMost == null) throw new ContentException(file, F("completes_when.absorbed.overflow_at_most"), "required");
if (!(a.OverflowAtMost >= 0 && a.OverflowAtMost <= 1)) throw new ContentException(file, F("completes_when.absorbed.overflow_at_most"), "must be a share from 0 to 1");
if (!(a.EmployedAtLeast > 0 && a.EmployedAtLeast <= 1)) throw new ContentException(file, F("completes_when.absorbed.employed_at_least"), "must be a share above 0, at most 1");
}
if (o.ReferenceDate == default) throw new ContentException(file, F("reference_date"), "required (the sourced date of the real event)");
if (o.PartOf != "")
{
if (o.Sources.Count == 0) throw new ContentException(file, F("sources"), "required: an objective part's historical date needs a source");
for (int i = 0; i < o.Sources.Count; i++)
if (o.Sources[i] == null || !o.Sources[i].Url.StartsWith("https://", StringComparison.Ordinal) || o.Sources[i].Checked == default)
throw new ContentException(file, F($"sources[{i}]"), "needs an https url and checked date");
}
var card = c.Events.FirstOrDefault(e => e.Id == o.Card)
?? throw new ContentException(file, F("card"), $"unknown event '{o.Card}'");
if (card.Objective != o.Id)
throw new ContentException(card.File, $"events[{card.Id}].objective", $"must be '{o.Id}': the event is that objective's card");
if (card.Options.Count != 1)
throw new ContentException(card.File, $"events[{card.Id}].options", "an objective's card has exactly one option");
}
foreach (var e in c.Events.Where(e => e.Objective != ""))
{
var o = c.Objectives.FirstOrDefault(x => x.Id == e.Objective)
?? throw new ContentException(e.File, $"events[{e.Id}].objective", $"unknown objective '{e.Objective}'");
if (o.Card != e.Id)
throw new ContentException(e.File, $"events[{e.Id}].objective", $"objective '{o.Id}' has another card, '{o.Card}'");
}
foreach (var group in c.Objectives.Where(o => o.PartOf != "").GroupBy(o => o.PartOf, StringComparer.Ordinal))
if (group.Count() < 2)
throw new ContentException(file, $"objectives[{group.First().Id}].part_of", $"'{group.Key}' needs at least two parts");
}
/// <summary>R-ALT-005: how far a road runs before it folds back. DESIGN VALUE: owner-set, not a historical figure
/// (Q-ALT-5, "Accept all recommendations", owner, 17 October 2026, #945).</summary>
public const int MaxConsequenceDepth = 2;
/// <summary>A requirement that names a road not taken: `diverged: true`, a non-historical option of an event that has
/// a historical option, or any option of a consequence card.</summary>
internal static bool IsAlternativeRoad(Content c, EventRequirement r)
{
var parent = c.Events.First(x => x.Id == r.Event);
if (r.Diverged || parent.Kind == EventKinds.Consequence) return true;
return parent.Options.Any(o => o.Historical) && parent.Options.Any(o => o.Id == r.Option && !o.Historical);
}
/// <summary>R-ALT-005 to R-ALT-007 and R-ALT-010. Called after every requirement is known to exist and to form no cycle, so the depth
/// walk ends.</summary>
static void CheckKinds(Content c, HashSet<string> offices)
{
var byId = c.Events.ToDictionary(e => e.Id);
var depth = new Dictionary<string, int>();
int Depth(GameEvent e)
{
if (depth.TryGetValue(e.Id, out var d)) return d;
d = e.Kind != EventKinds.Consequence ? 0 : 1 + e.Requires.Select(r => Depth(byId[r.Event])).DefaultIfEmpty(0).Max();
depth[e.Id] = d;
return d;
}
foreach (var e in c.Events)
{
string F(string field) => $"events[{e.Id}].{field}";
if (e.Kind != EventKinds.Historical && e.Kind != EventKinds.Consequence && e.Kind != EventKinds.Reconvergence)
throw new ContentException(e.File, F("kind"), $"'{e.Kind}' must be historical, consequence or reconvergence");
foreach (var o in e.Options.Where(o => o.Rejoin != ""))
{
var at = F($"options[{o.Id}].rejoin");
if (e.Kind != EventKinds.Consequence) throw new ContentException(e.File, at, "only a consequence card rejoins the record");
if (o.Rejoin == e.Id) throw new ContentException(e.File, at, "a card cannot rejoin itself");
var target = c.Events.FirstOrDefault(x => x.Id == o.Rejoin) ?? throw new ContentException(e.File, at, $"unknown event '{o.Rejoin}'");
if (!target.Options.Any(x => x.Historical) || !e.Requires.Any(r => r.Event == target.Id && IsAlternativeRoad(c, r)))
throw new ContentException(e.File, at, "rejoins only an event whose road this card follows, and which has a historical option");
}
if (e.Variants.Count > 0 && e.Kind != EventKinds.Reconvergence)
throw new ContentException(e.File, F("variants"), "only a reconvergence event carries variants");
if (e.Kind == EventKinds.Reconvergence && !e.Options.Any(o => o.Historical))
throw new ContentException(e.File, F("options"), "a reconvergence event happened: it has a historical option");
for (int i = 0; i < e.Variants.Count; i++)
{
var v = e.Variants[i];
var at = $"variants[{i}]";
for (int j = 0; j < v.When.Count; j++)
{
CheckRequirement(c, e, $"{at}.when[{j}]", v.When[j]);
var road = c.Events.First(x => x.Id == v.When[j].Event);
// Review focus 5: the road is settled before the card opens, so the text never flips while it is shown.
if (!road.To.HasValue || road.To.Value > e.From)
throw new ContentException(e.File, F($"{at}.when[{j}]"), FormattableString.Invariant($"'{road.Id}' can still be open when this card opens: its window must close on or before {e.From:yyyy-MM-dd}"));
// R-ALT-009 makes a requirement on the road's historical option hold once a consequence card rejoins it,
// so every card that can rejoin the road is settled before this card opens too.
if (!v.When[j].Diverged && road.Options.Any(o => o.Historical && o.Id == v.When[j].Option))
foreach (var back in c.Events.Where(x => x.Options.Any(o => o.Rejoin == road.Id)))
if (!back.To.HasValue || back.To.Value > e.From)
throw new ContentException(e.File, F($"{at}.when[{j}]"), FormattableString.Invariant($"'{back.Id}' can rejoin '{road.Id}' while this card is open: its window must close on or before {e.From:yyyy-MM-dd}"));
}
if (!v.When.Any(r => IsAlternativeRoad(c, r)))
throw new ContentException(e.File, F($"{at}.when"), "a variant follows a road not taken: at least one entry names an option that did not happen, or diverged: true");
if (v.Text.Trim() == "") throw new ContentException(e.File, F($"{at}.text"), "a variant has text");
ContentLoader.RequiredSources(e.File, F($"{at}.sources"), v.Sources);
if (v.Title != "") CheckPlaceholders(c, e, F($"{at}.title"), v.Title, offices);
CheckPlaceholders(c, e, F($"{at}.text"), v.Text, offices);
}
if (e.Kind != EventKinds.Consequence)
{
// Only a consequence card may follow one: the record never raises a consequence card, and a historical
// event in the middle of a chain would reset the depth cap.
for (int i = 0; i < e.Requires.Count; i++)
if (byId[e.Requires[i].Event].Kind == EventKinds.Consequence)
throw new ContentException(e.File, F($"requires[{i}]"), $"only a consequence card may follow a consequence card ('{e.Requires[i].Event}')");
continue;
}
if (e.Objective != "") throw new ContentException(e.File, F("objective"), "a consequence card is not an objective's card");
if (e.Anchor == "hard") throw new ContentException(e.File, F("anchor"), "a consequence card is soft: it exists only on a road not taken");
if (e.Options.Any(o => o.Historical)) throw new ContentException(e.File, F("options"), "a consequence card has no historical option");
if (!e.Requires.Any(r => IsAlternativeRoad(c, r)))
throw new ContentException(e.File, F("requires"), "a consequence card follows a road not taken: at least one requirement names an option that did not happen, or diverged: true");
var bare = e.Options.FirstOrDefault(o => o.Alternative == null);
if (bare != null)
throw new ContentException(e.File, F($"options[{bare.Id}].alternative"), "every option of a consequence card says who proposed it, or basis: design");
for (int i = 0; i < e.Requires.Count; i++)
{
var r = e.Requires[i];
var parent = byId[r.Event];
// R-ALT-007: the card carries the sensitive tags of every event it requires, so the no-gain rule covers it.
foreach (var tag in parent.Tags.Where(SensitiveTags.Contains).OrderBy(t => t, StringComparer.OrdinalIgnoreCase))
if (!e.Tags.Contains(tag, StringComparer.OrdinalIgnoreCase))
throw new ContentException(e.File, F("tags"), $"must carry '{tag}', as '{parent.Id}' does");
if (!IsAlternativeRoad(c, r)) continue;
// R-ALT-006, the Ferguson gate (Q-ALT-3 (a)): the road must be one contemporaries are recorded proposing or debating.
var roads = r.Diverged ? parent.Options.Where(o => !o.Historical) : parent.Options.Where(o => o.Id == r.Option);
var unrecorded = roads.FirstOrDefault(o => o.Alternative == null || !o.Alternative.IsConsidered);
if (unrecorded != null)
throw new ContentException(e.File, F($"requires[{i}]"), $"follows '{parent.Id}/{unrecorded.Id}', which nobody is recorded proposing ({(unrecorded.Alternative == null ? "no alternative record" : "basis: design")})");
}
if (Depth(e) > MaxConsequenceDepth)
throw new ContentException(e.File, F("requires"), FormattableString.Invariant($"this road runs {Depth(e)} cards deep; the most is {MaxConsequenceDepth} (Q-ALT-5)"));
}
}
/// <summary>R-ALT-003: the shape of an option's `alternative` record.</summary>
static void CheckAlternative(GameEvent e, EventOption o, string at)
{
var a = o.Alternative!;
if (o.Historical) throw new ContentException(e.File, at, "the historical option is the record, not an alternative");
if (a.Basis != OptionAlternative.Proposed && a.Basis != OptionAlternative.Debated && a.Basis != OptionAlternative.Design)
throw new ContentException(e.File, at + ".basis", $"'{a.Basis}' must be proposed, debated or design");
if (a.Basis == OptionAlternative.Design)
{
if (a.By != "" || a.Date.HasValue)
throw new ContentException(e.File, at + (a.By != "" ? ".by" : ".date"), "a design alternative names nobody and no date");
}
else
{
if (a.By.Trim() == "") throw new ContentException(e.File, at + ".by", "a proposed or debated alternative names who put it forward");
if (a.By.IndexOfAny(new[] { '{', '}' }) >= 0) throw new ContentException(e.File, at + ".by", "words only, no placeholder: name the body or office");
if (!a.Date.HasValue) throw new ContentException(e.File, at + ".date", "needs the date it was put forward");
if (a.Sources.Count == 0) throw new ContentException(e.File, at + ".sources", "needs at least one source");
}
foreach (var src in a.Sources)
if (!src.Url.StartsWith("https://", StringComparison.Ordinal) || src.Checked == default)
throw new ContentException(e.File, at + ".sources", "needs an https url and a checked date");
}
/// <summary>R-ALT-001 and R-ALT-002: a requirement names an existing other event and either one of its options or
/// `diverged: true`, which needs that event to have a historical option.</summary>
internal static void CheckRequirement(Content c, GameEvent e, string at, EventRequirement r)
{
string F(string field) => $"events[{e.Id}].{at}{field}";
if (r.Event == e.Id) throw new ContentException(e.File, F(".event"), "an event cannot require itself");
var required = c.Events.FirstOrDefault(x => x.Id == r.Event)
?? throw new ContentException(e.File, F(".event"), $"unknown event '{r.Event}'");
if (r.Diverged && r.Option != "") throw new ContentException(e.File, F(""), "give an option or diverged: true, not both");
if (!r.Diverged && r.Option == "") throw new ContentException(e.File, F(""), "needs an option or diverged: true");
if (r.Diverged && !required.Options.Any(o => o.Historical))
throw new ContentException(e.File, F(".diverged"), $"event '{required.Id}' has no historical option, so it cannot diverge");
if (!r.Diverged && required.Options.All(o => o.Id != r.Option))
throw new ContentException(e.File, F(".option"), $"event '{required.Id}' has no option '{r.Option}'");
}
/// <summary>Re-review N4: a cycle of `requires` (A needs B, B needs A, ...) could never fire. Called after every
/// requirement's ids are known to exist. It walks each list in order; the error names the files around the first
/// cycle found, starting from the first event (in load order) that lies on one.</summary>
static void CheckRequirementCycles(Content c)
{
var byId = c.Events.ToDictionary(e => e.Id);
foreach (var start in c.Events)
{
var cycle = CycleFrom(byId, start, start, new List<GameEvent> { start }, new HashSet<string> { start.Id });
if (cycle != null)
throw new ContentException(start.File, $"events[{start.Id}].requires",
"requirements form a cycle: " + string.Join(" -> ", cycle.Select(x => x.File)));
}
}
static List<GameEvent>? CycleFrom(Dictionary<string, GameEvent> byId, GameEvent start, GameEvent at, List<GameEvent> path, HashSet<string> seen)
{
foreach (var r in at.Requires)
{
var next = byId[r.Event];
if (next.Id == start.Id) return new List<GameEvent>(path) { next };
if (!seen.Add(next.Id)) continue; // already walked from start; a cycle not through start is reported from its own member
path.Add(next);
var found = CycleFrom(byId, start, next, path, seen);
if (found != null) return found;
path.RemoveAt(path.Count - 1);
}
return null;
}
/// <summary>An event's Hebrew text (#1064): title_he, text_he and every option's text_he, all or none (a card half in
/// Hebrew would mix the languages), in Hebrew letters, with placeholders that resolve as the English ones must.
/// text_he_review is agent-checked until a native speaker, or an AI-assisted contributor who discloses it, has read
/// it (#564; owner, 4 November 2026: "AI-assisted can clear it"), and needs the text.</summary>
static void CheckHebrew(Content c, GameEvent e, HashSet<string> offices)
{
string F(string field) => $"events[{e.Id}].{field}";
if (e.TextHeReviewGiven && e.TextHeReview != HebrewReview.AgentChecked)
throw new ContentException(e.File, F("text_he_review"), $"must be {HebrewReview.AgentChecked} (until a native speaker, or an AI-assisted contributor who discloses it, has read the text, #564), or left out once it has been read");
var fields = new List<(string Field, string Value)> { ("title_he", e.TitleHe), ("text_he", e.TextHe) };
fields.AddRange(e.Options.Select(o => ($"options[{o.Id}].text_he", o.TextHe)));
if (fields.All(x => x.Value == ""))
{
if (e.TextHeReviewGiven) throw new ContentException(e.File, F("text_he"), "required: text_he_review is set but the event has no Hebrew text");
return;
}
foreach (var (field, value) in fields)
{
if (value == "") throw new ContentException(e.File, F(field), "required: an event with Hebrew text has it for its title, its text and every option");
if (!value.Any(ch => ch >= '\u05D0' && ch <= '\u05EA')) throw new ContentException(e.File, F(field), "must be Hebrew, in Hebrew letters");
CheckPlaceholders(c, e, F(field), value, offices);
}
}
/// <summary>Each office placeholder in <paramref name="text"/> names a known, single-holder office with a holder on every
/// day the text can be shown: the event's window, from <paramref name="from"/> when given (an early text, R-WAR-008),
/// else from the event's own `from`.</summary>
static void CheckPlaceholders(Content c, GameEvent e, string field, string text, HashSet<string> offices, DateTime? from = null)
{
if (Offices.Placeholder.Replace(text, "").IndexOfAny(new[] { '{', '}' }) >= 0)
throw new ContentException(e.File, field, "stray '{' or '}' outside an {office_id} placeholder");
foreach (Match m in Offices.Placeholder.Matches(text))
{
var office = m.Groups[1].Value;
if (!offices.Contains(office)) throw new ContentException(e.File, field, $"unknown office placeholder '{m.Value}'");
if (c.Offices.Any(o => o.Id == office && o.SeveralHolders))
throw new ContentException(e.File, field, $"office '{office}' can have several holders at once, so '{m.Value}' would not name one person");
var gap = FirstUncovered(c, office, from ?? e.From, e.To);
if (gap.HasValue)
throw new ContentException(e.File, field, FormattableString.Invariant($"office '{office}' has no holder on {gap.Value:yyyy-MM-dd}, inside the event window"));
}
}
/// <summary>First date in [from, to) with nobody holding office, or null. Holders only change at term
/// starts and ends and at a holder's death, so checking those dates (plus from) covers the whole window.</summary>
static DateTime? FirstUncovered(Content c, string office, DateTime from, DateTime? to)
{
bool Inside(DateTime d) => d >= from && (to == null || d < to.Value);
var terms = c.People.SelectMany(p => p.Offices).Where(t => t.Office == office).ToList();
var points = new SortedSet<DateTime> { from };
foreach (var t in terms)
{
if (Inside(t.From)) points.Add(t.From);
if (t.To.HasValue && Inside(t.To.Value)) points.Add(t.To.Value);
}
foreach (var p in c.People.Where(p => p.Died.HasValue && Inside(p.Died.Value) && p.Offices.Any(t => t.Office == office)))
points.Add(p.Died!.Value);
// An open-ended window needs no extra check: a last finite term ends inside [from, ∞) and is caught above.
foreach (var d in points)
if (Offices.Holder(c, office, d) == null) return d;
return null;
}
}
}