Raxol.Adaptive.BehaviorTracker (Raxol v2.6.0)

Records pilot interactions as time-series events.

Captures pane focus dwell times, command frequency, alert response latency, and layout overrides. Computes windowed aggregates and notifies subscribers for downstream recommendation.

Summary

Types

aggregate()

behavior_event()

event_type()

t()

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

disable(server \\ __MODULE__)

enable(server \\ __MODULE__)

get_aggregates(server \\ __MODULE__, window_count \\ 5)

get_recent_events(server \\ __MODULE__, count \\ 20)

record(server \\ __MODULE__, event_type, data)

start_link(opts \\ [])

subscribe(server \\ __MODULE__)

Types

aggregate()

@type aggregate() :: %{
  window_start: integer(),
  pane_dwell_times: %{required(atom()) => float()},
  command_frequency: %{required(String.t()) => non_neg_integer()},
  avg_alert_response_ms: float(),
  most_used_panes: [atom()],
  least_used_panes: [atom()],
  scroll_frequency: %{required(atom()) => non_neg_integer()},
  scroll_velocity: %{required(atom()) => float()},
  takeover_duration_ms: %{required(atom()) => float()},
  layout_override_count: non_neg_integer(),
  command_concentration: %{required(atom()) => non_neg_integer()}
}

behavior_event()

@type behavior_event() :: %{timestamp: integer(), type: event_type(), data: map()}

event_type()

@type event_type() ::
  :pane_focus
  | :pane_dwell
  | :command_issued
  | :alert_response
  | :scroll_pattern
  | :takeover_start
  | :takeover_end
  | :layout_override

t()

@type t() :: %Raxol.Adaptive.BehaviorTracker{
  aggregate_ref: reference() | nil,
  aggregates: %{required(integer()) => aggregate()},
  buffer_size: pos_integer(),
  current_focus: atom() | nil,
  events: CircularBuffer.t(),
  session_id: binary() | nil,
  subscribers: MapSet.t(pid()),
  tracking_enabled: boolean(),
  window_size_ms: pos_integer()
}

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

disable(server \\ MODULE)

@spec disable(GenServer.server()) :: :ok

enable(server \\ MODULE)

@spec enable(GenServer.server()) :: :ok

get_aggregates(server \\ MODULE, window_count \\ 5)

@spec get_aggregates(GenServer.server(), pos_integer()) :: [aggregate()]

get_recent_events(server \\ MODULE, count \\ 20)

@spec get_recent_events(GenServer.server(), pos_integer()) :: [behavior_event()]

record(server \\ MODULE, event_type, data)

@spec record(GenServer.server(), event_type(), map()) :: :ok

start_link(opts \\ [])

@spec start_link(keyword()) :: GenServer.on_start()