feat(cli): add production health checks

Author: GaspardKirira

include/vix/cli/commands/HealthCommand.hpp

@@ -0,0 +1,50 @@
+/**
+ *
+ *  @file HealthCommand.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_HEALTH_COMMAND_HPP
+#define VIX_HEALTH_COMMAND_HPP
+
+#include <string>
+#include <vector>
+
+namespace vix::commands
+{
+  /**
+   * @brief Command entry point for production health checks.
+   */
+  struct HealthCommand
+  {
+    /**
+     * @brief Run the health command.
+     *
+     * Supported forms:
+     *
+     * `vix health`
+     * `vix health local`
+     * `vix health public`
+     * `vix health websocket`
+     *
+     * @param args Command arguments after `health`.
+     * @return Process exit code.
+     */
+    static int run(const std::vector<std::string> &args);
+
+    /**
+     * @brief Print health command help.
+     *
+     * @return Process exit code.
+     */
+    static int help();
+  };
+}
+
+#endif

include/vix/cli/commands/health/HealthChecker.hpp

@@ -0,0 +1,53 @@
+/**
+ *
+ *  @file HealthChecker.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_HEALTH_CHECKER_HPP
+#define VIX_HEALTH_CHECKER_HPP
+
+#include <vix/cli/commands/health/HealthTypes.hpp>
+
+namespace vix::commands::health::checker
+{
+  /**
+   * @brief Run all configured health checks.
+   *
+   * @param cfg Loaded health configuration.
+   * @return Process exit code.
+   */
+  int check_all(const HealthConfig &cfg);
+
+  /**
+   * @brief Run the local application health check.
+   *
+   * @param cfg Loaded health configuration.
+   * @return Process exit code.
+   */
+  int check_local(const HealthConfig &cfg);
+
+  /**
+   * @brief Run the public HTTPS health check.
+   *
+   * @param cfg Loaded health configuration.
+   * @return Process exit code.
+   */
+  int check_public(const HealthConfig &cfg);
+
+  /**
+   * @brief Run the WebSocket health check.
+   *
+   * @param cfg Loaded health configuration.
+   * @return Process exit code.
+   */
+  int check_websocket(const HealthConfig &cfg);
+}
+
+#endif

include/vix/cli/commands/health/HealthConfig.hpp

@@ -0,0 +1,48 @@
+/**
+ *
+ *  @file HealthConfig.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_HEALTH_CONFIG_HPP
+#define VIX_HEALTH_CONFIG_HPP
+
+#include <vix/cli/commands/health/HealthTypes.hpp>
+
+#include <optional>
+#include <string>
+
+namespace vix::commands::health
+{
+  /**
+   * @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 health configuration from vix.json.
+   *
+   * The configuration is read from `production.health`.
+   *
+   * @return Loaded health check configuration.
+   */
+  HealthConfig load_health_config();
+
+  /**
+   * @brief Return a readable name for a health target.
+   *
+   * @param target Health target.
+   * @return Target name.
+   */
+  const char *target_name(HealthTarget target) noexcept;
+}
+
+#endif

include/vix/cli/commands/health/HealthOutput.hpp

@@ -0,0 +1,84 @@
+/**
+ *
+ *  @file HealthOutput.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_HEALTH_OUTPUT_HPP
+#define VIX_HEALTH_OUTPUT_HPP
+
+#include <vix/cli/commands/health/HealthTypes.hpp>
+
+#include <iosfwd>
+#include <string>
+
+namespace vix::commands::health::output
+{
+  /**
+   * @brief Print the health command summary.
+   *
+   * @param out Output stream.
+   * @param cfg Loaded health configuration.
+   */
+  void print_summary(
+      std::ostream &out,
+      const HealthConfig &cfg);
+
+  /**
+   * @brief Print one health check result.
+   *
+   * @param out Output stream.
+   * @param result Health check result.
+   */
+  void print_result(
+      std::ostream &out,
+      const HealthResult &result);
+
+  /**
+   * @brief Print a successful health message.
+   *
+   * @param out Output stream.
+   * @param message Message to print.
+   */
+  void ok(
+      std::ostream &out,
+      const std::string &message);
+
+  /**
+   * @brief Print a health warning message.
+   *
+   * @param out Output stream.
+   * @param message Message to print.
+   */
+  void warn(
+      std::ostream &out,
+      const std::string &message);
+
+  /**
+   * @brief Print a health 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/health/HealthTypes.hpp

@@ -0,0 +1,145 @@
+/**
+ *
+ *  @file HealthTypes.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_HEALTH_TYPES_HPP
+#define VIX_HEALTH_TYPES_HPP
+
+#include <cstdint>
+#include <optional>
+#include <string>
+
+namespace vix::commands::health
+{
+  /**
+   * @enum HealthTarget
+   * @brief Health check target type.
+   */
+  enum class HealthTarget
+  {
+    Local,
+    Public,
+    WebSocket
+  };
+
+  /**
+   * @struct HealthEndpointConfig
+   * @brief Configuration for one health endpoint.
+   */
+  struct HealthEndpointConfig
+  {
+    /**
+     * @brief Whether this endpoint is configured and can be checked.
+     */
+    bool enabled{false};
+
+    /**
+     * @brief Endpoint URL.
+     */
+    std::string url{};
+
+    /**
+     * @brief Expected HTTP status code.
+     */
+    int expectedStatus{200};
+
+    /**
+     * @brief Request timeout in milliseconds.
+     */
+    std::uint64_t timeoutMs{5000};
+
+    /**
+     * @brief Maximum accepted response time in milliseconds.
+     */
+    std::uint64_t maxResponseMs{1000};
+  };
+
+  /**
+   * @struct HealthConfig
+   * @brief Production health check configuration.
+   */
+  struct HealthConfig
+  {
+    /**
+     * @brief Application name.
+     */
+    std::string appName{"vix-app"};
+
+    /**
+     * @brief Optional systemd service name checked before health requests.
+     */
+    std::optional<std::string> serviceName{};
+
+    /**
+     * @brief Local internal application endpoint.
+     */
+    HealthEndpointConfig local{};
+
+    /**
+     * @brief Public HTTPS endpoint.
+     */
+    HealthEndpointConfig publicEndpoint{};
+
+    /**
+     * @brief Public WebSocket endpoint.
+     */
+    HealthEndpointConfig websocket{};
+  };
+
+  /**
+   * @struct HealthResult
+   * @brief Result of one health check.
+   */
+  struct HealthResult
+  {
+    /**
+     * @brief Checked target.
+     */
+    HealthTarget target{HealthTarget::Local};
+
+    /**
+     * @brief Checked URL.
+     */
+    std::string url{};
+
+    /**
+     * @brief Expected HTTP status code.
+     */
+    int expectedStatus{200};
+
+    /**
+     * @brief Actual HTTP status code.
+     */
+    int actualStatus{0};
+
+    /**
+     * @brief Measured response time in milliseconds.
+     */
+    std::uint64_t responseMs{0};
+
+    /**
+     * @brief Maximum accepted response time in milliseconds.
+     */
+    std::uint64_t maxResponseMs{1000};
+
+    /**
+     * @brief Whether the endpoint is healthy.
+     */
+    bool healthy{false};
+
+    /**
+     * @brief Human-readable error message when unhealthy.
+     */
+    std::string error{};
+  };
+}
+
+#endif