@salesforce/afv-skills 1.65.0 → 1.66.0

package/skills/communications-revenue-cloud-settings-configure/SKILL.md

@@ -1,74 +0,0 @@
----
-name: communications-revenue-cloud-settings-configure
-description: "Use this skill when users want to manage Revenue Cloud for Communications (Industries Communications Sales) org preferences. Trigger when users mention revenue, cloudfor, communications, settings, revenue cloudfor communications settings."
-metadata:
-  version: "1.0"
-  accessCheck: "(OrgPermissions.CMEMultiRecipient && UserPermissions.CMESales) || (OrgPermissions.MultiRecipient || OrgPermissions.CMEMultiRecipient)"
----
-
-# Managing Revenue Cloudfor Communications Settings
-
-## When to Use This Skill
-
-Manage Revenue Cloud for Communications (Industries Communications Sales) org preferences. Read returns Map<String,Boolean> with keys multiLocationEnabled / multiSubscriberEnabled, reflecting OrgPreferences.MultiLocationFeatureOrgPref and OrgPreferences.MultiSubscriberFeatureOrgPref. Two write operations flip those preferences independently. Access guarded by multi-recipient feature access (read + multi-location write) or userCanUseCMEFeatures (multi-subscriber write); admin caller needs Customize Application + the relevant org permission (MultiRecipient/CMEMultiRecipient/CMESales). No Connect/Tooling/Metadata alternative exists.
-
-## Critical Constraints
-
-**Preconditions:**
-
-- Caller user must have Customize Application permission (admin permission required to edit org preferences via the UDD `editAccess`). (check: `Customize Application permission`)
-- Org must have OrgPermissions.MultiRecipient or OrgPermissions.CMEMultiRecipient enabled — required for the read and Multi-Location write (UDD orgAccess) and gating for multi-recipient feature access. (check: `OrgPermissions.MultiRecipient || OrgPermissions.CMEMultiRecipient`)
-- For Multi-Subscriber write only: org must have OrgPermissions.CMEMultiRecipient AND user must have UserPermissions.CMESales — gates Communications Media Enterprise features access access guard on setMultiSubscriberEnabled. (check: `OrgPermissions.CMEMultiRecipient && UserPermissions.CMESales`)
-
-## Verification Checklist
-
-After every write operation, confirm the effect by re-reading state:
-
-- After `write-multi-location-enabled`, `write-multi-subscriber-enabled`: call `verify-comms-org-preferences` (`GET /headless/invoke/industries/industries-communications-sales/get-comms-org-preferences`)
-
-## Operations Reference
-
-Operations grouped by purpose. Use these as the building blocks for the workflows above.
-
-### Summary
-
-| Operation | Purpose | Status | Call | Depends on |
-|-----------|---------|--------|------|------------|
-| `getCommsOrgPreferences_1` | read | implemented | `GET /headless/invoke/industries/industries-communications-sales/get-comms-org-preferences` | — |
-| `write-multi-location-enabled` | write | implemented | `PATCH /headless/invoke/industries/industries-communications-sales/set-multi-location-enabled` | — |
-| `write-multi-subscriber-enabled` | write | implemented | `PATCH /headless/invoke/industries/industries-communications-sales/set-multi-subscriber-enabled` | — |
-| `verify-comms-org-preferences` | verify | implemented | `GET /headless/invoke/industries/industries-communications-sales/get-comms-org-preferences` | `write-multi-location-enabled`, `write-multi-subscriber-enabled` |
-
-### Read operations
-
-#### `getCommsOrgPreferences_1`
-
-Read the two Industries Communications Sales OrgPreferences. Returns Map<String,Boolean> with keys multiLocationEnabled (OrgPreferences.MultiLocationFeatureOrgPref) and multiSubscriberEnabled (OrgPreferences.MultiSubscriberFeatureOrgPref). Caller must satisfy multi-recipient feature access.
-
-**Call:** `GET /headless/invoke/industries/industries-communications-sales/get-comms-org-preferences`   — status: `implemented`
-
-**Output:** Map<String,Boolean> with two keys: multiLocationEnabled (mirrors OrgPreferences.MultiLocationFeatureOrgPref) and multiSubscriberEnabled (mirrors OrgPreferences.MultiSubscriberFeatureOrgPref).
-
-### Write operations
-
-#### `write-multi-location-enabled`
-
-Set OrgPreferences.MultiLocationFeatureOrgPref to enable or disable Location-based quoting and ordering. Body: {value: boolean}. Returns true on success. Access guarded by multi-recipient feature access; requires OrgPermissions.MultiRecipient || OrgPermissions.CMEMultiRecipient + Customize Application permission.
-
-**Call:** `PATCH /headless/invoke/industries/industries-communications-sales/set-multi-location-enabled`   — status: `implemented`
-
-#### `write-multi-subscriber-enabled`
-
-Set OrgPreferences.MultiSubscriberFeatureOrgPref to enable or disable Subscriber-based quoting and ordering. Body: {value: boolean}. Returns true on success. Access guarded by Communications Media Enterprise features access (the broader CME entitlement, distinct from the multi-recipient guard on read/multi-location-write); requires OrgPermissions.CMEMultiRecipient + UserPermissions.CMESales + Customize Application permission.
-
-**Call:** `PATCH /headless/invoke/industries/industries-communications-sales/set-multi-subscriber-enabled`   — status: `implemented`
-
-### Verify operations
-
-#### `verify-comms-org-preferences`
-
-Re-read getCommsOrgPreferences after write-multi-location-enabled and/or write-multi-subscriber-enabled. The returned multiLocationEnabled / multiSubscriberEnabled values reflect the just-written OrgPreferences and confirm the writes took effect.
-
-**Call:** `GET /headless/invoke/industries/industries-communications-sales/get-comms-org-preferences`   — status: `implemented`
-
-**Depends on:** `write-multi-location-enabled`, `write-multi-subscriber-enabled`

