sm#317: event stream contract + schema version pinning for interactive CLI

codex-rs/cli/src/main.rs

@@ -1079,6 +1079,12 @@ fn merge_interactive_cli_flags(interactive: &mut TuiCli, subcommand_cli: TuiCli)
     if !subcommand_cli.add_dir.is_empty() {
         interactive.add_dir.extend(subcommand_cli.add_dir);
     }
+    if subcommand_cli.event_stream.is_some() {
+        interactive.event_stream = subcommand_cli.event_stream;
+    }
+    if subcommand_cli.event_schema_version.is_some() {
+        interactive.event_schema_version = subcommand_cli.event_schema_version;
+    }
     if let Some(prompt) = subcommand_cli.prompt {
         // Normalize CRLF/CR to LF so CLI-provided text can't leak `\r` into TUI state.
         interactive.prompt = Some(prompt.replace("\r\n", "\n").replace('\r', "\n"));

codex-rs/tui/src/cli.rs

@@ -110,6 +110,18 @@ pub struct Cli {
     #[arg(long = "no-alt-screen", default_value_t = false)]
     pub no_alt_screen: bool,
 
+    /// Emit structured JSONL lifecycle events to a file path, or `-` for stdout.
+    #[arg(long = "event-stream", value_name = "PATH_OR_STDOUT")]
+    pub event_stream: Option<String>,
+
+    /// Pin the event stream schema version for compatibility.
+    #[arg(
+        long = "event-schema-version",
+        value_name = "INT",
+        requires = "event_stream"
+    )]
+    pub event_schema_version: Option<u32>,
+
     #[clap(skip)]
     pub config_overrides: CliConfigOverrides,
 }

codex-rs/tui/src/lib.rs

@@ -577,8 +577,14 @@ async fn run_ratatui_app(
         }
     }
 
-    // Initialize high-fidelity session event logging if enabled.
-    session_log::maybe_init(&initial_config);
+    // Initialize session event logging if enabled.
+    if let Err(err) = session_log::maybe_init(&initial_config, &cli) {
+        restore();
+        let _ = tui.terminal.clear();
+        return Ok(AppExitInfo::fatal(format!(
+            "Failed to initialize session event logging: {err}"
+        )));
+    }
 
     let auth_manager = AuthManager::shared(
         initial_config.codex_home.clone(),