@salesforce/plugin-bre-to-cml 1.1.5 → 1.2.5

package/README.md

@@ -58,6 +58,13 @@ sf plugins
 
 ## Commands
 
+### Insurance: merging surcharge rules into an existing model
+
+`cml convert surcharge-rules` **always** merges generated surcharge rules into an org's existing
+curated `ConstraintModel` — nesting each rule into its leaf product type with a platform-compatible
+pathed rule key — rather than building a fresh, flat model. It requires an existing CML model for the
+resolved CML API.
+
 <!-- commands -->
 
 - [`sf cml convert prod-cfg-rules`](#sf-cml-convert-prod-cfg-rules)
@@ -140,7 +147,9 @@ FLAGS
   -o, --target-org=<value>      (required) Username or alias of the target org. Not required if the `target-org`
                                 configuration variable is already set.
       --api-version=<value>     Override the api version used for api requests made by this command
-      --update-records          Update source records in the org with RuleEngineType=ConstraintEngine.
+      --update-records          REMOVED. Convert no longer writes to the org; passing this flag now errors. Convert
+                                instead emits a reviewable record-update file enumerating the org-record changes, which
+                                you apply to the org separately.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -149,11 +158,15 @@ GLOBAL FLAGS
 DESCRIPTION
   Converts BRE-based Product Surcharge dynamic rules to CML eligibility constraints.
 
-  Reads ProductSurcharge records from the org (or a JSON file), parses their RuleDefinition, and generates CML
-  constraints that evaluate surcharge eligibility. Each surcharge rule becomes a named constraint that returns
-  true/false. The command outputs a .cml file with the constraint model, an \_Associations.csv file for
-  ExpressionSetConstraintObj records, and a \_RuleKeyMapping.json with the ProductSurcharge ID to RuleKey mapping for
-  updating records.
+  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).
 
 EXAMPLES
   $ sf cml convert surcharge-rules --cml-api SURCHARGE_CML --target-org myOrg
@@ -179,7 +192,9 @@ FLAGS
   -o, --target-org=<value>     (required) Username or alias of the target org. Not required if the `target-org`
                                configuration variable is already set.
       --api-version=<value>    Override the api version used for api requests made by this command
-      --update-records         Update source records in the org with RuleEngineType=ConstraintEngine.
+      --update-records         REMOVED. Convert no longer writes to the org; passing this flag now errors. Convert
+                               instead emits a reviewable record-update file enumerating the org-record changes, which
+                               you apply to the org separately.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -190,8 +205,11 @@ 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 outputs a .cml file with the constraint model, an \_Associations.csv file for ExpressionSetConstraintObj
-  records, and a \_RuleKeyMapping.json with the UnderwritingRule ID to RuleKey mapping for updating records.
+  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.
 
 EXAMPLES
   $ sf cml convert underwriting-rules --cml-api UW_CML --target-org myOrg

package/lib/commands/cml/convert/surcharge-rules.d.ts

@@ -1,6 +1,6 @@
 import { Connection } from '@salesforce/core';
-import { ParsedRuleDefinition, RuleKeyEntry, RuleRecord } from '../../../shared/insurance/models.js';
-import { InsuranceRuleConvertCommand, InsuranceRuleConvertResult } from '../../../shared/insurance/insurance-rule-convert-command.js';
+import { ParsedRuleDefinition, RecordUpdate, RuleKeyEntry, RuleRecord } from '../../../shared/insurance/models.js';
+import { InsuranceRuleConvertCommand, InsuranceRuleConvertContext, InsuranceRuleConvertResult, ParsedRuleEntry } from '../../../shared/insurance/insurance-rule-convert-command.js';
 type ProductSurchargeRecord = RuleRecord & {
     RuleDefinition: string | null;
 };
@@ -21,9 +21,25 @@ export default class CmlConvertSurchargeRules extends InsuranceRuleConvertComman
     protected readonly keyPrefix = "SC";
     protected readonly constraintLabel = "Surcharge eligibility";
     protected readonly apiNamePrefix = "SC_";
