@salesforce/plugin-deploy-retrieve 3.24.58 → 3.24.59

package/README.md

@@ -141,7 +141,7 @@ FLAG DESCRIPTIONS
     If you specify this flag, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [src/commands/project/convert/mdapi.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/convert/mdapi.ts)_
+_See code: [src/commands/project/convert/mdapi.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/convert/mdapi.ts)_
 
 ## `sf project convert source`
 
@@ -214,7 +214,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [src/commands/project/convert/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/convert/source.ts)_
+_See code: [src/commands/project/convert/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/convert/source.ts)_
 
 ## `sf project convert source-behavior`
 
@@ -273,7 +273,7 @@ EXAMPLES
     $ sf project convert source-behavior --behavior decomposePermissionSetBeta --dry-run --preserve-temp-dir
 ```
 
-_See code: [src/commands/project/convert/source-behavior.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/convert/source-behavior.ts)_
+_See code: [src/commands/project/convert/source-behavior.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/convert/source-behavior.ts)_
 
 ## `sf project delete source`
 
@@ -426,7 +426,7 @@ FLAG DESCRIPTIONS
     - Separate the test names with spaces: --tests Test1 Test2 "Test With Space"
 ```
 
-_See code: [src/commands/project/delete/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/delete/source.ts)_
+_See code: [src/commands/project/delete/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/delete/source.ts)_
 
 ## `sf project delete tracking`
 
@@ -463,7 +463,7 @@ EXAMPLES
     $ sf project delete tracking --target-org my-scratch
 ```
 
-_See code: [src/commands/project/delete/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/delete/tracking.ts)_
+_See code: [src/commands/project/delete/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/delete/tracking.ts)_
 
 ## `sf project deploy cancel`
 
@@ -535,7 +535,7 @@ FLAG DESCRIPTIONS
     project deploy report".
 ```
 
-_See code: [src/commands/project/deploy/cancel.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/cancel.ts)_
+_See code: [src/commands/project/deploy/cancel.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/cancel.ts)_
 
 ## `sf project deploy preview`
 
@@ -618,7 +618,7 @@ FLAG DESCRIPTIONS
     All child components are included. If you specify this flag, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [src/commands/project/deploy/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/preview.ts)_
+_See code: [src/commands/project/deploy/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/preview.ts)_
 
 ## `sf project deploy quick`
 
@@ -702,7 +702,7 @@ FLAG DESCRIPTIONS
     deploy report".
 ```
 
-_See code: [src/commands/project/deploy/quick.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/quick.ts)_
+_See code: [src/commands/project/deploy/quick.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/quick.ts)_
 
 ## `sf project deploy report`
 
@@ -794,7 +794,7 @@ FLAG DESCRIPTIONS
     --coverage-formatters lcov --coverage-formatters clover
 ```
 
-_See code: [src/commands/project/deploy/report.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/report.ts)_
+_See code: [src/commands/project/deploy/report.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/report.ts)_
 
 ## `sf project deploy resume`
 
@@ -879,7 +879,7 @@ FLAG DESCRIPTIONS
     --coverage-formatters lcov --coverage-formatters clover
 ```
 
-_See code: [src/commands/project/deploy/resume.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/resume.ts)_
+_See code: [src/commands/project/deploy/resume.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/resume.ts)_
 
 ## `sf project deploy start`
 
@@ -1128,7 +1128,7 @@ FLAG DESCRIPTIONS
     --coverage-formatters lcov --coverage-formatters clover
 ```
 
-_See code: [src/commands/project/deploy/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/start.ts)_
+_See code: [src/commands/project/deploy/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/start.ts)_
 
 ## `sf project deploy validate`
 
@@ -1315,7 +1315,7 @@ FLAG DESCRIPTIONS
     --coverage-formatters lcov --coverage-formatters clover
 ```
 
-_See code: [src/commands/project/deploy/validate.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/deploy/validate.ts)_
+_See code: [src/commands/project/deploy/validate.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/deploy/validate.ts)_
 
 ## `sf project generate manifest`
 
@@ -1411,7 +1411,7 @@ EXAMPLES
     $ sf project generate manifest --from-org test@myorg.com --excluded-metadata StandardValueSet
 ```
 
-_See code: [src/commands/project/generate/manifest.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/generate/manifest.ts)_
+_See code: [src/commands/project/generate/manifest.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/generate/manifest.ts)_
 
 ## `sf project list ignored`
 
