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 external-projection command reference

> Generated syntax and options for bregctl external-projection.

{/* 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, withdraw, or rotate an indexed external projection's cache scope using configured migration authority.

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

## Usage

```text
bregctl external-projection [OPTIONS] <COMMAND>
```

## Commands

| Command | Description |
| --- | --- |
| [`inspect`](./inspect/) | Report one projection's scope, refresh outcome counts and snapshot counts; reads no source values |
| [`withdraw`](./withdraw/) | Deactivate the scope and purge its cached rows; a binding still configured binds again at the next start |
| [`rotate`](./rotate/) | Start a fresh epoch under the configured binding, grant and cache lifetime, and purge cached rows |
| [`refresh`](./refresh/) | Run bounded ready work for one managed refresh plan through its authenticated HTTP route |

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