# benchweave doctor


Read-only triage over one data directory (seven typed checks).


``` bash
benchweave doctor [OPTIONS]
```


Takes no store hold and writes nothing (the mode=ro store probe may materialize the empty SQLite -shm/-wal sidecar pair -- verify's own at-rest behavior), so it works while a gateway is LIVE. Exit 0 iff every row passes: `unknown` rows also exit 1 -- scripts must not read an unverifiable pidfile as healthy.


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


    Usage: benchweave doctor [OPTIONS]

      Read-only triage over one data directory (seven typed checks).

      Takes no store hold and writes nothing (the mode=ro store probe may
      materialize the empty SQLite -shm/-wal sidecar pair -- verify's own at-rest
      behavior), so it works while a gateway is LIVE. Exit 0 iff every row passes:
      `unknown` rows also exit 1 -- scripts must not read an unverifiable pidfile
      as healthy.

    Options:
      --data-dir PATH  At-rest data directory (holds state.sqlite + content/).
                       [required]
      --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`.

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