Add AI-driven game validation and graphics diagnostics

.gitignore

@@ -46,3 +46,11 @@ CMakeSettings.json
 *.patch
 .claude/
 images/
+/Source/Resources/Automation/Artifacts/
+/Source/Resources/Automation/Reports/
+
+# Local validation findings
+/ISSUES.md
+
+# Local agent guidance
+/AGENTS.md

Source/Game-App/Game-App.lua

@@ -9,6 +9,7 @@ Solution.Util.CreateConsoleApp(mod.Name, Solution.Projects.Current.BinDir, mod.D
     local projFile = mod.Path .. "/" .. mod.Name .. ".lua"
     local files = Solution.Util.GetFilesForCpp(mod.Path)
     table.insert(files, projFile)
+    table.insert(files, mod.Path .. "/Game-App/Resources/renderdoc.json")
 
     Solution.Util.SetFiles(files)
     Solution.Util.SetIncludes(mod.Path)
@@ -22,9 +23,14 @@ Solution.Util.CreateConsoleApp(mod.Name, Solution.Projects.Current.BinDir, mod.D
         }
         Solution.Util.SetFiles(appIconFiles)
 
+        postbuildcommands
+        {
+            '{COPYFILE} "' .. mod.Path .. '/Game-App/Resources/renderdoc.json" "%{cfg.targetdir}/renderdoc.json"'
+        }
+
         vpaths 
         {
-            ['Resources/*'] = { '*.rc', '**.ico' },
+            ['Resources/*'] = { '*.rc', '**.ico', '**.json' },
             ["/*"] = { "*.lua", mod.Name .. "/**" }
         }
     end)

Source/Game-App/Game-App/Resources/renderdoc.json

@@ -0,0 +1,42 @@
+{
+  "file_format_version": "1.1.2",
+  "layer": {
+    "name": "VK_LAYER_RENDERDOC_Capture",
+    "type": "GLOBAL",
+    "library_path": ".\\renderdoc.dll",
+    "api_version": "1.4.324",
+    "implementation_version": "45",
+    "description": "RenderDoc capture layer",
+    "functions": {
+      "vkGetInstanceProcAddr": "VK_LAYER_RENDERDOC_CaptureGetInstanceProcAddr",
+      "vkGetDeviceProcAddr": "VK_LAYER_RENDERDOC_CaptureGetDeviceProcAddr",
+      "vkNegotiateLoaderLayerInterfaceVersion": "VK_LAYER_RENDERDOC_CaptureNegotiateLoaderLayerInterfaceVersion"
+    },
+    "instance_extensions": [
+      {
+        "name": "VK_EXT_debug_utils",
+        "spec_version": "1"
+      }
+    ],
+    "device_extensions": [
+      {
+        "name": "VK_EXT_debug_marker",
+        "spec_version": "4",
+        "entrypoints": [
+          "vkDebugMarkerSetObjectTagEXT",
+          "vkDebugMarkerSetObjectNameEXT",
+          "vkCmdDebugMarkerBeginEXT",
+          "vkCmdDebugMarkerEndEXT",
+          "vkCmdDebugMarkerInsertEXT"
+        ]
+      },
+      {
+        "name": "VK_EXT_tooling_info",
+        "spec_version": "1",
+        "entrypoints": [
+          "vkGetPhysicalDeviceToolPropertiesEXT"
+        ]
+      }
+    ]
+  }
+}

Source/Game-App/Game-App/main.cpp

@@ -10,7 +10,9 @@
 #include <quill/Backend.h>
 
 #include <atomic>
+#include <cstdio>
 #include <iostream>
+#include <string_view>
 #include <thread>
 
 #if WIN32
@@ -22,40 +24,48 @@
 #include <unistd.h>
 #endif
 
