feat: convert project to use a new source behavior

.github/workflows/test.yml

@@ -12,10 +12,10 @@ jobs:
     needs: yarn-lockfile-check
     uses: salesforcecli/github-workflows/.github/workflows/unitTestsLinux.yml@main
   windows-unit-tests:
-    needs: linux-unit-tests
+    # needs: linux-unit-tests
     uses: salesforcecli/github-workflows/.github/workflows/unitTestsWindows.yml@main
   nuts:
-    needs: linux-unit-tests
+    # needs: linux-unit-tests
     uses: salesforcecli/github-workflows/.github/workflows/nut.yml@main
     secrets: inherit
     strategy:

command-snapshot.json

@@ -36,6 +36,14 @@
     ],
     "plugin": "@salesforce/plugin-deploy-retrieve"
   },
+  {
+    "alias": [],
+    "command": "project:convert:source-behavior",
+    "flagAliases": [],
+    "flagChars": ["o", "p"],
+    "flags": ["behavior", "dry-run", "flags-dir", "json", "preserve-temp-dir", "target-org"],
+    "plugin": "@salesforce/plugin-deploy-retrieve"
+  },
   {
     "alias": ["force:source:delete"],
     "command": "project:delete:source",

messages/convert.source-behavior.md

@@ -0,0 +1,60 @@
+# summary
+
+Enable a sourceBehaviorOption in sfdx-project.json and update your project source to use it.
+
+# description
+
+Makes local changes to your project based on the chosen sourceBehaviorOption.
+
+# flags.behavior.summary
+
+Which sourceBehaviorOption to enable.
+
+# examples
+
+- Switch the project to use decomposed custom labels
+  <%= config.bin %> <%= command.id %> --behavior DecomposeCustomLabels
+
+- Without changing any existing files, see what the command would have produced.
+  <%= config.bin %> <%= command.id %> --behavior DecomposeCustomLabels --dry-run
+
+# flags.dry-run.summary
+
+Explain what the command would do.
+
+# flags.dry-run.description
+
+Doesn't modify existing files. Lists files that would be deleted, explains modifications to sfdx-project.json, and outputs the resulting modifications to a new folder for review.
+
+# flags.preserve-temp-dir.summary
+
+Don't delete the metadata API format temp dir that this command creates. Useful for debugging.
+
+# error.trackingNotSupported
+
+The project has a target-org that uses source tracking. This operation will cause changes to the local project that can't be properly tracked.
+
+# error.trackingNotSupported.actions
+
+- Get any changes or data you need from the org
+- Delete the org (`sf org delete scratch` or `sf org delete sandbox`)
+- Run the command again
+- Create a new org and deploy the modified source
+
+# error.packageDirectoryNeedsMainDefault
+
+The package directory %s does not have a main/default structure.
+The command will move metadata into main/default which doesn't seem like what you'd want.
+
+# error.packageDirectoryNeedsMainDefault.actions
+
+- Update %s to have all its metadata inside main/default.
+- Run the command again.
+
+# success.dryRun
+
+Files were created in %s outside your package directories for inspection.
+
+# error.noTargetTypes
+
+The project contains no packageDirectories with metadata that matches the specified behavior %s.

package.json

@@ -10,8 +10,8 @@
     "@salesforce/core": "^7.3.9",
     "@salesforce/kit": "^3.1.1",
     "@salesforce/plugin-info": "^3.2.7",
-    "@salesforce/sf-plugins-core": "^9.0.10",
-    "@salesforce/source-deploy-retrieve": "^11.5.0",
+    "@salesforce/sf-plugins-core": "^9.0.7",
+    "@salesforce/source-deploy-retrieve": "^11.6.0",
     "@salesforce/source-tracking": "^6.2.3",
     "@salesforce/ts-types": "^2.0.9",
     "chalk": "^5.3.0"
@@ -21,6 +21,7 @@
     "@salesforce/cli-plugins-testkit": "^5.3.4",
     "@salesforce/dev-scripts": "^9.1.2",
     "@salesforce/plugin-command-reference": "^3.0.83",
+    "@salesforce/schemas": "^1.9.0",
     "@salesforce/source-testkit": "^2.2.10",
     "@salesforce/ts-sinon": "^1.4.19",
     "cross-env": "^7.0.3",

schemas/project-convert-source__behavior.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/SourceBehaviorResult",
+  "definitions": {
+    "SourceBehaviorResult": {
+      "type": "object",
+      "properties": {
+        "sourceBehaviorOptions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "deletedFiles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "createdFiles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": ["sourceBehaviorOptions", "deletedFiles", "createdFiles"],
+      "additionalProperties": false
+    }
+  }
+}

schemas/project-delete-source.json

@@ -444,6 +444,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -459,11 +460,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -492,11 +493,11 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "MetadataApiDeployStatus": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "id": {
           "type": "string"
@@ -598,7 +599,6 @@
         "status",
         "success"
       ],
-      "additionalProperties": false,
       "description": "Raw response returned from a checkDeployStatus call to the Metadata API"
     },
     "CoverageResultsFileInfo": {

schemas/project-deploy-cancel.json

@@ -142,6 +142,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -157,11 +158,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -190,8 +191,7 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "RequestStatus": {
       "type": "string",

schemas/project-deploy-quick.json

@@ -142,6 +142,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -157,11 +158,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -190,8 +191,7 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "RequestStatus": {
       "type": "string",

schemas/project-deploy-report.json

@@ -142,6 +142,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -157,11 +158,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -190,8 +191,7 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "RequestStatus": {
       "type": "string",

schemas/project-deploy-resume.json

@@ -142,6 +142,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -157,11 +158,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -190,8 +191,7 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "RequestStatus": {
       "type": "string",

schemas/project-deploy-start.json

@@ -142,6 +142,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -157,11 +158,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -190,8 +191,7 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "RequestStatus": {
       "type": "string",

schemas/project-deploy-validate.json

@@ -142,6 +142,7 @@
     },
     "FileResponseSuccess": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -157,11 +158,11 @@
           "enum": ["Created", "Changed", "Unchanged", "Deleted"]
         }
       },
-      "required": ["fullName", "state", "type"],
-      "additionalProperties": false
+      "required": ["fullName", "state", "type"]
     },
     "FileResponseFailure": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "fullName": {
           "type": "string"
@@ -190,8 +191,7 @@
           "enum": ["Warning", "Error"]
         }
       },
-      "required": ["error", "fullName", "problemType", "state", "type"],
-      "additionalProperties": false
+      "required": ["error", "fullName", "problemType", "state", "type"]
     },
     "RequestStatus": {
       "type": "string",