@salesforce/plugin-bre-to-cml 1.3.0 → 1.3.2

package/messages/insurance.import.record-updates.md

@@ -0,0 +1,176 @@
+# summary
+
+Applies a record-update file emitted by a cml convert command to the target org.
+
+# description
+
+Reads a `<cmlApi>_SurchargeUpdate.json` or `<cmlApi>_UnderwritingUpdate.json` file — the reviewable record-update plan emitted by `sf cml convert surcharge-rules` / `sf cml convert underwriting-rules` — and applies its changes to the org. Convert is file-only and never writes to the org; this command is the apply step.
+
+The file is treated as untrusted input: it is structurally validated, every record is re-read from the org before anything is written, and each record's Name (plus the rule apiName for underwriting rule updates) is cross-checked against the file so an edited id cannot retarget a different record. Records whose org values already match are skipped, which makes re-running the command safe and idempotent.
+
+Before applying, the command prints every planned field-level change and asks for confirmation. Use --dry-run to review the plan without writing, and --no-prompt to apply without confirmation in automation. Changes are applied in order and are not rolled back, so a mid-apply failure can leave the org partially migrated; re-running is safe because already-applied records are skipped.
+
+Import the merged CML with `sf cml import as-expression-set` BEFORE applying a surcharge record-update file. The platform regenerates ProductSurcharge.RuleKey when RuleEngineType flips, and this command verifies that regenerated key against the key the CML rule was emitted under. That regeneration also requires the parent Surcharge.Code to be non-null — a surcharge whose parent Surcharge has a null Code cannot be flipped to ConstraintEngine and the org raises a save-hook error.
+
+# examples
+
+- Review the planned changes without writing anything:
+
+  <%= config.bin %> <%= command.id %> --file data/SURCHARGE_CML_SurchargeUpdate.json --target-org myOrg --dry-run
+
+- Apply the changes, confirming the preview interactively:
+
+  <%= config.bin %> <%= command.id %> --file data/SURCHARGE_CML_SurchargeUpdate.json --target-org myOrg
+
+- Apply the changes without a confirmation prompt, for automation:
+
+  <%= config.bin %> <%= command.id %> --file data/UW_CML_UnderwritingUpdate.json --target-org myOrg --no-prompt
+
+# flags.file.summary
+
+Path to the record-update JSON file emitted by a cml convert command.
+
+# flags.no-prompt.summary
+
+Don't prompt for confirmation before applying the changes.
+
+# flags.dry-run.summary
+
+Show the planned changes and exit without writing anything to the org.
+
+# info.nothingToApply
+
+The file contains no updates. Nothing to apply.
+
+# info.dryRun
+
+Dry run only — no changes were applied.
+
+# info.applySummary
+
+Records: %s updated, %s skipped (already current), %s failed.
+
+# warn.header
+
+These changes will be applied to %s
+
+# warn.summary
+
+%s to update, %s already current (will be skipped) in org %s.
+
+# warn.notTransactional
+
+Changes are applied in order and are NOT rolled back; a mid-apply failure can leave the org partially migrated.
+
+# warn.outcomeUnknown
+
+OUTCOME UNKNOWN %s (%s): %s. The request failed after it was sent, so the org may or may not hold this change; re-read the record before re-running.
+
+# warn.skippingPrompt
+
+Proceeding without confirmation because --no-prompt was passed.
+
+# confirm.apply
+
+Apply these changes to the org
+
+# error.unreadableFile
+
+Couldn't read the record-update file %s. %s
+
+# error.unreadableFile.actions
+
+- Check that the path points at a readable file (not a directory) and that you have permission to read it.
+
+# error.invalidFile
+
+Invalid record-update file. %s
+
+# error.invalidFile.actions
+
+- Regenerate the file with the matching `sf cml convert` command, or correct the reported problem by hand.
+
+# error.duplicateRecordId
+
+Invalid record-update file: the same record appears in it more than once. %s
+
+# error.duplicateRecordId.actions
+
+- Keep exactly one entry per record. If the repeated entries set different values, decide which value you intend and delete the others: a preview that shows one record twice, with two different outcomes, isn't something you can consent to.
+- Regenerate the file with the matching `sf cml convert` command if you can't tell which of the entries is the correct one.
+
+# error.recordIdentityMismatch
+
+Refusing to apply: the org state doesn't match the record-update file.
+
+%s
+
+# error.recordIdentityMismatch.actions
+
+- Regenerate the record-update file against this org, or hand-correct each reported entry so its id and name both match the record you mean to update. A record that was simply renamed in the org needs its `name` corrected, not its `id`.
+
+# error.unreadableOrgBlob
+
+Refusing to apply: the DynamicRuleDefinition stored in the org can't be parsed, so the identity check that keeps this write off the wrong record couldn't run.
+
+%s
+
+# error.unreadableOrgBlob.actions
+
+- Read the record's DynamicRuleDefinition out of the org (`sf data query --query "SELECT Id, Name, DynamicRuleDefinition FROM UnderwritingRule WHERE Id = '<id>'" --target-org <org>`) and repair or restore it, then re-run. Regenerating the record-update file won't help: convert reads the same unparseable value.
+- Drop the reported records from the file if you want to migrate the rest first; the records left in it are applied normally.
+
+# error.identityCheckUnavailable
+
+Refusing to apply: an identity check this command relies on couldn't run, so it can't confirm it would write to the right record. This is a defect in the plugin, not in your file.
+
+%s
+
+# error.identityCheckUnavailable.actions
+
+- Report this to the plugin maintainers with the message above and the command you ran. Editing the record-update file can't affect it — the missing data is a field the plugin failed to read back from the org.
+- Nothing was written: the check runs before any write, so the org is exactly as it was. Re-running, with or without --dry-run, refuses in the same place until the defect is fixed.
+
+# error.confirmationRequired
+
+Confirmation is required to apply changes to the org, but the terminal isn't interactive.
+
+# error.confirmationRequired.actions
+
+- Run again with --no-prompt to apply without confirmation (consider --dry-run first), or run interactively.
+
+# error.confirmationRequiredJson
+
+Confirmation is required to apply changes to the org, but the confirmation prompt is suppressed under --json because prompting would write prompt text into the JSON output stream.
+
+# error.confirmationRequiredJson.actions
+
+- Run again with --no-prompt to apply without confirmation, or with --dry-run to review the planned changes without writing.
+
+# error.aborted
+
+Aborted. No changes were applied to the org.
+
+# error.applyFailures
+
+%s of the record updates failed and %s succeeded. The org is partially migrated: the updates that succeeded are not rolled back.
+
+# error.applyFailures.actions
+
+- Fix the reported errors, then re-run (already-applied records are skipped): %s
+
+# error.applyFailuresNoneApplied
+
+%s of the record updates failed and none were applied, so this run left the org unchanged.
+
+# error.applyFailuresNoneApplied.actions
+
+- Fix the reported errors, then re-run. Nothing needs undoing first, because nothing was written: %s
+
+# error.applyFailuresOutcomeUnknown
+
+%s of the record updates failed and %s succeeded. %s of the failures happened after the request had been sent, so whether the org holds those changes is unknown; any update that did succeed is not rolled back.
+
+# error.applyFailuresOutcomeUnknown.actions
+
+- Re-read the records reported above as OUTCOME UNKNOWN to find out whether the org holds them, then fix the reported errors and re-run (already-applied records are skipped): %s

