Implement --exec flag and PyAutoGUI-compatible automation API

- Add --exec flag to execute multiple scripts before main program
- Scripts are executed in order and share Python interpreter state
- Implement full PyAutoGUI-compatible automation API in McRFPy_Automation
- Add screenshot, mouse control, keyboard input capabilities
- Fix Python initialization issues when multiple scripts are loaded
- Update CommandLineParser to handle --exec with proper sys.argv management
- Add comprehensive examples and documentation

This enables automation testing by allowing test scripts to run alongside
games using the same Python environment. The automation API provides
event injection into the SFML render loop for UI testing.

Closes #32 partially (Python interpreter emulation)
References automation testing requirements

src/CommandLineParser.cpp

@@ -108,6 +108,20 @@ CommandLineParser::ParseResult CommandLineParser::parse(McRogueFaceConfig& confi
             continue;
         }
         
+        if (arg == "--exec") {
+            current_arg++;
+            if (current_arg >= argc) {
+                std::cerr << "Argument expected for the --exec option" << std::endl;
+                result.should_exit = true;
+                result.exit_code = 1;
+                return result;
+            }
+            config.exec_scripts.push_back(argv[current_arg]);
+            config.python_mode = true;
+            current_arg++;
+            continue;
+        }
+        
         // If no flags matched, treat as positional argument (script name)
         if (arg[0] != '-') {
             config.script_path = arg;
@@ -141,6 +155,7 @@ void CommandLineParser::print_help() {
               << "  -V     : print the Python version number and exit (also --version)\n"
               << "\n"
               << "McRogueFace specific options:\n"
+              << "  --exec file  : execute script before main program (can be used multiple times)\n"
               << "  --headless   : run without creating a window (implies --audio-off)\n"
               << "  --audio-off  : disable audio\n"
               << "  --audio-on   : enable audio (even in headless mode)\n"