Initial commit: Theriapolis baseline at port/godot branch point

Captures the pre-Godot-port state of the codebase. This is the rollback anchor for the Godot port (M0 of theriapolis-rpg-implementation-plan-godot-port.md). All Phase 0 through Phase 6.5 work is included; Phase 7 is in flight. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-30 20:40:51 -07:00
commit b451f83174
525 changed files with 75786 additions and 0 deletions
@@ -0,0 +1,82 @@
+using Theriapolis.Core.Data;
+
+namespace Theriapolis.Tools.Commands;
+
+/// <summary>
+/// Phase 6 M3 — dialogue-validate. Loads every <c>dialogues/*.json</c>
+/// through <see cref="ContentLoader.LoadDialogues"/> (which already
+/// validates structure + references) and prints a per-tree summary.
+/// CI gate: exits non-zero on any validation error.
+///
+/// Usage:
+///   dotnet run --project Theriapolis.Tools -- dialogue-validate
+///   dotnet run --project Theriapolis.Tools -- dialogue-validate --data-dir ./Content/Data
+/// </summary>
+public static class DialogueValidate
+{
+    public static int Run(string[] args)
+    {
+        string dataDir = "./Content/Data";
+        for (int i = 0; i < args.Length; i++)
+        {
+            if (args[i] == "--data-dir" && i + 1 < args.Length)
+            {
+                dataDir = args[i + 1];
+                i++;
+            }
+        }
+
+        Console.WriteLine($"Validating dialogues in: {dataDir}");
+        var loader = new ContentLoader(dataDir);
+        DialogueDef[] defs;
+        try
+        {
+            // Load items for cross-reference (give_item / has_item).
+            var items = loader.LoadItems();
+            defs = loader.LoadDialogues(items);
+        }
+        catch (Exception ex)
+        {
+            Console.Error.WriteLine($"  ✗ {ex.Message}");
+            return 1;
+        }
+
+        Console.WriteLine($"  ✓ {defs.Length} dialogue tree(s) loaded.");
+        foreach (var d in defs.OrderBy(d => d.Id, StringComparer.Ordinal))
+        {
+            int totalOptions = d.Nodes.Sum(n => n.Options.Length);
+            int skillChecks  = d.Nodes.Sum(n => n.Options.Count(o => o.SkillCheck is not null));
+            Console.WriteLine($"    [{d.Id}]  root='{d.Root}'  nodes={d.Nodes.Length}  options={totalOptions}  skill_checks={skillChecks}");
+
+            // Reachability: BFS from root over options.next + next_on_*.
+            var reachable = new HashSet<string>(StringComparer.OrdinalIgnoreCase) { d.Root };
+            var queue = new Queue<string>();
+            queue.Enqueue(d.Root);
+            var nodesById = d.Nodes.ToDictionary(n => n.Id, StringComparer.OrdinalIgnoreCase);
+            while (queue.Count > 0)
+            {
+                var cur = queue.Dequeue();
+                if (!nodesById.TryGetValue(cur, out var node)) continue;
+                foreach (var opt in node.Options)
+                {
+                    foreach (var n in new[] { opt.Next, opt.NextOnSuccess, opt.NextOnFailure })
+                    {
+                        if (string.IsNullOrEmpty(n) || string.Equals(n, "<end>", StringComparison.OrdinalIgnoreCase)) continue;
+                        if (reachable.Add(n)) queue.Enqueue(n);
+                    }
+                }
+            }
+            int unreachable = d.Nodes.Length - reachable.Count;
+            if (unreachable > 0)
+            {
+                Console.Error.WriteLine($"    ✗ {unreachable} unreachable node(s) in '{d.Id}': "
+                    + string.Join(", ", d.Nodes.Where(n => !reachable.Contains(n.Id)).Select(n => n.Id)));
+                return 1;
+            }
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("All dialogue trees valid.");
+        return 0;
+    }
+}