fix(retrieve): improve source-tracking err message (#882)

* fix(retrieve): improve source-tracking err message * chore: revert link-check change * Apply suggestions from code review Co-authored-by: Juliet Shackell <[email protected]> --------- Co-authored-by: Juliet Shackell <[email protected]>
salesforcecli · Jan 22, 2024 · e0aa271 · e0aa271
1 parent 4a291d4
commit e0aa271
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/messages/retrieve.start.md b/messages/retrieve.start.md
@@ -192,3 +192,14 @@ The retrieve target directory [%s] overlaps one of your package directories. Spe
 # wantsToRetrieveCustomFields
 
 Because you're retrieving one or more CustomFields, we're also retrieving the CustomObject to which it's associated.
+
+# noSourceTracking
+
+Unable to track changes in your source files.
+This command expects the org to support source tracking. If it doesn't, you must specify the metadata you want to retrieve. 
+
+# noSourceTracking.actions
+
+- Use  the `--source-dir`, `--manifest` or `--package-name` flags to retrieve metadata in source format.
+
+- Use the `--target-metadata-dir` flag to retrieve metadata in metadata format to a directory.
diff --git a/src/commands/project/retrieve/start.ts b/src/commands/project/retrieve/start.ts
@@ -359,6 +359,13 @@ const buildRetrieveAndDeleteTargets = async (
     !flags['package-name']?.length;
 
   if (isChanges) {
+    if (!(await flags['target-org'].supportsSourceTracking())) {
+      throw new SfError(
+        messages.getMessage('noSourceTracking'),
+        'noSourceTracking',
+        messages.getMessages('noSourceTracking.actions')
+      );
+    }
     const stl = await SourceTracking.create({
       org: flags['target-org'],
       project: await SfProject.resolve(),