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 proposal-retention command reference

> Generated syntax and options for bregctl proposal-retention.

{/* Generated from crates/registry-cli-docs/catalog.json and the workspace version in Cargo.toml by scripts/generate-cli-reference.mjs. Run npm run generate. */}

Inspect and erase eligible Proposal retention detail.

## Contract status

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

## Usage

```text
bregctl proposal-retention [OPTIONS] <COMMAND>
```

## Commands

| Command | Description |
| --- | --- |
| [`list`](./list/) | List bounded value-free Proposal retention rows |
| [`dry-run`](./dry-run/) | Count exactly what one Proposal retention erase would remove |
| [`erase`](./erase/) | Erase eligible payload detail for one exact submission version |
| [`cleanup-attachments`](./cleanup-attachments/) | Retry deletion of unreferenced external attachments without erasing request detail |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--format <FORMAT>` | No | `human` | `human`, `json` | n/a | Emit the selected command's report in this format |
| `-h, --help` | No | n/a | n/a | n/a | Print help |

## 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`.