Cyclium.Mode (Cyclium v0.1.14)

Runtime mode management for cyclium nodes.

Controls whether episodes execute locally (:full) or are deferred to a trigger request table for another node to pick up (:trigger_only).

Supports both node-wide mode and per-actor overrides, switchable at runtime without restart.

Node-wide mode

Cyclium.Mode.set(:trigger_only)
Cyclium.Mode.set(:full)

Per-actor overrides

Cyclium.Mode.set_actor_override(:client_health, :trigger_only)
Cyclium.Mode.clear_actor_override(:client_health)
Cyclium.Mode.clear_all_overrides()

Querying

Cyclium.Mode.current()                      # node-wide mode
Cyclium.Mode.effective(:client_health)       # per-actor, falls back to node
Cyclium.Mode.runner_for(:client_health)      # resolved runner module
Cyclium.Mode.overrides()                     # all active overrides

Reads are ETS-backed for zero-cost lookups in hot paths (actor event handling).

Summary

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

clear_actor_override(actor_id)

Clears a per-actor override, falling back to node-wide mode.

clear_all_overrides()

Clears all per-actor overrides.

current()

Returns the node-wide mode.

default_runner()

Returns the default runner based on node-wide mode (for non-actor contexts).

effective(actor_id)

Returns the effective mode for a specific actor (override or node-wide).

overrides()

Returns all active per-actor overrides.

runner_for(actor_id)

Returns the runner module for the given actor based on effective mode.

set(mode)

Sets the node-wide mode at runtime.

set_actor_override(actor_id, mode)

Sets a mode override for a specific actor.

start_link(opts \\ [])

status()

Returns a summary of the current mode state.