evidencectl source suggest command reference
Suggest source configuration from an OpenAPI document.
Contract status
Section titled “Contract status”This page is generated from the public Clap command tree for Registry Stack source version 0.46.1 and catalog SHA-256 61bebbb88fe15e4da92e2b0adbca0cd5b1a47b8eac38f4b91a15095011368a43. Hidden implementation commands are omitted.
evidencectl source suggest [OPTIONS] <--openapi <OPENAPI>|PROJECT>Constraints
Section titled “Constraints”| Condition | Requirement |
|---|---|
| Command invocation | Exactly one of --openapi <OPENAPI>, [PROJECT] is required. |
--list-pointers is present | --operation <OPERATION> is required. |
| Command invocation | --openapi <OPENAPI> and [PROJECT] cannot be used together. |
Arguments
Section titled “Arguments”| Argument | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
[PROJECT] | No | n/a | n/a | n/a | Evidence project directory; the draft is printed when this is absent. This command needs an editable project containing evidence.yaml and its named Function assets. |
Options
Section titled “Options”| Option | Always required | Repeatable | Default | Values | Environment | Description |
|---|---|---|---|---|---|---|
--openapi <OPENAPI> | No | No | n/a | n/a | n/a | OpenAPI 3.0 or 3.1 document for a print-only draft. With a project, the retained source.openapi.yaml is used instead |
--operation <OPERATION> | No | No | n/a | n/a | n/a | Operation as “METHOD /path/template”; interactive selection if absent |
--status <STATUS> | No | No | 200 | n/a | n/a | Response status code to read the schema from |
--media-type <MEDIA_TYPE> | No | No | application/json | n/a | n/a | Response media type to read the schema from |
--select <SELECTION> | No | Yes | n/a | n/a | n/a | Projection pointer to select; repeat once per leaf. Interactive selection if absent |
--list-pointers | No | No | n/a | n/a | n/a | Print the candidate pointers the selected operation and response offer for —select, then stop without drafting |
--sample <SAMPLE> | No | No | n/a | n/a | n/a | Sample response JSON file used to suggest bounds. Read only; nothing from it is copied into any artifact except derived bounds |
--source-id <SOURCE_ID> | No | No | n/a | n/a | n/a | Source identifier for the generated artifacts |
--base-url <BASE_URL> | No | No | n/a | n/a | n/a | Reviewed source origin to write into a newly created source draft |
--map-selector <SELECTOR=TARGET> | No | Yes | n/a | n/a | n/a | Explicit selector-to-request mapping as ROLE.PROFILE.FIELD=path:NAME, query:NAME, or body:/JSON/POINTER. Repeat for each distinct request target. Requires an authoring project |
--format <FORMAT> | No | 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 | No | n/a | n/a | n/a | Print help (see a summary with ‘-h’) |
Generation contract
Section titled “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.