refactor(cli): prepare dev mode build flow

Author: GaspardKirira

include/vix/cli/build/BuildContext.hpp

@@ -0,0 +1,48 @@
+/**
+ *
+ *  @file BuildContext.hpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2026, Gaspard Kirira. All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ *  Shared build context helpers
+ *
+ */
+
+#ifndef VIX_CLI_BUILD_BUILD_CONTEXT_HPP
+#define VIX_CLI_BUILD_BUILD_CONTEXT_HPP
+
+#include <filesystem>
+#include <optional>
+#include <string>
+
+#include <vix/cli/process/Process.hpp>
+
+namespace vix::cli::build
+{
+  namespace fs = std::filesystem;
+  namespace process = vix::cli::process;
+
+  std::optional<process::Preset> resolve_builtin_preset(
+      const std::string &name);
+
+  std::string default_build_target_name(
+      const process::Options &opt,
+      const process::Plan &plan);
+
+  std::string default_graph_target_name(
+      const process::Options &opt,
+      const process::Plan &plan);
+
+  fs::path default_project_executable_path(
+      const process::Options &opt,
+      const process::Plan &plan);
+
+} // namespace vix::cli::build
+
+#endif

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

@@ -164,6 +164,7 @@ namespace vix::commands::RunCommand::detail
     std::string warnedArg;
 
     bool localCache = false;
+    bool devMode{false};
   };
 
   /**

src/build/BuildContext.cpp

@@ -0,0 +1,90 @@
+/**
+ *
+ *  @file BuildContext.cpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2026, Gaspard Kirira. All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ *  Shared build context helpers
+ *
+ */
+
+#include <vix/cli/build/BuildContext.hpp>
+
+#include <map>
+
+namespace vix::cli::build
+{
+  namespace
+  {
+    static std::map<std::string, process::Preset> builtin_presets()
+    {
+      std::map<std::string, process::Preset> presets;
+
+      presets.emplace(
+          "dev",
+          process::Preset{"dev", "Ninja", "Debug", "build-dev"});
+
+      presets.emplace(
+          "dev-ninja",
+          process::Preset{"dev-ninja", "Ninja", "Debug", "build-ninja"});
+
+      presets.emplace(
+          "release",
+          process::Preset{"release", "Ninja", "Release", "build-release"});
+
+      return presets;
+    }
+  } // namespace
+
+  std::optional<process::Preset> resolve_builtin_preset(
+      const std::string &name)
+  {
+    const auto presets = builtin_presets();
+    const auto it = presets.find(name);
+
+    if (it == presets.end())
+      return std::nullopt;
+
+    return it->second;
+  }
+
+  std::string default_build_target_name(
+      const process::Options &opt,
+      const process::Plan &plan)
+  {
+    if (!opt.buildTarget.empty())
+      return opt.buildTarget;
+
+    return plan.projectDir.filename().string();
+  }
+
+  std::string default_graph_target_name(
+      const process::Options &opt,
+      const process::Plan &plan)
+  {
+    if (!opt.buildTarget.empty())
+      return opt.buildTarget;
+
+    return plan.projectDir.filename().string();
+  }
+
+  fs::path default_project_executable_path(
+      const process::Options &opt,
+      const process::Plan &plan)
+  {
+    const std::string target = default_build_target_name(opt, plan);
+
+#ifdef _WIN32
+    return plan.buildDir / (target + ".exe");
+#else
+    return plan.buildDir / target;
+#endif
+  }
+
+} // namespace vix::cli::build

src/cmake/CMakeBuild.cpp

@@ -571,7 +571,7 @@ namespace vix::cli::build
         return false;
 
       if (filterCMakeSummary)
-        return !is_cmake_configure_summary_line(line);
+        return false;
 
       if (!progressOnly)
         return true;

src/commands/BuildCommand.cpp

@@ -20,6 +20,7 @@
 #include <vix/cli/build/ObjectCache.hpp>
 #include <vix/cli/build/BuildGraphExecutor.hpp>
 #include <vix/cli/build/BuildStyle.hpp>
+#include <vix/cli/build/BuildContext.hpp>
 
 #include <algorithm>
 #include <cctype>
@@ -95,17 +96,6 @@ namespace vix::commands::BuildCommand
       }
     };
 
-    static std::map<std::string, process::Preset> builtin_presets()
-    {
-      std::map<std::string, process::Preset> m;
-
-      m.emplace("dev", process::Preset{"dev", "Ninja", "Debug", "build-dev"});
-      m.emplace("dev-ninja", process::Preset{"dev-ninja", "Ninja", "Debug", "build-ninja"});
-      m.emplace("release", process::Preset{"release", "Ninja", "Release", "build-release"});
-
-      return m;
-    }
-
     static bool write_if_different(const fs::path &path, const std::string &content)
     {
       if (util::file_exists(path))
@@ -118,26 +108,6 @@ namespace vix::commands::BuildCommand
       return util::write_text_file_atomic(path, content);
     }
 
-    static std::string graph_build_target_name(
-        const process::Options &opt,
-        const process::Plan &plan)
-    {
-      if (!opt.buildTarget.empty())
-        return opt.buildTarget;
-
-      return plan.projectDir.filename().string();
-    }
-
-    static std::string cmake_build_target_name(
-        const process::Options &opt,
-        const process::Plan &plan)
-    {
-      if (!opt.buildTarget.empty())
-        return opt.buildTarget;
-
-      return plan.projectDir.filename().string();
-    }
-
     static bool graph_executor_enabled()
     {
       const char *value = std::getenv("VIX_GRAPH_EXECUTOR");
@@ -191,15 +161,6 @@ namespace vix::commands::BuildCommand
       return true;
     }
 