@@ -1453,7 +1453,7 @@ EXAMPLES
     $ sf project list ignored --source-dir package.xml
 ```
 
-_See code: [src/commands/project/list/ignored.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/list/ignored.ts)_
+_See code: [src/commands/project/list/ignored.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/list/ignored.ts)_
 
 ## `sf project reset tracking`
 
@@ -1502,7 +1502,7 @@ EXAMPLES
     $ sf project reset tracking --revision 30
 ```
 
-_See code: [src/commands/project/reset/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/reset/tracking.ts)_
+_See code: [src/commands/project/reset/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/reset/tracking.ts)_
 
 ## `sf project retrieve preview`
 
@@ -1556,7 +1556,7 @@ FLAG DESCRIPTIONS
     production orgs.
 ```
 
-_See code: [src/commands/project/retrieve/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/retrieve/preview.ts)_
+_See code: [src/commands/project/retrieve/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/retrieve/preview.ts)_
 
 ## `sf project retrieve start`
 
@@ -1729,6 +1729,6 @@ FLAG DESCRIPTIONS
     If you specify this flag, don’t specify --metadata or --source-dir.
 ```
 
-_See code: [src/commands/project/retrieve/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.58/src/commands/project/retrieve/start.ts)_
+_See code: [src/commands/project/retrieve/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.24.59/src/commands/project/retrieve/start.ts)_
 
 <!-- commandsstop -->

package/oclif.manifest.json

@@ -753,234 +753,6 @@
         "tracking:delete:project"
       ]
     },
