repl: forward CLI args to REPL and expose them via Vix.args()

Author: GaspardKirira

include/vix/cli/commands/repl/ReplFlow.hpp

@@ -15,7 +15,7 @@
 
 namespace vix::commands::ReplCommand
 {
-  int repl_flow_run();
+  int repl_flow_run(const std::vector<std::string> &replArgs);
 }
 
 #endif

src/commands/ReplCommand.cpp

@@ -20,20 +20,28 @@ namespace vix::commands::ReplCommand
 {
   int run(const std::vector<std::string> &args)
   {
-    (void)args;
-    return repl_flow_run();
+    std::vector<std::string> replArgs = args;
+    if (!replArgs.empty() && replArgs[0] == "--")
+      replArgs.erase(replArgs.begin());
+
+    return repl_flow_run(replArgs);
   }
 
   int help()
   {
     std::cout
         << "Usage:\n"
-        << "  vix repl\n\n"
+        << "  vix repl [-- <args...>]\n\n"
         << "Description:\n"
-        << "  Start an interactive Vix REPL (CLI shell + calculator).\n\n"
+        << "  Start an interactive Vix REPL (shell + calculator).\n"
+        << "  Args after `--` are available via Vix.args().\n\n"
         << "Examples:\n"
         << "  vix repl\n"
-        << "  vix repl   # then: = 1+2*3\n";
+        << "  vix repl -- --port 8080 --mode dev\n"
+        << "  # inside REPL:\n"
+        << "  #   Vix.args()\n"
+        << "  #   x = 1+2*3\n";
     return 0;
   }
+
 }

src/commands/repl/ReplFlow.cpp

@@ -446,10 +446,19 @@ namespace
 
     if (m == "args")
     {
-      // print JSON array
+      // args() takes no parameters in REPL (getter only)
+      if (!call.args.empty())
+      {
+        vix::cli::repl::api::println(
+            "error: Vix.args() takes no arguments.\n"
+            "hint: use Vix.args() to read CLI args.");
+        return true;
+      }
+
       nlohmann::json j = nlohmann::json::array();
       for (const auto &a : VixObj.args())
         j.push_back(a);
+
       vix::cli::repl::api::println(j.dump());
       return true;
     }
@@ -639,7 +648,7 @@ namespace
 
 namespace vix::commands::ReplCommand
 {
-  int repl_flow_run()
+  int repl_flow_run(const std::vector<std::string> &replArgs)
   {
     using vix::cli::repl::History;
     using vix::cli::repl::ReplConfig;
@@ -654,7 +663,7 @@ namespace vix::commands::ReplCommand
     vix::cli::repl::api::Vix VixObj(&history);
     std::unordered_map<std::string, nlohmann::json> vars;
 
-    VixObj.set_args({});
+    VixObj.set_args(replArgs);
 
     if (cfg.enableFileHistory)
     {