feat(framework): Mention superlink to login against upon an authentication error

[jafermarq]

Before it response said plainly "do flwr login" w/o specifying the SuperLinkConnection name:

uv run --python=3.11.14 --all-extras --all-groups flwr ls supergrid
Using SuperLink: supergrid (supergrid.flower.ai)
📄 Listing all runs...
╭─ Error ──────────────────────────────────────────────────────────────────────────────────────╮
│ Authentication failed. Please run `flwr login` to authenticate and try again.                │
╰──────────────────────────────────────────────────────────────────────────────────────────────╯

Now, it indicates which one to use (based on the command that triggered it: in this example flwr ls):

uv run --python=3.11.14 --all-extras --all-groups flwr ls supergrid
Using SuperLink: supergrid (supergrid.flower.ai)
📄 Listing all runs...
╭─ Error ──────────────────────────────────────────────────────────────────────────────────────╮
│ Authentication failed. Please run `flwr login supergrid` to authenticate and try again.      │
╰──────────────────────────────────────────────────────────────────────────────────────────────╯

[Copilot]

Pull request overview

This PR improves the CLI UX for authentication failures by suggesting the specific SuperLink connection name to pass to flwr login, based on the command context (e.g., flwr ls supergrid → flwr login supergrid).

Changes:

• Update flwr_cli_grpc_exc_handler to include the relevant SuperLink name in UNAUTHENTICATED error guidance.
• Add a unit test to ensure the suggested login command includes the connection name.

Critical issues

• The new use of click.get_current_context() in the gRPC exception handler can raise RuntimeError if the handler is executed outside an active Click/Typer context, masking the original UNAUTHENTICATED error. Additionally, calling read_superlink_connection() in the error handler can raise ClickException (e.g., missing default config), replacing the intended authentication guidance.

Simplicity/readability suggestions

• None beyond addressing the critical issue above.

Consistency concerns

• None identified.

Whether the PR should be split

• No.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
framework/py/flwr/cli/utils.py	Include SuperLink connection name in the UNAUTHENTICATED login suggestion.
framework/py/flwr/cli/utils_test.py	Add coverage for UNAUTHENTICATED gRPC error messaging including connection name.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.