-i32 main()
+i32 main(i32 argc, char* argv[])
 {
+    // MCPTools redirects the process streams to pipes. The C runtime otherwise
+    // block-buffers plain Luau print output, hiding automation progress until
+    // the buffer fills or the process exits.
+    std::setvbuf(stdout, nullptr, _IONBF, 0);
+    std::setvbuf(stderr, nullptr, _IONBF, 0);
+
 #if WIN32
     timeBeginPeriod(1);
 #endif
 
+    bool enableRenderDoc = false;
+    for (i32 argumentIndex = 1; argumentIndex < argc; argumentIndex++)
+    {
+        if (std::string_view(argv[argumentIndex]) == "-renderdoc")
+            enableRenderDoc = true;
+    }
+
     quill::Backend::start();
 
-    auto console_sink = quill::Frontend::create_or_get_sink<quill::ConsoleSink>("console_sink_1");
+    auto console_sink = quill::Frontend::create_or_get_sink<quill::ConsoleSink>("console_sink_1", false);
     quill::Logger* logger = quill::Frontend::create_or_get_logger("root", std::move(console_sink), "%(time:<16) LOG_%(log_level:<11) %(message)", "%H:%M:%S.%Qms", quill::Timezone::LocalTime, quill::ClockSourceType::System);
 
     Application app;
-    app.Start(true);
+    app.Start(true, enableRenderDoc);
 
     ConsoleCommandHandler commandHandler;
 #if WIN32
     moodycamel::ConcurrentQueue<std::string> consoleCommands;
     std::atomic_bool consoleInputRunning = true;
-    HANDLE consoleInput = GetStdHandle(STD_INPUT_HANDLE);
-    std::thread consoleInputThread;
-    if (consoleInput != nullptr && consoleInput != INVALID_HANDLE_VALUE)
+    std::thread consoleInputThread([&consoleCommands, &consoleInputRunning]()
     {
-        consoleInputThread = std::thread([&consoleCommands, &consoleInputRunning]()
+        while (consoleInputRunning)
         {
-            while (consoleInputRunning)
-            {
-                std::string command = StringUtils::GetLineFromCin();
-                if (!consoleInputRunning || std::cin.fail())
-                    break;
+            std::string command = StringUtils::GetLineFromCin();
+            if (!consoleInputRunning || std::cin.fail())
+                break;
 
-                consoleCommands.enqueue(std::move(command));
-            }
-        });
-    }
+            consoleCommands.enqueue(std::move(command));
+        }
+    });
 #else
     pollfd consoleInput =
     {

Source/Game-Lib/Game-Lib/Application/Application.cpp

@@ -34,11 +34,13 @@
 #include "Game-Lib/Scripting/Handlers/GameHandler.h"
 #include "Game-Lib/Scripting/Handlers/UnitHandler.h"
 #include "Game-Lib/Scripting/Handlers/TimeHandler.h"
+#include "Game-Lib/Scripting/Handlers/SchedulerHandler.h"
 #include "Game-Lib/Scripting/Handlers/CameraHandler.h"
 #include "Game-Lib/Scripting/Handlers/MapHandler.h"
 #include "Game-Lib/Scripting/Handlers/SceneHandler.h"
 #include "Game-Lib/Scripting/Handlers/EditorToolHandler.h"
 #include "Game-Lib/Scripting/Handlers/AssetHandler.h"
+#include "Game-Lib/Util/AutomationUtil.h"
 #include "Game-Lib/Util/AssetPath.h"
 #include "Game-Lib/Util/AssetWriter.h"
 #include "Game-Lib/Util/ClientDBUtil.h"
@@ -119,7 +121,9 @@ namespace
     }
 }
 
-Application::Application() : _messagesInbound(256), _messagesOutbound(256)
+Application::Application()
+    : _messagesInbound(256)
+    , _messagesOutbound(256)
 {
     ServiceLocator::SetApplication(this);
 }
@@ -136,7 +140,7 @@ Application::~Application()
     delete _assetWriter;
 }
 