package/oclif.lock

@@ -1068,10 +1068,10 @@
     wordwrap "^1.0.0"
     wrap-ansi "^7.0.0"
 
-"@oclif/plugin-command-snapshot@^5.3.33":
-  version "5.3.33"
-  resolved "https://registry.yarnpkg.com/@oclif/plugin-command-snapshot/-/plugin-command-snapshot-5.3.33.tgz#36f6cc1b8b9154e6087f9f7f8a3a83b0c089198f"
-  integrity sha512-Djtpaf6tO73cWMLXY+i7SZgfkVz3zRFZ1rwTKrAQZ55gN22zjHn0QXc181dtEGYcVb+laYJGHo/epvDntySi3g==
+"@oclif/plugin-command-snapshot@^5.3.35":
+  version "5.3.35"
+  resolved "https://registry.yarnpkg.com/@oclif/plugin-command-snapshot/-/plugin-command-snapshot-5.3.35.tgz#0bb1f3627a4d3209c5bd41089dbfffefbf94a60e"
+  integrity sha512-IIj6zISG1muLLSpPI560n6Q2F4njN+OFTP/PXp+sdGxrB0pT/NtuRQ6DXwo0fvOX2AA6aG7HMLNYRO5h5feGJg==
   dependencies:
     "@oclif/core" "^4"
     ansis "^3.17.0"
