feat: added new RunRelevantTests test-level

Author: jfeingold35

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.

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 {