leapview admin
Administrative utilities
Usage
leapview admin
Machine-readable: JSON · Markdown
Subcommands
delivery: Manage plan-driven delivery statedelivery pool: Manage the delivery physical-pool admissiondelivery pool bootstrap: Create and admit one operator-controlled delivery physical pooldelivery pool upgrade: Upgrade one admitted delivery physical-pool cataloginitialize: Initialize one instance administrator and publisher credentialmaintenance: Prune bounded operational historyrecovery: Prepare, validate, and publish immutable recovery frontiersrecovery prepare: Prepare one immutable recovery frontierrecovery publish: Publish one recovery frontier after exact validationrecovery validate: Record provider-produced evidence for one recovery attempt
delivery
Manage plan-driven delivery state
Usage
leapview admin delivery
Machine-readable: JSON · Markdown
delivery pool
Manage the delivery physical-pool admission
Usage
leapview admin delivery pool
Machine-readable: JSON · Markdown
delivery pool bootstrap
Create and admit one operator-controlled delivery physical pool
Usage
leapview admin delivery pool bootstrap [flags]
Behavior
| Side effect | Confirmation |
|---|---|
write |
required |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--apply |
bool | false |
persist the pool and admission; without this flag only validate and print digests |
--evidence |
string | `` | path to machine-readable shared-pool conformance evidence JSON |
--pool |
string | `` | path to non-secret physical-pool identity JSON |
delivery pool upgrade
Upgrade one admitted delivery physical-pool catalog
Usage
leapview admin delivery pool upgrade [flags]
Behavior
| Side effect | Confirmation |
|---|---|
write |
required |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--apply |
bool | false |
commit the catalog upgrade; without this flag run a dry-run through the operation authority |
--backup-verified |
bool | false |
assert that the required backup was verified before migration |
--catalog-schema-version |
string | `` | target DuckLake catalog schema version |
--drain-verified |
bool | false |
assert that active readers were drained before migration |
--evidence |
string | `` | path to target shared-pool conformance evidence JSON |
--migration-id |
string | `` | durable catalog migration UUID |
--pool |
string | `` | path to target physical-pool identity JSON |
--recovery-decision |
string | `` | failure recovery decision: rollback or forward_recovery |
initialize
Initialize one instance administrator and publisher credential
Usage
leapview admin initialize [flags]
Behavior
| Side effect | Confirmation |
|---|---|
write |
never |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--acknowledge-credentials |
bool | false |
remove the recoverable initialization credential bundle after it has been stored safely |
--format |
string | json |
output format (json) |
maintenance
Prune bounded operational history
Usage
leapview admin maintenance [flags]
Behavior
| Side effect | Confirmation |
|---|---|
destructive |
conditional |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--apply |
bool | false |
delete rows instead of dry-run |
--archived-agent-days |
int | 180 |
archived agent conversation retention in days; 0 disables archived conversation pruning |
--audit-days |
int | 365 |
audit event retention in days; 0 disables audit pruning |
--auth-state-days |
int | 30 |
expired or revoked auth state retention in days; 0 disables auth-state pruning |
--query-days |
int | 90 |
query event retention in days; 0 disables query pruning |
recovery
Prepare, validate, and publish immutable recovery frontiers
Usage
leapview admin recovery
Machine-readable: JSON · Markdown
recovery prepare
Prepare one immutable recovery frontier
Usage
leapview admin recovery prepare [flags]
Behavior
| Side effect | Confirmation |
|---|---|
write |
required |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--expires-at |
string | `` | retention-root expiry timestamp (RFC3339) |
--retain-root-id |
string | `` | optional retention-root UUID; defaults to the recovery-set ID |
--set |
string | `` | path to the prepared recovery-set JSON |
recovery publish
Publish one recovery frontier after exact validation
Usage
leapview admin recovery publish [flags]
Behavior
| Side effect | Confirmation |
|---|---|
write |
required |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--fence-epoch |
uint64 | 0 |
publication fence epoch (positive unsigned integer) |
--publisher |
string | `` | publisher identity |
--set-id |
string | `` | recovery-set UUID |
--validation-attempt-id |
string | `` | exact passed validation-attempt UUID |
recovery validate
Record provider-produced evidence for one recovery attempt
Usage
leapview admin recovery validate [flags]
Behavior
| Side effect | Confirmation |
|---|---|
write |
required |
Machine-readable: JSON · Markdown
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--attempt-id |
string | `` | validation-attempt UUID |
--evidence |
string | `` | path to provider-produced typed validation evidence JSON |
--set-id |
string | `` | recovery-set UUID |
--validator |
string | `` | operator/provider validator identity |