Enum DbCommand 

pub enum DbCommand {
    Reset {
        yes: bool,
        allow_checksum_drift_reset: bool,
        maintenance_database: String,
        workspace: Option<PathBuf>,
        node_id: Option<u32>,
        single_node_dev: bool,
    },
    Seed {
        database: String,
        allow_non_localhost: bool,
        workspace: Option<PathBuf>,
    },
    CleanupTestDbs {
        dry_run: bool,
        yes: bool,
        maintenance_database: String,
        allow_non_localhost: bool,
        workspace: Option<PathBuf>,
    },
}

Variants

Reset

Drop, recreate, and replay every committed migration against the application database. Triple-gated — refuses unless (a) DATABASE_URL resolves to localhost, (b) Djogi.toml::profile != "production", and (c) explicit confirmation is supplied via --yes or the interactive prompt. Logging databases (crud_log, event_log) are NOT touched. Requires PostgreSQL 18 or later — exits with code 2 if the server is below the minimum. Exit codes: 0 on success, 1 on error (config / network / SQL / replay), 2 on gate refusal (not localhost, production profile, missing --yes, below PG 18).

Fields

yes: bool

Skip the interactive y/N prompt and proceed. Required for non-interactive invocations (e.g. CI integration suites that call db reset between tests).

allow_checksum_drift_reset: bool

Permit db reset to continue even when the live ledger’s checksums no longer match the current on-disk migration files. Without this flag, checksum drift refuses before the destructive drop / recreate step.

maintenance_database: String

Maintenance database to connect to for the DROP DATABASE then CREATE DATABASE round-trip. Defaults to postgres, the conventional administrative DB present on every cluster. Override only if the cluster has a different administrative DB (e.g. AWS RDS uses rdsadmin).

workspace: Option<PathBuf>

Workspace root override.

node_id: Option<u32>

Explicit cluster node identity (0..=511). Mutually exclusive with --single-node-dev. Selected-node reset is refused — use --single-node-dev for destructive local reset.

single_node_dev: bool

Single-node development mode — the only permitted node identity for destructive reset. Refused in production profile or DJOGI_ENV=production.

Seed

Run operator-authored SQL seed files in seeds/<database>/. Idempotent — re-runs skip seeds whose V1:<sha256> checksum matches the djogi_seed_runs ledger; refuses on checksum drift. Localhost-gated by default. Requires PostgreSQL 18 or later — exits with code 2 if the server is below the minimum. --database <name> selects BOTH the seed directory and the connection target. The CLI splices <name> into database.url’s path component so seeds always land on the matching DB; a malformed application URL refuses with exit code 1. Exit codes: 0 on success, 1 on error (config / network / SQL / checksum drift / malformed URL), 2 on gate refusal (non-localhost without --allow-non-localhost, below PG 18).

Fields

database: String

Database name whose seeds directory should be run. The runner walks seeds/<database>/*.sql in alphabetical order.

allow_non_localhost: bool

Allow seeds to run against a non-localhost database. The gate is lighter than db reset’s — useful for CI integration suites seeding a remote test database.

workspace: Option<PathBuf>

Workspace root override.

CleanupTestDbs

Drop orphaned djogi_test_<uuid> databases left over from crashed #[djogi_test] runs (SIGKILL / OOM / panic-after-spawn before teardown could fire). Triple-gated identical to db reset — localhost (override via --allow-non-localhost), non-production profile, explicit --yes (waived under --dry-run). Requires PostgreSQL 18 or later — exits with code 2 if the server is below the minimum. Exit codes: 0 on success, 1 on error (config / connect / SQL), 2 on gate refusal (non-localhost, production profile, missing --yes without --dry-run, below PG 18).

Fields

dry_run: bool

List candidates without dropping. Skips the --yes confirmation gate because no destructive side effect occurs.

yes: bool

Skip the --yes confirmation gate. Required for non-interactive invocations unless --dry-run is also set.

maintenance_database: String

Maintenance database to connect to. Defaults to postgres, the conventional administrative DB on every cluster. Override only when the cluster uses a different admin DB (e.g. AWS RDS uses rdsadmin).

allow_non_localhost: bool

Allow cleanup against a non-localhost cluster. Off by default — the gate matches db reset’s localhost requirement so destructive ops stay local unless the operator explicitly opts out.

workspace: Option<PathBuf>

Workspace root override.

Trait Implementations

impl FromArgMatches for DbCommand

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for DbCommand

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand