feat: removal notice (#1226)

* feat: deprecation date notice

* docs: message update

* chore(release): 3.4.9-demo.0 [skip ci]

* docs: suggestions from code review

Co-authored-by: Juliet Shackell <[email protected]>

---------

Co-authored-by: svc-cli-bot <[email protected]>
Co-authored-by: Juliet Shackell <[email protected]>

Author: 3 people

README.md

@@ -75,7 +75,7 @@ $ npm install -g @salesforce/plugin-source
 $ sfdx COMMAND
 running command...
 $ sfdx (--version)
-@salesforce/plugin-source/3.4.8 linux-x64 node-v18.20.3
+@salesforce/plugin-source/3.4.9-demo.0 linux-x64 node-v18.20.3
 $ sfdx --help [COMMAND]
 USAGE
   $ sfdx COMMAND

messages/cancel.md

@@ -36,4 +36,4 @@ The cancel command failed due to: %s
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/deploy.md

@@ -273,4 +273,4 @@ You requested an async deploy with code coverage or JUnit results. The reports w
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/md.cancel.md

@@ -36,4 +36,4 @@ The cancel command failed due to: %s.
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/md.deploy.md

@@ -197,4 +197,4 @@ You requested an async deploy with code coverage or JUnit results. The reports w
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/md.deployreport.md

@@ -54,4 +54,4 @@ Using specified username %s.
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" and "%s" pair instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" and "%s" pair instead.

messages/md.retrieve.md

@@ -117,4 +117,4 @@ If the retrieve request has completed, the retrieved metadata zip file will be w
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/pull.md

@@ -62,4 +62,4 @@ Your retrieve request did not complete within the specified wait time [%s minute
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/push.md

@@ -50,4 +50,4 @@ Check the order of your dependencies and ensure all metadata is included.
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/report.md

@@ -50,4 +50,4 @@ The metadata deploy operation failed.
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" and "%s" pair instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" and "%s" pair instead.

messages/retrieve.md

@@ -193,4 +193,4 @@ The retrieve target directory [%s] overlaps one of your package directories. Spe
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

messages/status.md

@@ -34,4 +34,4 @@ No local or remote changes found.
 
 # deprecation
 
-We plan to deprecate this command in the future. Try using the "%s" command instead.
+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-source",
   "description": "Commands to interact with source formatted metadata",
-  "version": "3.4.8",
+  "version": "3.4.9-demo.0",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {

src/commands/force.ts

@@ -74,6 +74,10 @@ export type ForceCommandResult = { apiVersion: string };
 export class ForceCommand extends SfCommand<ForceCommandResult> {
   public static readonly hidden = true;
   public static readonly examples = [];
+  public static state = 'deprecated';
+  public static readonly deprecationOptions = {
+    message: 'Use "org display" to see the API version of any org.',
+  };
   // eslint-disable-next-line sf-plugin/no-hardcoded-messages-commands
   public static readonly summary = 'Display the ASCII art logo for the Salesforce CLI';
 

src/commands/force/mdapi/retrieve/report.ts

@@ -33,6 +33,10 @@ export class Report extends SourceCommand {
   public static readonly description = messages.getMessage('report.description');
   public static readonly examples = messages.getMessages('report.examples');
   public static readonly state = 'deprecated';
+  public static readonly deprecationOptions = {
+    to: 'project retrieve report',
+    message: messages.getMessage('deprecation', ['project retrieve report']),
+  };
   public static readonly hidden = true;
   public static readonly flags = {
     'api-version': orgApiVersionFlagWithDeprecations,