fix: update version recommendation logic

Author: maliroteh-sf

package.json

@@ -219,11 +219,13 @@
     }
   },
   "apiVersionMetadata": {
-    "comment": "Refer to ApiVersionMetadata in orgUtils.ts for details",
+    "comment1": "Refer to ApiVersionMetadata in orgUtils.ts for more details.",
+    "comment2": "target section defines the dev server version (matchingDevServerVersion) and the API version that it can support (versionNumber).",
     "target": {
       "versionNumber": "64.0",
       "matchingDevServerVersion": "~11.5.0"
     },
+    "comment3": "versionToTagMappings section defines the mapping between released tags for our CLI plugin and the org version that each tag supports.",
     "versionToTagMappings": [
       {
         "versionNumber": "62.0",

src/shared/orgUtils.ts

@@ -177,8 +177,9 @@ export class OrgUtils {
 
     if (Version.same(orgVersion, targetVersion) === false) {
       let errorMessage = messages.getMessage('error.org.api-mismatch.message', [orgVersion, targetVersion]);
+      // Find the tag (if any) that can support this org version
       const tagName = pkg.apiVersionMetadata.versionToTagMappings.find(
-        (info) => info.versionNumber === targetVersion
+        (info) => info.versionNumber === orgVersion
       )?.tagName;
       if (tagName) {
         const remediation = messages.getMessage('error.org.api-mismatch.remediation', [