feat(analysis): swim-lane viewer and aiperf analyze CLI

docs/cli-options.md

@@ -12,6 +12,10 @@ sidebar-title: Command Line Options
 
 Install shell completion for this application.
 
+### [`analyze swim-lane`](#aiperf-analyze-swim-lane)
+
+Render a per-session swim-lane PNG with concurrency curve underneath.
+
 ### [`analyze-trace`](#aiperf-analyze-trace)
 
 Analyze a mooncake trace file for ISL/OSL distributions and cache hit rates.
@@ -82,6 +86,32 @@ Output path for the completion script. If not specified, uses shell-specific def
 
 <hr/>
 
+## `aiperf analyze swim-lane`
+
+Render a per-session swim-lane PNG with concurrency curve underneath.
+
+#### `--run-dirs`, `--empty-run-dirs` `<list>` _(Required)_
+
+One or more AIPerf run directories.
+
+#### `-o`, `--out` `<str>`
+
+Output PNG path. Only valid when a single run directory is given.
+
+#### `-c`, `--concurrency` `<int>`
+
+Target concurrency to draw as a reference line in the concurrency panel.
+
+#### `--ramp` `<float>`
+
+Ramp duration in seconds for the ramp-done marker; overrides the value read from ``profile_export_aiperf.json`` (useful when only the jsonl was exported).
+
+#### `--html`, `--no-html`
+
+Also write an interactive HTML trace viewer (``swim_lane.html``, or the ``--out`` path with an ``.html`` suffix).
+
+<hr/>
+
 ## `aiperf analyze-trace`
 
 Analyze a mooncake trace file for ISL/OSL distributions and cache hit rates.