@spec connect(keyword()) :: [node()]

Sets up adb tunnels (idempotent) and connects to all running device nodes.

Returns list of connected node atoms.

Options

• :cookie - Erlang cookie (default: :dala_secret)
• :device - Target specific device by ID (optional)

@spec push_all([node()]) :: {non_neg_integer(), list()}

Pushes all compiled BEAM files from _build/dev/lib/*/ebin/ to nodes.

Only pushes BEAMs for runtime dependencies — deps marked only: :dev or runtime: false in mix.exs (and their transitive deps) are excluded. This prevents dev tooling (dala_dev, Bandit, Phoenix, etc.) from being pushed to the device when using path: deps during local framework development.

Returns {pushed_count, failed_list}.

@spec push_all_to_device(
  String.t(),
  keyword()
) :: {non_neg_integer(), list()}

Pushes all compiled BEAM files to devices specified by ID.

Convenience function that combines connect/1 and push_all/1.

@spec push_changed([node()], %{required(String.t()) => non_neg_integer()}) ::
  {non_neg_integer(), list()}

Pushes BEAM files that changed since snapshot (from snapshot_beams/0). Returns {pushed_count, failed_list} — pushed_count is 0 if nothing changed.

@spec runtime_beam_dirs() :: [String.t()]

Returns ebin directories for runtime deps only (no dev-only tooling). Used by Deployer so the filesystem push matches the dist push scope.

@spec snapshot_beams() :: %{required(String.t()) => non_neg_integer()}

Takes a snapshot of current BEAM mtimes for runtime deps only. Pass the result to push_changed/2 before and after compiling to get only the modules that actually changed.