-    static std::optional<process::Preset> resolve_preset(const std::string &name)
-    {
-      const auto presets = builtin_presets();
-      const auto it = presets.find(name);
-      if (it == presets.end())
-        return std::nullopt;
-      return it->second;
-    }
-
     static std::size_t count_built_targets_from_log(const std::string &log)
     {
       std::size_t count = 0;
@@ -927,7 +888,7 @@ namespace vix::commands::BuildCommand
         return std::nullopt;
       }
 
-      const auto presetOpt = resolve_preset(opt.preset);
+      const auto presetOpt = build::resolve_builtin_preset(opt.preset);
       if (!presetOpt)
         return std::nullopt;
 
@@ -1848,7 +1809,7 @@ namespace vix::commands::BuildCommand
         {
           build::BuildGraphExecutorOptions executorOptions;
           executorOptions.buildDir = plan_.buildDir;
-          executorOptions.target = graph_build_target_name(opt_, plan_);
+          executorOptions.target = build::default_graph_target_name(opt_, plan_);
           executorOptions.jobs = opt_.jobs;
           executorOptions.quiet = opt_.quiet;
           executorOptions.verbose = verboseMode;
@@ -2088,7 +2049,7 @@ namespace vix::commands::BuildCommand
 
               build::print_build_header_full(
                   std::cout,
-                  cmake_build_target_name(opt_, plan_),
+                  build::default_build_target_name(opt_, plan_),
                   display_build_profile(plan_),
                   plan_.launcher,
                   plan_.fastLinkerFlag,
@@ -2098,7 +2059,7 @@ namespace vix::commands::BuildCommand
             {
               build::print_build_header_full(
                   std::cout,
-                  cmake_build_target_name(opt_, plan_),
+                  build::default_build_target_name(opt_, plan_),
                   display_build_profile(plan_),
                   std::nullopt,
                   std::nullopt,
@@ -2280,7 +2241,7 @@ namespace vix::commands::BuildCommand
     if (parseExit != 0)
       return parseExit;
 
-    if (!resolve_preset(opt.preset))
+    if (!build::resolve_builtin_preset(opt.preset))
     {
       error("Unknown preset: " + opt.preset);
       hint("Available presets: dev, dev-ninja, release");

src/commands/DevCommand.cpp

@@ -19,6 +19,7 @@
 #include <algorithm>
 #include <string>
 #include <vector>
+#include <iostream>
 
 #include <cstdlib>
 #ifdef _WIN32
@@ -46,12 +47,20 @@ namespace vix::commands::DevCommand
   int run(const std::vector<std::string> &args)
   {
     std::vector<std::string> forwarded;
-    forwarded.reserve(args.size() + 1);
+    forwarded.reserve(args.size() + 2);
+
     forwarded.insert(forwarded.end(), args.begin(), args.end());
 
     if (!has_watch_flag(forwarded))
       forwarded.emplace_back("--watch");
-    vix::cli::util::info_line(std::cout, "Dev mode active");
+
+    forwarded.emplace_back("--dev-mode");
+
+    std::cerr << "[vix:dev] forwarding to run:";
+    for (const auto &arg : forwarded)
+      std::cerr << " " << arg;
+    std::cerr << "\n";
+
     return vix::commands::RunCommand::run(forwarded);
   }
 

src/commands/RunCommand.cpp

@@ -1595,6 +1595,23 @@ namespace vix::commands::RunCommand
                                       ? fs::current_path()
                                       : target.path;
 
+      warn_if_env_file_missing(projectDir);
+
+      if (opt.watch)
+      {
+#ifndef _WIN32
+        std::cerr << "[vix:dev] entering project watch from resolved target:"
+                  << " watch=" << (opt.watch ? "1" : "0")
+                  << " devMode=" << (opt.devMode ? "1" : "0")
+                  << " projectDir=" << projectDir.string()
+                  << "\n";
+
+        return run_project_watch(opt, projectDir);
+#else
+        hint("Project watch mode is not yet implemented on Windows; running once without auto-reload.");
+#endif
+      }
+
       if (has_presets(projectDir))
         return run_project_with_presets(projectDir, opt, ui_enabled());
 
@@ -1624,6 +1641,13 @@ namespace vix::commands::RunCommand
 
     warn_if_env_file_missing(projectDir);
 
+    std::cerr << "[vix:dev] before project watch check:"
+              << " watch=" << (opt.watch ? "1" : "0")
+              << " devMode=" << (opt.devMode ? "1" : "0")
+              << " singleCpp=" << (opt.singleCpp ? "1" : "0")
+              << " projectDir=" << projectDir.string()
+              << "\n";
+
     if (!opt.singleCpp && opt.watch)
     {
 #ifndef _WIN32

src/commands/run/RunFlow.cpp

@@ -98,6 +98,7 @@ namespace vix::commands::RunCommand::detail
     {
       return v == "--verbose" || v == "--quiet" || v == "-q" ||
              v == "--watch" || v == "--reload" ||
+             v == "--dev-mode" ||
              v == "--force-server" || v == "--force-script" ||
              v == "--san" || v == "--ubsan" || v == "--tsan" ||
              v == "--docs" || v == "--no-docs" || v.rfind("--docs=", 0) == 0 ||
@@ -444,6 +445,10 @@ namespace vix::commands::RunCommand::detail
       {
         opt.localCache = true;
       }
+      else if (a == "--dev-mode")
+      {
+        opt.devMode = true;
+      }
       else if (a == "--log-level" || a == "--loglevel")
       {
         opt.logLevel = take_value(args, i, a, opt);