feat(cli): add production deploy workflow

Author: GaspardKirira

include/vix/cli/commands/DeployCommand.hpp

@@ -0,0 +1,51 @@
+/**
+ *
+ *  @file DeployCommand.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
+ */
+#ifndef VIX_DEPLOY_COMMAND_HPP
+#define VIX_DEPLOY_COMMAND_HPP
+
+#include <string>
+#include <vector>
+
+namespace vix::commands
+{
+  /**
+   * @brief Command entry point for production deployment.
+   */
+  struct DeployCommand
+  {
+    /**
+     * @brief Run the deploy command.
+     *
+     * Supported forms:
+     *
+     * `vix deploy`
+     * `vix deploy --dry-run`
+     * `vix deploy --verbose`
+     * `vix deploy --no-pull`
+     * `vix deploy --no-tests`
+     *
+     * @param args Command arguments after `deploy`.
+     * @return Process exit code.
+     */
+    static int run(const std::vector<std::string> &args);
+
+    /**
+     * @brief Print deploy command help.
+     *
+     * @return Process exit code.
+     */
+    static int help();
+  };
+}
+
+#endif

include/vix/cli/commands/deploy/DeployConfig.hpp

@@ -0,0 +1,51 @@
+/**
+ *
+ *  @file DeployConfig.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
+ */
+#ifndef VIX_DEPLOY_CONFIG_HPP
+#define VIX_DEPLOY_CONFIG_HPP
+
+#include <vix/cli/commands/deploy/DeployTypes.hpp>
+
+#include <optional>
+#include <string>
+
+namespace vix::commands::deploy
+{
+  /**
+   * @brief Read the current Vix project name.
+   *
+   * @return The detected project name, or std::nullopt if no name can be resolved.
+   */
+  std::optional<std::string> read_project_name();
+
+  /**
+   * @brief Load production deployment configuration from vix.json.
+   *
+   * The configuration is read from `production.deploy`.
+   *
+   * @return Loaded deployment configuration.
+   */
+  DeployConfig load_deploy_config();
+
+  /**
+   * @brief Apply command-line deploy options to the loaded config.
+   *
+   * @param cfg Loaded deployment configuration.
+   * @param options Runtime deploy options.
+   * @return Effective deployment configuration.
+   */
+  DeployConfig apply_deploy_options(
+      DeployConfig cfg,
+      const DeployOptions &options);
+}
+
+#endif

include/vix/cli/commands/deploy/DeployOutput.hpp

@@ -0,0 +1,96 @@
+/**
+ *
+ *  @file DeployOutput.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
+ */
+#ifndef VIX_DEPLOY_OUTPUT_HPP
+#define VIX_DEPLOY_OUTPUT_HPP
+
+#include <vix/cli/commands/deploy/DeployTypes.hpp>
+
+#include <iosfwd>
+#include <string>
+
+namespace vix::commands::deploy::output
+{
+  /**
+   * @brief Print the deployment configuration summary.
+   *
+   * @param out Output stream.
+   * @param cfg Effective deployment configuration.
+   * @param options Runtime deployment options.
+   */
+  void print_summary(
+      std::ostream &out,
+      const DeployConfig &cfg,
+      const DeployOptions &options);
+
+  /**
+   * @brief Print the beginning of a deployment step.
+   *
+   * @param out Output stream.
+   * @param label Step label.
+   */
+  void step(
+      std::ostream &out,
+      const std::string &label);
+
+  /**
+   * @brief Print the command that will be executed.
+   *
+   * @param out Output stream.
+   * @param command Command text.
+   */
+  void command(
+      std::ostream &out,
+      const std::string &command);
+
+  /**
+   * @brief Print a successful deployment message.
+   *
+   * @param out Output stream.
+   * @param message Message to print.
+   */
+  void ok(
+      std::ostream &out,
+      const std::string &message);
+
+  /**
+   * @brief Print a deployment warning message.
+   *
+   * @param out Output stream.
+   * @param message Message to print.
+   */
+  void warn(
+      std::ostream &out,
+      const std::string &message);
+
+  /**
+   * @brief Print a deployment error message.
+   *
+   * @param out Output stream.
+   * @param message Message to print.
+   */
+  void error(
+      std::ostream &out,
+      const std::string &message);
+
+  /**
+   * @brief Print a fix suggestion.
+   *
+   * @param out Output stream.
+   * @param message Fix suggestion.
+   */
+  void fix(
+      std::ostream &out,
+      const std::string &message);
+}
+
+#endif

include/vix/cli/commands/deploy/DeployRunner.hpp

