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

# evidencectl dev check command reference

> Generated syntax and options for evidencectl dev check.

{/* Generated from crates/registry-cli-docs/catalog.json and the workspace version in Cargo.toml by scripts/generate-cli-reference.mjs. Run npm run generate. */}

Check a task connection or local issuer session state file offline.

## Contract status

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

## Usage

```text
evidencectl dev check [OPTIONS] <FILE>
```

## Constraints

| Condition | Requirement |
| --- | --- |
| `--preserve-target-authenticated-context` is present | All of `--target <TARGET>`, `--issuer-project <PROJECT>` are required. |

## Arguments

| Argument | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `<FILE>` | Yes | n/a | n/a | n/a | A task connection file or a local issuer session state file; its envelope says which. No secret reference is resolved |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--deny-warnings` | No | n/a | n/a | n/a | Exit 1 when a warning is reported |
| `--evidence-port <EVIDENCE_PORT>` | No | n/a | n/a | n/a | Loopback port for the local Evidence Gateway service |
| `--issuer-port <ISSUER_PORT>` | No | n/a | n/a | n/a | Loopback port for the local issuer service |
| `--issuer-project <PROJECT>` | No | n/a | n/a | n/a | Ready Base Registry Engine (BReg) dev project that owns the shared issuer and Evidence client registrations |
| `--resource <URI>` | No | n/a | n/a | n/a | Exact inbound OAuth resource for this retained Evidence session. Defaults to the local gateway resource on first start |
| `--target <TARGET>` | No | n/a | n/a | n/a | Reuse a local target's source connections and outbound TLS in the generated local caller rehearsal. Target service authentication is not replayed |
| `--preserve-target-authenticated-context` | No | n/a | n/a | n/a | Preserve the selected local target's reviewed human authenticated-context subject bindings. Requires a target and its borrowed BReg issuer owner |
| `--format <FORMAT>` | No | `human` | `human`, `json`, `junit` | n/a | Emit the selected command's report in this format. `junit` is accepted only by `test` and `fixtures run` |
| `-h, --help` | No | n/a | n/a | n/a | Print help |

## Generation contract

After changing a public command, argument, option, default, environment binding, or help description, run `cargo run --locked -p registry-cli-docs -- --write`, commit `crates/registry-cli-docs/catalog.json`, then run `npm run generate` from `docs/site`.