feat(run,check): add --local-cache for script mode and unify cache behavior

Author: GaspardKirira

include/vix/cli/commands/check/CheckDetail.hpp

@@ -78,6 +78,9 @@ namespace vix::commands::CheckCommand::detail
     /// Absolute path of the .cpp file to validate.
     fs::path cppFile;
 
+    /// Use local .vix-scripts instead of global ~/.vix/cache/scripts.
+    bool localCache = false;
+
     /// Enable AddressSanitizer + UBSan.
     bool enableSanitizers = false;
 

include/vix/cli/commands/run/RunDetail.hpp

@@ -130,6 +130,8 @@ namespace vix::commands::RunCommand::detail
 
     bool warnedVixFlagAfterDoubleDash = false;
     std::string warnedArg;
+
+    bool localCache = false;
   };
 
   /**
@@ -353,7 +355,7 @@ namespace vix::commands::RunCommand::detail
   /**
    * @brief Return the root directory used for generated script projects.
    */
-  fs::path get_scripts_root();
+  fs::path get_scripts_root(bool localCache);
 
   /**
    * @brief Detect whether a .cpp script uses the Vix runtime.

src/commands/RunCommand.cpp

@@ -1296,6 +1296,7 @@ namespace vix::commands::RunCommand
     out << "  --ubsan                       Enable UBSan only\n";
     out << "  --with-sqlite                 Enable SQLite support for script mode\n";
     out << "  --with-mysql                  Enable MySQL support for script mode\n\n";
+    out << "  --local-cache                 Use local .vix-scripts instead of global cache\n";
 
     out << "Documentation:\n";
     out << "  --docs                        Enable auto docs (sets VIX_DOCS=1)\n";

src/commands/check/CheckScript.cpp

@@ -182,7 +182,7 @@ namespace vix::commands::CheckCommand::detail
     const bool enableUbsanOnly = opt.enableUbsanOnly;
     const std::string exeName = script.stem().string();
 
-    fs::path scriptsRoot = run::get_scripts_root();
+    fs::path scriptsRoot = run::get_scripts_root(opt.localCache);
     std::error_code ec;
     fs::create_directories(scriptsRoot, ec);
     if (ec)

src/commands/run/RunFlow.cpp

@@ -439,6 +439,10 @@ namespace vix::commands::RunCommand::detail
       {
         opt.verbose = true;
       }
+      else if (a == "--local-cache")
+      {
+        opt.localCache = true;
+      }
       else if (a == "--log-level" || a == "--loglevel")
       {
         opt.logLevel = take_value(args, i, a, opt);

src/commands/run/RunScript.cpp

@@ -421,13 +421,47 @@ namespace vix::commands::RunCommand::detail
       hint("If you meant a runtime arg, use `--run` (or repeatable --args).");
     }
 
+    unsigned long long fnv1a_64(const std::string &input)
+    {
+      constexpr unsigned long long offset = 14695981039346656037ULL;
+      constexpr unsigned long long prime = 1099511628211ULL;
+
+      unsigned long long hash = offset;
+      for (char c : input)
+      {
+        const unsigned char uc = static_cast<unsigned char>(c);
+        hash ^= static_cast<unsigned long long>(uc);
+        hash *= prime;
+      }
+
+      return hash;
+    }
+
+    std::string hex_u64(unsigned long long value)
+    {
+      static constexpr char digits[] = "0123456789abcdef";
+      std::string out(16, '0');
+
+      for (int i = 15; i >= 0; --i)
+      {
+        out[static_cast<std::size_t>(i)] = digits[value & 0xF];
+        value >>= 4ULL;
+      }
+
+      return out;
+    }
+
     ScriptProjectState prepare_script_project_state(Options &opt)
     {
       ScriptProjectState state;
-      state.script = opt.cppFile;
+      state.script = fs::absolute(opt.cppFile).lexically_normal();
       state.exeName = state.script.stem().string();
-      state.scriptsRoot = get_scripts_root();
-      state.projectDir = state.scriptsRoot / state.exeName;
+      state.scriptsRoot = get_scripts_root(opt.localCache);
+
+      const std::string scriptCacheKey = hex_u64(
+          fnv1a_64("script-cache:" + state.script.string()));
+
+      state.projectDir = state.scriptsRoot / scriptCacheKey;
       state.cmakeLists = state.projectDir / "CMakeLists.txt";
       state.buildDir = state.projectDir / "build-ninja";
       state.sigFile = state.projectDir / ".vix-config.sig";
@@ -874,6 +908,14 @@ namespace vix::commands::RunCommand::detail
     if (prepCode != 0)
       return prepCode;
 
+    if (o.clean)
+    {
+      std::error_code ec;
+      fs::remove_all(state.buildDir, ec);
+      fs::remove(state.sigFile, ec);
+      state.needConfigure = true;
+    }
+
     const int code = configure_and_build_script(o, state);
     if (code != 0)
       return code;

src/commands/run/detail/ScriptCMake.cpp

@@ -1290,9 +1290,15 @@ namespace vix::commands::RunCommand::detail
     return false;
   }
 
-  fs::path get_scripts_root()
+  fs::path get_scripts_root(bool localCache)
   {
-    return fs::current_path() / ".vix-scripts";
+    if (localCache)
+      return fs::current_path() / ".vix-scripts";
+
+    if (const auto home = home_dir(); home)
+      return fs::path(*home) / ".vix" / "cache" / "scripts";
+
+    return fs::temp_directory_path() / "vix" / "cache" / "scripts";
   }
 
   std::string make_script_cmakelists(