@@ -0,0 +1,32 @@
+/**
+ *
+ *  @file DeployRunner.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
+ */
+#ifndef VIX_DEPLOY_RUNNER_HPP
+#define VIX_DEPLOY_RUNNER_HPP
+
+#include <vix/cli/commands/deploy/DeployTypes.hpp>
+
+namespace vix::commands::deploy::runner
+{
+  /**
+   * @brief Execute the production deployment workflow.
+   *
+   * @param cfg Effective deployment configuration.
+   * @param options Runtime deployment options.
+   * @return Process exit code.
+   */
+  int run(
+      const DeployConfig &cfg,
+      const DeployOptions &options);
+}
+
+#endif

include/vix/cli/commands/deploy/DeployTypes.hpp

@@ -0,0 +1,110 @@
+/**
+ *
+ *  @file DeployTypes.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
+ */
+#ifndef VIX_DEPLOY_TYPES_HPP
+#define VIX_DEPLOY_TYPES_HPP
+
+#include <string>
+
+namespace vix::commands::deploy
+{
+  /**
+   * @struct DeployOptions
+   * @brief Runtime options passed from the deploy command line.
+   */
+  struct DeployOptions
+  {
+    /**
+     * @brief Print commands without executing them.
+     */
+    bool dryRun{false};
+
+    /**
+     * @brief Print additional execution details.
+     */
+    bool verbose{false};
+
+    /**
+     * @brief Disable git pull even when enabled in configuration.
+     */
+    bool noPull{false};
+
+    /**
+     * @brief Disable tests even when enabled in configuration.
+     */
+    bool noTests{false};
+  };
+
+  /**
+   * @struct DeployConfig
+   * @brief Production deployment configuration.
+   */
+  struct DeployConfig
+  {
+    /**
+     * @brief Application name.
+     */
+    std::string appName{"vix-app"};
+
+    /**
+     * @brief Whether deploy should pull latest code before building.
+     */
+    bool pull{false};
+
+    /**
+     * @brief Git branch to pull.
+     */
+    std::string branch{"main"};
+
+    /**
+     * @brief Build command executed during deployment.
+     */
+    std::string buildCommand{"vix build"};
+
+    /**
+     * @brief Whether deploy should run tests after build.
+     */
+    bool tests{false};
+
+    /**
+     * @brief Test command executed when tests are enabled.
+     */
+    std::string testCommand{"vix tests"};
+
+    /**
+     * @brief systemd service name restarted after build.
+     */
+    std::string serviceName{};
+
+    /**
+     * @brief Whether deploy should run local health check.
+     */
+    bool healthLocal{true};
+
+    /**
+     * @brief Whether deploy should run public health check.
+     */
+    bool healthPublic{false};
+
+    /**
+     * @brief Whether deploy should print recent service logs on failure.
+     */
+    bool logsOnFailure{true};
+
+    /**
+     * @brief Number of journalctl log lines shown on failure.
+     */
+    int logLines{80};
+  };
+}
+
+#endif

src/CLI.cpp

@@ -52,6 +52,7 @@
 #include <vix/cli/commands/ServiceCommand.hpp>
 #include <vix/cli/commands/ProxyCommand.hpp>
 #include <vix/cli/commands/HealthCommand.hpp>
+#include <vix/cli/commands/DeployCommand.hpp>
 #include <vix/cli/commands/AgentCommand.hpp>
 #include <vix/cli/commands/GameExportCommand.hpp>
 #include <vix/utils/Env.hpp>
@@ -293,6 +294,8 @@ namespace vix
     { return commands::ProxyCommand::run(args); };
     commands_["health"] = [](auto args)
     { return commands::HealthCommand::run(args); };
+    commands_["deploy"] = [](auto args)
+    { return commands::DeployCommand::run(args); };
     commands_["agent"] = [](auto args)
     { return commands::AgentCommand::run(args); };
     commands_["game"] = [](auto args)
@@ -525,6 +528,8 @@ namespace vix
         return commands::ProxyCommand::help();
       if (cmd == "health")
         return commands::HealthCommand::help();
+      if (cmd == "deploy")
+        return commands::DeployCommand::help();
       if (cmd == "modules")
         return commands::ModulesCommand::help();
       if (cmd == "game")
@@ -650,6 +655,7 @@ namespace vix
     out << indent(3) << "service            Install and manage a production systemd service\n";
     out << indent(3) << "proxy              Generate and validate reverse proxy configs\n";
     out << indent(3) << "health             Check local, public and WebSocket app health\n";
+    out << indent(3) << "deploy             Run the production deployment workflow\n";
     out << indent(3) << "modules            Manage optional project modules\n\n";
 
     out << indent(2) << "Registry and dependencies:\n";