Saxonberg Server API
    Preparing search index...

    Variable COMMAND_PHASESConst

    COMMAND_PHASES: readonly [
        "focus-update",
        "validate",
        "confirm-prompt",
        "dispatch",
        "emit-scene",
    ] = ...

    Names of the lifecycle phases an option's effects: can target.

    Implementation status:

    • focus-update — hookable. Per-arg focus chain push/replace fires inside the arg-resolution loop. skip is honored.
    • dispatch — placeholder. Controller execution. replace handlers (deferred-dispatch, explain-plan) throw at run time until the substrate lands.
    • validate, confirm-prompt, emit-scene — placeholders. Schema validates against the name; the dispatcher throws if a player command actually triggers a phase that hasn't been made hookable yet (e.g. --force reaching the unimplemented confirm-prompt phase).

    Adding a phase to this list documents new vocabulary; the dispatcher only honors effects against phases its code path has actually instrumented.