Merge pull request #1428 from salesforcecli/sl/W-18681384

Add a warning in PDR-W-18681384

Author: EstebanRomero84

messages/deploy.metadata.md

@@ -257,3 +257,8 @@ The `pushPackageDirectoriesSequentially` property is not respected by this comma
 # apiVersionMsgDetailed
 
 %s %s metadata to %s using the v%s %s API.
+
+# 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. 

messages/retrieve.start.md

@@ -199,3 +199,8 @@ This command expects the org to support source tracking. If it doesn't, you must
 - 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.
+
+# 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 retrieve with either the `--metadata`, `--source-dir`, or `--manifest` flag.

src/commands/project/deploy/start.ts

@@ -199,6 +199,12 @@ export default class DeployMetadata extends SfCommand<DeployResultJson> {
       throw messages.createError('error.NoTestsSpecified');
     }
 
+    const noDeployFlags = !flags['source-dir'] && !flags.manifest && !flags.metadata && !flags['metadata-dir'];
+
+    if (noDeployFlags && !(await flags['target-org'].tracksSource())) {
+      this.warn(messages.getMessage('noSourceTrackingWarning'));
+    }
+
     const api = await resolveApi(this.configAggregator);
     const username = flags['target-org'].getUsername();
     const title = flags['dry-run'] ? 'Deploying Metadata (dry-run)' : 'Deploying Metadata';

src/commands/project/retrieve/start.ts

@@ -176,6 +176,19 @@ export default class RetrieveMetadata extends SfCommand<RetrieveResultJson> {
   // eslint-disable-next-line complexity
   public async run(): Promise<RetrieveResultJson> {
     const { flags } = await this.parse(RetrieveMetadata);
+
+    // Add warning for non-source-tracking orgs when using default behavior
+    const isChanges =
+      !flags['source-dir'] &&
+      !flags['manifest'] &&
+      !flags['metadata'] &&
+      !flags['target-metadata-dir'] &&
+      !flags['package-name']?.length;
+
+    if (isChanges && !(await flags['target-org'].tracksSource())) {
+      this.warn(messages.getMessage('noSourceTrackingWarning'));
+    }
+
     let resolvedTargetDir: string | undefined;
     if (flags['output-dir']) {
       resolvedTargetDir = resolve(flags['output-dir']);
@@ -518,6 +531,7 @@ const buildRetrieveOptions = async (
   output: string | undefined
 ): Promise<RetrieveSetOptions> => {
   const apiVersion = await resolveApiVersion(flags);
+
   return {
     usernameOrConnection: flags['target-org'].getUsername() ?? flags['target-org'].getConnection(flags['api-version']),
     merge: true,

test/nuts/retrieve/noTracking.nut.ts

@@ -49,6 +49,15 @@ describe('retrieve mdapi format without project', () => {
     expect(result?.files).to.not.be.empty;
   });
 
+  it('should fail when retrieving changes from a non-tracking org', () => {
+    const result = execCmd<RetrieveResultJson>(`project:retrieve:start -o ${session.hubOrg.username} --json`, {
+      ensureExitCode: 1,
+    });
+
+    expect(result.jsonOutput?.name).to.equal('noSourceTracking');
+    expect(result.jsonOutput?.message).to.include('Unable to track changes in your source files');
+  });
+
   after(async () => {
     await session?.clean();
   });