NDIF CLI

[MichaelRipa]

No description provided.

[JadenFiotto-Kaufman]

remove

[Butanium]

Issue: ndif info hangs when Ray is still initializing

Summary

ndif info can hang indefinitely when Ray is starting up but not yet fully ready to accept connections.

Symptoms

$ uv run ndif info
NDIF Session Information
============================================================
...
Quick Connectivity Check:
  ✓ Broker reachable at redis://localhost:6374
  ✓ Object store reachable at http://localhost:27018
  ✓ API reachable at http://localhost:5001
  ✓ Ray reachable at ray://localhost:10001
<hangs here, no "Ray Cluster Nodes:" output>

The command prints all info but never exits. Requires Ctrl+C to abort.

Root Cause

In cli/commands/info.py, the connectivity check flow is:

1. check_ray(ray_address) does a socket-level check — only verifies the port is listening (cli/lib/checks.py:116)
2. If the port is open, _show_ray_nodes(ray_address) is called
3. Inside _show_ray_nodes(), it calls ray.init(address=ray_address, ...) with no timeout

The problem: Ray's port can be open (listening) before the cluster is fully initialized. The socket check passes, but ray.init() blocks waiting for the cluster to be ready.

Suggested Fix

Add user feedback to _show_ray_nodes() (and maybe a timeout?):

def _show_ray_nodes(ray_address: str):
    """Show Ray cluster nodes."""
    import click
    try:
        import ray
        if not ray.is_initialized():
            click.echo()
            click.echo("Connecting to Ray cluster (this may take a moment if Ray is starting)...")
            ray.init(
                address=ray_address,
                ignore_reinit_error=True,
                logging_level="error",
                _timeout=10,
            )
        # ...
    except TimeoutError:
        click.echo("  Ray cluster is still initializing, skipping node info")
    except Exception:
        pass

Impact

• Low severity — only affects the info command, not core functionality
• Confusing UX when running ndif info shortly after ndif start

Workaround

Wait a few seconds after ndif start before running ndif info, or just wait for the command to complete (Ray finishes initializing).