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

# bregctl apply command reference

> Generated syntax and options for bregctl apply.

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

Apply one built package using the configured migration authority.

## 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
bregctl apply [OPTIONS] --runtime-config <ABSOLUTE_FILE> --package <ABSOLUTE_DIRECTORY>
```

## Options

| Option | Always required | Repeatable | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `--runtime-config <ABSOLUTE_FILE>` | Yes | No | n/a | n/a | n/a | Absolute runtime configuration for deployment identity, roles, and database access. A symbolic link at any component of this path is refused. |
| `--package <ABSOLUTE_DIRECTORY>` | Yes | No | n/a | n/a | n/a | Absolute target package directory. A symbolic link at any component of this path is refused. |
| `--initial` | No | No | n/a | n/a | n/a | Activate the first package in an uninitialized Registry database |
| `--backup <BINDING_PATH=BINDING_FILE>` | No | Yes | n/a | n/a | n/a | Reviewed backup binding the plan requires and the absolute backup binding file that satisfies it, as BINDING_PATH=BINDING_FILE |
| `--acknowledge-retired-audit-discard` | No | No | n/a | n/a | n/a | Acknowledge discarding rows retained in a pre-simplification registry_audit or registry_audit_head table. Without this, apply refuses rather than silently dropping those retained audit entries while installing the current schema |
| `--operator-reference <REFERENCE>` | No | No | n/a | n/a | n/a | Operator change reference, at most 512 bytes, recorded as a keyed hash in the activation ledger and audit |
| `--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.