Improve deprecation warnings

[dhruvmanila]

Summary

Related: astral-sh/ruff-lsp#522

Test Plan

1. User explicitly sets native server "on" with legacy settings

settings.json:

{
	"ruff.nativeServer": "on",
	"ruff.lint.args": []
}

Logs:

2025-02-10 10:47:34.157 [warning] Following settings have been deprecated in the native server: ["ruff.lint.args"]. Please [migrate](https://docs.astral.sh/ruff/editors/migration/) to the new settings or remove them. Feel free to comment on the [GitHub discussion](https://github.com/astral-sh/ruff/discussions/15991) to ask questions or share feedback.

Notification:

2. User explicitly sets native server "off" with no legacy settings

settings.json:

{
	"ruff.nativeServer": "off"
}

Logs:

2025-02-10 10:49:26.272 [warning] Legacy server ([ruff-lsp](https://github.com/astral-sh/ruff-lsp)) has been deprecated. Please consider using the native server instead by removing 'ruff.nativeServer' or setting it to 'on'. Feel free to comment on the [GitHub discussion](https://github.com/astral-sh/ruff/discussions/15991) to ask questions or share feedback.

Notification:

3. User explicitly sets native server "off" with legacy settings

settings.json:

{
	"ruff.nativeServer": "off",
	"ruff.lint.args": []
}

Logs:

2025-02-10 10:50:44.897 [warning] Legacy server ([ruff-lsp](https://github.com/astral-sh/ruff-lsp)) has been deprecated. Please consider using the native server instead by removing 'ruff.nativeServer' or setting it to 'on'. Following settings are not supported with the native server and have been deprecated: ["ruff.lint.args"]. Please [migrate](https://docs.astral.sh/ruff/editors/migration/) to the new settings or remove them. Feel free to comment on the [GitHub discussion](https://github.com/astral-sh/ruff/discussions/15991) to ask questions or share feedback.

Notification:

4. Auto behavior with legacy settings

settings.json:

{
	"ruff.nativeServer": "auto",
	"ruff.lint.args": []
}

Logs:

2025-02-10 10:52:07.449 [warning] Legacy server ([ruff-lsp](https://github.com/astral-sh/ruff-lsp)) has been deprecated. Please consider using the native server instead by setting 'ruff.nativeServer' to 'on'. Following settings are not supported with the native server and have been deprecated: ["ruff.lint.args"]. Please [migrate](https://docs.astral.sh/ruff/editors/migration/) to the new settings or remove them. Feel free to comment on the [GitHub discussion](https://github.com/astral-sh/ruff/discussions/15991) to ask questions or share feedback.

Notification:

5. Auto behavior with non-stable ruff server

Same as (4) with Ruff 0.5.2 installed. The notification message is the same except that the logs include an additional mesage:

2025-02-10 11:22:56.654 [info] Stable version of the native server requires Ruff 0.5.3, but found 0.5.2 at /Users/dhruv/.local/bin/ruff instead
2025-02-10 11:22:56.654 [warning] Legacy server ([ruff-lsp](https://github.com/astral-sh/ruff-lsp)) has been deprecated. Please consider using the native server instead by setting 'ruff.nativeServer' to 'on'. Following settings are not supported with the native server and have been deprecated: ["ruff.lint.args"]. Please [migrate](https://docs.astral.sh/ruff/editors/migration/) to the new settings or remove them. Feel free to comment on the [GitHub discussion](https://github.com/astral-sh/ruff/discussions/15991) to ask questions or share feedback.

6. Auto behavior with Ruff without the server command

This uses Ruff 0.3.4 and will first provide a warning message same as (4) and when the user sets nativeServer to on, they'll get an error:

[dhruvmanila]

I'm a bit unsure on the flow of (5) and (6), any suggestions are appreciated.

[MichaReiser]

For 4: I find it a bit confusing that we suggest setting to on nativeServer: on when it is sufficient for them to migrate the settings. Requiring explicitly setting nativeServer: on does have the downside that many users never set nativeServer: auto, it's just the default (or did we change the default)?

For 5: I'm unsure what the info message is trying to tell me. Does it mean I have to upgrade to use the native server or is it only a hint that I'd be using an experimental version if I keep using the older version?

6 doesn't seem ideal but it's also not terrible. Maybe we could add a note to the migration guide that using the native server requires at least Ruff 0.3.5 to give users a heads up?

[dhruvmanila]

Thank you for the feedback.

For 4: I find it a bit confusing that we suggest setting to on nativeServer: on when it is sufficient for them to migrate the settings. Requiring explicitly setting nativeServer: on does have the downside that many users never set nativeServer: auto, it's just the default (or did we change the default)?

Yes, "auto" is the default value. I'll remove the nativeServer: on suggestion.

For 5: I'm unsure what the info message is trying to tell me. Does it mean I have to upgrade to use the native server or is it only a hint that I'd be using an experimental version if I keep using the older version?

That message already existed, but I think I can improve it:

Stable version of the native server requires Ruff 0.5.3, but found 0.5.2 at /Users/dhruv/.local/bin/ruff instead; using the legacy server (ruff-lsp)

Note that there's also this info message that'll be present so overall it says that the auto behavior found the Ruff version which does not include stable server so will use ruff-lsp instead:

Resolved 'ruff.nativeServer: auto' to use the legacy (ruff-lsp) server

6 doesn't seem ideal but it's also not terrible. Maybe we could add a note to the migration guide that using the native server requires at least Ruff 0.3.5 to give users a heads up?

Yeah, that makes sense.