@@ -1128,10 +1128,10 @@
     strip-ansi "^7.2.0"
     wrap-ansi "^9.0.2"
 
-"@oclif/test@^4.1.21":
-  version "4.1.21"
-  resolved "https://registry.yarnpkg.com/@oclif/test/-/test-4.1.21.tgz#3c46cfd7671df4019e7d9a43be94509d827fe285"
-  integrity sha512-3Hsqv1mo7P/n8qXKJ4nLTYISA3oPzXGZDc4R9ioi5hpK1lQ7UI1ZcLkt0aKJ1qMKrYStzk20IWhcPRT0Vpteyw==
+"@oclif/test@^4.1.22":
+  version "4.1.22"
+  resolved "https://registry.yarnpkg.com/@oclif/test/-/test-4.1.22.tgz#5a0db873e91b6267b0360619970069f456ba3378"
+  integrity sha512-szaFr78p60axV6ECky9U2SMABE0g1JQpV3qyRjuPCt0pyAlgEzXodLnk99coqE1mny2qYlOU440dd37Xd/AQUA==
   dependencies:
     ansis "^3.17.0"
     debug "^4.4.3"
@@ -1167,12 +1167,12 @@
   resolved "https://registry.yarnpkg.com/@rtsao/scc/-/scc-1.1.0.tgz#927dd2fae9bc3361403ac2c7a00c32ddce9ad7e8"
   integrity sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g==
 
-"@salesforce/cli-plugins-testkit@^5.3.64":
-  version "5.3.64"
-  resolved "https://registry.yarnpkg.com/@salesforce/cli-plugins-testkit/-/cli-plugins-testkit-5.3.64.tgz#6c28fefc787f83096cb274e38fc855727ffa13f3"
-  integrity sha512-4jUPow+oOr2Jp3s3QKCS1Aw9qs9AV2sIuk3YvWz9gMd7Y3/wVROG4C5OelfnrClGocxDAOVaCgJrTSoF0VQzUg==
+"@salesforce/cli-plugins-testkit@^5.3.66":
+  version "5.3.66"
+  resolved "https://registry.yarnpkg.com/@salesforce/cli-plugins-testkit/-/cli-plugins-testkit-5.3.66.tgz#918a61e62092495bb9fadd1dee38e281d4e7b334"
+  integrity sha512-xmco8MRlrpPmj2n9LZ8hkp0aWWDXbFDvNzTOC6h/z756PSu+g3ERNsW+HwXiyrirMd7rH7IalKSMcNXgWS/f3w==
   dependencies:
-    "@salesforce/core" "^8.31.2"
+    "@salesforce/core" "^8.32.6"
     "@salesforce/kit" "^3.2.6"
     "@salesforce/ts-types" "^2.0.11"
     "@types/shelljs" "^0.10.0"
@@ -1183,7 +1183,7 @@
     strip-ansi "6.0.1"
     ts-retry-promise "^0.8.1"
 
-"@salesforce/core@^8.23.1", "@salesforce/core@^8.31.2", "@salesforce/core@^8.31.4", "@salesforce/core@^8.32.6":
+"@salesforce/core@^8.23.1", "@salesforce/core@^8.31.4", "@salesforce/core@^8.32.6":
   version "8.32.6"
   resolved "https://registry.yarnpkg.com/@salesforce/core/-/core-8.32.6.tgz#2824dc917888dc040995dfef3a9e83d41fafbdea"
   integrity sha512-ZR973WoqCgi6cR58WhgokbHVZOaADNKHiuM1FAwS5pTLQnC91xYi04i2e/gpAX2AUf7Ya6zjbusYtZNpSyKKAQ==
@@ -1252,10 +1252,10 @@
   dependencies:
     "@salesforce/ts-types" "^2.0.12"
 