-    "project:generate:manifest": {
-      "aliases": [
-        "force:source:manifest:create"
-      ],
-      "args": {},
-      "deprecateAliases": true,
-      "description": "Create a manifest from a list of metadata components (--metadata) or from one or more local directories that contain source files (--source-dir). You can specify either of these flags, not both.\n\nUse --type to specify the type of manifest you want to create. The resulting manifest files have specific names, such as the standard package.xml or destructiveChanges.xml to delete metadata. Valid values for this flag, and their respective file names, are:\n\n    * package : package.xml (default)\n    * pre : destructiveChangesPre.xml\n    * post : destructiveChangesPost.xml\n    * destroy : destructiveChanges.xml\n\nSee https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_deleting_files.htm for information about these destructive manifest files.\n\nUse --name to specify a custom name for the generated manifest if the pre-defined ones don’t suit your needs. You can specify either --type or --name, but not both.\n\nTo include multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --include-packages and --source-dir.\n\nTo build a manifest from the metadata in an org, use the --from-org flag. You can combine --from-org with the --metadata flag to include only certain metadata types, or with the --excluded-metadata flag to exclude certain metadata types. When building a manifest from an org, the command makes many concurrent API calls to discover the metadata that exists in the org. To limit the number of concurrent requests, use the SF_LIST_METADATA_BATCH_SIZE environment variable and set it to a size that works best for your org and environment. If you experience timeouts or inconsistent manifest contents, then setting this environment variable can improve accuracy. However, the command takes longer to run because it sends fewer requests at a time.",
-      "examples": [
-        "Create a manifest for deploying or retrieving all Apex classes and custom objects:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass --metadata CustomObject",
-        "Create a manifest for deleting the specified Apex class:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass:MyApexClass --type destroy",
-        "Create a manifest for deploying or retrieving all the metadata components in the specified local directory; name the file myNewManifest.xml:\n$ <%= config.bin %> <%= command.id %> --source-dir force-app --name myNewManifest",
-        "Create a manifest from the metadata components in the specified org and include metadata in any unlocked packages:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --include-packages unlocked",
-        "Create a manifest from specific metadata types in an org:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --metadata ApexClass,CustomObject,CustomLabels",
-        "Create a manifest from all metadata components in an org excluding specific metadata types:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --excluded-metadata StandardValueSet"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata": {
-          "char": "m",
-          "name": "metadata",
-          "summary": "Names of metadata components to include in the manifest.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "source-dir": {
-          "aliases": [
-            "sourcepath"
-          ],
-          "char": "p",
-          "deprecateAliases": true,
-          "name": "source-dir",
-          "summary": "Paths to the local source files to include in the manifest.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "name": {
-          "aliases": [
-            "manifestname"
-          ],
-          "char": "n",
-          "deprecateAliases": true,
-          "exclusive": [
-            "type"
-          ],
-          "name": "name",
-          "summary": "Name of a custom manifest file to create.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "aliases": [
-            "manifesttype"
-          ],
-          "char": "t",
-          "deprecateAliases": true,
-          "exclusive": [
-            "name"
-          ],
-          "name": "type",
-          "summary": "Type of manifest to create; the type determines the name of the created file.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "pre",
-            "post",
-            "destroy",
-            "package"
-          ],
-          "type": "option"
-        },
-        "include-packages": {
-          "aliases": [
-            "includepackages"
-          ],
-          "char": "c",
-          "dependsOn": [
-            "from-org"
-          ],
-          "deprecateAliases": true,
-          "name": "include-packages",
-          "summary": "Package types (managed, unlocked) whose metadata is included in the manifest; by default, metadata in managed and unlocked packages is excluded. Metadata in unmanaged packages is always included.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "managed",
-            "unlocked"
-          ],
-          "type": "option"
-        },
-        "excluded-metadata": {
-          "name": "excluded-metadata",
-          "relationships": [
-            {
-              "type": "some",
-              "flags": [
-                "from-org",
-                "source-dir"
-              ]
-            }
-          ],
-          "summary": "Metadata types to exclude when building a manifest from an org. Specify the name of the type, not the name of a specific component.",
-          "delimiter": ",",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "from-org": {
-          "aliases": [
-            "fromorg"
-          ],
-          "deprecateAliases": true,
-          "exclusive": [
-            "source-dir"
-          ],
-          "name": "from-org",
-          "summary": "Username or alias of the org that contains the metadata components from which to build a manifest.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-dir": {
-          "aliases": [
-            "outputdir",
-            "o"
-          ],
-          "char": "d",
-          "deprecateAliases": true,
-          "name": "output-dir",
-          "summary": "Directory to save the created manifest.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:generate:manifest",
-      "pluginAlias": "@salesforce/plugin-deploy-retrieve",
-      "pluginName": "@salesforce/plugin-deploy-retrieve",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Create a project manifest that lists the metadata components you want to deploy or retrieve.",
-      "enableJsonFlag": true,
-      "requiresProject": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "project",
-        "generate",
-        "manifest.js"
-      ],
-      "aliasPermutations": [
-        "force:source:manifest:create",
-        "source:force:manifest:create",
-        "source:manifest:force:create",
-        "source:manifest:create:force",
-        "force:manifest:source:create",
-        "manifest:force:source:create",
-        "manifest:source:force:create",
-        "manifest:source:create:force",
-        "force:manifest:create:source",
-        "manifest:force:create:source",
-        "manifest:create:force:source",
-        "manifest:create:source:force",
-        "force:source:create:manifest",
-        "source:force:create:manifest",
-        "source:create:force:manifest",
-        "source:create:manifest:force",
-        "force:create:source:manifest",
-        "create:force:source:manifest",
-        "create:source:force:manifest",
-        "create:source:manifest:force",
-        "force:create:manifest:source",
-        "create:force:manifest:source",
-        "create:manifest:force:source",
-        "create:manifest:source:force"
-      ],
-      "permutations": [
-        "project:generate:manifest",
-        "generate:project:manifest",
-        "generate:manifest:project",
-        "project:manifest:generate",
-        "manifest:project:generate",
-        "manifest:generate:project"
-      ]
-    },
     "project:deploy:cancel": {
       "aliases": [
         "deploy:metadata:cancel"
@@ -2478,17 +2250,20 @@
         "validate:deploy:project"
       ]
     },
-    "project:list:ignored": {
+    "project:generate:manifest": {
       "aliases": [
-        "force:source:ignored:list"
+        "force:source:manifest:create"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "When deploying or retrieving metadata between your local project and an org, you can specify the source files you want to exclude with a .forceignore file. The .forceignore file structure mimics the .gitignore structure. Each line in .forceignore specifies a pattern that corresponds to one or more files. The files typically represent metadata components, but can be any files you want to exclude, such as LWC configuration JSON files or tests.",
+      "description": "Create a manifest from a list of metadata components (--metadata) or from one or more local directories that contain source files (--source-dir). You can specify either of these flags, not both.\n\nUse --type to specify the type of manifest you want to create. The resulting manifest files have specific names, such as the standard package.xml or destructiveChanges.xml to delete metadata. Valid values for this flag, and their respective file names, are:\n\n    * package : package.xml (default)\n    * pre : destructiveChangesPre.xml\n    * post : destructiveChangesPost.xml\n    * destroy : destructiveChanges.xml\n\nSee https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_deleting_files.htm for information about these destructive manifest files.\n\nUse --name to specify a custom name for the generated manifest if the pre-defined ones don’t suit your needs. You can specify either --type or --name, but not both.\n\nTo include multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --include-packages and --source-dir.\n\nTo build a manifest from the metadata in an org, use the --from-org flag. You can combine --from-org with the --metadata flag to include only certain metadata types, or with the --excluded-metadata flag to exclude certain metadata types. When building a manifest from an org, the command makes many concurrent API calls to discover the metadata that exists in the org. To limit the number of concurrent requests, use the SF_LIST_METADATA_BATCH_SIZE environment variable and set it to a size that works best for your org and environment. If you experience timeouts or inconsistent manifest contents, then setting this environment variable can improve accuracy. However, the command takes longer to run because it sends fewer requests at a time.",
       "examples": [
-        "List all the files in all package directories that are ignored:\n<%= config.bin %> <%= command.id %>",
-        "List all the files in a specific directory that are ignored:\n<%= config.bin %> <%= command.id %> --source-dir force-app",
-        "Check if a particular file is ignored:\n<%= config.bin %> <%= command.id %> --source-dir package.xml"
+        "Create a manifest for deploying or retrieving all Apex classes and custom objects:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass --metadata CustomObject",
+        "Create a manifest for deleting the specified Apex class:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass:MyApexClass --type destroy",
+        "Create a manifest for deploying or retrieving all the metadata components in the specified local directory; name the file myNewManifest.xml:\n$ <%= config.bin %> <%= command.id %> --source-dir force-app --name myNewManifest",
+        "Create a manifest from the metadata components in the specified org and include metadata in any unlocked packages:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --include-packages unlocked",
+        "Create a manifest from specific metadata types in an org:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --metadata ApexClass,CustomObject,CustomLabels",
+        "Create a manifest from all metadata components in an org excluding specific metadata types:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --excluded-metadata StandardValueSet"
       ],
       "flags": {
         "json": {
@@ -2506,27 +2281,158 @@
           "multiple": false,
           "type": "option"
         },
-        "source-dir": {
+        "api-version": {
           "aliases": [
-            "sourcepath"
+            "apiversion"
           ],
-          "char": "p",
           "deprecateAliases": true,
-          "name": "source-dir",
-          "summary": "File or directory of files that the command checks for foreceignored files.",
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:list:ignored",
+        },
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata": {
+          "char": "m",
+          "name": "metadata",
+          "summary": "Names of metadata components to include in the manifest.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "source-dir": {
+          "aliases": [
+            "sourcepath"
+          ],
+          "char": "p",
+          "deprecateAliases": true,
+          "name": "source-dir",
+          "summary": "Paths to the local source files to include in the manifest.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "name": {
+          "aliases": [
+            "manifestname"
+          ],
+          "char": "n",
+          "deprecateAliases": true,
+          "exclusive": [
+            "type"
+          ],
+          "name": "name",
+          "summary": "Name of a custom manifest file to create.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "aliases": [
+            "manifesttype"
+          ],
+          "char": "t",
+          "deprecateAliases": true,
+          "exclusive": [
+            "name"
+          ],
+          "name": "type",
+          "summary": "Type of manifest to create; the type determines the name of the created file.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "pre",
+            "post",
+            "destroy",
+            "package"
+          ],
+          "type": "option"
+        },
+        "include-packages": {
+          "aliases": [
+            "includepackages"
+          ],
+          "char": "c",
+          "dependsOn": [
+            "from-org"
+          ],
+          "deprecateAliases": true,
+          "name": "include-packages",
+          "summary": "Package types (managed, unlocked) whose metadata is included in the manifest; by default, metadata in managed and unlocked packages is excluded. Metadata in unmanaged packages is always included.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "managed",
+            "unlocked"
+          ],
+          "type": "option"
+        },
+        "excluded-metadata": {
+          "name": "excluded-metadata",
+          "relationships": [
+            {
+              "type": "some",
+              "flags": [
+                "from-org",
+                "source-dir"
+              ]
+            }
+          ],
+          "summary": "Metadata types to exclude when building a manifest from an org. Specify the name of the type, not the name of a specific component.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "from-org": {
+          "aliases": [
+            "fromorg"
+          ],
+          "deprecateAliases": true,
+          "exclusive": [
+            "source-dir"
+          ],
+          "name": "from-org",
+          "summary": "Username or alias of the org that contains the metadata components from which to build a manifest.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "aliases": [
+            "outputdir",
+            "o"
+          ],
+          "char": "d",
+          "deprecateAliases": true,
+          "name": "output-dir",
+          "summary": "Directory to save the created manifest.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:generate:manifest",
       "pluginAlias": "@salesforce/plugin-deploy-retrieve",
       "pluginName": "@salesforce/plugin-deploy-retrieve",
       "pluginType": "core",
       "strict": true,
-      "summary": "Check your local project package directories for forceignored files.",
+      "summary": "Create a project manifest that lists the metadata components you want to deploy or retrieve.",
       "enableJsonFlag": true,
       "requiresProject": true,
       "isESM": true,
@@ -2534,54 +2440,55 @@
         "lib",
         "commands",
         "project",
-        "list",
-        "ignored.js"
+        "generate",
+        "manifest.js"
       ],
       "aliasPermutations": [
-        "force:source:ignored:list",
-        "source:force:ignored:list",
-        "source:ignored:force:list",
-        "source:ignored:list:force",
-        "force:ignored:source:list",
-        "ignored:force:source:list",
-        "ignored:source:force:list",
-        "ignored:source:list:force",
-        "force:ignored:list:source",
-        "ignored:force:list:source",
-        "ignored:list:force:source",
-        "ignored:list:source:force",
-        "force:source:list:ignored",
-        "source:force:list:ignored",
-        "source:list:force:ignored",
-        "source:list:ignored:force",
-        "force:list:source:ignored",
-        "list:force:source:ignored",
-        "list:source:force:ignored",
-        "list:source:ignored:force",
-        "force:list:ignored:source",
-        "list:force:ignored:source",
-        "list:ignored:force:source",
-        "list:ignored:source:force"
+        "force:source:manifest:create",
+        "source:force:manifest:create",
+        "source:manifest:force:create",
+        "source:manifest:create:force",
+        "force:manifest:source:create",
+        "manifest:force:source:create",
+        "manifest:source:force:create",
+        "manifest:source:create:force",
+        "force:manifest:create:source",
+        "manifest:force:create:source",
+        "manifest:create:force:source",
+        "manifest:create:source:force",
+        "force:source:create:manifest",
+        "source:force:create:manifest",
+        "source:create:force:manifest",
+        "source:create:manifest:force",
+        "force:create:source:manifest",
+        "create:force:source:manifest",
+        "create:source:force:manifest",
+        "create:source:manifest:force",
+        "force:create:manifest:source",
+        "create:force:manifest:source",
+        "create:manifest:force:source",
+        "create:manifest:source:force"
       ],
       "permutations": [
-        "project:list:ignored",
-        "list:project:ignored",
-        "list:ignored:project",
-        "project:ignored:list",
-        "ignored:project:list",
-        "ignored:list:project"
+        "project:generate:manifest",
+        "generate:project:manifest",
+        "generate:manifest:project",
+        "project:manifest:generate",
+        "manifest:project:generate",
+        "manifest:generate:project"
       ]
     },
