# benchweave report


Render run evidence into an operator report (store at rest).


``` bash
benchweave report [OPTIONS]
```


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: benchweave report [OPTIONS]

      Render run evidence into an operator report (store at rest).

    Options:
      --data-dir PATH  At-rest data directory (holds state.sqlite + content/).
                       [required]
      --bench TEXT     Restrict the report to one bench id (default: every bench).
      --out PATH       Write the report to FILE (markdown; JSON with --json)
                       instead of stdout.
      --gateway TEXT   NOT IMPLEMENTED: compose the report from a live gateway
                       over REST. The report is at-rest only in this task -- read
                       the data directory.
      --json           Emit the stable machine JSON contract instead of text.
      --help           Show this message and exit.


# Options


`--data-dir: PATH`  
**Required.** At-rest data directory (holds state.sqlite + content/). Environment variable: `BENCHWEAVE_DATA_DIR`.

`--bench: TEXT`  
Restrict the report to one bench id (default: every bench).

`--out: PATH`  
Write the report to FILE (markdown; JSON with `--json`) instead of stdout.

`--gateway: TEXT`  
NOT IMPLEMENTED: compose the report from a live gateway over REST. The report is at-rest only in this task -- read the data directory. Environment variable: `BENCHWEAVE_GATEWAY`.

`--json`  
Emit the stable machine JSON contract instead of text.