beam_weaver

defmodule BeamWeaver.Diagnostics do
  @moduledoc """
  Runtime diagnostics.

  This is the Elixir-native counterpart to LangChain's runtime environment and
  sys-info helpers. It returns plain data for callers and only prints when
  explicitly asked.
  """

  @doc """
  Returns BeamWeaver and VM runtime metadata.
  """
  @spec runtime_environment() :: map()
  def runtime_environment do
    %{
      "beam_weaver_version" => Application.spec(:beam_weaver, :vsn) |> to_string(),
      "elixir_version" => System.version(),
      "otp_release" => System.otp_release(),
      "erts_version" => :erlang.system_info(:version) |> to_string(),
      "system_architecture" => :erlang.system_info(:system_architecture) |> to_string(),
      "schedulers" => System.schedulers_online()
    }
  end

  @doc """
  Prints runtime diagnostics in a deterministic order.
  """
  @spec print_sys_info(keyword()) :: :ok
  def print_sys_info(opts \\ []) do
    output = Keyword.get(opts, :output, &IO.puts/1)

    runtime_environment()
    |> Enum.sort_by(fn {key, _value} -> key end)
    |> Enum.each(fn {key, value} -> output.("#{key}: #{value}") end)
  end
end