A Civilization-style strategy game about governing Israel from 15 May 1948. Real ministers, real map, every fact sourced. Unity + deterministic C# sim.
#nullable enable
using System;
using System.Collections.Generic;
using System.Linq;
using Statecraft.Sim;
using UnityEngine;
using YamlDotNet.Serialization;
using YamlDotNet.Serialization.NamingConventions;
namespace Statecraft.Game.UI
{
/// <summary>Reads and checks Assets/Resources/EventVideos/event-videos.yaml, the event -> illustration clip mapping
/// (decision videos, owner rulings 2026-10-13; docs/event-videos.md). A Unity-side file, never part of the hashed game
/// content. The game reads it from Resources at start (Load); the clips themselves are in StreamingAssets/video and are
/// fetched by URL only when the player asks for one (CardVideo).</summary>
public static class EventVideoMapping
{
public const string ResourcePath = "EventVideos/event-videos";
public const string Path = "Assets/Resources/EventVideos/event-videos.yaml";
public const string ClipFolder = "Assets/StreamingAssets/video";
public sealed class Row
{
public string Event { get; set; } = "";
public string File { get; set; } = "";
public string Shot { get; set; } = "";
public string Source { get; set; } = "";
public string SourceSha256 { get; set; } = "";
public string Generator { get; set; } = "";
public string Generated { get; set; } = "";
public string Alt { get; set; } = "";
public string AltHe { get; set; } = "";
// The setter records even an explicit YAML null, which must differ from an omitted post-review marker.
string? altHeReview;
public string? AltHeReview
{
get => altHeReview;
set { altHeReview = value; AltHeReviewPresent = true; }
}
[YamlIgnore] public bool AltHeReviewPresent { get; private set; }
public bool AiGenerated { get; set; }
public bool Sensitive { get; set; }
public bool SensitivityReviewed { get; set; }
/// <summary>Outcome clips only (the `outcomes` list): the option whose order it shows, and the window of the shot
/// the encoder keeps (tools/encode_event_videos.py).</summary>
public string Option { get; set; } = "";
public bool Decimate { get; set; }
public int StartFrame { get; set; }
public int Frames { get; set; }
}
sealed class Doc
{
public string Checked { get; set; } = "";
public List<Row> Clips { get; set; } = new List<Row>();
public List<Row> Outcomes { get; set; } = new List<Row>();
}
/// <summary>Parses the mapping. Throws InvalidOperationException naming the file on malformed YAML or unknown keys.</summary>
public static IReadOnlyList<Row> Parse(string yaml) => ParseDoc(yaml).Clips;
/// <summary>The End Turn outcome clips (decision videos, phase 3).</summary>
public static IReadOnlyList<Row> ParseOutcomes(string yaml) => ParseDoc(yaml).Outcomes;
static Doc ParseDoc(string yaml)
{
try
{
var doc = new DeserializerBuilder().WithNamingConvention(UnderscoredNamingConvention.Instance)
.WithDuplicateKeyChecking().Build().Deserialize<Doc>(yaml ?? "") ?? new Doc();
foreach (var row in doc.Clips.Concat(doc.Outcomes))
if (AltHebrewProblem(row.AltHe, row.AltHeReview, row.AltHeReviewPresent) is string problem)
throw new InvalidOperationException($"{Path}: {row.Event}: {problem}");
return doc;
}
catch (YamlDotNet.Core.YamlException e) { throw new InvalidOperationException($"{Path}: {e.Message}", e); }
}
/// <summary>The shipped mapping, or no rows when it is missing.</summary>
public static IReadOnlyList<Row> Load()
{
var asset = Resources.Load<TextAsset>(ResourcePath);
return asset == null ? Array.Empty<Row>() : Parse(asset.text);
}
/// <summary>The shipped outcome clips, or none when the mapping is missing.</summary>
public static IReadOnlyList<Row> LoadOutcomes() => LoadBoth().outcomes;
/// <summary>The shipped card loops and outcome clips from one read of the mapping (none when it is missing).</summary>
public static (IReadOnlyList<Row> clips, IReadOnlyList<Row> outcomes) LoadBoth()
{
var asset = Resources.Load<TextAsset>(ResourcePath);
if (asset == null) return (Array.Empty<Row>(), Array.Empty<Row>());
var doc = ParseDoc(asset.text);
return (doc.Clips, doc.Outcomes);
}
/// <summary>Every problem with the outcome rows: an unknown event or option, a repeated event, an option that is not
/// the event's historical one (counterfactual orders get no clip), any deport option or event with one (Deport never
/// gets any video), a file that is not <event>-outcome.mp4 or is missing, a window that is not 3 to 4 s at 24
/// fps, and the same labelling, source and sensitivity rules as the card loops.</summary>
public static List<string> OutcomeProblems(IReadOnlyList<Row> rows, Content content, Func<string, bool> fileExists)
{
var problems = new List<string>();
var events = content.Events.ToDictionary(e => e.Id);
var sensitiveEvents = new HashSet<string>(ReleaseGate.SensitiveEvents(content));
foreach (var g in rows.GroupBy(r => r.Event).Where(g => g.Count() > 1)) problems.Add($"{g.Key}: more than one outcome");
foreach (var r in rows)
{
if (!events.TryGetValue(r.Event, out var ev)) { problems.Add($"{r.Event}: no such event"); continue; }
if (r.Option.IndexOf("deport", StringComparison.OrdinalIgnoreCase) >= 0 || ev.Options.Any(o => o.Id.IndexOf("deport", StringComparison.OrdinalIgnoreCase) >= 0))
problems.Add($"{r.Event}: Deport never gets any video");
var option = ev.Options.FirstOrDefault(o => o.Id == r.Option);
if (option == null) problems.Add($"{r.Event}: no option '{r.Option}'");
else if (!option.Historical) problems.Add($"{r.Event}: '{r.Option}' is not the historical option; counterfactual orders get no clip");
if (r.File != r.Event + "-outcome.mp4") problems.Add($"{r.Event}: file must be {r.Event}-outcome.mp4 (got '{r.File}')");
else if (!fileExists(r.File)) problems.Add($"{r.Event}: {ClipFolder}/{r.File} missing (run tools/encode_event_videos.py)");
if (r.Frames < 72 || r.Frames > 96) problems.Add($"{r.Event}: {r.Frames} frames is not 3 to 4 s at 24 fps");
if (!r.AiGenerated) problems.Add($"{r.Event}: ai_generated must be true");
if (!r.Source.StartsWith("promo/", StringComparison.Ordinal) || r.SourceSha256.Length != 64) problems.Add($"{r.Event}: source and its sha256 needed");
if (r.Generator.Trim() == "" || r.Generated.Trim() == "") problems.Add($"{r.Event}: generator or date missing");
if (!r.Alt.StartsWith("Illustration: ", StringComparison.Ordinal) || r.Alt.Length < 30) problems.Add($"{r.Event}: alt text must start 'Illustration: ' and say what it shows");
if (AltHebrewProblem(r.AltHe, r.AltHeReview, r.AltHeReviewPresent) is string altProblem) problems.Add($"{r.Event}: {altProblem}");
if (sensitiveEvents.Contains(ev.Id) && !r.Sensitive) problems.Add($"{r.Event}: the event has a sensitive tag, so its clip must be sensitive: true");
if (r.SensitivityReviewed && !r.Sensitive) problems.Add($"{r.Event}: sensitivity_reviewed without sensitive");
}
return problems;
}
/// <summary>Every problem with the rows (empty when the mapping is sound): an unknown or repeated event; an event
/// with a deport option (Deport never gets any video: GDD owner ruling 1, CONTENT_POLICY section 4); an event with no
/// archival photograph (a clip is never the only picture of a real event); a file that is not <event>.mp4 or is
/// missing; a row not marked ai_generated, or without its source, SHA-256, generator, date or alt text; and an event
/// with a sensitive tag whose clip is not marked sensitive.</summary>
public static List<string> Problems(IReadOnlyList<Row> rows, Content content, Func<string, bool> hasPhoto, Func<string, bool> fileExists)
{
var problems = new List<string>();
var events = content.Events.ToDictionary(e => e.Id);
var sensitiveEvents = new HashSet<string>(ReleaseGate.SensitiveEvents(content));
foreach (var g in rows.GroupBy(r => r.Event).Where(g => g.Count() > 1)) problems.Add($"{g.Key}: more than one row");
foreach (var r in rows)
{
if (!events.TryGetValue(r.Event, out var ev)) { problems.Add($"{r.Event}: no such event"); continue; }
if (ev.Options.Any(o => o.Id.IndexOf("deport", StringComparison.OrdinalIgnoreCase) >= 0))
problems.Add($"{r.Event}: has a deport option; Deport never gets any video");
if (!hasPhoto(r.Event)) problems.Add($"{r.Event}: has no archival photograph; a clip is never the only picture of an event");
if (r.File != r.Event + ".mp4") problems.Add($"{r.Event}: file must be {r.Event}.mp4 (got '{r.File}')");
else if (!fileExists(r.File)) problems.Add($"{r.Event}: {ClipFolder}/{r.File} missing (run tools/encode_event_videos.py)");
if (!r.AiGenerated) problems.Add($"{r.Event}: ai_generated must be true");
if (!r.Source.StartsWith("promo/", StringComparison.Ordinal)) problems.Add($"{r.Event}: source must be a promo shot");
if (r.SourceSha256.Length != 64) problems.Add($"{r.Event}: source_sha256 missing");
if (r.Generator.Trim() == "" || r.Generated.Trim() == "") problems.Add($"{r.Event}: generator or date missing");
if (!r.Alt.StartsWith("Illustration: ", StringComparison.Ordinal) || r.Alt.Length < 30) problems.Add($"{r.Event}: alt text must start 'Illustration: ' and say what it shows");
if (AltHebrewProblem(r.AltHe, r.AltHeReview, r.AltHeReviewPresent) is string altProblem) problems.Add($"{r.Event}: {altProblem}");
if (sensitiveEvents.Contains(ev.Id) && !r.Sensitive) problems.Add($"{r.Event}: the event has a sensitive tag, so its clip must be sensitive: true");
if (r.SensitivityReviewed && !r.Sensitive) problems.Add($"{r.Event}: sensitivity_reviewed without sensitive");
}
return problems;
}
static string? AltHebrewProblem(string? altHe, string? review, bool reviewPresent)
{
if (reviewPresent && string.IsNullOrWhiteSpace(altHe)) return "alt_he_review requires alt_he";
if (reviewPresent && review != "agent-checked") return "alt_he_review must be agent-checked";
return null;
}
/// <summary>The events whose clip is sensitive and not yet sensitivity-reviewed, in id order.</summary>
public static IReadOnlyList<string> SensitiveUnreviewed(IReadOnlyList<Row> rows) =>
rows.Where(r => r.Sensitive && !r.SensitivityReviewed).Select(r => r.Event).Distinct().OrderBy(x => x, StringComparer.Ordinal).ToList();
}
}