Enum EnvVerb 

pub enum EnvVerb {
    Init(EnvInitArgs),
    Apply(EnvApplyArgs),
    Create(EnvCreateArgs),
    Update(EnvUpdateArgs),
    SetPublicUrl(EnvSetPublicUrlArgs),
    List,
    Show {
        env_id: String,
    },
    Doctor {
        env_id: String,
    },
    ToolCheck {
        env_id: String,
    },
    Render(EnvRenderArgs),
    Reconcile(EnvReconcileArgs),
    ApplyRevision(EnvApplyRevisionArgs),
    ApplyTraffic(EnvApplyTrafficArgs),
    Destroy {
        env_id: String,
        confirm: bool,
    },
    MigrateDev {
        target: String,
        check: bool,
        apply: bool,
    },
    MigrateState {
        target: String,
        check: bool,
        apply: bool,
        state_dir: Option<PathBuf>,
    },
}

Variants

Init(EnvInitArgs)

Idempotent bootstrap of the local environment with the five default env-pack bindings (A4 helper exposed as a CLI verb). Creates the env if missing, fills in any missing default bindings on an existing env, or reports untouched if the env is already complete. User-bound non-default descriptors are NEVER overwritten.

Apply(EnvApplyArgs)

Declarative, upsert-only environment apply. Reads a greentic.env-manifest.v1 document via --answers <PATH> and reconciles the env toward it: validate → diff → plan → execute → verify. Re-running an unchanged manifest is a visible no-op. --dry-run previews the plan; --check is the CI gate (exit 1 on pending diff).

Create(EnvCreateArgs)

Update(EnvUpdateArgs)

SetPublicUrl(EnvSetPublicUrlArgs)

op env set-public-url <env_id> <URL>. Replaces the env’s persisted host_config.public_base_url. Equivalent to op config set --public-url <URL> but easier to discover for the common “I set the URL once and forget it” path.

List

Show

Fields

env_id: String

Doctor

Fields

env_id: String

ToolCheck

Run per-binding tool preflight. Resolves each env-pack binding via the registry and invokes its handler’s preflight() to check external tools (binary presence, version, auth, scope) needed for real work. The built-in local handlers report no external tools.

Fields

env_id: String

Render(EnvRenderArgs)

Render the env’s declarative desired state through the deployer env-pack’s manifest renderer, without applying anything (plan §6 step 10). With --output writes one YAML file per object in apply order; otherwise embeds the manifests in the JSON outcome.

Reconcile(EnvReconcileArgs)

Apply the env’s declarative desired state to its live cluster and prune the workers of revisions no longer present (the apply-side counterpart of render). K8s deployer env-pack only today; connects through the binding’s kubeconfig_context answer.

ApplyRevision(EnvApplyRevisionArgs)

Bring a SINGLE revision’s worker resources into agreement with its recorded lifecycle (present → apply the worker pair, absent → tear it down) — the surgical counterpart of reconcile. K8s deployer env-pack only today; connects through the binding’s kubeconfig_context answer.

ApplyTraffic(EnvApplyTrafficArgs)

Push one deployment’s recorded traffic split to its live ALB listener (the routing-side counterpart of apply-revision). AWS-ECS deployer env-pack only — K8s serves splits from its in-process runtime router, so op traffic set alone suffices there. The split itself is recorded by op traffic set; this verb makes it observable in the live runtime.

Routing depends on the binding’s ALB routing answers. With a routing condition set (alb_routing_host / alb_routing_path), this writes a per-deployment listener RULE keyed by that host/path, leaving the default action and sibling deployments’ rules intact — deployments coexist behind one listener. With NO routing condition, it falls back to REPLACING the listener’s default action, which assumes the alb_listener_arn is DEDICATED to this one deployment (a split then clobbers any sibling routing / auth / redirect on that listener).

Destroy

Fields

env_id: String

confirm: bool

MigrateDev

Migrate the legacy dev environment to <target> (typically local). Run with --check to scan without touching state; --apply performs the one-shot rewrite only when the check is clean (A4b).

Fields

target: String

Target env id — typically local.

check: bool

Scan for blocking findings and report; do not touch state.

apply: bool

Re-run the check; if clean, perform the migration.

MigrateState

Archive the legacy <state_dir>/deploy/ artifact tree (A6). --apply renames it to a hidden .deploy-migrated-<ts>/ sentinel; contents are NOT copied into the new layout. Quiesce live deploys first — apply::run does not participate in the migration lock.

Fields

target: String

Target env id — must exist in EnvironmentStore.

check: bool

Scan for blocking findings and report; do not touch state.

apply: bool

Re-run the check; if clean, rename the legacy tree.

state_dir: Option<PathBuf>

Override the legacy state-dir root. Defaults to $HOME/.greentic/state.

Trait Implementations

impl Debug for EnvVerb

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for EnvVerb

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 EnvVerb

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