-void Application::Start(bool startInSeparateThread)
+void Application::Start(bool startInSeparateThread, bool enableRenderDoc)
 {
     if (_isRunning)
         return;
@@ -145,12 +149,13 @@ void Application::Start(bool startInSeparateThread)
     {
         _isRunning = true;
 
-        std::thread applicationThread = std::thread(&Application::Run, this);
+        std::thread applicationThread =
+            std::thread(&Application::Run, this, enableRenderDoc);
         applicationThread.detach();
     }
     else
     {
-        _isRunning = Init();
+        _isRunning = Init(enableRenderDoc);
     }
 }
 
@@ -224,11 +229,11 @@ bool Application::TryGetMessageOutbound(MessageOutbound& message)
     return messageFound;
 }
 
-void Application::Run()
+void Application::Run(bool enableRenderDoc)
 {
     tracy::SetThreadName("Application Thread");
 
-    if (Init())
+    if (Init(enableRenderDoc))
     {
         Timer timer;
         Timer updateTimer;
@@ -325,7 +330,7 @@ void Application::Run()
     Stop();
 }
 
-bool Application::Init()
+bool Application::Init(bool enableRenderDoc)
 {
     _registries.gameRegistry = new entt::registry();
     _registries.uiRegistry = new entt::registry();
@@ -431,7 +436,7 @@ bool Application::Init()
     Util::Texture::DiscoverAll();
     Util::ClientDB::DiscoverAll();
 
-    _gameRenderer = new GameRenderer();
+    _gameRenderer = new GameRenderer(enableRenderDoc);
     _imguiInputBridge = new ImGuiInputBridge(*_inputSystem);
 
     NC_LOG_INFO("EditorHandler : Initializing");
@@ -461,6 +466,7 @@ bool Application::Init()
         _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Game, new Scripting::Game::GameHandler());
         _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Unit, new Scripting::Unit::UnitHandler());
         _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Time, new Scripting::Time::TimeHandler());
+        _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Scheduler, new Scripting::Scheduler::SchedulerHandler());
         _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Camera, new Scripting::Camera::CameraHandler());
         _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Map, new Scripting::Map::MapHandler());
         _luaManager->SetLuaHandler((Scripting::LuaHandlerID)MetaGen::Game::Lua::LuaHandlerTypeEnum::Scene, new Scripting::Scene::SceneHandler());
@@ -555,6 +561,12 @@ bool Application::Tick(f32 deltaTime)
                 break;
             }
 
