Expand description
Lifecycle hook runtime contracts and orchestration primitives.
Structs§
- Hook
Defaults - Hook defaults applied when a hook spec omits optional limits.
- Hook
Engine - Resolves configured hooks for a lifecycle phase-event.
- Hook
Executor - Default hook executor implementation.
- Hook
Invocation Payload - Structured lifecycle payload sent to hook stdin as JSON.
- Hook
Mutation Config - Mutation settings for a hook.
- Hook
Payload Builder Input - Input contract for building hook invocation stdin payloads.
- Hook
Payload Context - Lifecycle context payload block.
- Hook
Payload Context Input - Mutable lifecycle context fields carried in hook stdin payloads.
- Hook
Payload Iteration - Iteration metadata payload block.
- Hook
Payload Loop - Loop metadata payload block.
- Hook
Payload Metadata - Mutable metadata payload block.
- Hook
RunRequest - Input contract for executing a single lifecycle hook command.
- Hook
RunResult - Structured outcome for one hook invocation.
- Hook
Spec - Hook specification for a single lifecycle event mapping.
- Hook
Stream Output - Captured hook stream output with truncation metadata.
- Hooks
Config - Hooks configuration.
- Resolved
Hook Spec - Hook spec with defaults materialized for runtime dispatch.
- Suspend
State Record - Durable suspend-state payload written when a hook yields
on_error: suspend. - Suspend
State Store - File-store for suspend/resume artifacts under a loop workspace.
Enums§
- Hook
Executor Error - Hook executor errors.
- Hook
OnError - Per-hook failure disposition.
- Hook
Phase Event - Supported lifecycle phase-event keys for v1 hooks.
- Hook
Suspend Mode - Suspend mode used for
on_error: suspend. - Suspend
Lifecycle State - Runtime lifecycle state persisted in
.ralph/suspend-state.json. - Suspend
State Store Error - Suspend-state store operations that can fail.
Constants§
- SUSPEND_
STATE_ SCHEMA_ VERSION - Current suspend-state schema version.
Traits§
- Hook
Executor Contract - Contract for executing one hook run request.