feat: removal notice (#1226)

mshanemc · svc-cli-bot · jshackell-sfdc · web-flow · commit 78966a0b96e2 · 2024-06-26T09:21:44.000-05:00
* 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 &lt;63259011+jshackell-sfdc@users.noreply.github.com&gt;

---------

Co-authored-by: svc-cli-bot &lt;Svc_cli_bot@salesforce.com&gt;
Co-authored-by: Juliet Shackell &lt;63259011+jshackell-sfdc@users.noreply.github.com&gt;
diff --git a/README.md b/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
diff --git a/messages/cancel.md b/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.
diff --git a/messages/deploy.md b/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.
diff --git a/messages/md.cancel.md b/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.
diff --git a/messages/md.deploy.md b/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.
diff --git a/messages/md.deployreport.md b/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.
diff --git a/messages/md.retrieve.md b/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.
diff --git a/messages/pull.md b/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.
diff --git a/messages/push.md b/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.
diff --git a/messages/report.md b/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.
diff --git a/messages/retrieve.md b/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.
diff --git a/messages/status.md b/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.
diff --git a/package.json b/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": {
diff --git a/src/commands/force.ts b/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';
 
diff --git a/src/commands/force/mdapi/retrieve/report.ts b/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,

Original file line number	Diff line number	Diff line change
`@@ -36,4 +36,4 @@ The cancel command failed due to: %s`
`36`	`36`
`37`	`37`	`# deprecation`
`38`	`38`
`39`		`-We plan to deprecate this command in the future. Try using the "%s" command instead.`
	`39`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.`
Original file line number	Diff line number	Diff line change
`@@ -273,4 +273,4 @@ You requested an async deploy with code coverage or JUnit results. The reports w`
`273`	`273`
`274`	`274`	`# deprecation`
`275`	`275`
`276`		`-We plan to deprecate this command in the future. Try using the "%s" command instead.`
	`276`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.`
Original file line number	Diff line number	Diff line change
`@@ -197,4 +197,4 @@ You requested an async deploy with code coverage or JUnit results. The reports w`
`197`	`197`
`198`	`198`	`# deprecation`
`199`	`199`
`200`		`-We plan to deprecate this command in the future. Try using the "%s" command instead.`
	`200`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.`
Original file line number	Diff line number	Diff line change
`@@ -54,4 +54,4 @@ Using specified username %s.`
`54`	`54`
`55`	`55`	`# deprecation`
`56`	`56`
`57`		`-We plan to deprecate this command in the future. Try using the "%s" and "%s" pair instead.`
	`57`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" and "%s" pair instead.`
Original file line number	Diff line number	Diff line change
`@@ -117,4 +117,4 @@ If the retrieve request has completed, the retrieved metadata zip file will be w`
`117`	`117`
`118`	`118`	`# deprecation`
`119`	`119`
`120`		`-We plan to deprecate this command in the future. Try using the "%s" command instead.`
	`120`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.`
Original file line number	Diff line number	Diff line change
`@@ -62,4 +62,4 @@ Your retrieve request did not complete within the specified wait time [%s minute`
`62`	`62`
`63`	`63`	`# deprecation`
`64`	`64`
`65`		`-We plan to deprecate this command in the future. Try using the "%s" command instead.`
	`65`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.`
Original file line number	Diff line number	Diff line change
`@@ -50,4 +50,4 @@ Check the order of your dependencies and ensure all metadata is included.`
`50`	`50`
`51`	`51`	`# deprecation`
`52`	`52`
`53`		`-We plan to deprecate this command in the future. Try using the "%s" command instead.`
	`53`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" command instead.`
Original file line number	Diff line number	Diff line change
`@@ -50,4 +50,4 @@ The metadata deploy operation failed.`
`50`	`50`
`51`	`51`	`# deprecation`
`52`	`52`
`53`		`-We plan to deprecate this command in the future. Try using the "%s" and "%s" pair instead.`
	`53`	`+This command is deprecated and will be removed from Salesforce CLI on November 6, 2024. Use the "%s" and "%s" pair instead.`