+            case MessageInbound::Type::AutomationRun:
+            {
+                Util::Automation::ExecuteScript(*_luaManager, message.requestId, message.data);
+                break;
+            }
+
             case MessageInbound::Type::ReloadScripts:
             {
                 ServiceLocator::GetLuaManager()->SetDirty();

Source/Game-Lib/Game-Lib/Application/Application.h

@@ -43,7 +43,7 @@ class Application
     Application();
     ~Application();
 
-    void Start(bool startInSeparateThread);
+    void Start(bool startInSeparateThread, bool enableRenderDoc = false);
     void Stop();
     void RequestExit();
 
@@ -54,9 +54,9 @@ class Application
     bool Tick(f32 deltaTime);
 
 private:
-    void Run();
+    void Run(bool enableRenderDoc);
 
-    bool Init();
+    bool Init(bool enableRenderDoc);
     bool Render(f32 deltaTime, f32& timeSpentWaiting);
 
     void DatabaseReload();

Source/Game-Lib/Game-Lib/Application/ConsoleCommandHandler.cpp

@@ -10,6 +10,7 @@ ConsoleCommandHandler::ConsoleCommandHandler()
     RegisterCommand("ping"_h, &ConsoleCommands::CommandPing);
     RegisterCommand("lua"_h, &ConsoleCommands::CommandDoString);
     RegisterCommand("eval"_h, &ConsoleCommands::CommandDoString);
+    RegisterCommand("automation_run"_h, &ConsoleCommands::CommandAutomationRun);
     RegisterCommand("r"_h, &ConsoleCommands::CommandReloadScripts);
     RegisterCommand("reload"_h, &ConsoleCommands::CommandReloadScripts);
     RegisterCommand("reloadscripts"_h, &ConsoleCommands::CommandReloadScripts);

Source/Game-Lib/Game-Lib/Application/ConsoleCommands.cpp

@@ -3,6 +3,8 @@
 #include "Application.h"
 #include "Message.h"
 
+#include <Base/Util/DebugHandler.h>
+
 void ConsoleCommands::CommandPrint(Application& app, std::vector<std::string>& subCommands)
 {
     if (subCommands.size() == 0)
@@ -55,6 +57,18 @@ void ConsoleCommands::CommandDoString(Application& app, std::vector<std::string>
     app.PassMessage(message);
 }
 
+void ConsoleCommands::CommandAutomationRun(Application& app, std::vector<std::string>& subCommands)
+{
+    if (subCommands.size() != 2)
+    {
+        NC_LOG_ERROR("Usage: automation_run <request-id> Scripts/<path>.luau");
+        return;
+    }
+
+    MessageInbound message(MessageInbound::Type::AutomationRun, subCommands[1], subCommands[0]);
+    app.PassMessage(message);
+}
+
 void ConsoleCommands::CommandReloadScripts(Application& app, std::vector<std::string>& subCommands)
 {
     MessageInbound message(MessageInbound::Type::ReloadScripts);

Source/Game-Lib/Game-Lib/Application/ConsoleCommands.h

@@ -10,6 +10,7 @@ class ConsoleCommands
     static void CommandPing(Application& app, std::vector<std::string>& subCommands);
     static void CommandExit(Application& app, std::vector<std::string>& subCommands);
     static void CommandDoString(Application& app, std::vector<std::string>& subCommands);
+    static void CommandAutomationRun(Application& app, std::vector<std::string>& subCommands);
     static void CommandReloadScripts(Application& app, std::vector<std::string>& subCommands);
     static void CommandRefreshDB(Application& app, std::vector<std::string>& subCommands);
-};
+};

Source/Game-Lib/Game-Lib/Application/Message.h

@@ -1,6 +1,9 @@
 #pragma once
 #include <Base/Types.h>
 
+#include <string>
+#include <utility>
+
 struct MessageInbound
 {
 public:
@@ -10,17 +13,20 @@ struct MessageInbound
         Print,
         Ping,
         DoString,
+        AutomationRun,
         ReloadScripts,
         RefreshDB,
         Exit
     };
 
 public:
     MessageInbound() { }
-    MessageInbound(Type inType, std::string inData = "") : type(inType), data(inData) { }
+    MessageInbound(Type inType, std::string inData = "", std::string inRequestId = "")
+        : type(inType), data(std::move(inData)), requestId(std::move(inRequestId)) { }
 
     Type type = Type::Invalid;
     std::string data = "";
+    std::string requestId = "";
 };
 
 struct MessageOutbound
@@ -40,4 +46,4 @@ struct MessageOutbound
 
     Type type = Type::Invalid;
     std::string data = "";
-};
+};

Source/Game-Lib/Game-Lib/ECS/Components/Events.h

@@ -12,6 +12,23 @@ namespace ECS::Components
         u32 mapId;
     };
 
+    enum class MapLoadFailureReason : u8
+    {
+        MissingDatabaseRecord,
+        MissingHeader,
+        InvalidHeader,
+        MissingBaseModel,
+        NoChunks,
+        NoAvailableChunks,
+    };
+
+    struct MapLoadFailedEvent
+    {
+    public:
+        u32 mapId;
+        MapLoadFailureReason reason;
+    };
+
     struct ModelLoadedEventFlags
     {
     public:
@@ -24,4 +41,4 @@ namespace ECS::Components
     public:
         ModelLoadedEventFlags flags = { 0 };
     };
-}
+}