Expose diving hyper parameters + Vector length/Farkas diving

cpp/include/cuopt/linear_programming/constants.h

@@ -112,6 +112,21 @@
 #define CUOPT_MIP_HYPER_HEURISTIC_RELATED_VARS_TIME_LIMIT \
   "mip_hyper_heuristic_related_vars_time_limit"
 
+/* @brief Diving heuristic toggles: -1 automatic, 0 disabled, 1 enabled */
+#define CUOPT_MIP_HYPER_DIVING_LINE_SEARCH   "mip_hyper_diving_line_search"
+#define CUOPT_MIP_HYPER_DIVING_PSEUDOCOST    "mip_hyper_diving_pseudocost"
+#define CUOPT_MIP_HYPER_DIVING_GUIDED        "mip_hyper_diving_guided"
+#define CUOPT_MIP_HYPER_DIVING_COEFFICIENT   "mip_hyper_diving_coefficient"
+#define CUOPT_MIP_HYPER_DIVING_FARKAS        "mip_hyper_diving_farkas"
+#define CUOPT_MIP_HYPER_DIVING_VECTOR_LENGTH "mip_hyper_diving_vector_length"
+/* @brief Diving heuristic limits */
+#define CUOPT_MIP_HYPER_DIVING_MIN_NODE_DEPTH         "mip_hyper_diving_min_node_depth"
+#define CUOPT_MIP_HYPER_DIVING_NODE_LIMIT             "mip_hyper_diving_node_limit"
+#define CUOPT_MIP_HYPER_DIVING_ITERATION_LIMIT_FACTOR "mip_hyper_diving_iteration_limit_factor"
+#define CUOPT_MIP_HYPER_DIVING_BACKTRACK_LIMIT        "mip_hyper_diving_backtrack_limit"
+/* @brief Show per-strategy diving symbol in logs (true) instead of a generic 'D' */
+#define CUOPT_MIP_HYPER_DIVING_SHOW_DIVING_TYPE "mip_hyper_diving_show_diving_type"
+
 /* @brief MIP determinism mode constants */
 #define CUOPT_MODE_OPPORTUNISTIC 0
 #define CUOPT_MODE_DETERMINISTIC 1

cpp/include/cuopt/linear_programming/mip/diving_hyper_params.hpp

@@ -0,0 +1,63 @@
+/* clang-format off */
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* clang-format on */
+
+#pragma once
+
+namespace cuopt::linear_programming {
+
+/**
+ * @brief Tuning knobs for the dual-simplex diving heuristics used in MIP B&B.
+ *
+ * Mirrors dual_simplex::diving_heuristics_settings_t — fields are copied
+ * verbatim into branch_and_bound_settings.diving_settings before solve. These
+ * are registered in the unified parameter framework via solver_settings_t and
+ * can be loaded from a config file with load_parameters_from_file().
+ */
+struct mip_diving_hyper_params_t {
+  // -1 automatic, 0 disabled, 1 enabled
+  int line_search_diving   = -1;
+  int pseudocost_diving    = -1;
+  int guided_diving        = -1;
+  int coefficient_diving   = -1;
+  int farkas_diving        = -1;
+  int vector_length_diving = -1;
+
+  // The minimum depth to start diving from.
+  int min_node_depth = 10;
+
+  // The maximum number of nodes when performing a dive.
+  int node_limit = 500;
+
+  // The maximum number of dual simplex iteration allowed
+  // in a single dive. This set in terms of the total number of
+  // iterations in the best-first threads.
+  double iteration_limit_factor = 0.05;
+
+  // The maximum backtracking allowed.
+  int backtrack_limit = 5;
+
+  // For the Farkas diving to be effective, the coefficients in the objective function
+  // must have distinct values. The low tolerance here disables Farkas diving for
+  // set covering/partitioning, where all coefficients have the same value.
+  double farkas_obj_dynamism_tol = 1E-4;
+
+  // If a given diving heuristic found a new incumbent, show the corresponding
+  // symbol in the first column of the log row. When false, every dive collapses
+  // to 'D'. Otherwise,
+  //   B = best-first
+  //   H = heuristics
+  //   C = coefficient diving
+  //   L = line-search diving
+  //   P = pseudocost diving
+  //   G = guided diving
+  //   F = Farkas diving
+  //   V = vector-length diving
+  //   U = unknown
+  bool show_diving_type = false;
+};
+
+}  // namespace cuopt::linear_programming

cpp/include/cuopt/linear_programming/mip/solver_settings.hpp

@@ -11,6 +11,7 @@
 #include <vector>
 
 #include <cuopt/linear_programming/constants.h>
+#include <cuopt/linear_programming/mip/diving_hyper_params.hpp>
 #include <cuopt/linear_programming/mip/heuristics_hyper_params.hpp>
 #include <cuopt/linear_programming/pdlp/pdlp_hyper_params.cuh>
 #include <cuopt/linear_programming/utilities/internals.hpp>
@@ -162,6 +163,8 @@ class mip_solver_settings_t {
 
   mip_heuristics_hyper_params_t heuristic_params;
 
+  mip_diving_hyper_params_t diving_params;
+
  private:
   std::vector<internals::base_solution_callback_t*> mip_callbacks_;
   std::optional<i_t> semi_continuous_original_num_variables_;