+    protected readonly ruleType = "InsuranceSurchargeRule";
     protected readonly soql = "SELECT Id, Name, RuleDefinition, ProductPath FROM ProductSurcharge WHERE RuleApiName != null";
+    protected readonly recordUpdateKind: "surcharge-update";
+    private readonly surchargeProductCodes;
     run(): Promise<CmlConvertSurchargeRulesResult>;
+    /**
+     * Merge mode: read the org's existing ConstraintModel, compute each surcharge's pathed rule key
+     * (matching the platform's auto-generated RuleKey), and nest the `rule(...)` statement into the
+     * correct existing leaf `type` block — instead of overwriting the curated model with a flat one.
+     */
+    protected runMergeConvert(_ctx: InsuranceRuleConvertContext, conn: Connection, records: ProductSurchargeRecord[], ruleDefs: ParsedRuleEntry[], productIdToCode: Map<string, string>, api: string, safeApi: string, workspaceDir: string): Promise<InsuranceRuleConvertResult>;
     protected parseRecord(record: ProductSurchargeRecord): ParsedRuleDefinition | null;
-    protected updateOrgRecords(_records: ProductSurchargeRecord[], ruleKeyMapping: RuleKeyEntry[], conn: Connection): Promise<void>;
+    /**
+     * Pure transform — the file-only successor to the old live updateOrgRecords. Mirrors it exactly:
+     * one ProductSurcharge per placed rule, flipping RuleEngineType to ConstraintEngine. The
+     * expectedRuleKey (the convert-computed pathed key) and productCodes are advisory — they are NOT
+     * written to the org (the platform regenerates ProductSurcharge.RuleKey on the flip); the apply
+     * uses them to verify the surcharge will actually fire and to flag ProductCode/ProductPath drift.
+     */
+    protected buildRecordUpdates(_records: ProductSurchargeRecord[], ruleKeyMapping: RuleKeyEntry[]): RecordUpdate[];
 }
 export {};

package/lib/commands/cml/convert/surcharge-rules.js

@@ -17,6 +17,7 @@ import { Flags } from '@salesforce/sf-plugins-core';
 import { Messages } from '@salesforce/core';
 import { InsuranceRuleConvertCommand, } from '../../../shared/insurance/insurance-rule-convert-command.js';
 import { decodeHtmlEntities } from '../../../shared/insurance/insurance-rule-generator.js';
+import { buildPathedSurchargeRules, fetchExistingConstraintModel, fetchProductTypeTags, mergeSurchargeRules, splitProductPath, } from '../../../shared/insurance/insurance-cml-merge.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-bre-to-cml', 'cml.convert.surcharge-rules');
 // eslint-disable-next-line sf-plugin/only-extend-SfCommand
@@ -36,7 +37,14 @@ export default class CmlConvertSurchargeRules extends InsuranceRuleConvertComman
     keyPrefix = 'SC';
     constraintLabel = 'Surcharge eligibility';
     apiNamePrefix = 'SC_';
+    // Emit surcharge eligibility as a CML `rule(decl, "InsuranceSurchargeRule", "<ruleKey>", "True")`.
+    ruleType = 'InsuranceSurchargeRule';
     soql = 'SELECT Id, Name, RuleDefinition, ProductPath FROM ProductSurcharge WHERE RuleApiName != null';
+    recordUpdateKind = 'surcharge-update';
+    // Populated during runMergeConvert (the only place the ProductPath→ProductCode mapping is known)
+    // and consumed by buildRecordUpdates, which the base calls to serialize the update file. Maps a
+    // ProductSurcharge Id to its ordered ProductCode path — advisory drift-detection for the apply.
+    surchargeProductCodes = new Map();
     async run() {
         const { flags } = await this.parse(CmlConvertSurchargeRules);
         return this.runConvert({
@@ -46,8 +54,79 @@ export default class CmlConvertSurchargeRules extends InsuranceRuleConvertComman
             workspaceDir: flags['workspace-dir'],
             inputFile: flags['surcharge-file'],
             updateRecords: flags['update-records'],
+            // Surcharge conversion ALWAYS merges into the org's existing curated ConstraintModel —
+            // the flat-overwrite build path is intentionally unreachable here (it silently drops nested
+            // surcharges via non-pathed rule keys). There is no flag to opt out.
+            mergeWithOrg: true,
         });
     }
