From 909d69fd0a5e07b81e2beed174358d94edf4e7c6 Mon Sep 17 00:00:00 2001
From: svc-cli-bot <svc_cli_bot@salesforce.com>
Date: Sun, 1 Oct 2023 08:46:05 +0000
Subject: [PATCH] chore(release): 2.2.6 [skip ci]

---
 CHANGELOG.md |   6 +
 README.md    | 394 ++++++++++++++++++++++++++++++---------------------
 package.json |   2 +-
 3 files changed, 242 insertions(+), 160 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 854b6107..72b1ee68 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [2.2.6](https://github.com/salesforcecli/plugin-custom-metadata/compare/2.2.5...2.2.6) (2023-10-01)
+
+### Bug Fixes
+
+- **deps:** bump @salesforce/core from 5.2.10 to 5.3.1 ([156d8f3](https://github.com/salesforcecli/plugin-custom-metadata/commit/156d8f3de0a27365792e9d88cd902eb1d94e5a4c))
+
 ## [2.2.5](https://github.com/salesforcecli/plugin-custom-metadata/compare/2.2.4...2.2.5) (2023-09-28)
 
 ### Bug Fixes
diff --git a/README.md b/README.md
index 56906334..117f6f25 100644
--- a/README.md
+++ b/README.md
@@ -71,259 +71,335 @@ sfdx plugins
 
 <!-- commands -->
 
-- [`sfdx force:cmdt:create -n <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcecmdtcreate--n-string--l-string--p-string--v-packageprotectedprotectedpublic--d-directory---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:cmdt:field:create -n <string> -f Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [-p <array>] [-s <number>] [-l <string>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcecmdtfieldcreate--n-string--f-checkboxdatedatetimeemailnumberpercentphonepicklisttexttextarealongtextareaurl--p-array--s-number--l-string--d-directory---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:cmdt:generate -n <string> -s <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-i] [-d <directory>] [-r <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcecmdtgenerate--n-string--s-string--l-string--p-string--v-packageprotectedprotectedpublic--i--d-directory--r-directory--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:cmdt:record:create [name=value...] -t <string> -n <string> [-l <string>] [-p <string>] [-i <directory>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcecmdtrecordcreate-namevalue--t-string--n-string--l-string--p-string--i-directory--d-directory---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:cmdt:record:insert -f <string> -t <string> [-i <directory>] [-d <directory>] [-n <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcecmdtrecordinsert--f-string--t-string--i-directory--d-directory--n-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+- [`sfdx cmdt:generate:field`](#sfdx-cmdtgeneratefield)
+- [`sfdx cmdt:generate:fromorg`](#sfdx-cmdtgeneratefromorg)
+- [`sfdx cmdt:generate:object`](#sfdx-cmdtgenerateobject)
+- [`sfdx cmdt:generate:record`](#sfdx-cmdtgeneraterecord)
+- [`sfdx cmdt:generate:records`](#sfdx-cmdtgeneraterecords)
 
-## `sfdx force:cmdt:create -n <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx cmdt:generate:field`
 
-creates a new custom metadata type in the current project
+Generate a field for a custom metadata type based on the provided field type.
 
 ```
 USAGE
-  $ sfdx force:cmdt:create -n <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-d
-    <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx cmdt:generate:field -n <value> -f
+    Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [--json] [-p <value>] [-s
+    <value>] [-l <value>] [-d <value>]
 
 FLAGS
-  -d, --outputdir=<value>                                                           directory to store the newly-created
-                                                                                    custom metadata type files
-  -l, --label=<value>                                                               label for the custom metadata type
-  -n, --typename=<value>                                                            (required) unique object name for
-                                                                                    the custom metadata type
-  -p, --plurallabel=<value>                                                         plural version of the label value;
-                                                                                    if blank, uses label
-  -v, --visibility=(PackageProtected|Protected|Public)                              [default: Public] visibility of the
-                                                                                    custom metadata type
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -d, --output-directory=<value>    Directory to store newly-created field definition files.
+  -f, --type=<option>               (required) Type of the field.
+                                    <options: Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|L
+                                    ongTextArea|Url>
+  -l, --label=<value>               Label for the field.
+  -n, --name=<value>                (required) Unique name for the field.
+  -p, --picklist-values=<value>...  Picklist values; required for picklist fields.
+  -s, --decimal-places=<value>      Number of decimal places to use for number or percent fields.
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  creates a new custom metadata type in the current project
+  Generate a field for a custom metadata type based on the provided field type.
+
+  Similar to a custom object, a custom metadata type has a list of custom fields that represent aspects of the metadata.
+
+  This command creates a metadata file that describes the new custom metadata type field. By default, the file is
+  created in a "fields" directory in the current directory. Use the --output-directory to generate the file in the
+  directory that contains the custom metadata type metdata files, such as "force-app/main/default/objects/MyCmdt__mdt"
+  for the custom metadata type called MyCmdt.
+
+ALIASES
+  $ sfdx force:cmdt:field:create
+  $ sfdx cmdt:field:create
 
 EXAMPLES
-  Create a custom metadata type with developer name 'MyCustomType'; this name will also be used as the label:
+  Generate a metadata file for a custom checkbox field and add the file to the MyCmdt__mdt/fields directory:
+
+    $ sfdx cmdt:generate:field --name MyCheckboxField --type Checkbox --output-directory \
+      force-app/main/default/objects/MyCmdt__mdt
+
+  Generate a metadata file for a custom picklist field and add a few values:
+
+    $ sfdx cmdt:generate:field --name MyPicklistField --type Picklist --picklist-values A --picklist-values B \
+      --picklist-values C --output-directory force-app/main/default/objects/MyCmdt__mdt
+
+  Generate a metadata file for a custom number field and specify 2 decimal places:
+
+    $ sfdx cmdt:generate:field --name MyNumberField --type Number --decimal-places 2 --output-directory \
+      force-app/main/default/objects/MyCmdt__mdt
+
+FLAG DESCRIPTIONS
+  -d, --output-directory=<value>  Directory to store newly-created field definition files.
 
-      $ sfdx force:cmdt:create --typename MyCustomType
+    New files are automatically created in the "fields" directory. The location can be an absolute path or relative to
+    the current working directory. The default is the current directory.
 
-  Create a protected custom metadata type with a specific label:
+  -f, --type=Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url
 
-      $ sfdx force:cmdt:create --typename MyCustomType --label "Custom Type" --plurallabel "Custom Types" --visibility Protected
+    Type of the field.
+
+    You can't use this command to create a custom metadata type field of type "Metadata Relationship". Use the
+    Salesforce Setup UI instead.
+
+  -s, --decimal-places=<value>  Number of decimal places to use for number or percent fields.
+
+    The value must be greater than or equal to zero. Default value is 0.
 ```
 
-_See code: [src/commands/force/cmdt/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v2.0.0/src/commands/force/cmdt/create.ts)_
+_See code: [src/commands/cmdt/generate/field.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/2.2.6/src/commands/cmdt/generate/field.ts)_
 
-## `sfdx force:cmdt:field:create -n <string> -f Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [-p <array>] [-s <number>] [-l <string>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx cmdt:generate:fromorg`
 
-generate a custom metadata field based on the field type provided
+Generate a custom metadata type and all its records from a Salesforce object.
 
 ```
 USAGE
-  $ sfdx force:cmdt:field:create -n <string> -f
-    Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [-p <array>] [-s <number>]
-    [-l <string>] [-d <directory>] [--json] [--loglevel
-    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx cmdt:generate:fromorg -o <value> -n <value> -s <value> [--json] [--api-version <value>] [-l <value>] [-p <value>]
+    [-v PackageProtected|Protected|Public] [-i] [-d <value>] [-r <value>]
 
 FLAGS
-  -d, --outputdir=<value>
-      directory to store newly-created field definition files
+  -d, --type-output-directory=<value>  [default: force-app/main/default/objects] Directory to store newly-created custom
+                                       metadata type files.
+  -i, --ignore-unsupported             Ignore unsupported field types.
+  -l, --label=<value>                  Label for the custom metadata type.
+  -n, --dev-name=<value>               (required) Name of the custom metadata type.
+  -o, --target-org=<value>             (required) Username or alias of the target org.
+  -p, --plural-label=<value>           Plural version of the label value; if blank, uses label.
+  -r, --records-output-dir=<value>     [default: force-app/main/default/customMetadata] Directory to store newly-created
+                                       custom metadata record files.
+  -s, --sobject=<value>                (required) API name of the source Salesforce object used to generate the custom
+                                       metadata type.
+  -v, --visibility=<option>            [default: Public] Who can see the custom metadata type.
+                                       <options: PackageProtected|Protected|Public>
+  --api-version=<value>                Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Generate a custom metadata type and all its records from a Salesforce object.
 
-  -f, --fieldtype=(Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url)
-      (required) type of field
+  Use this command to migrate existing custom objects or custom settings in an org to custom metadata types. If a field
+  of the Salesforce object is of an unsupported type, the field type is automatically converted to text. Run "sfdx cmdt
+  generate field --help" to see the list of supported cmdt field types, listed in the --type flag summary. Use the
+  --ignore-unsupported to ignore these fields.
 
-  -l, --label=<value>
-      label for the field
+  This command creates the metadata files that describe the new custom metadata type and its fields in the
+  "force-app/main/default/objects/TypeName__mdt" directory by default, where "TypeName" is the value of the required
+  --dev-name flag. Use --type-output-directory to create them in a different directory.
 
-  -n, --fieldname=<value>
-      (required) unique name for the field
+ALIASES
+  $ sfdx force:cmdt:generate
 
-  -p, --picklistvalues=<value>
-      comma-separated list of picklist values; required for Picklist fields
+EXAMPLES
+  Generate a custom metadata type from a custom object called MySourceObject__c in your default org:
 
-  -s, --decimalplaces=<value>
-      number of decimal places to use for Number or Percent fields
+    $ sfdx cmdt:generate:fromorg --dev-name MyCMDT --sobject MySourceObject__c
 
-  --json
-      format output as json
+  Generate a custom metadata type from a custom object in an org with alias my-scratch-org; ignore unsupported field
+  types instead of converting them to text:
 
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)
-      [default: warn] logging level for this command invocation
+    $ sfdx cmdt:generate:fromorg --dev-name MyCMDT --sobject MySourceObject__c --ignore-unsupported --target-org \
+      my-scratch-org
 
-DESCRIPTION
-  generate a custom metadata field based on the field type provided
+  Generate a protected custom metadata type from a custom object:
 
-EXAMPLES
-  Create a metadata file for a custom checkbox field:
+    $ sfdx cmdt:generate:fromorg --dev-name MyCMDT --sobject MySourceObject__c --visibility Protected
 
-      $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Checkbox
+  Generate a protected custom metadata type from a custom setting with a specific singular and plural label:
 
-  Create a metadata file for a custom picklist field:
+    $ sfdx cmdt:generate:fromorg --dev-name MyCMDT --label "My CMDT" --plural-label "My CMDTs" --sobject \
+      MySourceSetting__c --visibility Protected
 
-      $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Picklist --picklistvalues "A,B,C"
+  Generate a custom metadata type and put the resulting metadata files in the specified directory:
 
-  Create a metadata file for a custom number field:
+    $ sfdx cmdt:generate:fromorg --dev-name MyCMDT --sobject MySourceObject__c --type-output-directory \
+      path/to/my/cmdt/directory
 
-      $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Number --decimalplaces 2
+  Generate a custom metadata type and put the resulting record metadata file(s) in the specified directory:
+
+    $ sfdx cmdt:generate:fromorg --dev-name MyCMDT --sobject MySourceObject__c --records-output-dir \
+      path/to/my/cmdt/record/directory
+
+FLAG DESCRIPTIONS
+  -i, --ignore-unsupported  Ignore unsupported field types.
+
+    In this context, "ignore" means that the fields aren't created. The default behavior is to create fields of type
+    text and convert the field values to text.
+
+  -v, --visibility=PackageProtected|Protected|Public  Who can see the custom metadata type.
+
+    For more information on what each option means, see this topic in Salesforce Help:
+    https://help.salesforce.com/s/articleView?id=sf.custommetadatatypes_ui_create.htm&type=5.
 ```
 
-_See code: [src/commands/force/cmdt/field/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v2.0.0/src/commands/force/cmdt/field/create.ts)_
+_See code: [src/commands/cmdt/generate/fromorg.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/2.2.6/src/commands/cmdt/generate/fromorg.ts)_
 
-## `sfdx force:cmdt:generate -n <string> -s <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-i] [-d <directory>] [-r <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx cmdt:generate:object`
 
-generates a custom metadata type and all its records for the provided sObject
+Generate a new custom metadata type in the current project.
 
 ```
 USAGE
-  $ sfdx force:cmdt:generate -n <string> -s <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public]
-    [-i] [-d <directory>] [-r <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel
-    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx cmdt:generate:object -n <value> [--json] [-l <value>] [-p <value>] [-v PackageProtected|Protected|Public] [-d
+    <value>]
 
 FLAGS
-  -d, --typeoutputdir=<value>                                                       [default:
-                                                                                    force-app/main/default/objects]
-                                                                                    directory to store newly-created
-                                                                                    custom metadata type files
-  -i, --ignoreunsupported                                                           ignore unsupported field types
-  -l, --label=<value>                                                               label for the custom metadata type
-  -n, --devname=<value>                                                             (required) name of the custom
-                                                                                    metadata type
-  -p, --plurallabel=<value>                                                         plural version of the label value;
-                                                                                    if blank, uses label
-  -r, --recordsoutputdir=<value>                                                    [default: force-app/main/default/cus
-                                                                                    tomMetadata] directory to store
-                                                                                    newly-created custom metadata record
-                                                                                    files
-  -s, --sobjectname=<value>                                                         (required) API name of the sObject
-                                                                                    source for custom metadata
-                                                                                    generation
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -v, --visibility=(PackageProtected|Protected|Public)                              [default: Public] visibility of the
-                                                                                    custom metadata type
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -d, --output-directory=<value>  Directory to store the newly-created custom metadata type files
+  -l, --label=<value>             Label for the custom metadata type.
+  -n, --type-name=<value>         (required) Unique object name for the custom metadata type.
+  -p, --plural-label=<value>      Plural version of the label value; if blank, uses label.
+  -v, --visibility=<option>       [default: Public] Who can see the custom metadata type.
+                                  <options: PackageProtected|Protected|Public>
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  generates a custom metadata type and all its records for the provided sObject
+  Generate a new custom metadata type in the current project.
 
-EXAMPLES
-  Generate a custom metadata type from an sObject in the default target org:
+  This command creates a metadata file that describes the new custom metadata type. By default, the file is created in
+  the MyCustomType__mdt directory in the current directory, where MyCustomType is the value of the required --type-name
+  flag. Use the --output-directory to generate the file in a package directory with other custom metadata types, such as
+  "force-app/main/default/objects".
 
-      $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname MySourceObject__c
+ALIASES
+  $ sfdx force:cmdt:create
+  $ sfdx cmdt:create
 
-  Generate a custom metadata type from an sObject in the specified target org; ignore unsupported field types instead of converting them to text:
+EXAMPLES
+  Generate a custom metadata type with developer name 'MyCustomType'; this name is also used as the label:
 
-      $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname MySourceObject__c  --ignoreunsupported --targetusername 'alias or user email of the org containing the source type'
+    $ sfdx cmdt:generate:object --type-name MyCustomType
 
-  Generate a protected custom metadata type from an sObject in the default target org:
+  Generate a protected custom metadata type with a specific label:
 
-      $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomObject__c  --visibility Protected
+    $ sfdx cmdt:generate:object --type-name MyCustomType --label "Custom Type" --plural-label "Custom Types" \
+      --visibility Protected
 
-  Generate a protected custom metadata type with a specific label from an sObject in the default target org:
+FLAG DESCRIPTIONS
+  -d, --output-directory=<value>  Directory to store the newly-created custom metadata type files
 
-      $ sfdx force:cmdt:generate --devname MyCMDT --label "My CMDT" --plurallabel "My CMDTs" --sobjectname SourceCustomSetting__c  --visibility Protected
+    The location can be an absolute path or relative to the current working directory. The default is the current
+    directory.
 
-  Generate a custom metadata type from an sObject in the default target org; put the resulting type metadata file in the specified directory:
+  -n, --type-name=<value>  Unique object name for the custom metadata type.
 
-      $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomSetting__c --typeoutputdir 'path/to/my/cmdt/directory'
+    The name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin
+    with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores.
 
-  Generate a custom metadata type from an sObject in the default target org; put the resulting record metadata file(s) in the specified directory:
+  -v, --visibility=PackageProtected|Protected|Public  Who can see the custom metadata type.
 
-      $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomSetting__c --recordsoutputdir 'path/to/my/cmdt/record/directory'
+    For more information on what each option means, see this topic in Salesforce Help:
+    https://help.salesforce.com/s/articleView?id=sf.custommetadatatypes_ui_create.htm&type=5.
 ```
 
-_See code: [src/commands/force/cmdt/generate.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v2.0.0/src/commands/force/cmdt/generate.ts)_
+_See code: [src/commands/cmdt/generate/object.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/2.2.6/src/commands/cmdt/generate/object.ts)_
 
-## `sfdx force:cmdt:record:create [name=value...] -t <string> -n <string> [-l <string>] [-p <string>] [-i <directory>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx cmdt:generate:record`
 
-create a new record for a given custom metadata type in the current project
+Generate a new record for a given custom metadata type in the current project.
 
 ```
 USAGE
-  $ sfdx force:cmdt:record:create [name=value...] -t <string> -n <string> [-l <string>] [-p <string>] [-i <directory>] [-d
-    <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx cmdt:generate:record -t <value> -n <value> [--json] [-l <value>] [-p true|false] [-i <value>] [-d <value>]
 
 FLAGS
-  -d, --outputdir=<value>                                                           [default: force-app/main/default/cus
-                                                                                    tomMetadata] directory to store
-                                                                                    newly-created custom metadata record
-                                                                                    files
-  -i, --inputdir=<value>                                                            [default:
-                                                                                    force-app/main/default/objects]
-                                                                                    directory to pull the custom
-                                                                                    metadata type definition from
-  -l, --label=<value>                                                               label for the new record
-  -n, --recordname=<value>                                                          (required) name for the new record
-  -p, --protected=<option>                                                          [default: false] protect the record
-                                                                                    when it is in a managed package
-                                                                                    <options: true|false>
-  -t, --typename=<value>                                                            (required) API name of the custom
-                                                                                    metadata type to create a record for
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -d, --output-directory=<value>  [default: force-app/main/default/customMetadata] Directory to store newly-created
+                                  custom metadata record files.
+  -i, --input-directory=<value>   [default: force-app/main/default/objects] Directory from which to get the custom
+                                  metadata type definition from.
+  -l, --label=<value>             Label for the new record.
+  -n, --record-name=<value>       (required) Name of the new record.
+  -p, --protected=<option>        [default: false] Protect the record when it's in a managed package.
+                                  <options: true|false>
+  -t, --type-name=<value>         (required) API name of the custom metadata type to create a record for; must end in
+                                  "__mdt".
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  create a new record for a given custom metadata type in the current project
+  Generate a new record for a given custom metadata type in the current project.
+
+  The custom metadata type must already exist in your project. You must specify a name for the new record. Use
+  name=value pairs to specify the values for the fields, such as MyTextField="some text here" or MyNumberField=32.
+
+ALIASES
+  $ sfdx force:cmdt:record:create
+  $ sfdx cmdt:record:create
 
 EXAMPLES
-  Create a record metadata file for custom metadata type 'MyCMT' with values specified for two custom fields:
+  Create a record metadata file for custom metadata type 'MyCMT' with specified values for two custom fields:
+
+    $ sfdx cmdt:generate:record --type-name MyCMT__mdt --record-name MyRecord My_Custom_Field_1=Foo \
+      My_Custom_Field_2=Bar
 
-      $ sfdx force:cmdt:record:create --typename MyCMT__mdt --recordname MyRecord My_Custom_Field_1=Foo My_Custom_Field_2=Bar
+  Create a protected record metadata file for custom metadata type 'MyCMT' with a specific label and values specified
+  for two custom fields:
 
-  Create a protected record metadata file for custom metadata type 'MyCMT' with a specific label and values specified for two custom fields:
+    $ sfdx cmdt:generate:record --type-name MyCMT__mdt --record-name MyRecord --label "My Record" --protected true \
+      My_Custom_Field_1=Foo My_Custom_Field_2=Bar
 
-      $ sfdx force:cmdt:record:create --typename MyCMT__mdt --recordname MyRecord --label "My Record" --protected true My_Custom_Field_1=Foo My_Custom_Field_2=Bar
+FLAG DESCRIPTIONS
+  -p, --protected=true|false  Protect the record when it's in a managed package.
+
+    Protected records can only be accessed by code in the same managed package namespace.
 ```
 
-_See code: [src/commands/force/cmdt/record/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v2.0.0/src/commands/force/cmdt/record/create.ts)_
+_See code: [src/commands/cmdt/generate/record.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/2.2.6/src/commands/cmdt/generate/record.ts)_
 
-## `sfdx force:cmdt:record:insert -f <string> -t <string> [-i <directory>] [-d <directory>] [-n <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx cmdt:generate:records`
 
-create new custom metadata type records from a CSV file
+Generate new custom metadata type records from a CSV file.
 
 ```
 USAGE
-  $ sfdx force:cmdt:record:insert -f <string> -t <string> [-i <directory>] [-d <directory>] [-n <string>] [--json] [--loglevel
-    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx cmdt:generate:records -f <value> -t <value> [--json] [-i <value>] [-d <value>] [-n <value>]
 
 FLAGS
-  -d, --outputdir=<value>                                                           [default: force-app/main/default/cus
-                                                                                    tomMetadata] directory to store
-                                                                                    newly-created custom metadata record
-                                                                                    files
-  -f, --filepath=<value>                                                            (required) path to the CSV file
-  -i, --inputdir=<value>                                                            [default:
-                                                                                    force-app/main/default/objects]
-                                                                                    directory to pull the custom
-                                                                                    metadata type definition from
-  -n, --namecolumn=<value>                                                          [default: Name] column that is used
-                                                                                    to determine the name of the record
-  -t, --typename=<value>                                                            (required) API name of the custom
-                                                                                    metadata type
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -d, --output-directory=<value>  [default: force-app/main/default/customMetadata] Directory to store newly-created
+                                  custom metadata record files.
+  -f, --csv=<value>               (required) Pathname of the CSV file.
+  -i, --input-directory=<value>   [default: force-app/main/default/objects] Directory from which to get the custom
+                                  metadata type definition from.
+  -n, --name-column=<value>       [default: Name] Column used to determine the name of the record.
+  -t, --type-name=<value>         (required) API name of the custom metadata type to create a record for.
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  create new custom metadata type records from a CSV file
+  Generate new custom metadata type records from a CSV file.
+
+  The custom metadata type must already exist in your project. By default, the Name column is used to determine the
+  record name; use the --name-column flag to specify a different column.
+
+ALIASES
+  $ sfdx force:cmdt:record:insert
+  $ sfdx cmdt:record:insert
 
 EXAMPLES
-  Create record metadata files for type 'My_CMDT_Name' (from your local project) based on values in a CSV file, using 'Name' as the column that specifies the record name:
+  Generate record metadata files from values in a CSV file for the custom metadata type MyCmdt. Use 'Name' as the
+  column that specifies the record name:
+
+    $ sfdx cmdt:generate:records --csv path/to/my.csv --type-name MyCmdt
+
+  Generate record metadata files from a CSV file in the directory different from the default, and use 'PrimaryKey' as
+  the column that specifies the record name:
 
-      $ sfdx force:cmdt:record:insert --filepath path/to/my.csv --typename My_CMDT_Name
+    $ sfdx cmdt:generate:records --csv path/to/my.csv --type-name MyCmdt --input-directory path/to/my/cmdt/directory \
+      --name-column "PrimaryKey"
 
-  Create record metadata files for type 'My_CMDT_Name' (from the specified directory) based on values in a CSV file, using 'PrimaryKey' as the column that specifies the record name:
+FLAG DESCRIPTIONS
+  -t, --type-name=<value>  API name of the custom metadata type to create a record for.
 
-      $ sfdx force:cmdt:record:insert --filepath path/to/my.csv --typename My_CMDT_Name --inputdir "path/to/my/cmdt/directory" --namecolumn "PrimaryKey"
+    The '__mdt' suffix is appended to the end of the name if it's omitted.
 ```
 
-_See code: [src/commands/force/cmdt/record/insert.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v2.0.0/src/commands/force/cmdt/record/insert.ts)_
+_See code: [src/commands/cmdt/generate/records.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/2.2.6/src/commands/cmdt/generate/records.ts)_
 
 <!-- commandsstop -->
 
diff --git a/package.json b/package.json
index 5a8b6222..4d7f4cef 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-custom-metadata",
   "description": "Tools for working with custom metadata types and their records.",
-  "version": "2.2.5",
+  "version": "2.2.6",
   "contributors": [
     {
       "name": "Carolyn Grabill",