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

# bregctl generate command reference

> Generated syntax and options for bregctl generate.

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

Write selected compiler artifacts to a new directory.

## Contract status

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

## Usage

```text
bregctl generate [OPTIONS] --output <DIRECTORY> <ARTIFACT> <PROJECT>
```

## Arguments

| Argument | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `<ARTIFACT>` | Yes | n/a | `openapi`, `schemas`, `actions`, `manifest`, `metadata`, `sql`, `evidence-source` | n/a | Artifact family to write |
| `<PROJECT>` | Yes | n/a | n/a | n/a | Base Registry Engine project directory. A symbolic link at any component of this path is refused. |

## Options

| Option | Always required | Repeatable | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `--production` | No | No | n/a | n/a | n/a | Enforce production-only package closure requirements |
| `--output <DIRECTORY>` | Yes | No | n/a | n/a | n/a | New directory that will receive exactly the generated artifact inventory. A symbolic link at any component of this path is refused. |
| `--access-profile <ACCESS_PROFILE>` | No | No | n/a | n/a | n/a | Existing registry lookup access profile (evidence-source only) |
| `--entity <ENTITY>` | No | No | n/a | n/a | n/a | Compiled entity to export (evidence-source only) |
| `--selector <SELECTORS>` | No | Yes | n/a | n/a | n/a | Exact lookup alternatives; repeat to expose several selectors |
| `--fields <FIELDS>` | No | Yes | n/a | n/a | n/a | Explicit readable fact fields, separated by commas |
| `--source-id <SOURCE_ID>` | No | No | n/a | n/a | n/a | Stable source identity inside the Evidence authoring project |
| `--connection <CONNECTION>` | No | No | n/a | n/a | n/a | Logical connection that the Evidence operator configures separately |
| `--format <FORMAT>` | No | No | `human` | `human`, `json` | n/a | Emit the selected command's report in this format |
| `-h, --help` | No | No | n/a | n/a | n/a | Print help |

## Generation contract

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