+    /**
+     * Merge mode: read the org's existing ConstraintModel, compute each surcharge's pathed rule key
+     * (matching the platform's auto-generated RuleKey), and nest the `rule(...)` statement into the
+     * correct existing leaf `type` block — instead of overwriting the curated model with a flat one.
+     */
+    async runMergeConvert(_ctx, conn, records, ruleDefs, productIdToCode, api, safeApi, workspaceDir) {
+        const existing = await fetchExistingConstraintModel(conn, api);
+        if (!existing?.cmlText.trim()) {
+            this.error(`surcharge-rules merges into an existing ConstraintModel for CML API '${api}', but none was found. Create the curated model first (e.g. via the underwriting/prod-cfg converters or by importing a baseline), then re-run this command.`);
+        }
+        const productIds = new Set();
+        for (const { record } of ruleDefs) {
+            // [Fix #11] Route every ProductPath parse through one helper so trim + drop-empty semantics
+            // never diverge between the convert layer and the merge module.
+            for (const id of splitProductPath(record.ProductPath))
+                productIds.add(id);
+        }
+        const productIdToType = await fetchProductTypeTags(conn, productIds);
+        // Capture the ProductCode path per surcharge so the emitted update file can carry it (same
+        // mapping buildPathedSurchargeRules uses for the rule key). Drift here would desync the platform
+        // RuleKey, so it is recorded for the apply-time check rather than discarded.
+        this.surchargeProductCodes.clear();
+        for (const { record } of ruleDefs) {
+            // [Fix #11] Same single helper.
+            const codes = splitProductPath(record.ProductPath).map((id) => productIdToCode.get(id) ?? id);
+            this.surchargeProductCodes.set(record.Id, codes);
+        }
+        const rules = buildPathedSurchargeRules(this.keyPrefix, ruleDefs, productIdToCode, productIdToType);
+        rules.forEach((r) => this.log(`  -> ${r.recordName} => ${r.ruleKey} (type: ${r.typeName ?? 'UNRESOLVED'})`));
+        const { mergedCml, placements, skips, attributeWarnings } = mergeSurchargeRules(existing.cmlText, rules);
+        this.log(`\nMerge summary: ${placements.filter((p) => p.status === 'inserted').length} inserted, ${placements.filter((p) => p.status === 'replaced').length} updated in place, ${skips.length} skipped.`);
+        for (const s of skips)
+            this.warn(`  SKIPPED ${s.rule.recordName}: ${s.reason}`);
+        for (const w of attributeWarnings)
+            this.warn(`  ATTRIBUTE ${w}`);
+        // [Fix #9] When skips are present, log a high-signal final summary that buckets reasons —
+        // an operator scanning hundreds of per-rule warnings should not have to grep to learn whether
+        // they're staring at one duplicate or fifty missing-type-tag rules. Buckets match the merge
+        // module's skip-reason vocabulary; anything that doesn't match a known reason falls into "other".
+        if (skips.length > 0) {
+            const counts = { duplicate: 0, emptyPath: 0, noTypeTag: 0, typeBlockMissing: 0, typeBlockAmbiguous: 0, other: 0 };
+            for (const s of skips) {
+                if (s.reason.startsWith('duplicate pathed rule key'))
+                    counts.duplicate += 1;
+                else if (s.reason.startsWith('empty ProductPath'))
+                    counts.emptyPath += 1;
+                else if (s.reason.startsWith('no CML type tag'))
+                    counts.noTypeTag += 1;
+                else if (s.reason.includes('not found in existing model'))
+                    counts.typeBlockMissing += 1;
+                else if (s.reason.includes('is ambiguous'))
+                    counts.typeBlockAmbiguous += 1;
+                else
+                    counts.other += 1;
+            }
+            this.log(`Skip breakdown: ${counts.duplicate} duplicate-key, ${counts.emptyPath} empty-ProductPath, ` +
+                `${counts.noTypeTag} no-type-tag, ${counts.typeBlockMissing} type-block-missing, ` +
+                `${counts.typeBlockAmbiguous} type-block-ambiguous, ${counts.other} other`);
+        }
+        const ruleKeyMapping = placements.map((p) => ({
+            recordId: p.rule.recordId,
+            name: p.rule.recordName,
+            ruleKey: p.rule.ruleKey,
+        }));
+        const recordUpdateFile = await this.writeRecordUpdateFile(records, ruleKeyMapping, api, safeApi, workspaceDir);
+        return this.writeMergedOutputFiles(mergedCml, ruleKeyMapping, safeApi, workspaceDir, api, recordUpdateFile);
+    }
     parseRecord(record) {
         if (!record.RuleDefinition) {
             this.warn(`Skipping ${record.Name}: no RuleDefinition`);
@@ -67,20 +146,22 @@ export default class CmlConvertSurchargeRules extends InsuranceRuleConvertComman
             return null;
         }
     }
