feat: added new RunRelevantTests test-level @W-20152151@

messages/deploy.metadata.md

@@ -104,6 +104,8 @@ Valid values are:
 
 - RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.
 
+- RunRelevantTests — Runs only tests that are relevant to the files being deployed.
+
   If you don’t specify a test level, the default behavior depends on the contents of your deployment package and target org. For more information, see [Running Tests in a Deployment](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm) in the "Metadata API Developer Guide".
 
 # flags.source-dir.summary
@@ -261,4 +263,4 @@ The `pushPackageDirectoriesSequentially` property is not respected by this comma
 # noSourceTrackingWarning
 
 Starting in December 2025, this command will require that the target org use source tracking.
-Specifically, to use this command with a production org, scratch org created with the `--no-track-source` flag, or other non-source-tracking org, you must specify the metadata you want to deploy with either the `--metadata`, `--source-dir`, or `--manifest` flag. 
+Specifically, to use this command with a production org, scratch org created with the `--no-track-source` flag, or other non-source-tracking org, you must specify the metadata you want to deploy with either the `--metadata`, `--source-dir`, or `--manifest` flag.

messages/deploy.metadata.validate.md

@@ -52,6 +52,8 @@ Valid values are:
 
 - RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.
 
+- RunRelevantTests — Runs only tests that are relevant to the files being deployed.
+
 # flags.source-dir.summary
 
 Path to the local source files to validate for deployment.

package.json

@@ -9,12 +9,12 @@
     "@oclif/core": "^4.8.0",
     "@oclif/multi-stage-output": "^0.8.28",
     "@salesforce/apex-node": "^8.3.5",
-    "@salesforce/core": "^8.23.2",
+    "@salesforce/core": "^8.23.4",
     "@salesforce/kit": "^3.2.4",
     "@salesforce/plugin-info": "^3.4.93",
     "@salesforce/sf-plugins-core": "^12.2.5",
-    "@salesforce/source-deploy-retrieve": "^12.25.0",
-    "@salesforce/source-tracking": "^7.5.1",
+    "@salesforce/source-deploy-retrieve": "^12.27.0",
+    "@salesforce/source-tracking": "^7.6.0",
     "@salesforce/ts-types": "^2.0.12",
     "ansis": "^3.17.0",
     "terminal-link": "^3.0.0"

src/commands/project/deploy/start.ts

@@ -122,7 +122,13 @@ export default class DeployMetadata extends SfCommand<DeployResultJson> {
     'test-level': testLevelFlag({
       description: messages.getMessage('flags.test-level.description'),
       summary: messages.getMessage('flags.test-level.summary'),
-      options: [TestLevel.NoTestRun, TestLevel.RunSpecifiedTests, TestLevel.RunLocalTests, TestLevel.RunAllTestsInOrg],
+      options: [
+        TestLevel.NoTestRun,
+        TestLevel.RunSpecifiedTests,
+        TestLevel.RunLocalTests,
+        TestLevel.RunAllTestsInOrg,
+        TestLevel.RunRelevantTests,
+      ],
       helpGroup: testFlags,
     }),
     verbose: Flags.boolean({

src/commands/project/deploy/validate.ts

@@ -96,7 +96,12 @@ export default class DeployMetadataValidate extends SfCommand<DeployResultJson>
     'target-org': Flags.requiredOrg(),
     tests: testsFlag({ helpGroup: testFlags }),
     'test-level': testLevelFlag({
-      options: [TestLevel.RunAllTestsInOrg, TestLevel.RunLocalTests, TestLevel.RunSpecifiedTests],
+      options: [
+        TestLevel.RunAllTestsInOrg,
+        TestLevel.RunLocalTests,
+        TestLevel.RunSpecifiedTests,
+        TestLevel.RunRelevantTests,
+      ],
       default: TestLevel.RunLocalTests,
       description: messages.getMessage('flags.test-level.description'),
       summary: messages.getMessage('flags.test-level.summary'),

src/utils/types.ts

@@ -35,6 +35,7 @@ export enum TestLevel {
   RunSpecifiedTests = 'RunSpecifiedTests',
   RunLocalTests = 'RunLocalTests',
   RunAllTestsInOrg = 'RunAllTestsInOrg',
+  RunRelevantTests = 'RunRelevantTests',
 }
 
 export enum API {