feat: source tracking beta commands

* refactor: redo open for sfdx-core dependency reasons

* test: ebikes for nuts

* feat: source tracking commands in source:beta

* test: nuts for source tracking commands

* docs: new subtopics

* chore: remove imported asserted project/org

* chore: restore breaking comma

* chore: bump source tracking version

* chore: rebuild with latest lockfile

* refactor: feedback from WR

* style: typo and cleaner concats

* chore: pr feedback

* refactor: pull more like retrieve

* refactor: status formatter

* test: remove unused export

* chore: bump stl

* fix: missing header for pull

* fix: show conflicts from both remote and local, including remote filename

* test: better output, workaroun for Audience type

* refactor: consistent naming of command classes

* refactor: push feedback

* style: comment is no longer a question

* test: ebikes from clone instead of fs

* fix: status flags are better

* test: nuts with conn adjusted for git checkout

* chore: bump sdr for Created state fix

* test: unignore profiles

* test: was not using ebikes, revert

* chore: change status' flags in snapshot

* feat: show conflicts from both remote and local, including remote filename

* fix: show conflicts from both remote and local, including remote filename

* test: better output, workaroun for Audience type

* fix: push gets its own formatter for json reasons

* fix: missing pull messages

* chore: bump SDR to 4.5.7 (#253)

* chore(release): 1.2.3 [ci skip]

* Updated/Added CODEOWNERS with ECCN

* chore(release): 1.2.4 [ci skip]

* chore: sync .gitignore [skip-validate-pr] (#251)

Authored via Leif

* test: parallelize nuts, exclude async deploy nut

* test: one NUT for special types

* test: remove tracking NUTs

* ci: custom nut commands

* test: fix folderTypes, cross-env for windows

* test:  cross-env for windows SEED_FILTER, nyc only top-level

* ci: no sha; change nut order

* test: deploy nuts in parallel

* ci: disable async nuts

* test: exclude async nuts

* test: revert async-exclude

* test: revert tsconfig, revert config.yml

* test: exclude env for seeds

* feat: mark ignores

* feat: status shows remote ignores

* refactor: consistent naming of command classes

* refactor: push feedback

* style: comment is no longer a question

* test: ebikes from clone instead of fs

* fix: status flags are better

* test: nuts with conn adjusted for git checkout

* chore: bump sdr for Created state fix

* test: unignore profiles

* test: was not using ebikes, revert

* chore: change status' flags in snapshot

* refactor: move status logic to STL

* test: update ignore nut

* style: formatting line length

* fix: push uses correct json

* test: update tests for new push json format

* test: ut on lts, not node17

* Wr/destructive deploy (#230)

* fix: implementing destructive change deploy, 1 NUT

* chore: add NUTs, fix UTs

* chore: post-review board updates

* chore: fix linting

* chore: minor updates to flag logic, redo NUT query method

* chore: remove unnecessary checks in NUTs

* chore: bump SDR to 5, include deploy:destructive in NUTs

* chore(release): 1.2.5 [ci skip]

* fix: use cross-env for test:nuts script (#260)

* chore(release): 1.2.6 [ci skip]

* chore: unhide beta commands

* chore: bump SDR and STL

* test: and tracking nuts

* ci: windows UT

* test: nuts are hub-auth-agnostic

* ci: windows only

* ci: restore windows tests

Co-authored-by: Willie Ruemmele <[email protected]>
Co-authored-by: SF-CLI-BOT <[email protected]>
Co-authored-by: svc-scm <[email protected]>
Co-authored-by: Steve Hetzel <[email protected]>

* Sm/quiet-flag (#259)

* fix: push gets its own formatter for json reasons

* fix: missing pull messages

* feat: mark ignores

* feat: status shows remote ignores

* refactor: move status logic to STL

* test: update ignore nut

* style: formatting line length

* fix: push uses correct json

* test: update tests for new push json format

* test: ut on lts, not node17

* test: include tracking nuts

* feat: quiet flag on push (for stdout and json)

* test: put the individual tracking nuts back

* feat: quiet shows only failures in json

* refactor: simplify quiet logic

* test: ut for formatter with quiet

* feat: show ignored if any

* refactor: ignored as first column

* fix: no spinner for conflict check on --overwrite

* fix: early exit when there are no results

* fix: handle no-result (deletes only, or no changes)

* chore: bump sdr and stl

Co-authored-by: Willie Ruemmele <[email protected]>
Co-authored-by: SF-CLI-BOT <[email protected]>
Co-authored-by: svc-scm <[email protected]>
Co-authored-by: Steve Hetzel <[email protected]>

Author: 5 people

.circleci/config.yml

@@ -52,12 +52,10 @@ workflows:
                 - linux
                 - windows
               node_version:
-                - latest
+                # - latest
                 - lts
                 - maintenance
             exclude:
-              - os: windows
-                node_version: lts
               - os: windows
                 node_version: maintenance
       - release-management/test-nut:
@@ -79,6 +77,7 @@ workflows:
                 - 'yarn test:nuts:retrieve'
                 - 'yarn test:nuts:specialTypes'
                 - 'yarn test:nuts:deploy:destructive'
+                - 'yarn test:nuts:tracking'
       - release-management/release-package:
           sign: true
           github-release: true

.eslintrc.js

@@ -6,4 +6,5 @@
  */
 module.exports = {
   extends: ['eslint-config-salesforce-typescript', 'eslint-config-salesforce-license'],
+  ignorePatterns: ['test/nuts/ebikes-lwc/**'],
 };

.gitignore

@@ -39,3 +39,6 @@ node_modules
 # os specific files
 .DS_Store
 .idea
+
+# ignore generated nut tests
+test/nuts/generated/

CHANGELOG.md

@@ -4,10 +4,9 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [1.2.6](https://github.com/salesforcecli/plugin-source/compare/v1.2.5...v1.2.6) (2021-10-21)
 
-
 ### Bug Fixes
 
-* use cross-env for test:nuts script ([#260](https://github.com/salesforcecli/plugin-source/issues/260)) ([76627fb](https://github.com/salesforcecli/plugin-source/commit/76627fb21c62a4fb140c87ccfc266accd79af3fd))
+- use cross-env for test:nuts script ([#260](https://github.com/salesforcecli/plugin-source/issues/260)) ([76627fb](https://github.com/salesforcecli/plugin-source/commit/76627fb21c62a4fb140c87ccfc266accd79af3fd))
 
 ### [1.2.5](https://github.com/salesforcecli/plugin-source/compare/v1.2.4...v1.2.5) (2021-10-21)
 

README.md

@@ -1,4 +1,29 @@
 [
+  {
+    "command": "force:source:beta:pull",
+    "plugin": "@salesforce/plugin-source",
+    "flags": ["apiversion", "forceoverwrite", "json", "loglevel", "targetusername", "wait"]
+  },
+  {
+    "command": "force:source:beta:push",
+    "plugin": "@salesforce/plugin-source",
+    "flags": ["apiversion", "forceoverwrite", "ignorewarnings", "json", "loglevel", "quiet", "targetusername", "wait"]
+  },
+  {
+    "command": "force:source:beta:status",
+    "plugin": "@salesforce/plugin-source",
+    "flags": ["apiversion", "json", "local", "loglevel", "remote", "targetusername"]
+  },
+  {
+    "command": "force:source:beta:tracking:clear",
+    "plugin": "@salesforce/plugin-source",
+    "flags": ["apiversion", "json", "loglevel", "noprompt", "targetusername"]
+  },
+  {
+    "command": "force:source:beta:tracking:reset",
+    "plugin": "@salesforce/plugin-source",
+    "flags": ["apiversion", "json", "loglevel", "noprompt", "revision", "targetusername"]
+  },
   {
     "command": "force:source:convert",
     "plugin": "@salesforce/plugin-source",

command-snapshot.json

@@ -0,0 +1,17 @@
+{
+  "description": "pull source from the scratch org to the project",
+  "descriptionLong": "Pulls changed source from the scratch org to your project to keep them in sync.",
+  "help": "If the command detects a conflict, it displays the conflicts but does not complete the process. After reviewing the conflict, rerun the command with the --forceoverwrite parameter.",
+  "flags": {
+    "forceoverwrite": "ignore conflict warnings and overwrite changes to the project",
+    "forceoverwriteLong": "Runs the pull command even if conflicts exist. Changes in the scratch org overwrite changes in the project.",
+    "waitLong": "The number of minutes to wait for the command to complete and display results to the terminal window. If the command continues to run after the wait period, the CLI returns control of the terminal window to you. The default is 33 minutes."
+  },
+  "NonScratchOrgPull": "We can\"t retrieve your changes. \"force:source:pull\" is only available for orgs that have source tracking enabled. Use \"force:source:retrieve\" or \"force:mdapi:retrieve\" instead.",
+  "sourceConflictDetected": "Source conflict(s) detected.",
+  "pull": "Your retrieve request did not complete within the specified wait time [%s minutes]. Try again with a longer wait time.",
+  "retrievedSourceHeader": "Retrieved Source",
+  "NoResultsFound": "No results found",
+  "retrievedSourceWarningsHeader": "Retrieved Source Warnings",
+  "retrieveTimeout": "Your retrieve request did not complete within the specified wait time [%s minutes]. Try again with a longer wait time."
+}

messages/pull.json

@@ -0,0 +1,17 @@
+{
+  "description": "push source to a scratch org from the project",
+  "descriptionLong": "Pushes changed source from your project to a scratch org to keep them in sync.",
+  "help": "If the command detects a conflict, it displays the conflicts but does not complete the process. After reviewing the conflict, rerun the command with the --forceoverwrite parameter.",
+  "flags": {
+    "waitLong": "Number of minutes to wait for the command to complete and display results to the terminal window. If the command continues to run after the wait period, the CLI returns control of the terminal window to you. The default is 33 minutes.",
+    "forceoverwrite": "ignore conflict warnings and overwrite changes to scratch org",
+    "forceoverwriteLong": "Runs the push command even if conflicts exist. Changes in the project overwrite changes in the scratch org.",
+    "replacetokens": "replace tokens in source files prior to deployment",
+    "replacetokensLong": "Replaces tokens in source files prior to deployment.",
+    "ignorewarnings": "deploy changes even if warnings are generated",
+    "ignorewarningsLong": "Completes the deployment even if warnings are generated.",
+    "quiet": "minimize json and sdtout output on success"
+  },
+  "sourcepushFailed": "Push failed.",
+  "conflictMsg": "We couldn't complete the push operation due to conflicts. Verify that you want to keep the local versions, then run \"sfdx force:source:push -f\" with the --forceoverwrite (-f) option."
+}

messages/push.json

@@ -0,0 +1,19 @@
+{
+  "description": "list local changes and/or changes in a scratch org",
+  "LongDescription": "Lists changes that have been made locally, in a scratch org, or both.",
+  "examples": [
+    "sfdx force:source:status -l",
+    "sfdx force:source:status -r",
+    "sfdx force:source:status -a",
+    "sfdx force:source:status -a -u [email protected] --json"
+  ],
+  "flags": {
+    "all": "list all the changes that have been made",
+    "allLong": "Lists all the changes that have been made.",
+    "local": "list the changes that have been made locally",
+    "localLong": "Lists the changes that have been made locally.",
+    "remote": "list the changes that have been made in the scratch org",
+    "remoteLong": "Lists the changes that have been made in the scratch org."
+  },
+  "humanSuccess": "Source Status"
+}

messages/status.json

@@ -0,0 +1,7 @@
+{
+  "resetDescription": "reset local and remote source tracking\n\n WARNING: This command deletes or overwrites all existing source tracking files. Use with extreme caution. \n\nResets local and remote source tracking so that the CLI no longer registers differences between your local files and those in the org. When you next run force:source:status, the CLI returns no results, even though conflicts might actually exist. The CLI then resumes tracking new source changes as usual.\n\nUse the --revision parameter to reset source tracking to a specific revision number of an org source member. To get the revision number, query the SourceMember Tooling API object with the force:data:soql:query command. For example:\n $ sfdx force:data:soql:query -q \"SELECT MemberName, MemberType, RevisionCounter FROM SourceMember\" -t",
+  "clearDescription": "clear all local source tracking information\n\nWARNING: This command deletes or overwrites all existing source tracking files. Use with extreme caution.\n\nClears all local source tracking information. When you next run force:source:status, the CLI displays all local and remote files as changed, and any files with the same name are listed as conflicts.",
+  "nopromptDescription": "do not prompt for source tracking override confirmation",
+  "revisionDescription": "reset to a specific SourceMember revision counter number",
+  "promptMessage": "WARNING: This operation will modify all your local source tracking files. The operation can have unintended consequences on all the force:source commands. Are you sure you want to proceed (y/n)?"
+}