-"@salesforce/plugin-command-reference@^3.1.131":
-  version "3.1.131"
-  resolved "https://registry.yarnpkg.com/@salesforce/plugin-command-reference/-/plugin-command-reference-3.1.131.tgz#642bc96a550540e1cec0b44b76d53d0b40360ea9"
-  integrity sha512-CGNwVXCnsZa+X70apV0HUUOyQSf8w1jyG3GhPBv3Gh0X+Dppartlc3tsmkkYO1s9VbYgsTv0nTaaScsMVeFxcA==
+"@salesforce/plugin-command-reference@^3.1.132":
+  version "3.1.132"
+  resolved "https://registry.yarnpkg.com/@salesforce/plugin-command-reference/-/plugin-command-reference-3.1.132.tgz#b40af2618d13466728211b7b88b312a2104c5b4f"
+  integrity sha512-khxcwV+djsdN7pa2gRQjy3Xvn5RJ4/AqCdvsIfU70bZKo2LqjHK9O+Pkz0F7ci2ao4nyamRlyL9C6rpKPg+N+g==
   dependencies:
     "@oclif/core" "^4"
     "@salesforce/core" "^8.32.6"
@@ -3314,9 +3314,9 @@ extend@^3.0.2:
   integrity sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==
 
 fast-copy@^3.0.2:
-  version "3.0.2"
-  resolved "https://registry.yarnpkg.com/fast-copy/-/fast-copy-3.0.2.tgz#59c68f59ccbcac82050ba992e0d5c389097c9d35"
-  integrity sha512-dl0O9Vhju8IrcLndv2eU4ldt1ftXMqqfgN4H1cpmGV7P6jeB9FwpN9a2c8DPGE1Ys88rNUJVYDHq73CGAGOPfQ==
+  version "3.1.0"
+  resolved "https://registry.yarnpkg.com/fast-copy/-/fast-copy-3.1.0.tgz#1787743b5384319d62ee72a01720345104226802"
+  integrity sha512-IuCOCDFM1F/s4LtG7Bjr3yUUwPHybyhqN74xk2cMYoP51vVeErMy8+6HGFchi/+45lW8uzhs6lBeEqks2GWt6A==
 
 fast-deep-equal@^3.1.1, fast-deep-equal@^3.1.3:
   version "3.1.3"
@@ -5488,10 +5488,10 @@ object.values@^1.2.1:
     define-properties "^1.2.1"
     es-object-atoms "^1.0.0"
 
-oclif@^4.23.29:
-  version "4.23.29"
-  resolved "https://registry.yarnpkg.com/oclif/-/oclif-4.23.29.tgz#3b62399a0ce68370c9a6bebc6fb9eea776729f62"
-  integrity sha512-pUekmMh+wwIbFq3xX1EfkgZ7RuYuuSbdhJiB+20zqSfGE8Tt9T+K9br1/vmsaIOxfDo0Dw3jxLBk4JZOMFEMeQ==
+oclif@^4.23.30:
+  version "4.23.30"
+  resolved "https://registry.yarnpkg.com/oclif/-/oclif-4.23.30.tgz#d353a4eeb8b836214f3eaaa3f33c09c1468b2fd5"
+  integrity sha512-x8sMRv606XqZAWEfGh981PP2JM4G2CKt4/z2KDntoNHljD8slfJ5sHaDFUQya9w6W8xOJDMFF3UaLAFFYHo13w==
   dependencies:
     "@aws-sdk/client-cloudfront" "^3.1079.0"
     "@aws-sdk/client-s3" "^3.1079.0"
@@ -7129,9 +7129,9 @@ undici-types@~7.10.0:
   integrity sha512-t5Fy/nfn+14LuOc2KNYg75vZqClpAiqscVvMygNnlsHBFpSXdJaYtXMcdNLpl/Qvc3P2cB3s6lOV51nqsFq4ag==
 
 undici@^8.5.0:
-  version "8.10.0"
-  resolved "https://registry.yarnpkg.com/undici/-/undici-8.10.0.tgz#67ed7c4087f0f40fba7bef3a46f2be80572f2473"
-  integrity sha512-HvltHd7avK13QIw/oLe4qoOLyoVSoafqJ2jYOrtMRBkbYT31eiBQ8O0ehRKZiEZCMEyLFQNIADpgCWC5fALvYQ==
+  version "8.11.2"
+  resolved "https://registry.yarnpkg.com/undici/-/undici-8.11.2.tgz#b8f6f6504384ae535c8e46f8403fd8075f011d46"
+  integrity sha512-u4UB2/IrKdU6lFxumHmmo1a3fCQO5tzQllRorfoRS63txhrB7xTpSn1PftwC4qEHkOaqP95fCWW4lJzwErwzhQ==
 
 unicorn-magic@^0.3.0:
   version "0.3.0"

