@spec close(t()) :: :ok

@spec open(Path.t(), Keyword.t()) :: t()

@spec restore_write_to_terminal(t()) :: t()

@spec rotate(t()) :: t()

@spec set_write_to_terminal(
  t(),
  boolean()
) :: t()

@spec write(
  t(),
  AntikytheraCore.GearLog.Message.t()
) :: {:kept_open | :rotated, t()}