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 generate command reference

> Generated syntax and options for evidencectl source mock generate.

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

Materialize or extend editable mock cases from OpenAPI.

## 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 generate [OPTIONS] [PROJECT]
```

## Constraints

| Condition | Requirement |
| --- | --- |
| `--output <OUTPUT>` is present | `--openapi <OPENAPI>` is required. |
| `--case <CASE>` is present | `--operation <OPERATION>` is required. |
| `--path-parameter <PATH_PARAMETERS>` is present | `--operation <OPERATION>` is required. |
| Command invocation | `--as-of <AS_OF>` and `--config <CONFIG>` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `--openapi <OPENAPI>` cannot be used together. |
| Command invocation | `--config <CONFIG>` and `--output <OUTPUT>` 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 | Repeatable | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `--openapi <OPENAPI>` | No | No | n/a | n/a | n/a | OpenAPI document for initial standalone materialization |
| `--config <CONFIG>` | No | No | n/a | n/a | n/a | Existing editable configuration to complete or extend |
| `--output <OUTPUT>` | No | No | n/a | n/a | n/a | Initial configuration path. Defaults to mocks/source.yaml |
| `--operation <OPERATION>` | No | No | n/a | n/a | n/a | Select one `METHOD /path/template` operation |
| `--case <CASE>` | No | No | n/a | n/a | n/a | Starter or appended case name for the selected operation |
| `--path-parameter <PATH_PARAMETERS>` | No | Yes | n/a | n/a | n/a | Concrete selected-operation path parameter as NAME=VALUE; repeat as needed |
| `--seed <SEED>` | No | No | n/a | n/a | n/a | Deterministic unsigned generation seed for a new plan. Defaults to zero |
| `--as-of <AS_OF>` | No | No | n/a | n/a | n/a | Calendar date used only by explicit or inferred age generation |
| `--explain` | No | No | n/a | n/a | n/a | Explain generator choices without printing generated or authored values |
| `--format <output_format>` | No | No | `human` | `human` | n/a | Select human-readable output; this command provides no JSON report |
| `-h, --help` | No | 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.