package/oclif.manifest.json

@@ -1,5 +1,99 @@
 {
   "commands": {
+    "cml:import:as-expression-set": {
+      "aliases": [],
+      "args": {},
+      "description": "Review CM created by conversion command before doing import.  \nThis command executes following logic:\n- Import one CML at a time\n- Upsert the Expression Set using the `cml-api` name\n- Read and upsert `ExpressionSetConstraintObj` rows from the `cml-api_associations.csv` file (resolving FKs)\n- Upload the CML blob",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --cml-api MY_TEST --context-definition PricingTransactionCD2 --workspace-dir data --target-org tgtOrg"
+      ],
+      "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": {
+          "char": "o",
+          "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": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "context-definition": {
+          "char": "x",
+          "name": "context-definition",
+          "required": true,
+          "summary": "Context Definition name to be assocciated with the CML.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cml-api": {
+          "char": "c",
+          "name": "cml-api",
+          "required": true,
+          "summary": "Unique CML API Name to be created.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace-dir": {
+          "char": "d",
+          "name": "workspace-dir",
+          "summary": "Directory where converted CML and assocciations csv files are located.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "cml:import:as-expression-set",
+      "pluginAlias": "@salesforce/plugin-bre-to-cml",
+      "pluginName": "@salesforce/plugin-bre-to-cml",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Imports CML and associations to the target org",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cml",
+        "import",
+        "as-expression-set.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "cml:import:as-expression-set",
+        "import:cml:as-expression-set",
+        "import:as-expression-set:cml",
+        "cml:as-expression-set:import",
+        "as-expression-set:cml:import",
+        "as-expression-set:import:cml"
+      ]
+    },
     "cml:convert:prod-cfg-rules": {
       "aliases": [],
       "args": {},
@@ -113,7 +207,7 @@
     "cml:convert:surcharge-rules": {
       "aliases": [],
       "args": {},
-      "description": "Reads ProductSurcharge records from the org (or a JSON file), parses their RuleDefinition, and merges the generated surcharge rules into the org's existing curated ConstraintModel for the resolved CML API. Each surcharge rule is nested into its leaf product type with a platform-compatible pathed rule key (matching the RuleKey the platform auto-generates), so the rule actually fires for nested products instead of being silently dropped. The command is file-only and never writes to the org. It requires an existing CML model to merge into and outputs a .cml file with the full merged model, a header-only \\_Associations.csv file, a \\_RuleKeyMapping.json with the ProductSurcharge ID to RuleKey mapping, and a \\_SurchargeUpdate.json file enumerating the org-record changes. Review the files, then apply the CML with `sf cml import as-expression-set` and apply the org-record changes enumerated in the \\_SurchargeUpdate.json file to the org separately (in that order).",
+      "description": "Reads ProductSurcharge records from the org (or a JSON file), parses their RuleDefinition, and merges the generated surcharge rules into the org's existing curated ConstraintModel for the resolved CML API. Each surcharge rule is nested into its leaf product type with a platform-compatible pathed rule key (matching the RuleKey the platform auto-generates), so the rule actually fires for nested products instead of being silently dropped. The command is file-only and never writes to the org. It requires an existing CML model to merge into and outputs a .cml file with the full merged model, a header-only \\_Associations.csv file, a \\_RuleKeyMapping.json with the ProductSurcharge ID to RuleKey mapping, and a \\_SurchargeUpdate.json file enumerating the org-record changes. Review the files, then apply the CML with `sf cml import as-expression-set` and apply the \\_SurchargeUpdate.json file with `sf insurance import record-updates` (in that order — the platform regenerates ProductSurcharge.RuleKey against the active model when RuleEngineType flips).\n\nThe parent Surcharge's Code field must be set (non-null): the platform derives the leaf segment of the auto-generated ProductSurcharge.RuleKey from Surcharge.Code, so the converter uses it to build a matching rule key. A surcharge whose parent Surcharge has a null Code cannot be flipped to ConstraintEngine (the org raises a save-hook error) and will not convert correctly — populate Surcharge.Code before converting.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --cml-api SURCHARGE_CML --target-org myOrg",
         "<%= config.bin %> <%= command.id %> --cml-api SURCHARGE_CML --surcharge-file path/to/surcharges.json --workspace-dir data --target-org myOrg"
@@ -212,7 +306,7 @@
     "cml:convert:underwriting-rules": {
       "aliases": [],
       "args": {},
-      "description": "Reads UnderwritingRule records from the org (or a JSON file), parses their DynamicRuleDefinition, and generates CML constraints that evaluate underwriting eligibility. Each rule becomes a named constraint that returns true/false. The command is file-only and never writes to the org: it outputs a .cml file with the constraint model, an \\_Associations.csv file for ExpressionSetConstraintObj records, a \\_RuleKeyMapping.json with the UnderwritingRule ID to RuleKey mapping, and a \\_UnderwritingUpdate.json file enumerating the org-record changes. Review the files, then apply the CML with `sf cml import as-expression-set` and apply the org-record changes enumerated in the \\_UnderwritingUpdate.json file to the org separately.",
+      "description": "Reads UnderwritingRule records from the org (or a JSON file), parses their DynamicRuleDefinition, and generates CML constraints that evaluate underwriting eligibility. Each rule becomes a named constraint that returns true/false. The command is file-only and never writes to the org: it outputs a .cml file with the constraint model, an \\_Associations.csv file for ExpressionSetConstraintObj records, a \\_RuleKeyMapping.json with the UnderwritingRule ID to RuleKey mapping, and a \\_UnderwritingUpdate.json file enumerating the org-record changes. Review the files, then apply the CML with `sf cml import as-expression-set` and apply the \\_UnderwritingUpdate.json file with `sf insurance import record-updates`.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --cml-api UW_CML --target-org myOrg",
         "<%= config.bin %> <%= command.id %> --cml-api UW_CML --uw-file data/underwriting.json --workspace-dir data --target-org myOrg"
@@ -308,12 +402,14 @@
         "underwriting-rules:convert:cml"
       ]
     },
-    "cml:import:as-expression-set": {
+    "insurance:import:record-updates": {
       "aliases": [],
       "args": {},
-      "description": "Review CM created by conversion command before doing import.  \nThis command executes following logic:\n- Import one CML at a time\n- Upsert the Expression Set using the `cml-api` name\n- Read and upsert `ExpressionSetConstraintObj` rows from the `cml-api_associations.csv` file (resolving FKs)\n- Upload the CML blob",
+      "description": "Reads a `<cmlApi>_SurchargeUpdate.json` or `<cmlApi>_UnderwritingUpdate.json` file — the reviewable record-update plan emitted by `sf cml convert surcharge-rules` / `sf cml convert underwriting-rules` — and applies its changes to the org. Convert is file-only and never writes to the org; this command is the apply step.\n\nThe file is treated as untrusted input: it is structurally validated, every record is re-read from the org before anything is written, and each record's Name (plus the rule apiName for underwriting rule updates) is cross-checked against the file so an edited id cannot retarget a different record. Records whose org values already match are skipped, which makes re-running the command safe and idempotent.\n\nBefore applying, the command prints every planned field-level change and asks for confirmation. Use --dry-run to review the plan without writing, and --no-prompt to apply without confirmation in automation. Changes are applied in order and are not rolled back, so a mid-apply failure can leave the org partially migrated; re-running is safe because already-applied records are skipped.\n\nImport the merged CML with `sf cml import as-expression-set` BEFORE applying a surcharge record-update file. The platform regenerates ProductSurcharge.RuleKey when RuleEngineType flips, and this command verifies that regenerated key against the key the CML rule was emitted under. That regeneration also requires the parent Surcharge.Code to be non-null — a surcharge whose parent Surcharge has a null Code cannot be flipped to ConstraintEngine and the org raises a save-hook error.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --cml-api MY_TEST --context-definition PricingTransactionCD2 --workspace-dir data --target-org tgtOrg"
+        "Review the planned changes without writing anything:\n<%= config.bin %> <%= command.id %> --file data/SURCHARGE_CML_SurchargeUpdate.json --target-org myOrg --dry-run",
+        "Apply the changes, confirming the preview interactively:\n<%= config.bin %> <%= command.id %> --file data/SURCHARGE_CML_SurchargeUpdate.json --target-org myOrg",
+        "Apply the changes without a confirmation prompt, for automation:\n<%= config.bin %> <%= command.id %> --file data/UW_CML_UnderwritingUpdate.json --target-org myOrg --no-prompt"
       ],
       "flags": {
         "json": {
@@ -348,60 +444,56 @@
           "multiple": false,
           "type": "option"
         },
-        "context-definition": {
-          "char": "x",
-          "name": "context-definition",
+        "file": {
+          "char": "f",
+          "name": "file",
           "required": true,
-          "summary": "Context Definition name to be assocciated with the CML.",
+          "summary": "Path to the record-update JSON file emitted by a cml convert command.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "cml-api": {
-          "char": "c",
-          "name": "cml-api",
-          "required": true,
-          "summary": "Unique CML API Name to be created.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "no-prompt": {
+          "char": "p",
+          "name": "no-prompt",
+          "summary": "Don't prompt for confirmation before applying the changes.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "workspace-dir": {
-          "char": "d",
-          "name": "workspace-dir",
-          "summary": "Directory where converted CML and assocciations csv files are located.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Show the planned changes and exit without writing anything to the org.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "cml:import:as-expression-set",
+      "id": "insurance:import:record-updates",
       "pluginAlias": "@salesforce/plugin-bre-to-cml",
       "pluginName": "@salesforce/plugin-bre-to-cml",
       "pluginType": "core",
       "strict": true,
-      "summary": "Imports CML and associations to the target org",
+      "summary": "Applies a record-update file emitted by a cml convert command to the target org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
-        "cml",
+        "insurance",
         "import",
-        "as-expression-set.js"
+        "record-updates.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "cml:import:as-expression-set",
-        "import:cml:as-expression-set",
-        "import:as-expression-set:cml",
-        "cml:as-expression-set:import",
-        "as-expression-set:cml:import",
-        "as-expression-set:import:cml"
+        "insurance:import:record-updates",
+        "import:insurance:record-updates",
+        "import:record-updates:insurance",
+        "insurance:record-updates:import",
+        "record-updates:insurance:import",
+        "record-updates:import:insurance"
       ]
     }
   },
-  "version": "1.3.0"
+  "version": "1.3.2"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-bre-to-cml",
     "description": "Plugin for migrating BRE based configurator rules to CML.",
-    "version": "1.3.0",
+    "version": "1.3.2",
     "salesforceRelease": "256.11",
     "dependencies": {
         "@oclif/core": "^4",
@@ -11,15 +11,15 @@
         "got": "12"
     },
     "devDependencies": {
-        "@oclif/plugin-command-snapshot": "^5.3.33",
-        "@oclif/test": "^4.1.21",
-        "@salesforce/cli-plugins-testkit": "^5.3.64",
+        "@oclif/plugin-command-snapshot": "^5.3.35",
+        "@oclif/test": "^4.1.22",
+        "@salesforce/cli-plugins-testkit": "^5.3.66",
         "@salesforce/dev-scripts": "^11.0.4",
-        "@salesforce/plugin-command-reference": "^3.1.131",
+        "@salesforce/plugin-command-reference": "^3.1.132",
         "@types/node": "^22.20.1",
         "eslint-config-salesforce-license": "^1.0.2",
         "eslint-plugin-sf-plugin": "^1.20.33",
-        "oclif": "^4.23.29",
+        "oclif": "^4.23.30",
         "ts-node": "^10.9.2",
         "typescript": "^5.9.3"
     },
@@ -62,6 +62,14 @@
                         "description": "description for cml.import"
                     }
                 }
+            },
+            "insurance": {
+                "description": "description for insurance",
+                "subtopics": {
+                    "import": {
+                        "description": "description for insurance.import"
+                    }
+                }
             }
         },
         "flexibleTaxonomy": true
@@ -221,7 +229,7 @@
     "type": "module",
     "author": "George Kibilov",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-bre-to-cml/1.3.0.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-bre-to-cml/1.3.0.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-bre-to-cml/1.3.2.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-bre-to-cml/1.3.2.sig"
     }
 }