package/skills/communications-smb-fiber-catalog-create/SKILL.md

@@ -1,413 +0,0 @@
----
-name: communications-smb-fiber-catalog-create
-description: "Load the Communications Cloud SMB Fiber sample product catalog into a Salesforce org that has completed comms-cloud-initial-setup. Trigger when users mention \"load the SMB Fiber sample catalog\", \"set up SMB Fiber products for a demo/POC\", or \"give me a populated Comms Cloud org to explore\". Lands ~163 sObjects (6 AttributePicklists + 19 AttributePicklistValues, 5 AttributeCategories, 8 AttributeDefinitions, 8 ProductClassifications + 8 ProductClassificationAttrs, 4 bundle Product2s + 8 simple Product2s, 28 ProductComponentGroups + 28 ProductRelatedComponents, 1 ProductCatalog + 1 ProductCategory + 4 ProductCategoryProducts, ~23 ProductSellingModelOptions, 12 PricebookEntries) via six `/composite/graph` POSTs. All DeveloperNames and codes are `CCC_*` prefixed. Preconditions: three Comms Cloud permsets on the caller, two ProductSellingModels named `Evergreen - Monthly` and `Broadband Subscription`, active Standard Price Book, and a Bundle→ClassificationComponent ProductRelationshipType."
-metadata:
-  version: "1.0"
----
-
-# Communications Cloud — SMB Fiber Sample Catalog
-
-Load the fixed SMB Fiber sample product catalog into a Salesforce org
-that has completed `comms-cloud-initial-setup`. Fixed sample dataset:
-product names, prices, and structure are baked in. Intended for demos,
-POCs, and evaluation. The CSV fixtures ship with the skill and are
-consumed as-is; editing them is not supported.
-
-Single API: `/services/data/v67.0/composite/graph` (up to 500 sObjects
-per graph, 15 graphs per request, per-graph atomic, back-refs via
-`@{ref.id}`). Six graphs land the full catalog:
-
-1. **Graph 1** — 6 AttributePicklists + 19 AttributePicklistValues.
-2. **Graph 2** — 5 AttributeCategories + 8 AttributeDefinitions + 8
-   ProductClassifications + 8 ProductClassificationAttrs.
-3. **Graph 3** — 4 bundles + 4 PSMOs (`Evergreen - Monthly`) + 28 PCGs
-   + 28 PRCs + 1 Catalog + 1 Category + 4 PCPs.
-4. **Graph 4a** — 8 simples + 7 PSMOs (`Evergreen - Monthly`;
-   Installation ships without a PSMO per the source inventory's
-   "Sell only with Other Products" note).
-5. **Graph 4b** — 12 bridge PSMOs (`Broadband Subscription`).
-6. **Graph 4c** — 12 PricebookEntries against Standard Price Book.
-
-Graph 4 is split because PricebookEntry validation checks
-`(Product2Id, ProductSellingModelId)` against ProductSellingModelOption
-at insert time, and a same-graph PSMO is not yet visible to that check
-(`FIELD_INTEGRITY_EXCEPTION` otherwise).
-
-One-shot. Blind re-run against an already-imported org returns
-`DUPLICATE_VALUE` on Graph 1 and rolls back atomically — safe, no
-partial writes. Runtime is under 60 seconds on a warm org.
-
-Naming: the 4 bundle Product2 Names are `Fibre Broadband
-Bronze/Silver/Gold/Platinum`; the 8 simple-product Names are `CPE
-Router`, `CPE Router with WiFi`, `Static IP`, `Installation`, `Instant
-Connect`, `Constant Connect`, `DDos Migration`, `Enhanced Security`
-(verbatim from the source inventory, including the source's spelling
-`DDos Migration`). Catalog Name/Code: `BroadBand Catalog` /
-`CCC_CATALOG_BROADBAND`. Category Name/Code: `Fiber BroadBand` /
-`CCC_CAT_FIBER`.
-
-## Workflow
-
-── Step 0 — target-org confirmation ──────────────────────────────────
-
-0. Read `Organization` and surface identity to the customer before any
-   write:
-   `SELECT Id, Name, InstanceName, IsSandbox, OrganizationType FROM
-    Organization LIMIT 1`.
-   Emit:
-   ```text
-   About to load the SMB Fiber sample catalog into:
-     Org: <Organization.Name> (<Organization.Id>)
-     Instance: <Organization.InstanceName>
-     Type: <Organization.OrganizationType> (IsSandbox=<true|false>)
-   This will create ~163 sObjects prefixed CCC_*. Confirm to proceed.
-   ```
-   Do NOT proceed without explicit customer confirmation.
-
-── Steps 1–4 — precondition probes ────────────────────────────────────
-
-1. **Probe `/composite/graph` reachability.**
-   `GET /services/data/v67.0/composite/graph` → 405 when reachable.
-   A 404 means Composite API is disabled; halt with
-   `PRECONDITION_VIOLATION`.
-
-2. **Verify Comms Cloud permsets on the caller.** Flat SOQL against
-   `PermissionSetAssignment`:
-   ```text
-   SELECT PermissionSet.Name FROM PermissionSetAssignment
-    WHERE AssigneeId = <caller-user-id>
-      AND PermissionSet.Name IN
-        ('CMESalesStandardPermissionSet',
-         'CommsCloudSalesFeatures',
-         'SimpleCsvDataImport')
-   ```
-   Resolve `AssigneeId` from the session context — do NOT probe
-   `/services/oauth2/userinfo` (unrouted on some MCP transports).
-   Expect 3 rows. Halt with `PRECONDITION_VIOLATION` listing the
-   missing permsets by human-readable label:
-   ```text
-   Your user is missing:
-     - "Communications Cloud Sales — Standard" (CMESalesStandardPermissionSet)
-     - "Communications Cloud Sales Features"   (CommsCloudSalesFeatures)
-     - "Simple CSV Data Import"                (SimpleCsvDataImport)
-   Run comms-cloud-initial-setup first (it handles license + permset
-   assignment), then re-invoke this skill.
-   ```
-
-3. **Resolve or create every PSM name declared in the CSVs.** Build
-   the union of non-blank `PsmName` on `bundles.csv` +
-   `simple-products.csv` + every `PricingSellingModelName` on
-   `pricebook-entries.csv`. For the shipped templates the set is
-   `{"Evergreen - Monthly", "Broadband Subscription"}`. One SOQL:
-   ```text
-   SELECT Id, Name, Status FROM ProductSellingModel
-    WHERE Name IN :required_psm_names
-   ```
-   For every required name NOT returned Active, POST it via
-   `/sobjects/ProductSellingModel` with a **per-name** create body — each
-   PSM needs a distinct `(SellingModelType, PricingTerm, PricingTermUnit)`
-   triple (the org enforces uniqueness on that triple):
-   ```text
-   "Evergreen - Monthly":
-     {"Name":"Evergreen - Monthly","SellingModelType":"Evergreen",
-      "Status":"Active","PricingTerm":1,"PricingTermUnit":"Months"}
-   "Broadband Subscription":
-     {"Name":"Broadband Subscription","SellingModelType":"TermDefined",
-      "Status":"Active","PricingTerm":1,"PricingTermUnit":"Months"}
-   ```
-   `PricingTerm` + `PricingTermUnit` are REQUIRED at create time
-   (`INVALID_INPUT` otherwise; term must be `1` when the unit is
-   `Months`). If a row exists but `Status != 'Active'`, PATCH it to
-   Active. Build `psm_id_by_name` from the merged set of pre-existing +
-   freshly-created Ids. Blank `PsmName` on `simple-products.csv` means
-   "no PSMO for this product" (Installation per the source inventory) —
-   not an error.
-
-3.5. **Resolve the Bundle→ClassificationComponent ProductRelationshipType.**
-   ```text
-   SELECT Id FROM ProductRelationshipType
-    WHERE MainProductRoleCat='Bundle'
-      AND AssociatedProductRoleCat='ClassificationComponent'
-    LIMIT 1
-   ```
-   Seeded by RC. Save the Id for PRC emission in Graph 3. Halt if
-   absent.
-
-4. **Resolve and activate Standard Price Book.**
-   `SELECT Id, IsActive FROM Pricebook2 WHERE IsStandard=true LIMIT 1`.
-   Save `standard_pricebook_id`. If `IsActive=false`, PATCH:
-   `PATCH /services/data/v67.0/sobjects/Pricebook2/<id> {"IsActive": true}`.
-   No customer prompt — the skill's job is to leave the org demo-ready.
-
-── Steps 6.1–6.5d — the six graph writes ──────────────────────────────
-
-6.1. **Graph 1 — Picklists + Values.** Inputs: `picklists.csv` +
-   `picklist-values.csv`.
-   - 6 AttributePicklist: `{Name, DataType, Status: "Active"}`.
-     `DataType` = `Text` for all six.
-     `picklists.csv:DeveloperName` is a fixture-level correlation key,
-     NOT a Salesforce field — not emitted.
-   - 19 AttributePicklistValue: `{Name, PicklistId: @{apl.id}, Code,
-     Value, Sequence, Status: "Active"}`. `Code` is the unique key
-     (`CCC_PKLVAL_*`, `CCC_PVLVAL_*`, or `CCC_PKVAL_*` per source
-     inventory typos, copied verbatim).
-   Total 25 sObjects.
-
-6.3. **Graph 2 — Categories + Definitions + Classifications + PCAs.**
-   Inputs: `attribute-categories.csv` + `attributes.csv` +
-   `classifications.csv`.
-   - 5 AttributeCategory: `{Name, Code, Description}`.
-   - 8 AttributeDefinition: `{Name, Label, DeveloperName, DataType,
-     IsActive, Code, Description, DefaultHelpText, [PicklistId]}`.
-     Picklist-typed rows resolve `PicklistId` to raw Ids from Graph 1's
-     response (cross-graph, not `@{ref.id}`).
-   - 8 ProductClassification: `{Name, Code, Status: "Active"}`.
-   - 8 ProductClassificationAttr: `{Name, ProductClassificationId,
-     AttributeDefinitionId, AttributeCategoryId, Status: "Active"}`.
-     `Name` synthesized as `<classification> - <attribute>` (required).
-     `AttributeCategoryId` resolved from
-     `attributes.csv:AttributeCategoryName`. Sourced by expanding each
-     non-blank `classifications.csv:AttributeDeveloperNames` cell (a
-     `;`-separated list of `CCC_ATT_*`/`CCC_CPE_*` codes) into one PCA
-     per code.
-   Total 29 sObjects.
-
-6.5a. **Graph 3 — Bundles + Groups + Components + Catalog.** Inputs:
-   `bundles.csv` + `component-groups.csv` + `component-wiring.csv` +
-   `catalog.csv` + `categories.csv`.
-   - 4 Product2 (bundles): `{Name, ProductCode, Family, Type: "Bundle",
-     ConfigureDuringSale: "Allowed", IsActive: true, IsAssetizable: true,
-     Description, BasedOnId: <PC.id for row.ClassificationDeveloperName
-     from Graph 2 state>}`.
-   - 4 ProductSellingModelOption: `{Product2Id: @{bundle.id},
-     ProductSellingModelId: psm_id_by_name["Evergreen - Monthly"]}`.
-   - 28 ProductComponentGroup: `{Name, Code, ParentProductId:
-     @{bundle.id}, Sequence, MinBundleComponents, MaxBundleComponents}`.
-     CPE groups Min=1/Max=1; every other group Min=0/Max=1.
-   - 28 ProductRelatedComponent: `{ParentProductId: @{bundle.id},
-     ProductRelationshipTypeId: <PRT Id from Step 3.5>,
-     ProductComponentGroupId: @{pcg.id},
-     ChildProductClassificationId: <PC.id from Graph 2 state>,
-     Quantity: 1, Sequence: <row.Sequence>}`.
-   - 1 ProductCatalog: `{Name, Code, Description}`.
-   - 1 ProductCategory: `{Name, Code, Description, CatalogId:
-     @{catalog.id}}`.
-   - 4 ProductCategoryProduct: `{ProductCategoryId: @{category.id},
-     ProductId: @{bundle.id}}` — one per bundle code in
-     `categories.csv:BundleProductCodes` (`;`-separated).
-   Total 70 sObjects.
-
-6.5b. **Graph 4a — Simple Products + PSMOs.** Inputs: `simple-products.csv`.
-   - 8 Product2 (simples): `{Name, ProductCode, Family, Description,
-     IsActive: true, IsAssetizable}`. `Type` omitted (nullable).
-     `ConfigureDuringSale` omitted (simples are PRC children, not
-     parents). No classification FK — classification is wired via the
-     bundle's PRC path.
-   - 7 ProductSellingModelOption: `{Product2Id: @{simple.id},
-     ProductSellingModelId: psm_id_by_name["Evergreen - Monthly"]}`.
-     Installation (blank `PsmName`) emits Product2 but no PSMO.
-   Total 15 sObjects.
-
-6.5c. **Graph 4b — Broadband Subscription bridge PSMOs.**
-   12 ProductSellingModelOption: `{Product2Id: <Product2.Id for
-   pbe-row.ProductCode from Graph 3+4a state>, ProductSellingModelId:
-   psm_id_by_name["Broadband Subscription"]}`. One per PBE product
-   (4 bundles + 8 simples). Required because PricebookEntry validation
-   checks `(Product2Id, ProductSellingModelId)` against
-   ProductSellingModelOption at insert time.
-
-6.5d. **Graph 4c — PricebookEntries.** Inputs: `pricebook-entries.csv`.
-   12 PricebookEntry: `{Pricebook2Id: standard_pricebook_id, Product2Id:
-   <Product2.Id for row.ProductCode>, UnitPrice, IsActive,
-   ProductSellingModelId: psm_id_by_name[row.PricingSellingModelName],
-   UseStandardPrice: false}`. All 12 rows name `Broadband Subscription`.
-   `CurrencyIsoCode` omitted on single-currency orgs (rejected as
-   `INVALID_FIELD` otherwise); re-add on multi-currency orgs.
-
-── Step 7 — report ────────────────────────────────────────────────────
-
-7. On success, emit:
-   ```text
-   SMB Fiber sample catalog loaded into <Organization.Name>.
-   - 4 bundles (Fibre Broadband Bronze/Silver/Gold/Platinum) at
-     $30/$40/$50/$60.
-   - 8 simple products (CPE Router, CPE Router with WiFi, Static IP,
-     Installation, Instant Connect, Constant Connect, DDos Migration,
-     Enhanced Security) at published unit prices.
-   - 28 component groups + 28 classification-child relationships.
-   - Per-PSM PSMO breakdown (Evergreen - Monthly: 11,
-     Broadband Subscription: 12).
-   - 12 PricebookEntries against Standard Price Book.
-   - 1 catalog + 1 category with 4 bundles under the category.
-   - 6 attribute picklists + 19 values, 8 attribute definitions,
-     5 categories, 8 classifications, 8 classification-attr wirings.
-   ```
-
-   On any graph failure, extract the first real error:
-   1. Iterate `graphResponse.compositeResponse[]` in order.
-   2. Skip entries with `errorCode == "PROCESSING_HALTED"` (cascade
-      rollback noise from per-graph atomicity).
-   3. First non-halted entry is the root cause.
-
-   Report:
-   ```text
-   Graph <N> failed and rolled back atomically. Your org is unchanged.
-   First error:
-     referenceId: <referenceId>
-     sObject:     <parsed-from-url>
-     errorCode:   <errorCode>
-     message:     <message>
-     fields:      <fields>
-   ```
-   Do NOT retry automatically — per-graph rollback leaves the org
-   consistent.
-
-## Dispatch contract — `/services/data/v67.0/composite/graph`
-
-Every write step (6.1, 6.3, 6.5a, 6.5b, 6.5c, 6.5d) goes through this
-single endpoint.
-
-Body shape:
-```json
-{
-  "graphs": [
-    {
-      "graphId": "smb-fiber-g1",
-      "compositeRequest": [
-        {
-          "method": "POST",
-          "url": "/services/data/v67.0/sobjects/AttributePicklist",
-          "referenceId": "apl_upload",
-          "body": {"Name": "Upload Speed Picklist",
-                   "DataType": "Text",
-                   "Status": "Active"}
-        },
-        {
-          "method": "POST",
-          "url": "/services/data/v67.0/sobjects/AttributePicklistValue",
-          "referenceId": "apv_up40",
-          "body": {"Name": "Upload Speed 40",
-                   "PicklistId": "@{apl_upload.id}",
-                   "Code": "CCC_PKLVAL_UPLOAD_SPEED_40",
-                   "Value": "40",
-                   "Sequence": 10,
-                   "Status": "Active"}
-        }
-      ]
-    }
-  ]
-}
-```
-
-- Up to 500 sObjects per graph, 15 graphs per request. Full SMB Fiber
-  payload (25 + 29 + 70 + 15 + 12 + 12 = 163 sObjects) fits well under
-  both caps.
-- Per-graph atomicity: any sub-request failure rolls back the entire
-  graph; sibling graphs commit independently.
-- Back-refs use `@{referenceId.id}` (lowercase `id`), same graph only.
-  Cross-graph FKs resolve via captured Ids from prior graphs' responses.
-- `graphId` must be <40 chars and start with an alphanumeric character.
-
-## Why not the Connect API alternatives
-
-- `/connect/pcm/actions/catalog-update` is pilot-gated and returns
-  `FUNCTIONALITY_NOT_ENABLED` on standard sandboxes.
-- `importCatalogProducts` (RevCloud) is not registered under
-  `/actions/standard` on standard sandboxes in v67.0.
-
-Everything routes through `/composite/graph` — a single API with broad
-availability.
-
-## Critical constraints (wire truth)
-
-- **AttributePicklist**: no `DeveloperName`, no `MasterLabel`.
-  Uniqueness by `Name`. `DataType` accepts `Boolean|Date|Datetime|
-  Number|Text|Currency|Percent` (NOT `Picklist`).
-- **AttributePicklistValue**: unique key is `Code`. Writable fields:
-  `Name, PicklistId, Code, Value, Sequence, Status`. `DisplayValue`
-  and `Abbreviation` from the source inventory are not sObject fields.
-- **AttributeCategory**: writable fields are `Name, Code, Description`
-  only. `Sequence/Status/IsActive/EffectiveStartDate/EffectiveEndDate`
-  all rejected.
-- **AttributeDefinition**: help-text field is `DefaultHelpText` (not
-  `HelpText`). No `DisplaySequence`, no `AttributeCategoryId` — AD↔AC
-  linkage runs through PCA. `Name` uniqueness-enforced. `DataType`
-  accepts `Checkbox|Date|Datetime|Number|Text|Currency|Percent|Picklist`
-  (NOT `Boolean`).
-- **ProductClassification**: writable fields are `Name, Code, Status,
-  ParentProductClassificationId` only. `Description` rejected.
-- **ProductClassificationAttr**: `Name` is REQUIRED. No `DeveloperName`.
-  Uniqueness by `(ProductClassificationId, AttributeDefinitionId)`.
-- **Product2**: `Type` picklist has only `Bundle` active (simples omit
-  `Type`). No `IsConfigurable`, no `CanUseRevenueSchedule`, no
-  `ProductSellingModelId` — PSM linkage runs through
-  `ProductSellingModelOption`. Bundles with classification-child PRCs
-  MUST carry `ConfigureDuringSale="Allowed"`.
-- **ProductRelatedComponent** with `ChildProductClassificationId`:
-  `ProductRelationshipTypeId` REQUIRED; `ProductComponentGroupId`
-  REQUIRED and at most ONE classification per PCG;
-  `IsComponentRequired` must be false; `IsDefaultComponent` must be
-  omitted; `ParentSellingModelId` and `ChildSellingModelId` must be
-  omitted. Required-vs-optional is expressed on the PCG via
-  `MinBundleComponents`/`MaxBundleComponents`, NOT on the PRC.
-- **ProductComponentGroup**: no `IsActive` field.
-- **ProductCatalog**: no `IsActive`, no `CatalogCode`. Natural key is
-  `Code`.
-- **ProductCategory**: no `IsActive`.
-- **ProductCategoryProduct**: no `IsPrimaryCategory`. Emits `{ProductCategoryId,
-  ProductId}` only.
-- **ProductSellingModel**: uniqueness is enforced on the
-  `(SellingModelType, PricingTerm, PricingTermUnit)` triple, not on
-  `Name`. The two catalog PSMs are kept distinct by `SellingModelType`
-  (`Evergreen - Monthly` = `Evergreen`, `Broadband Subscription` =
-  `TermDefined`).
-- **PricebookEntry**: `ProductSellingModelId` must be a PSM Id
-  (`0jP...`), never a PSMO Id (`0iO...`). The matching PSMO for
-  `(Product2Id, ProductSellingModelId)` must exist in a PRIOR graph —
-  same-graph PSMO is not visible to PBE validation
-  (`FIELD_INTEGRITY_EXCEPTION` otherwise). This is why Graph 4 is split
-  into 4a → 4b → 4c. `CurrencyIsoCode` rejected on single-currency
-  orgs.
-- **Composite Graph DELETE**: does not support dependency ordering.
-  Any teardown must be per-Id DELETEs on
-  `/sobjects/{sobject}/{id}`.
-
-## Fixtures
-
-Templates at `assets/templates/`. Every row maps 1:1 to a source
-inventory tab (Picklists / Picklist Values / Attributes / Attribute
-Categories / Product Classification / Products / Product Groups /
-Catalog / Pricebooks). See `assets/README.md` for column semantics.
-
-| File | Rows | Feeds |
-|---|---|---|
-| `picklists.csv` | 6 | Graph 1 — AttributePicklist |
-| `picklist-values.csv` | 19 | Graph 1 — AttributePicklistValue |
-| `attribute-categories.csv` | 5 | Graph 2 — AttributeCategory |
-| `attributes.csv` | 8 | Graph 2 — AttributeDefinition |
-| `classifications.csv` | 8 | Graph 2 — ProductClassification + PCA |
-| `bundles.csv` | 4 | Graph 3 — bundle Product2 + PSMO |
-| `simple-products.csv` | 8 | Graph 4a — simple Product2 + PSMO |
-| `component-groups.csv` | 28 | Graph 3 — ProductComponentGroup |
-| `component-wiring.csv` | 28 | Graph 3 — ProductRelatedComponent |
-| `catalog.csv` | 1 | Graph 3 — ProductCatalog |
-| `categories.csv` | 1 | Graph 3 — ProductCategory + PCP |
-| `pricebook-entries.csv` | 12 | Graph 4b + Graph 4c |
-
-## Operations reference
-
-| Step | Verb + Path | Op | Kind |
-|------|---|---|---|
-| 0    | `GET /services/data/v67.0/query` | Organization identity confirmation | probe |
-| 1    | `GET /services/data/v67.0/composite/graph` | reachability | probe |
-| 2    | `GET /services/data/v67.0/query` | PermissionSetAssignment lookup | read |
-| 3    | `GET /services/data/v67.0/query` + `POST /sobjects/ProductSellingModel` (per missing PSM) | PSM lookup + auto-create missing | read+write |
-| 3.5  | `GET /services/data/v67.0/query` | Bundle→ClassificationComponent PRT lookup | read |
-| 4    | `GET /services/data/v67.0/query` + `PATCH /sobjects/Pricebook2/<id>` (if inactive) | Standard Pricebook lookup + auto-activate | read+write |
-| 6.1  | `POST /services/data/v67.0/composite/graph` | Graph 1 | write |
-| 6.3  | `POST /services/data/v67.0/composite/graph` | Graph 2 | write |
-| 6.5a | `POST /services/data/v67.0/composite/graph` | Graph 3 | write |
-| 6.5b | `POST /services/data/v67.0/composite/graph` | Graph 4a | write |
-| 6.5c | `POST /services/data/v67.0/composite/graph` | Graph 4b | write |
-| 6.5d | `POST /services/data/v67.0/composite/graph` | Graph 4c | write |
-| 7    | (no HTTP) | assemble report | inline |