Deprecate apollo-cli (#5983)

* Deprecate Apollo CLI

* update migration guide

* Update docs/source/migration/4.0.mdx

Co-authored-by: Benoit 'BoD' Lubek <[email protected]>

---------

Co-authored-by: Benoit 'BoD' Lubek <[email protected]>

Author: martinbonnin

docs/source/migration/4.0.mdx

@@ -196,7 +196,43 @@ val call = client.query(MyQuery())
 
 `HttpEngine` now implements `Closeable` and has its `dispose` method renamed to `close`. If you have a custom `HttpEngine`, you need to implement `close` instead of `dispose`.
 
-## Apollo Gradle Plugin
+
+## Maven artifacts reorganization
+
+Over the years, a lot of support functionality was added alongside `apollo-api` and `apollo-runtime`. While useful, most of this functionality doesn't share the same level of stability and maturity as the main artifacts and bundling them did not make much sense.
+
+Moving forward, some artifacts are released separately and have new Maven coordinates, GitHub repositories and package names. Others are deprecated.
+
+For the initial v4 release, all the artifacts are kept with deprecation warnings. They will be removed in the future.
+
+The artifacts are:
+
+* apollo-mockserver
+    * MockServer was born out of our own internal needs for a KMP-ready mockserver. Most of its public API is subject to change, and it has been moved to a separate repository.
+* apollo-cli-incubating
+    * The Apollo CLI contract is subject to change and it has been moved to a separate repository.
+* apollo-rx-support
+    * The RxJava{2-3} artifacts are very thin wrappers around kotlinx-coroutines-rx{2-3} and we recommend using those instead.
+* apollo-idling-resource
+    * ApolloIdlingResource is deprecated. We recommend using reactive patterns to test your UI instead. See [this article about ways to do so](https://medium.com/androiddevelopers/alternatives-to-idling-resources-in-compose-tests-8ae71f9fc473) for more details.
+
+### Summary
+
+| Old coordinates                                  | New coordinates                                | New Repository                                            |
+|--------------------------------------------------|------------------------------------------------|:----------------------------------------------------------|
+| com.apollographql.apollo3:apollo-mockserver      | com.apollographql.mockserver:apollo-mockserver | https://github.com/apollographql/apollo-kotlin-mockserver |
+| com.apollographql.apollo3:apollo-cli-incubating  | com.apollographql.mockserver:apollo-cli        | https://github.com/apollographql/apollo-kotlin-cli        |
+| com.apollographql.apollo3:apollo-idling-resource | Deprecated                                     | Deprecated                                                |
+| com.apollographql.apollo3:apollo-rx2-support     | Deprecated                                     | Deprecated                                                |
+| com.apollographql.apollo3:apollo-rx3-support     | Deprecated                                     | Deprecated                                                |
+
+
+| Old package name                     | New package name             |
+|--------------------------------------|------------------------------|
+| com.apollographql.apollo3.mockserver | com.apollographql.mockserver |
+| com.apollographql.apollo3.cli        | com.apollographql.cli        |
+
+## Gradle Plugin
 
 ### Multi-module `dependsOn`
 
@@ -617,37 +653,7 @@ apolloClient.query().rxSingle()
 apolloClient.query().toFlow().asFlowable().firstOrError()
 ```
 
-## New Maven coordinates for some artifacts
-
-Over the years, a lot of support functionality was added alongside `apollo-runtime`. While useful, most of this functionality doesn't share the same level of stability and bundling the release does not make much sense.
-
-Moving forward, `apollo-mockserver` is released separately.
-
-Replace maven coordinates: 
-
-```kotlin
-dependencies {
-  // Replace
-  testImplementation("com.apollographql.apollo3:apollo-mockserver:$apolloVersion")
-  
-  // With
-  testImplementation("com.apollographql.mockserver:apollo-mockserver:$mockServerVersion")
-}
-```
-
-And the package names:
-
-```kotlin
-// Replace
-import com.apollographql.apollo3.mockserver
-
-// With
-import com.apollographql.mockserver
-```
-
-## ApolloIdlingResource is deprecated
 
-We recommend using reactive patterns to test your UI instead. See [this article about ways to do so](https://medium.com/androiddevelopers/alternatives-to-idling-resources-in-compose-tests-8ae71f9fc473).
 
 ## Example of a migration
 

libraries/apollo-cli-incubating/src/main/kotlin/com/apollographql/apollo3/cli/Main.kt

@@ -1,5 +1,6 @@
 package com.apollographql.apollo3.cli
 
+import com.apollographql.apollo3.annotations.ApolloDeprecatedSince
 import com.github.ajalt.clikt.core.CliktCommand
 import com.github.ajalt.clikt.core.PrintCompletionMessage
 import com.github.ajalt.clikt.core.subcommands
@@ -50,6 +51,8 @@ private class PlaceHolderCommand : CliktCommand(name = "placeholder") {
   }
 }
 
+@Deprecated("The Apollo CLI has new maven coordinates at 'com.apollographql.cli:apollo-cli. See https://go.apollo.dev/ak-4-migration-guide for more details.")
+@ApolloDeprecatedSince(ApolloDeprecatedSince.Version.v4_0_0)
 fun main(args: Array<String>) {
   MainCommand("apollo-cli")
       .subcommands(MyCompletionCommand())