diff --git a/src/trace_tests/cli.py b/src/trace_tests/cli.py
index fe49ab6..55d3f8f 100644
--- a/src/trace_tests/cli.py
+++ b/src/trace_tests/cli.py
@@ -263,6 +263,7 @@ def verify(
     default=DEFAULT_MAX_AGE_SECONDS,
     type=click.IntRange(min=1),
     show_default=True,
+    help="Maximum allowed record age in seconds (iat freshness window)",
 )
 @click.option(
     "--html", "html_out", type=click.Path(), help="Write a self-contained HTML report here"
diff --git a/tests/unit/test_cli.py b/tests/unit/test_cli.py
index be93fd2..c861e50 100644
--- a/tests/unit/test_cli.py
+++ b/tests/unit/test_cli.py
@@ -4,6 +4,7 @@
 import pathlib
 import time
 
+import click
 import pytest
 from click.testing import CliRunner
 
@@ -93,3 +94,29 @@ def test_dunder_version_is_not_a_stale_literal():
     import trace_tests
 
     assert trace_tests.__version__ == version("agentrust-trace-tests")
+
+
+def _iter_commands(cmd: click.Command) -> list[click.Command]:
+    yielded = [cmd]
+    if isinstance(cmd, click.Group):
+        for subcmd in cmd.commands.values():
+            yielded.extend(_iter_commands(subcmd))
+    return yielded
+
+
+def test_all_options_have_help():
+    """Every Click command option must have non-empty help text."""
+    missing = []
+    for cmd in _iter_commands(main):
+        for param in cmd.params:
+            if isinstance(param, click.Option) and not (param.help and param.help.strip()):
+                missing.append((cmd.name, param.opts))
+    assert not missing, f"Options missing help text: {missing}"
+
+
+def test_report_help_describes_max_age():
+    """`report --help` must describe `--max-age`."""
+    result = CliRunner().invoke(main, ["report", "--help"])
+    assert result.exit_code == 0
+    assert "--max-age" in result.output
+    assert "Maximum allowed record age in seconds" in result.output