Registry stack documentation: machine-readable Markdown.
Index of all pages: https://docs.registrystack.org/v/0.38.0/llms.txt
Full corpus: https://docs.registrystack.org/v/0.38.0/llms-full.txt

# evidencectl doctor command reference

> Generated syntax and options for evidencectl doctor.

{/* Generated from Clap command definitions by scripts/generate-cli-reference.mjs. Run npm run generate. */}

Check one runtime configuration and its startup dependencies.

## Contract status

This page is generated from the public Clap command tree for Registry Stack source version `0.38.0` and catalog SHA-256 `cd13c658f65af295f9df3c6db86dc045ac06e9e040afc1f5f5b27c3184ab653d`. Hidden implementation commands are omitted.

## Usage

```text
evidencectl doctor [OPTIONS]
```

## Constraints

| Condition | Requirement |
| --- | --- |
| `--require-audit-under <ABSOLUTE_DIRECTORY>` is present | `--runtime-config <FILE>` is required. |
| `--without-audit-lock` is present | `--runtime-config <FILE>` is required. |
| Command invocation | `--format <output_format>` and `--json` cannot be used together. |
| Command invocation | `--json` and `--runtime-config <FILE>` cannot be used together. |
| Command invocation | `--project <PROJECT>` and `--runtime-config <FILE>` cannot be used together. |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--runtime-config <FILE>` | No | n/a | n/a | n/a | Absolute Evidence Gateway runtime configuration file to inspect |
| `--require-audit-under <ABSOLUTE_DIRECTORY>` | No | n/a | n/a | n/a | Also prove that the audit destination resolves below this persistent root |
| `--without-audit-lock` | No | n/a | n/a | n/a | Prove the audit destination without taking its single-writer lock. For a candidate staged beside the running instance it will replace, which holds that lock. Modes, write access, and a complete final entry are still proved, and every other dependency is proved as without it. |
| `--project <PROJECT>` | No | n/a | n/a | n/a | Evidence project directory; defaults to the current directory. Compatibility form for inspecting a deployment project that holds runtime.yaml beside bundle/. New dependency checks use --runtime-config. |
| `--json` | No | n/a | n/a | n/a | Compatibility spelling for JSON artifact-inspection output |
| `--format <output_format>` | No | `human` | `human`, `json`, `junit` | n/a | Select human-readable or machine-readable output. `junit` is accepted only by fixture runs (`test` and `fixtures run`) |
| `-h, --help` | No | n/a | n/a | n/a | Print help (see a summary with '-h') |

## Generation contract

Run `npm run generate` from `docs/site` after changing a public command, argument, option, default, environment binding, or help description.