cyclium

defmodule Cyclium.Expectation do
  @moduledoc """
  Declarative configuration for a single expectation.

  Expectations are defined in code via the Actor DSL, not stored in the database.
  """

  @type t :: %__MODULE__{
          id: atom(),
          actor_id: atom(),
          domain: atom(),
          trigger: tuple() | atom() | [tuple() | atom()],
          subscribes_to: [binary()],
          filter: map(),
          debounce_ms: non_neg_integer() | nil,
          cooldown_ms: non_neg_integer() | nil,
          subject_key: atom() | nil,
          resources: [map()],
          outputs: [atom()],
          budget: map(),
          log_strategy: atom(),
          audit_level: atom(),
          retention_days: non_neg_integer() | nil,
          description: binary(),
          strategy: module() | nil,
          synthesizer: module() | nil,
          strategy_config: map() | nil,
          recovery_policy: :fail | :restart,
          window: Cyclium.Window.window_size() | nil,
          dry_run: keyword() | nil,
          sample_rate: float() | nil,
          circuit_breaker: map() | nil,
          adaptive_budget: boolean(),
          service_levels: map() | nil,
          finding_enrichment: (map(), map() -> {:ok, map()} | :skip) | {module(), atom()} | nil,
          escalation_rules: map() | nil,
          finding_ttl_seconds: pos_integer() | nil,
          loop_detection: boolean()
        }

  defstruct [
    :id,
    :actor_id,
    :domain,
    :trigger,
    :strategy,
    :synthesizer,
    :strategy_config,
    subscribes_to: [],
    filter: %{},
    debounce_ms: nil,
    cooldown_ms: nil,
    subject_key: nil,
    resources: [],
    outputs: [],
    budget: %{max_turns: 12, max_tokens: 25_000, max_wall_ms: 120_000},
    log_strategy: :timeline,
    audit_level: :standard,
    retention_days: 90,
    description: "",
    recovery_policy: :fail,
    window: nil,
    dry_run: nil,
    sample_rate: nil,
    circuit_breaker: nil,
    adaptive_budget: false,
    service_levels: nil,
    finding_enrichment: nil,
    escalation_rules: nil,
    finding_ttl_seconds: nil,
    loop_detection: true
  ]
end