toga-ai 1.0.243 → 1.0.245

package/knowledge/2.0/apps/_underscore/features/forecast-sale-import.md

@@ -35,6 +35,7 @@ related:
   - ../architecture.md
   - ../../worker2/architecture.md
   - ../../worker2/features/netsuite-salesorder-open-orders-sync.md
+  - ../../worker2/features/netsuite-supporting-record-webhook-importer.md
   - ./netsuite-rest-client.md
 ---
 

package/knowledge/2.0/apps/worker2/INDEX.md

@@ -15,6 +15,7 @@
 | [Monitoring Framework (Orchestrator + Child Monitors)](features/monitoring-framework.md) | A unified, DB-driven monitoring framework for business-critical data flows (Compass POs, Prudential asset imports, AIG closed claims, …). | worker2/Worker/Monitor.php, worker2/Worker/Monitors/, worker2/Worker/Monitors/RateEntitlement.php, worker2/Worker/Notification/Email.php, worker2/Worker/Rate.php, dbchanges2/Core/2026-05-21 - Monitors.sql, dbchanges2/Core/2026-06-29a - Rate Entitlement Contract Monitor.sql |
 | [NetSuite → TOGA Opportunity Sync (API Message Queue + worker2 webhook)](features/netsuite-opportunity-sync.md) | Outbound sync from NetSuite to TOGA for the record types the Forecast2 importer pulls (opportunities first; sales/items/etc. | worker2/Worker/Netsuite.php, worker2/Worker/Netsuite/Opportunity.php, worker2/Controller/Index.php, _underscore/Worker.php, test/@dave/NetSuite/api-message-queue/lib_amq_queue.js, test/@dave/NetSuite/api-message-queue/ue_api_msg_queue_enqueue.js, test/@dave/NetSuite/api-message-queue/ue_amq_drain.js, test/@dave/NetSuite/api-message-queue/ss_amq_drain.js, test/@dave/NetSuite/api-message-queue/DEPLOY_RUNBOOK.md, test/@dave/clickup/backfill_opportunity_numbers.php, test/@dave/clickup/probe_opportunity_fields.php, test/@dave/probe_clickup_desc_match.php, test/@dave/test_model_load_behavior.php, dbchanges2/Forecast/2026-06-25a - Add unique index on Opportunities netsuiteOpportunityInternalId.sql, worker/crons/toga2/forecast2/common_import_sales_from_netsuite.php |
 | [NetSuite → Forecast Open-Orders Sync (salesOrder webhook → OpenOrderItems)](features/netsuite-salesorder-open-orders-sync.md) | Webhook-driven, single-record port of the legacy open-orders importer (TRUE-79142). | worker2/Worker/Netsuite/SalesOrder.php, worker2/Worker/Netsuite.php, test/@dave/probe_salesorder_rest_shape.php, test/@dave/probe_open_order_lines.php, test/@dave/check_so_status.php, test/@dave/check_so_history.php, test/@dave/probe_so_rest_lines.php, test/@dave/probe_missing_oo_timing.php, test/@dave/probe_missing_oo_createdby.php, test/@dave/probe_drift_so_dates.php, test/@dave/probe_open_order_gating.php, worker/crons/toga2/forecast2/import_open_orders.php, worker/crons/toga2/forecast2/common_import_sales_from_netsuite.php |
+| [NetSuite Supporting-Record Webhook Importer (the reusable recipe)](features/netsuite-supporting-record-webhook-importer.md) | A single **repeatable recipe** for porting a legacy daily-pull NetSuite *supporting-record* importer (the lookup/dimension tables behind Forecast2 — Employees, | worker2/Worker/Netsuite/Employee.php, worker2/Worker/Netsuite/Account.php, worker2/Worker/Netsuite/Classification.php, worker2/Worker/Netsuite/Customer.php, worker2/Worker/Netsuite/Item.php, worker2/Worker/Netsuite.php, _underscore/Model/Forecast/Employee.php, _underscore/Model/Forecast/Account.php, _underscore/Model/Forecast/Classification.php, _underscore/Component/Forecast/Db/Db.php, test/@dave/test_employee_lifecycle.php, test/@dave/test_account_lifecycle.php, test/@dave/test_classification_lifecycle.php, test/@dave/NetSuite/api-message-queue/ue_api_msg_queue_enqueue.js, worker/crons/toga2/forecast2/import_supporting_records.php |
 | [DB-Driven Notification (Internal) Email](features/notification-email.md) | Internal/notification emails (merge-conflict alerts, ops notices — anything system-generated, not client-facing transactional mail) are sent through one worker | worker2/Worker/Notification/Email.php, _underscore/Model/Client/EmailTemplate.php, dbchanges2/Client/2026-06-23a - EmailTemplateWrapper.sql, dbchanges2/Client_True/2026-06-23a - EmailTemplateWrapper.sql |
 | [Startech Webhook Handler (worker2)](features/startech-webhook-handler.md) | Receives inbound webhook events from Startech (Easeedesk) and creates or updates the corresponding ticket in TOGA 2.0. | worker2/Worker/Startech.php |
 | [Talos (TOGa IQ) Meeting-Notes Integration & Token Auto-Refresh (consumer)](features/talos-meeting-notes-integration.md) | How a **dev tool / agent consumes Talos (TOGa IQ)** to query the team meeting-notes corpus programmatically. | .claude/skills/plan-ticket/scripts/talos.js |

package/knowledge/2.0/apps/worker2/features/netsuite-supporting-record-webhook-importer.md

@@ -0,0 +1,135 @@
+---
+title: NetSuite Supporting-Record Webhook Importer (the reusable recipe)
+framework: "2.0"
+repo: worker2
+project: Worker
+client: shared
+type: feature
+status: active
+updated: 2026-06-30
+owners: ["dfranks"]
+files:
+  - worker2/Worker/Netsuite/Employee.php
+  - worker2/Worker/Netsuite/Account.php
+  - worker2/Worker/Netsuite/Classification.php
+  - worker2/Worker/Netsuite/Customer.php
+  - worker2/Worker/Netsuite/Item.php
+  - worker2/Worker/Netsuite.php
+  - _underscore/Model/Forecast/Employee.php
+  - _underscore/Model/Forecast/Account.php
+  - _underscore/Model/Forecast/Classification.php
+  - _underscore/Component/Forecast/Db/Db.php
+  - test/@dave/test_employee_lifecycle.php
+  - test/@dave/test_account_lifecycle.php
+  - test/@dave/test_classification_lifecycle.php
+  - test/@dave/NetSuite/api-message-queue/ue_api_msg_queue_enqueue.js
+  - worker/crons/toga2/forecast2/import_supporting_records.php
+related:
+  - ./netsuite-opportunity-sync.md
+  - ./netsuite-salesorder-open-orders-sync.md
+  - ../../_underscore/features/forecast-sale-import.md
+  - ../../_underscore/features/netsuite-rest-client.md
+  - ../architecture.md
+---
+
+## Summary
+
+A single **repeatable recipe** for porting a legacy daily-pull NetSuite *supporting-record*
+importer (the lookup/dimension tables behind Forecast2 — Employees, Accounts, Classifications,
+Customers, Items) into a **real-time, webhook-driven, single-record upsert**. A NetSuite
+create/edit/delete arrives at `webhook.togahub.com/netsuite`, the `_Worker_NetSuite::Webhook`
+router dispatches `Netsuite/<Record>/<verb>`, and a thin per-record handler upserts (or
+guarded-deletes) one row in the `Forecast` schema.
+
+This is the supporting-record sibling of the transaction-family importers — the
+[Opportunity sync](./netsuite-opportunity-sync.md) (header+children), the
+[Open-Orders sync](./netsuite-salesorder-open-orders-sync.md), and the
+[Forecast.Sales import engine](../../_underscore/features/forecast-sale-import.md). After
+Items + Customers established it and Employees/Accounts/Classifications repeated it verbatim, the
+**recipe is the durable knowledge**: the remaining siblings are mechanical. This doc captures the
+recipe and its two recurring variants so a new one is a fill-in-the-blanks job, not a fresh design.
+
+## The recipe (per supporting record)
+
+1. **Handler** `worker2/Worker/Netsuite/<Record>.php`:
+   `abstract class _Worker_Netsuite_<Record> implements _Interface_Static_Webhook_Netsuite`.
+   The shared `_Worker_NetSuite::Webhook` router PascalCases the inbound `recordType` to find it —
+   **no router edit is needed.** Verbs:
+   - `post` / `put` → `syncRecord()` then `_Database::transactionCommit(self::DB_FORECAST)`
+     (the lazy-transaction discipline — `syncRecord` itself never commits; the caller owns the txn).
+   - `delete` → run the **referenced-guard** first, and commit **only if it actually deletes**.
+2. **`syncRecord()`** (no commit): fetch the record via SuiteQL single-id form —
+   `_Component_Api_Netsuite::send('POST', QUERY_SUITEQL.'?limit=1', ['q'=>$sql], ['Prefer'=>'transient'])`
+   — then **upsert keyed on `netsuiteInternalId`**: `load()` the existing row, then **change-detect
+   with string-cast compares** (`_Number::nullableIntChanged` for nullable ints) before `save()`.
+   The guard is mandatory because **`save()` does NOT diff** — without the change-detect it would
+   re-write (and could re-touch) every field on every webhook.
+3. **Model** `_underscore/Model/Forecast/<Record>.php extends _Model_True`, declaring **ONLY the
+   NetSuite-sourced columns.** Deliberately **omit externally-managed columns** so a webhook upsert's
+   `save()` can never null them — e.g. Employees' `teamId` / `departmentId` / `role` / `urlHeadshot`
+   are Power-BI/HR-managed and are left off the model.
+4. **Delete guard** = a `_Component_Forecast_Db::<record>IsReferenced(int): bool` helper using
+   `SELECT EXISTS( … UNION ALL … )` across **every inbound RESTRICT FK**. Referenced → return a
+   *retained-message string* (do **NOT** throw, do **NOT** blast dependent rows); unreferenced →
+   hard-delete. All these helpers are added to the **same** `_underscore/Component/Forecast/Db/Db.php`
+   right after `lookupId()` (so independent sibling-ticket PRs branched from `_production` conflict
+   *trivially* on merge — keep every helper method).
+5. **Enqueuer:** add `'<record>':'<record>'` to `RECORD_TYPE_MAP` in
+   `test/@dave/NetSuite/api-message-queue/ue_api_msg_queue_enqueue.js` (account/customer/employee/
+   classification entries already exist).
+6. **e2e harness** `test/@dave/test_<record>_lifecycle.php`: clone an existing one. It drives NetSuite
+   REST (check/create/get/update/delete) + the in-process worker verbs (post/put/verb-delete) + a local
+   dump of the resulting `Forecast` rows. Boots via chdir `worker2` + `require index.php`.
+7. **Cron:** leave the legacy `SHOULD_SYNC_<X>` daily pull **ON** as a backstop (and, for self-ref
+   records, the parent/supervisor backfill). It shares `import_supporting_records.php` with the other
+   sections, so **never disable the wrapper.**
+
+## Two recurring variants
+
+- **Self-referential parent/supervisor FK** (`Employees.supervisorEmployeeId`,
+  `Classifications.parentClassificationId`) = **RESOLVE-OR-NULL, never recursive upsert.** Resolve the
+  parent's local id by its NetSuite internalId via `lookupId`; if absent store **NULL** (the daily cron
+  backfills the link later). Inserting a non-existent local parent id would violate or dangle the FK.
+  The delete guard for a self-ref record must **also** check for child rows
+  (`WHERE parent…Id = id`) to avoid orphaning the hierarchy.
+- **Type/enum mapping** (Accounts): replicate the authoritative shim's `accttype`→canonical map
+  (`App_Api_Netsuite_Rest::listAccounts`, `library/app/api/netsuite/rest.php:218-237`) as a handler
+  const `ACCT_TYPE_MAP` so stored values stay format-consistent (`_income`, `_accountsReceivable`, …);
+  an unmapped value passes through raw. **Keep the const in sync with the shim.**
+- **Name from a hierarchical NetSuite `name`/`fullname`** = the **leaf segment**
+  (`explode(' : ')` + `array_pop`), matching the SOAP/cron/Item resolver.
+
+## Gotchas / known issues
+
+- **SuiteQL over the REST client has NO server-side placeholder binding.** `_Component_Api_Netsuite::send`
+  passes the query string as-is, so the **`(int)` cast on an already-int id is the injection control** —
+  the same codebase-wide idiom used by `lookupId()` and the Item/Opportunity/Employee handlers. A
+  php-reviewer flags it **CRITICAL** on a fresh read; it is **acceptable here** because the id is a
+  local PK from `load()`, never user input. Document the cast-only mitigation with a one-line comment.
+- **SuiteQL returns parent/supervisor reference ids as numeric STRINGS**, so the private resolve-helper
+  parameter must stay **untyped** (not `int|null`) or it `TypeError`s.
+- **The supporting-record tables already carry a UNIQUE index on `netsuiteInternalId`** (Employees,
+  Accounts, Classifications, Customers, Items), so the upsert's `load()` resolves exactly one row — no
+  duplicate-amplification (unlike the [opportunity `load()` footgun](./netsuite-opportunity-sync.md)),
+  no migration needed.
+- **`save()` does not diff** — see recipe step 2: the change-detect guard before `save()` is what makes
+  a no-change webhook a true no-op.
+
+## Change history
+
+- 2026-06-30 — Captured the supporting-record webhook-importer recipe and its two variants
+  (self-ref RESOLVE-OR-NULL parent FK + child-orphan delete-guard; Accounts `accttype` enum map; leaf
+  segment naming) after the third+ application (TRUE-79870 Employees, TRUE-79871 Accounts, TRUE-79872
+  Classifications) repeated the Items/Customers pattern verbatim. Recorded the model-omits-externally-
+  managed-columns rule, the `_Component_Forecast_Db::<record>IsReferenced` delete-guard contract
+  (retained-message string, never throw/blast), the trusted-int SuiteQL idiom (no REST placeholder
+  binding; cast-only mitigation), the SuiteQL-returns-string reference-id `TypeError` trap, and the
+  leave-the-legacy-cron-on-as-backstop boundary. (dfranks)
+
+## Related docs
+
+- [NetSuite → TOGA Opportunity Sync](./netsuite-opportunity-sync.md) — header+children transaction sibling.
+- [NetSuite → Forecast Open-Orders Sync](./netsuite-salesorder-open-orders-sync.md).
+- [Forecast.Sales NetSuite import engine](../../_underscore/features/forecast-sale-import.md) — the
+  revenue-transaction family + the shared `_Component_Forecast_Db` low-level helpers.
+- [Worker (worker2) Architecture](../architecture.md).

package/knowledge/INDEX.md

@@ -5,7 +5,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 ## 1.0 framework
 
 - **library** (Library) _(framework core)_ — 10 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
-- **worker** (Worker) — 11 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
+- **worker** (Worker) — 12 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
 - **togadesk** (TOGa Desk) — 8 doc(s) → [1.0/apps/togadesk/INDEX.md](1.0/apps/togadesk/INDEX.md)
 - **togaview** (TOGa View) — 6 doc(s) → [1.0/apps/togaview/INDEX.md](1.0/apps/togaview/INDEX.md)
 - **webhook** (Webhook) — 1 doc(s) → [1.0/apps/webhook/INDEX.md](1.0/apps/webhook/INDEX.md)
@@ -17,7 +17,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 ## 2.0 framework
 
 - **_underscore** (_Underscore) _(framework core)_ — 19 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
-- **worker2** (Worker) — 22 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
+- **worker2** (Worker) — 23 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
 - **api2** (API) — 7 doc(s) → [2.0/apps/api2/INDEX.md](2.0/apps/api2/INDEX.md)
 - **dbchanges2** (Database Changes) _(framework core)_ — 3 doc(s) → [2.0/apps/dbchanges2/INDEX.md](2.0/apps/dbchanges2/INDEX.md)
 - **toga2-supply** (TOGa Supply) — 3 doc(s) → [2.0/apps/toga2-supply/INDEX.md](2.0/apps/toga2-supply/INDEX.md)

package/knowledge/clients/prudential/INDEX.md

@@ -3,6 +3,7 @@
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|
 | [Prudential: Dell ASN units PRE/POST interceptor (legacy key + flat tracking)](features/dell-asn-units-interceptor.md) | 2.0 | After the tracking-number bridge migration, the ASN unit route was renamed (`advance-shipping-notice-units` → `advance-shipping-notice-item-units`), so the inhe | _underscore/Model/Prudential/AdvanceShippingNotice.php, dbchanges2/Client_Prudential/2026-06-10 - AsnUnitsInterceptor.sql |
+| [Prudential: Dell LCH IOP transmissions (LCHRequestV2)](features/dell-lch-iop-transmissions.md) | 1.0 | Outbound order transmissions from the 1.0 worker tier to Dell's Lifecycle Hub (LCH) ITSM integration. | library/app/api/delllch.php, worker/crons/toga2/prudential/transmissions_to_dell.php, worker/crons/toga2/prudential_beta/transmissions_to_dell_india.php, worker/crons/toga2/prudential_beta/transmissions_to_dell_ireland.php, worker/crons/toga2/prudential_beta/transmissions_to_dell_usa.php |
 | [Prudential: Service Request Regional Address Validation](features/service-request-address-validation.md) | 2.0 | The `prePost` interceptor on `_Model_Prudential_ServiceRequest` validates `deliverToAddress` fields differently depending on which Prudential regional customer | _underscore/Model/Prudential/ServiceRequest.php |
 | [Prudential Order Shipped Email — transmit_ordershipped_updates_prudential.php](features/transmit-ordershipped-email.md) | 1.0 | Cron script that transmits "Order Shipped" updates to ServiceNow (RITM) and sends a shipped notification email to the end user. | worker/crons/toga2/prudential/transmit_ordershipped_updates_prudential.php |
 | [Prudential Financial](profile.md) | 2.0 | Prudential is a TOGA client whose device-fulfillment flow is driven by **Dell** via the Dell API (`Client_Prudential.Apis.id = 2`). |  |

package/knowledge/clients/prudential/features/dell-lch-iop-transmissions.md

@@ -0,0 +1,124 @@
+---
+title: "Prudential: Dell LCH IOP transmissions (LCHRequestV2)"
+framework: "1.0"
+repo: worker
+project: Worker
+client: prudential
+type: client-feature
+status: active
+updated: 2026-06-30
+owners: ["rgirish"]
+files:
+  - library/app/api/delllch.php
+  - worker/crons/toga2/prudential/transmissions_to_dell.php
+  - worker/crons/toga2/prudential_beta/transmissions_to_dell_india.php
+  - worker/crons/toga2/prudential_beta/transmissions_to_dell_ireland.php
+  - worker/crons/toga2/prudential_beta/transmissions_to_dell_usa.php
+related:
+  - ../profile.md
+  - dell-asn-units-interceptor.md
+---
+
+## Summary
+
+Outbound order transmissions from the 1.0 worker tier to Dell's Lifecycle Hub (LCH) ITSM
+integration. As of Dell's **May 2025 IOP spec update**, the deprecated `LCHRequest` endpoint
+was replaced by **`LCHRequestV2`** — a re-shaped payload with an explicit `requestEvent`
+field. All four Prudential transmission scripts (3 beta regional + 1 production) and the 1.0
+library client (`App_Api_Delllch`) were migrated. The OAuth and base-URL layer is unchanged;
+only the request route and payload schema changed.
+
+This is the **outbound** counterpart to the 2.0 inbound Dell ASN flow (see
+`dell-asn-units-interceptor.md`).
+
+## How it works
+
+- **Route:** `api/v2/request/LCHRequest` → **`api/v2/request/LCHRequestV2`** in all four
+  transmission scripts.
+- **Base URL / auth unchanged:** OAuth 2.0 `client_credentials` flow and base endpoints
+  (`iopv2/` prod, `iopv2np/` test) in `App_Api_Delllch::initialize()` are unchanged.
+- **Event model (the key change):** the new schema adds a required **`requestEvent`** field —
+  `'Create'` for new orders, `'Update'` for updates, `'Cancel'` for cancellations. This
+  replaces the old overloaded `svcOrderType` that previously signalled both the SR type AND
+  the event (`'CANCEL'`/`'UPDATE'`). In V2, `requestType` carries the SR type only
+  (Refresh / Breakfix / Reclaim / Bulk).
+- **Optional pre-submission validation:** `App_Api_Delllch::validateLCHRequestV2(array $payload, bool $isProduction = true): mixed`
+  calls `api/v2/validate/LCHRequestV2` — returns 200 on a valid payload, `422` with a
+  `problems[]` / `issues[]` array on schema violations. Useful for debugging a new payload
+  shape before sending a real order.
+
+### Payload schema migration (old → new)
+
+| Old (`LCHRequest`) | New (`LCHRequestV2`) |
+| --- | --- |
+| `svcOrderReqNumber` | `requestNumber` |
+| `svcOrderType` (overloaded: type + event) | `requestType` (Refresh/Breakfix/Reclaim/Bulk only) + `requestEvent` (Create/Update/Cancel) |
+| `svcOrderPriority` | `priority` |
+| `customerName` / `customerTelephone` / `customerEmail` / `employeeID` / `employeeType` (flat) | `employee{}` object: `employee.name` / `.phone` / `.email` / `.id` / `.type` |
+| `addresses[]` with `Ship To` element | `shipAddress{}` flat object |
+| `addresses[]` with `Return To` element | `returnAddress{}` flat object (`addressTo`, `careOf`, `address1`, `address2`, `city`, `state`, `postalCode`, `countryCode`) |
+| `returnItems[].itemType` / `.itemSerialNumber` / `.itemAssetTag` | `returnItems[].type` / `.serialNumber` / `.assetTag` |
+| `updateDate` (UPDATE events) | `deliveryDate` |
+| `updateReason` | `reason` |
+
+**Removed fields (no longer in the V2 schema):** `lob`, `msgID`, `deviceType`,
+`organizationalUnit`, `shippingMethod`, `profile`, `imageType`, `modeledAfter`,
+`hdRetentionIndicator`, `cidCoverage`, `cidCaseIndicator`.
+
+### SR-type / branch behavior
+
+- **LABEL SR type:** old code set `svcOrderType='RECLAIM'` mid-payload; new code sets
+  `requestType='Reclaim'` in the LABEL branch.
+- **RECLAIM:** `kitProfile='PACKAGING'` for all countries.
+- **THIN CLIENT guard removed:** the old `if deviceType == 'THIN CLIENT' then deviceType = 'LAPTOP'`
+  mapping was deleted — `deviceType` no longer exists in the V2 schema.
+
+### Country-specific logic (preserved across the migration)
+
+- **India:** `employee.type='NA'` hardcoded for all SR types. India device tier map
+  (`Knowledge Worker`→`Standard Notebook`, `Developer`→`Developer Notebook`) preserved in the
+  BREAKFIX / REFRESH / else branches.
+- **Ireland / USA:** `employee.type` initialised to `'STANDARD'` at base payload.
+  Brownfield/Apple device lookups via ServiceNow (`App_Api_Prudential::send()`) preserved.
+  Return address uses the `returnAddress{}` flat object built from
+  `$returnToAddress` / `$returnToAddressApple` arrays via `array_merge()` with an `addressTo`
+  override.
+
+## Deployment order (Prudential standard: beta before production)
+
+Beta scripts (`crons/toga2/prudential_beta/`) are migrated and verified **first**; only then
+is the production script (`crons/toga2/prudential/transmissions_to_dell.php`,
+`$inProduction = true`) touched. Beta scripts run against the beta DB
+(`db_beta_toga2core` / `db_client_prudential`) so failures never reach live customer orders.
+This is the established pattern for all Prudential script changes.
+
+## Verification plan
+
+1. Run beta scripts against the beta DB; check `Logs_Prudential` API table for the outbound
+   request body and Dell's 200/202 response.
+2. Optionally call `App_Api_Delllch::validateLCHRequestV2()` on a sample payload to pre-check
+   the schema before sending a real order.
+3. After beta passes a full order cycle (New → shipped), confirm the production script is live.
+
+## Gotchas
+- `requestType` is the SR type only (Refresh/Breakfix/Reclaim/Bulk) — do **not** put the event
+  there. Event signalling moved to the separate required `requestEvent` field
+  (Create/Update/Cancel). Conflating them is the easiest way to reproduce the old overloaded
+  `svcOrderType` bug under the new schema.
+- Dell deprecated `LCHRequest`; any script still POSTing to the old route will fail. All four
+  transmission scripts must point at `LCHRequestV2`.
+- The removed fields (e.g. `deviceType`, `lob`, `imageType`) will be rejected by V2 validation —
+  do not reintroduce them.
+
+## Change history
+- 2026-06-30 — Migrated all Prudential Dell transmissions (3 beta regional + production) and
+  `App_Api_Delllch` from deprecated `LCHRequest` to `LCHRequestV2` per Dell's May 2025 IOP
+  spec: re-shaped payload (employee/ship/return objects, renamed return-item keys), new
+  required `requestEvent` event field replacing overloaded `svcOrderType`, removed dropped
+  fields and the THIN CLIENT device guard, added `validateLCHRequestV2()` pre-submission
+  validation helper. Country-specific (India/Ireland/USA) device-tier and address logic
+  preserved. (rgirish)
+
+## Related docs
+- Prudential: Dell ASN units interceptor (inbound 2.0 counterpart).
+- Prudential profile.

package/knowledge/clients/prudential/profile.md

@@ -6,16 +6,19 @@ apps:
   - api2
   - dbchanges2
   - websocket
+  - worker
+  - library
 project: _Underscore
 client: prudential
 type: profile
 status: active
-updated: 2026-06-29
+updated: 2026-06-30
 owners: ["jcardinal", "rgirish"]
 files: []
 related:
   - features/dell-asn-units-interceptor.md
   - features/service-request-address-validation.md
+  - features/dell-lch-iop-transmissions.md
 ---
 
 ## Summary
@@ -33,6 +36,9 @@ order-status transmissions.
 - **Outbound (worker crons):** `transmissions_to_netsuite.php`, `transmit_ordershipped_updates_prudential.php`,
   `transmit_closecomplete_updates_prudential.php`, `transmit_order_delivered_updates_from_fedex_toga2.php`,
   `update_tracking_number_from_netsuite_to_toga.php`, `manually_insert_ASN.php`.
+- **Outbound (Dell LCH ITSM):** `transmissions_to_dell.php` (prod) + `prudential_beta/transmissions_to_dell_{india,ireland,usa}.php`
+  POST to Dell's LCH `LCHRequestV2` endpoint via the 1.0 `App_Api_Delllch` client. See the
+  Dell LCH IOP transmissions feature doc.
 
 ## Gotchas
 - Dell will not change their payload shape — see the Dell ASN units interceptor feature doc for the
@@ -46,5 +52,6 @@ order-status transmissions.
 
 ## Related docs
 - Dell ASN units interceptor.
+- Dell LCH IOP transmissions (LCHRequestV2, outbound 1.0).
 - 2.0 _underscore: Tracking-Number Bridge Migration.
 - features/transmit-ordershipped-email.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.243",
+  "version": "1.0.245",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",