-    async updateOrgRecords(_records, ruleKeyMapping, conn) {
-        this.log('\nUpdating ProductSurcharge records with RuleEngineType=ConstraintEngine...');
-        const updates = ruleKeyMapping.map((m) => ({
-            Id: m.recordId,
-            RuleEngineType: 'ConstraintEngine',
+    /**
+     * Pure transform — the file-only successor to the old live updateOrgRecords. Mirrors it exactly:
+     * one ProductSurcharge per placed rule, flipping RuleEngineType to ConstraintEngine. The
+     * expectedRuleKey (the convert-computed pathed key) and productCodes are advisory — they are NOT
+     * written to the org (the platform regenerates ProductSurcharge.RuleKey on the flip); the apply
+     * uses them to verify the surcharge will actually fire and to flag ProductCode/ProductPath drift.
+     */
+    buildRecordUpdates(_records, ruleKeyMapping) {
+        return ruleKeyMapping.map((m) => ({
+            sobject: 'ProductSurcharge',
+            id: m.recordId,
+            name: m.name,
+            fields: [{ field: 'RuleEngineType', value: 'ConstraintEngine' }],
+            expectedRuleKey: m.ruleKey,
+            productCodes: this.surchargeProductCodes.get(m.recordId),
         }));
-        const results = await conn.sobject('ProductSurcharge').update(updates);
-        const list = Array.isArray(results) ? results : [results];
-        const successes = list.filter((r) => r.success);
-        const failures = list.filter((r) => !r.success);
-        this.log(`  Updated ${successes.length} records successfully`);
-        for (const f of failures) {
-            this.warn(`  Failed to update ${f.id ?? 'unknown'}: ${JSON.stringify(f.errors)}`);
-        }
     }
 }
 //# sourceMappingURL=surcharge-rules.js.map

package/lib/commands/cml/convert/surcharge-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"surcharge-rules.js","sourceRoot":"","sources":["../../../../src/commands/cml/convert/surcharge-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAc,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EACL,2BAA2B,GAE5B,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAE3F,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,+BAA+B,EAAE,6BAA6B,CAAC,CAAC;AAQvG,2DAA2D;AAC3D,MAAM,CAAC,OAAO,OAAO,wBAAyB,SAAQ,2BAAmD;IAChG,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,GAAG,2BAA2B,CAAC,KAAK;QACpC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC;YAC3B,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,8BAA8B,CAAC;YAC5D,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC;IAEiB,WAAW,GAAG,kBAAkB,CAAC;IACjC,SAAS,GAAG,IAAI,CAAC;IACjB,eAAe,GAAG,uBAAuB,CAAC;IAC1C,aAAa,GAAG,KAAK,CAAC;IACtB,IAAI,GACrB,8FAA8F,CAAC;IAE1F,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,UAAU,CAAC;YACrB,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;YAC9B,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;YAChC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;YACxB,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC;YAClC,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAES,WAAW,CAAC,MAA8B;QAClD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,IAAI,qBAAqB,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC,CAG/D,CAAC;YACF,OAAO;gBACL,GAAG,GAAG;gBACN,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI;gBACvC,WAAW,EAAE,MAAM,CAAC,WAAW;aACR,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,IAAI,CAAC,sCAAsC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAES,KAAK,CAAC,gBAAgB,CAC9B,QAAkC,EAClC,cAA8B,EAC9B,IAAgB;QAEhB,IAAI,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QACxF,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,EAAE,EAAE,CAAC,CAAC,QAAQ;YACd,cAAc,EAAE,kBAAkB;SACnC,CAAC,CAAC,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,aAAa,SAAS,CAAC,MAAM,uBAAuB,CAAC,CAAC;QAC/D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,EAAE,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC"}
+{"version":3,"file":"surcharge-rules.js","sourceRoot":"","sources":["../../../../src/commands/cml/convert/surcharge-rules.ts"],"names":[],"mappings":"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"}

package/lib/commands/cml/convert/underwriting-rules.d.ts

@@ -1,11 +1,13 @@
-import { Connection } from '@salesforce/core';
-import { ParsedRuleDefinition, RuleKeyEntry, RuleRecord } from '../../../shared/insurance/models.js';
+import { ParsedRuleDefinition, RecordUpdate, RuleKeyEntry, RuleRecord } from '../../../shared/insurance/models.js';
 import { InsuranceRuleConvertCommand, InsuranceRuleConvertResult } from '../../../shared/insurance/insurance-rule-convert-command.js';
 type UnderwritingRuleRecord = RuleRecord & {
     ApiName: string | null;
     DynamicRuleDefinition: string | null;
     RuleKey: string | null;
     UnderwritingRuleGroupId: string | null;
+    UnderwritingRuleGroup: {
+        Name: string | null;
+    } | null;
 };
 export type CmlConvertUnderwritingRulesResult = InsuranceRuleConvertResult;
 export default class CmlConvertUnderwritingRules extends InsuranceRuleConvertCommand<UnderwritingRuleRecord> {
@@ -24,9 +26,19 @@ export default class CmlConvertUnderwritingRules extends InsuranceRuleConvertCom
     protected readonly keyPrefix = "UW";
     protected readonly constraintLabel = "Underwriting eligibility";
     protected readonly apiNamePrefix = "UW_";
-    protected readonly soql = "SELECT Id, Name, ApiName, DynamicRuleDefinition, ProductPath, RuleKey, UnderwritingRuleGroupId FROM UnderwritingRule WHERE RuleKey = null";
+    protected readonly soql = "SELECT Id, Name, ApiName, DynamicRuleDefinition, ProductPath, RuleKey, UnderwritingRuleGroupId, UnderwritingRuleGroup.Name FROM UnderwritingRule WHERE RuleKey = null";
+    protected readonly recordUpdateKind: "underwriting-update";
     run(): Promise<CmlConvertUnderwritingRulesResult>;
     protected parseRecord(record: UnderwritingRuleRecord): ParsedRuleDefinition | null;
-    protected updateOrgRecords(records: UnderwritingRuleRecord[], ruleKeyMapping: RuleKeyEntry[], conn: Connection): Promise<void>;
+    /**
+     * Pure transform — the file-only successor to the old live updateOrgRecords. Produces the exact
+     * org-record changes convert previously applied: (1) each UnderwritingRuleGroup flipped to
+     * RuleEngineType=ConstraintEngine, then (2) each BRE UnderwritingRule's DynamicRuleDefinition blob
+     * rewritten with the converted ruleKey (and the nested underwritingRuleGroup.ruleEngineType, when
+     * present). Groups are emitted first so a faithful apply mirrors the original ordering. The blob
+     * rewrite uses a RAW JSON.parse of the org's stored value (NOT decodeHtmlEntities) — byte-for-byte
+     * the same mutation the live path performed.
+     */
+    protected buildRecordUpdates(records: UnderwritingRuleRecord[], ruleKeyMapping: RuleKeyEntry[]): RecordUpdate[];
 }
 export {};

package/lib/commands/cml/convert/underwriting-rules.js

@@ -38,7 +38,8 @@ export default class CmlConvertUnderwritingRules extends InsuranceRuleConvertCom
     apiNamePrefix = 'UW_';
     // DynamicRuleDefinition is a non-filterable (long text) field, so it can't appear in the
     // WHERE clause; records with a null DynamicRuleDefinition are skipped during parsing instead.
-    soql = 'SELECT Id, Name, ApiName, DynamicRuleDefinition, ProductPath, RuleKey, UnderwritingRuleGroupId FROM UnderwritingRule WHERE RuleKey = null';
+    soql = 'SELECT Id, Name, ApiName, DynamicRuleDefinition, ProductPath, RuleKey, UnderwritingRuleGroupId, UnderwritingRuleGroup.Name FROM UnderwritingRule WHERE RuleKey = null';
+    recordUpdateKind = 'underwriting-update';
     async run() {
         const { flags } = await this.parse(CmlConvertUnderwritingRules);
         return this.runConvert({
@@ -69,38 +70,41 @@ export default class CmlConvertUnderwritingRules extends InsuranceRuleConvertCom
             return null;
         }
     }
-    async updateOrgRecords(records, ruleKeyMapping, conn) {
-        const groupIds = new Set();
+    /**
+     * Pure transform — the file-only successor to the old live updateOrgRecords. Produces the exact
+     * org-record changes convert previously applied: (1) each UnderwritingRuleGroup flipped to
+     * RuleEngineType=ConstraintEngine, then (2) each BRE UnderwritingRule's DynamicRuleDefinition blob
+     * rewritten with the converted ruleKey (and the nested underwritingRuleGroup.ruleEngineType, when
+     * present). Groups are emitted first so a faithful apply mirrors the original ordering. The blob
+     * rewrite uses a RAW JSON.parse of the org's stored value (NOT decodeHtmlEntities) — byte-for-byte
+     * the same mutation the live path performed.
+     */
+    buildRecordUpdates(records, ruleKeyMapping) {
+        const updates = [];
+        // (1) UnderwritingRuleGroup flips — union of every referenced group, name resolved from the
+        // queried relationship so the apply-time identity guard has something to cross-check.
+        const groupNames = new Map();
         for (const record of records) {
             if (record.UnderwritingRuleGroupId) {
-                groupIds.add(record.UnderwritingRuleGroupId);
+                groupNames.set(record.UnderwritingRuleGroupId, record.UnderwritingRuleGroup?.Name ?? null);
             }
         }
-        if (groupIds.size > 0) {
-            this.log(`\nUpdating ${groupIds.size} UnderwritingRuleGroup records with RuleEngineType=ConstraintEngine...`);
-            const groupUpdates = Array.from(groupIds).map((id) => ({
-                Id: id,
-                RuleEngineType: 'ConstraintEngine',
-            }));
-            const groupResults = await conn.sobject('UnderwritingRuleGroup').update(groupUpdates);
-            const groupList = Array.isArray(groupResults) ? groupResults : [groupResults];
-            const groupSuccesses = groupList.filter((r) => r.success);
-            const groupFailures = groupList.filter((r) => !r.success);
-            this.log(`  Updated ${groupSuccesses.length} group records`);
-            for (const f of groupFailures) {
-                this.warn(`  Failed to update group ${f.id ?? 'unknown'}: ${JSON.stringify(f.errors)}`);
+        for (const [groupId, groupName] of groupNames) {
+            if (!groupName) {
+                // Without a Name the apply can't run its identity guard; skip rather than write blind.
+                this.warn(`Skipping UnderwritingRuleGroup ${groupId}: no Name resolved (cannot verify identity on apply)`);
+                continue;
             }
+            updates.push({
+                sobject: 'UnderwritingRuleGroup',
+                id: groupId,
+                name: groupName,
+                fields: [{ field: 'RuleEngineType', value: 'ConstraintEngine' }],
+            });
         }
+        // (2) UnderwritingRule DynamicRuleDefinition rewrites — same subset and same mutation as live.
         const ruleKeyMap = new Map(ruleKeyMapping.map((m) => [m.recordId, m.ruleKey]));
         const breRecords = records.filter((r) => !r.RuleKey && r.DynamicRuleDefinition);
-        if (breRecords.length === 0) {
-            this.log('\nNo BRE rules to update with RuleKey.');
-            return;
-        }
-        this.log(`\nUpdating ${breRecords.length} UnderwritingRule DynamicRuleDefinition with ruleKey and ruleEngineType...`);
-        let successCount = 0;
-        let failCount = 0;
-        const updates = [];
         for (const record of breRecords) {
             const ruleKey = ruleKeyMap.get(record.Id);
             if (!ruleKey || !record.DynamicRuleDefinition)
@@ -111,26 +115,19 @@ export default class CmlConvertUnderwritingRules extends InsuranceRuleConvertCom
                 if (defn.underwritingRuleGroup && typeof defn.underwritingRuleGroup === 'object') {
                     defn.underwritingRuleGroup.ruleEngineType = 'ConstraintEngine';
                 }
-                updates.push({ Id: record.Id, DynamicRuleDefinition: JSON.stringify(defn) });
+                updates.push({
+                    sobject: 'UnderwritingRule',
+                    id: record.Id,
+                    name: record.Name,
+                    apiName: record.ApiName ?? undefined,
+                    fields: [{ field: 'DynamicRuleDefinition', value: JSON.stringify(defn) }],
+                });
             }
             catch {
                 this.warn(`  Failed to parse DynamicRuleDefinition for ${record.Name}`);
-                failCount++;
-            }
-        }
-        if (updates.length > 0) {
-            const results = await conn.sobject('UnderwritingRule').update(updates);
-            for (const r of Array.isArray(results) ? results : [results]) {
-                if (r.success) {
-                    successCount++;
-                }
-                else {
-                    failCount++;
-                    this.warn(`  Failed to update ${r.id ?? 'unknown'}: ${JSON.stringify(r.errors)}`);
-                }
             }
         }
-        this.log(`  Updated ${successCount} rule records, ${failCount} failed`);
+        return updates;
     }
 }
 //# sourceMappingURL=underwriting-rules.js.map

package/lib/commands/cml/convert/underwriting-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"underwriting-rules.js","sourceRoot":"","sources":["../../../../src/commands/cml/convert/underwriting-rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"underwriting-rules.js","sourceRoot":"","sources":["../../../../src/commands/cml/convert/underwriting-rules.ts"],"names":[],"mappings":"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"}

package/lib/shared/insurance/insurance-cml-merge.d.ts

@@ -0,0 +1,91 @@
+import { Connection } from '@salesforce/core';
+import { ParsedRuleDefinition, RuleRecord } from './models.js';
+/**
+ * MERGE MODE (insurance-only): instead of building a fresh single-type CML and PATCH-replacing
+ * the org's curated "Gold Standard" ConstraintModel, this module reads the existing model text,
+ * computes each surcharge's PLATFORM-COMPATIBLE pathed rule key, and inserts/updates the
+ * `rule(...)` statement inside the correct existing leaf `type` block. The result is the full
+ * merged model, written to the same `${cmlApi}.cml` path the common import reads — so the import
+ * still does a whole-file PATCH, but the file now contains the curated model + the surcharge rules
+ * nested correctly rather than a flat overwrite.
+ *
+ * Why pathed keys: when a ProductSurcharge is persisted as ConstraintEngine the platform
+ * auto-generates `RuleKey` as `SC` + sanitize(ProductCode) of every segment in ProductPath (in
+ * order) + sanitize(apiName), joined by `__`. The Core surcharge engine matches the fired CML rule
+ * key against that auto-generated RuleKey by exact string, so the CML rule key MUST be pathed too.
+ */
+export declare const SURCHARGE_RULE_ACTION = "InsuranceSurchargeRule";
+export type PathedSurchargeRule = {
+    recordId: string;
+    recordName: string;
+    apiName: string;
+    /** Full pathed key: SC__<code-of-each-path-segment>__<apiName>. */
+    ruleKey: string;
+    /**
+     * Ordered ProductCodes for every ProductPath segment used to build {@link ruleKey}. Empty when the
+     * source ProductPath was blank/whitespace-only — the merge guards on this to refuse the replace
+     * path for malformed input (an empty-path rule degenerates to `SC__<apiName>` which could
+     * coincidentally match a curated short-keyed line).
+     */
+    pathProductCodes: string[];
+    /** Leaf CML type name (ConstraintModelTag of the LAST ProductPath segment). */
+    typeName: string | undefined;
+    /** The generated `rule(<decl>, "InsuranceSurchargeRule", "<ruleKey>", "True");` statement. */
+    statement: string;
+    /** Sanitized attribute names referenced by the rule declaration (for visibility warnings). */
+    referencedAttributes: string[];
+};
+export type MergePlacement = {
+    rule: PathedSurchargeRule;
+    status: 'inserted' | 'replaced';
+};
+export type MergeSkip = {
+    rule: PathedSurchargeRule;
+    reason: string;
+};
+export type MergeResult = {
+    mergedCml: string;
+    placements: MergePlacement[];
+    skips: MergeSkip[];
+    attributeWarnings: string[];
+};
+/**
+ * Builds the pathed surcharge rule key that mirrors the platform's auto-generated
+ * `ProductSurcharge.RuleKey`: prefix + every path-segment product code + apiName.
+ */
+export declare function buildPathedRuleKey(prefix: string, pathProductCodes: string[], apiName: string, stageTransition?: string): string;
+/** Splits a `ProductPath` into its ordered Product2 ids (slash-separated). */
+export declare function splitProductPath(productPath: string): string[];
+/**
+ * Reads the org's existing ConstraintModel text for the given CML API name, mirroring the lookup
+ * the common import uses (ExpressionSetDefinition.DeveloperName -> ExpressionSetDefinitionVersion).
+ * Returns undefined when no model exists yet (caller should then fall back to the build path).
+ */
+export declare function fetchExistingConstraintModel(conn: Connection, cmlApiName: string): Promise<{
+    versionId: string;
+    cmlText: string;
+} | undefined>;
+/**
+ * Resolves Product2 id -> CML type name from the authoritative source: ExpressionSetConstraintObj
+ * rows with ConstraintModelTagType='Type' (ReferenceObjectId is the Product2 id, ConstraintModelTag
+ * is the CML type name). This is how the curated model binds products to type blocks, so it's the
+ * correct way to find which existing `type` block a surcharge's leaf product nests into.
+ */
+export declare function fetchProductTypeTags(conn: Connection, productIds: Set<string>): Promise<Map<string, string>>;
+/** Builds the `rule(...)` statement for a surcharge, using the same constraint generator as build mode. */
+export declare function buildSurchargeRuleStatement(declaration: string, ruleKey: string): string;
+/**
+ * Prepares the pathed-rule descriptors for a set of parsed surcharge records.
+ * `productIdToCode` and `productIdToType` must already cover every ProductPath segment.
+ */
+export declare function buildPathedSurchargeRules(prefix: string, ruleDefs: Array<{
+    record: RuleRecord;
+    ruleDef: ParsedRuleDefinition;
+}>, productIdToCode: Map<string, string>, productIdToType: Map<string, string>): PathedSurchargeRule[];
+/**
+ * Merges the pathed surcharge `rule(...)` statements into the existing CML text. If the rule key is
+ * already present, the existing statement line is replaced in place (idempotent). Otherwise the
+ * statement is inserted just before the closing brace of the leaf `type` block. Rules whose leaf type
+ * block can't be found are skipped (reported, never silently dropped).
+ */
+export declare function mergeSurchargeRules(existingCml: string, rules: PathedSurchargeRule[]): MergeResult;