Crate bamboo_hooks 

Lifecycle hook registry and configured handler runtimes.

The agent engine owns lifecycle seams and applies returned decisions. This crate owns handler matching, deterministic dispatch, command execution, and external script runtime selection.

Structs

HookDispatchReport

Complete dispatch result for one lifecycle seam.

HookDispatcher

Registry and deterministic dispatcher for programmatic and configured hooks.

HookExecution

One completed handler execution, returned to the engine for observability.

HookRunOutcome

Aggregate control and context output from one lifecycle seam.

LifecycleHookTestOutput

Raw handler result returned by the settings dry-run endpoint.

ScriptHook

One config-driven lifecycle script executed by an installed system runtime.

ShellCommandHook

One config-driven lifecycle shell command.

Enums

LifecycleHookEvent

User-facing lifecycle events that currently map to engine hook seams.

LifecycleScriptRunner

Runtime used to execute a lifecycle script.

Functions

test_lifecycle_handler

Execute one configured handler against a deterministic synthetic payload. Production runtime limits and output caps are preserved, while result interpretation is skipped so callers receive raw diagnostics.

test_lifecycle_shell_command

Backward-compatible command-only dry-run entry point.

Type Aliases

ShellHookEvent

Backward-compatible name retained for SDK consumers.

ShellHookTestOutput

Backward-compatible name for the command-only dry-run response.