warn if outdated

Author: clavery

.changeset/add-update-warning.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-cli': patch
+---
+
+Add update notifications that warn users when a newer version of the CLI is available

docs/cli/index.md

@@ -27,6 +27,12 @@ These flags are available on all commands that interact with B2C instances:
 | `--username`, `-u` | `SFCC_USERNAME` | Username for Basic Auth |
 | `--password`, `-p` | `SFCC_PASSWORD` | Password/access key for Basic Auth |
 
+### Other Environment Variables
+
+| Environment Variable | Description |
+|---------------------|-------------|
+| `B2C_SKIP_NEW_VERSION_CHECK` | Skip the new version availability check |
+
 ## Command Topics
 
 ### Instance Operations

packages/b2c-cli/package.json

@@ -19,6 +19,7 @@
     "@oclif/plugin-not-found": "^3",
     "@oclif/plugin-plugins": "^5",
     "@oclif/plugin-version": "^2",
+    "@oclif/plugin-warn-if-update-available": "^3",
     "@salesforce/b2c-tooling-sdk": "workspace:*",
     "cliui": "^9.0.1",
     "marked": "^15.0.0",
@@ -82,8 +83,14 @@
       "@oclif/plugin-plugins",
       "@oclif/plugin-not-found",
       "@oclif/plugin-version",
-      "@oclif/plugin-autocomplete"
+      "@oclif/plugin-autocomplete",
+      "@oclif/plugin-warn-if-update-available"
     ],
+    "warn-if-update-available": {
+      "timeoutInDays": 1,
+      "frequency": 1,
+      "frequencyUnit": "minutes"
+    },
     "topicSeparator": " ",
     "topics": {
       "auth": {