feat: remote preflight, protocol version exposure, retry validation, …

man/man1/soroban-debug-remote.1

@@ -74,16 +74,22 @@ May also be specified with the \fBSOROBAN_DEBUG_STORAGE_TIMEOUT_MS\fR environmen
 \fB\-\-retry\-attempts\fR \fI<N>\fR [default: 3]
 Maximum number of retry attempts for idempotent requests (ping, inspect, storage).
 
+Must be at least 1.  Use 1 to disable retries entirely (one attempt, no retry).
+
 Default: 3.
 .TP
 \fB\-\-retry\-base\-delay\-ms\fR \fI<MS>\fR [default: 200]
 Base delay in milliseconds between retry attempts (exponential back\-off).
 
+Must be greater than 0 and no larger than \-\-retry\-max\-delay\-ms.
+
 Default: 200 ms.
 .TP
 \fB\-\-retry\-max\-delay\-ms\fR \fI<MS>\fR [default: 2000]
 Maximum delay in milliseconds between retry attempts.
 
+Must be greater than or equal to \-\-retry\-base\-delay\-ms.
+
 Default: 2 000 ms.
 .TP
 \fB\-\-format\fR \fI<FORMAT>\fR [default: pretty]
@@ -112,5 +118,8 @@ Get contract storage state as JSON
 remote\-evaluate(1)
 Evaluate an expression in the current debug context
 .TP
+remote\-preflight(1)
+Run a preflight check: connect, handshake, auth, and optional TLS validation without loading a contract. Suitable for CI health checks and troubleshooting
+.TP
 remote\-help(1)
 Print this message or the help of the given subcommand(s)

src/cli/args.rs

@@ -1424,18 +1424,24 @@ pub struct RemoteArgs {
 
     /// Maximum number of retry attempts for idempotent requests (ping, inspect, storage).
     ///
+    /// Must be at least 1.  Use 1 to disable retries entirely (one attempt, no retry).
+    ///
     /// Default: 3.
     #[arg(long, value_name = "N", default_value = "3")]
     pub retry_attempts: usize,
 
     /// Base delay in milliseconds between retry attempts (exponential back-off).
     ///
+    /// Must be greater than 0 and no larger than --retry-max-delay-ms.
+    ///
     /// Default: 200 ms.
     #[arg(long, value_name = "MS", default_value = "200")]
     pub retry_base_delay_ms: u64,
 
     /// Maximum delay in milliseconds between retry attempts.
     ///
+    /// Must be greater than or equal to --retry-base-delay-ms.
+    ///
     /// Default: 2 000 ms.
     #[arg(long, value_name = "MS", default_value = "2000")]
     pub retry_max_delay_ms: u64,
@@ -1459,6 +1465,17 @@ pub enum RemoteAction {
 
     /// Evaluate an expression in the current debug context
     Evaluate(RemoteEvaluateArgs),
+
+    /// Run a preflight check: connect, handshake, auth, and optional TLS validation
+    /// without loading a contract. Suitable for CI health checks and troubleshooting.
+    Preflight(PreflightArgs),
+}
+
+#[derive(Parser)]
+pub struct PreflightArgs {
+    /// Output format (pretty or json)
+    #[arg(long = "output", value_enum, default_value_t = OutputFormat::Pretty)]
+    pub output_format: OutputFormat,
 }
 
 #[derive(Parser)]