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 source mock serve command reference

> Generated syntax and options for evidencectl source mock serve.

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

Serve schema-valid synthetic responses from OpenAPI or exact edited cases.

## 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 source mock serve [OPTIONS] [PROJECT]
```

## Constraints

| Condition | Requirement |
| --- | --- |
| Command invocation | `--as-of <AS_OF>` and `--config <CONFIG>` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `--explain` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `--openapi <OPENAPI>` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `--operation <OPERATION>` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `--seed <SEED>` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `[PROJECT]` cannot be used together. |
| Command invocation | `--openapi <OPENAPI>` and `[PROJECT]` cannot be used together. |

## Arguments

| Argument | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `[PROJECT]` | No | n/a | n/a | n/a | Evidence project directory; defaults to the current directory. This command needs an editable project: one holding questions/ and sources/ beside evidence-project.yaml. |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--openapi <OPENAPI>` | No | n/a | n/a | n/a | OpenAPI 3.0 or 3.1 document for an ephemeral, write-free preview |
| `--config <CONFIG>` | No | n/a | n/a | n/a | Materialized mock configuration whose checked body bytes are authoritative |
| `--operation <OPERATION>` | No | n/a | n/a | n/a | Narrow ephemeral discovery to one `METHOD /path/template` operation |
| `--http-addr <HTTP_ADDR>` | No | n/a | n/a | n/a | Numeric loopback listener address. Standalone mode defaults to 127.0.0.1:4010 |
| `--seed <SEED>` | No | n/a | n/a | n/a | Deterministic unsigned generation seed. Ephemeral mode defaults to zero |
| `--as-of <AS_OF>` | No | n/a | n/a | n/a | Calendar date used only by explicit or inferred age generation |
| `--explain` | No | n/a | n/a | n/a | Explain generator choices without printing generated or authored values |
| `--format <output_format>` | No | `human` | `human` | n/a | Select human-readable output; this command provides no JSON report |
| `-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.