Hooks

View as Markdown

Rudel exposes hooks around sandbox lifecycle events.

Common hook groups include:

  • sandbox create, update, destroy
  • snapshot and restore
  • cleanup and expiry reporting
  • Git push and worktree operations

Example

PHP
add_action(
    'rudel_after_environment_create',
    function ( \Rudel\Environment $environment ): void {
        error_log( 'Created Rudel environment ' . $environment->id );
    }
);

Hook payloads use Rudel models and arrays. Prefer the documented public API over reaching into command classes.

Filters

Filters are intended for policy adjustment, not for replacing Rudel's storage model.

Runtime identity, table prefixes, and worktree metadata remain DB-backed Rudel state.