-    "project:reset:tracking": {
+    "project:list:ignored": {
       "aliases": [
-        "force:source:tracking:reset"
+        "force:source:ignored:list"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "WARNING: This command deletes or overwrites all existing source tracking files. Use with extreme caution.\n\nResets local and remote source tracking so that Salesforce CLI no longer registers differences between your local files and those in the org. When you next run 'project deploy preview', Salesforce CLI returns no results, even though conflicts might actually exist. Salesforce CLI then resumes tracking new source changes as usual.\n\nUse the --revision flag 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 'data soql' command. For example:\n\n    <%= config.bin %> data query --query \"SELECT MemberName, MemberType, RevisionCounter FROM SourceMember\" --use-tooling-api --target-org my-scratch",
+      "description": "When deploying or retrieving metadata between your local project and an org, you can specify the source files you want to exclude with a .forceignore file. The .forceignore file structure mimics the .gitignore structure. Each line in .forceignore specifies a pattern that corresponds to one or more files. The files typically represent metadata components, but can be any files you want to exclude, such as LWC configuration JSON files or tests.",
       "examples": [
-        "Reset source tracking for the org with alias \"my-scratch\":\n$ <%= config.bin %> <%= command.id %> --target-org my-scratch",
-        "Reset source tracking to revision number 30 for your default org:\n$ <%= config.bin %> <%= command.id %> --revision 30"
+        "List all the files in all package directories that are ignored:\n<%= config.bin %> <%= command.id %>",
+        "List all the files in a specific directory that are ignored:\n<%= config.bin %> <%= command.id %> --source-dir force-app",
+        "Check if a particular file is ignored:\n<%= config.bin %> <%= command.id %> --source-dir package.xml"
       ],
       "flags": {
         "json": {
@@ -2599,70 +2506,27 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
+        "source-dir": {
           "aliases": [
-            "apiversion"
+            "sourcepath"
           ],
+          "char": "p",
           "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "revision": {
-          "char": "r",
-          "name": "revision",
-          "summary": "SourceMember revision counter number to reset to.",
+          "name": "source-dir",
+          "summary": "File or directory of files that the command checks for foreceignored files.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-prompt": {
-          "aliases": [
-            "noprompt"
-          ],
-          "char": "p",
-          "deprecateAliases": true,
-          "name": "no-prompt",
-          "summary": "Don't prompt for source tracking override confirmation.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
-      "hasDynamicHelp": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "project:reset:tracking",
+      "id": "project:list:ignored",
       "pluginAlias": "@salesforce/plugin-deploy-retrieve",
       "pluginName": "@salesforce/plugin-deploy-retrieve",
       "pluginType": "core",
       "strict": true,
-      "summary": "Reset local and remote source tracking.",
+      "summary": "Check your local project package directories for forceignored files.",
       "enableJsonFlag": true,
       "requiresProject": true,
       "isESM": true,
@@ -2670,42 +2534,42 @@
         "lib",
         "commands",
         "project",
-        "reset",
-        "tracking.js"
+        "list",
+        "ignored.js"
       ],
       "aliasPermutations": [
-        "force:source:tracking:reset",
-        "source:force:tracking:reset",
-        "source:tracking:force:reset",
-        "source:tracking:reset:force",
-        "force:tracking:source:reset",
-        "tracking:force:source:reset",
-        "tracking:source:force:reset",
-        "tracking:source:reset:force",
-        "force:tracking:reset:source",
-        "tracking:force:reset:source",
-        "tracking:reset:force:source",
-        "tracking:reset:source:force",
-        "force:source:reset:tracking",
-        "source:force:reset:tracking",
-        "source:reset:force:tracking",
-        "source:reset:tracking:force",
-        "force:reset:source:tracking",
-        "reset:force:source:tracking",
-        "reset:source:force:tracking",
-        "reset:source:tracking:force",
-        "force:reset:tracking:source",
-        "reset:force:tracking:source",
-        "reset:tracking:force:source",
-        "reset:tracking:source:force"
+        "force:source:ignored:list",
+        "source:force:ignored:list",
+        "source:ignored:force:list",
+        "source:ignored:list:force",
+        "force:ignored:source:list",
+        "ignored:force:source:list",
+        "ignored:source:force:list",
+        "ignored:source:list:force",
+        "force:ignored:list:source",
+        "ignored:force:list:source",
+        "ignored:list:force:source",
+        "ignored:list:source:force",
+        "force:source:list:ignored",
+        "source:force:list:ignored",
+        "source:list:force:ignored",
+        "source:list:ignored:force",
+        "force:list:source:ignored",
+        "list:force:source:ignored",
+        "list:source:force:ignored",
+        "list:source:ignored:force",
+        "force:list:ignored:source",
+        "list:force:ignored:source",
+        "list:ignored:force:source",
+        "list:ignored:source:force"
       ],
       "permutations": [
-        "project:reset:tracking",
-        "reset:project:tracking",
-        "reset:tracking:project",
-        "project:tracking:reset",
-        "tracking:project:reset",
-        "tracking:reset:project"
+        "project:list:ignored",
+        "list:project:ignored",
+        "list:ignored:project",
+        "project:ignored:list",
+        "ignored:project:list",
+        "ignored:list:project"
       ]
     },
     "project:retrieve:preview": {
@@ -3052,7 +2916,143 @@
         "start:project:retrieve",
         "start:retrieve:project"
       ]
+    },
+    "project:reset:tracking": {
+      "aliases": [
+        "force:source:tracking:reset"
+      ],
+      "args": {},
+      "deprecateAliases": true,
+      "description": "WARNING: This command deletes or overwrites all existing source tracking files. Use with extreme caution.\n\nResets local and remote source tracking so that Salesforce CLI no longer registers differences between your local files and those in the org. When you next run 'project deploy preview', Salesforce CLI returns no results, even though conflicts might actually exist. Salesforce CLI then resumes tracking new source changes as usual.\n\nUse the --revision flag 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 'data soql' command. For example:\n\n    <%= config.bin %> data query --query \"SELECT MemberName, MemberType, RevisionCounter FROM SourceMember\" --use-tooling-api --target-org my-scratch",
+      "examples": [
+        "Reset source tracking for the org with alias \"my-scratch\":\n$ <%= config.bin %> <%= command.id %> --target-org my-scratch",
+        "Reset source tracking to revision number 30 for your default org:\n$ <%= config.bin %> <%= command.id %> --revision 30"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "revision": {
+          "char": "r",
+          "name": "revision",
+          "summary": "SourceMember revision counter number to reset to.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-prompt": {
+          "aliases": [
+            "noprompt"
+          ],
+          "char": "p",
+          "deprecateAliases": true,
+          "name": "no-prompt",
+          "summary": "Don't prompt for source tracking override confirmation.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "project:reset:tracking",
+      "pluginAlias": "@salesforce/plugin-deploy-retrieve",
+      "pluginName": "@salesforce/plugin-deploy-retrieve",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Reset local and remote source tracking.",
+      "enableJsonFlag": true,
+      "requiresProject": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "project",
+        "reset",
+        "tracking.js"
+      ],
+      "aliasPermutations": [
+        "force:source:tracking:reset",
+        "source:force:tracking:reset",
+        "source:tracking:force:reset",
+        "source:tracking:reset:force",
+        "force:tracking:source:reset",
+        "tracking:force:source:reset",
+        "tracking:source:force:reset",
+        "tracking:source:reset:force",
+        "force:tracking:reset:source",
+        "tracking:force:reset:source",
+        "tracking:reset:force:source",
+        "tracking:reset:source:force",
+        "force:source:reset:tracking",
+        "source:force:reset:tracking",
+        "source:reset:force:tracking",
+        "source:reset:tracking:force",
+        "force:reset:source:tracking",
+        "reset:force:source:tracking",
+        "reset:source:force:tracking",
+        "reset:source:tracking:force",
+        "force:reset:tracking:source",
+        "reset:force:tracking:source",
+        "reset:tracking:force:source",
+        "reset:tracking:source:force"
+      ],
+      "permutations": [
+        "project:reset:tracking",
+        "reset:project:tracking",
+        "reset:tracking:project",
+        "project:tracking:reset",
+        "tracking:project:reset",
+        "tracking:reset:project"
+      ]
     }
   },
-  "version": "3.24.58"
+  "version": "3.24.59"
 }

package/package.json

@@ -1,14 +1,14 @@
 {
     "name": "@salesforce/plugin-deploy-retrieve",
     "description": "deploy and retrieve commands for sf",
-    "version": "3.24.58",
+    "version": "3.24.59",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "enableO11y": true,
     "o11yUploadEndpoint": "https://794testsite.my.site.com/byolwr/webruntime/log/metrics",
     "dependencies": {
         "@inquirer/prompts": "^7.8.3",
-        "@oclif/core": "^4.11.3",
+        "@oclif/core": "^4.11.14",
         "@oclif/multi-stage-output": "^0.8.42",
         "@salesforce/apex-node": "^8.4.22",
         "@salesforce/core": "^8.31.4",
@@ -22,10 +22,10 @@
         "terminal-link": "^3.0.0"
     },
     "devDependencies": {
-        "@oclif/plugin-command-snapshot": "^5.3.23",
+        "@oclif/plugin-command-snapshot": "^5.3.30",
         "@salesforce/cli-plugins-testkit": "^5.3.57",
         "@salesforce/dev-scripts": "^11.0.4",
-        "@salesforce/plugin-command-reference": "^3.1.95",
+        "@salesforce/plugin-command-reference": "^3.1.119",
         "@salesforce/schemas": "^1.9.0",
         "@salesforce/source-testkit": "^2.2.212",
         "@salesforce/ts-sinon": "^1.4.34",
@@ -258,7 +258,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.24.58.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.24.58.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.24.59.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.24.59.sig"
     }
 }