From 0d938e483bab7d3de2070b90af4fccc9dd081bdc Mon Sep 17 00:00:00 2001
From: Shiv Rossi <shiv@fastmail.com>
Date: Fri, 18 Sep 2026 19:32:50 -0600
Subject: [PATCH] chore: cover output-flag help (COD-507)

---
 crates/hydra-codegen/tests/codegen.rs | 37 +++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/crates/hydra-codegen/tests/codegen.rs b/crates/hydra-codegen/tests/codegen.rs
index 823feea..eebb640 100644
--- a/crates/hydra-codegen/tests/codegen.rs
+++ b/crates/hydra-codegen/tests/codegen.rs
@@ -925,6 +925,43 @@ fn output_flags_compile_and_parse_as_boolean_presentation_options() {
     assert_eq!(params, serde_json::json!({}));
 }
 
+#[test]
+fn output_flags_render_declared_help_from_compiled_cli() {
+    let list_records_help = FixtureCli::try_parse_from(["fixture", "list-records", "--help"])
+        .expect_err("list-records help exits through clap");
+    assert_eq!(
+        list_records_help.kind(),
+        clap::error::ErrorKind::DisplayHelp,
+        "list-records --help must render help"
+    );
+    let list_records_help = list_records_help.render().to_string();
+    assert!(
+        list_records_help.contains("--include-cursor"),
+        "list-records help must expose the exact output flag: {list_records_help}"
+    );
+    assert!(
+        list_records_help.contains("Include the checkpoint alongside each displayed record"),
+        "list-records help must expose the declared output-flag description: {list_records_help}"
+    );
+
+    let status_help = FixtureCli::try_parse_from(["fixture", "status", "--help"])
+        .expect_err("status help exits through clap");
+    assert_eq!(
+        status_help.kind(),
+        clap::error::ErrorKind::DisplayHelp,
+        "status --help must render help"
+    );
+    let status_help = status_help.render().to_string();
+    assert!(
+        status_help.contains("--verbose"),
+        "status help must expose the exact output flag: {status_help}"
+    );
+    assert!(
+        status_help.contains("Include verbose status presentation details"),
+        "status help must expose the declared output-flag description: {status_help}"
+    );
+}
+
 #[test]
 fn output_flags_stay_out_of_request_and_mcp_projections() {
     let definition = cli_output_flags_definition();