toga-ai 1.0.1127 → 1.0.1128

package/knowledge/INDEX.md

@@ -7,7 +7,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **library** (Library) _(framework core)_ — 41 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
 - **worker** (Worker) — 43 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
 - **dbchanges** (Database Changes) _(framework core)_ — 1 doc(s) → [1.0/apps/dbchanges/INDEX.md](1.0/apps/dbchanges/INDEX.md)
-- **worker1.5** (Worker 1.5) — 4 doc(s) → [1.0/apps/worker1.5/INDEX.md](1.0/apps/worker1.5/INDEX.md)
+- **worker1.5** (Worker 1.5) — 5 doc(s) → [1.0/apps/worker1.5/INDEX.md](1.0/apps/worker1.5/INDEX.md)
 - **togadesk** (TOGa Desk) — 18 doc(s) → [1.0/apps/togadesk/INDEX.md](1.0/apps/togadesk/INDEX.md)
 - **togaview** (TOGa View) — 9 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)

package/knowledge/clients/office-depot/INDEX.md

@@ -4,5 +4,6 @@
 |-----|-----------|---------|
 | [ODP Monthly Talos Call Transcript Report (worker2 cron)](features/odp-call-transcript-monthly-report.md) | 2.0 | Monthly xlsx of ODP Talos voice-agent calls, built from S3 session reports and emailed; open before any ODP call reporting work. |
 | [Office Depot Phone Tech Support](features/odp-tech-support.md) | standalone | Office Depot's phone agent guides store associates through Tier-1 support and records Desk tickets; open for its client-specific prompt, tools, tuning and deplo |
+| [Office Depot — OptimumDesk SKU Sync (RetailServices supplier 14, POST /api/skus)](features/optimumdesk-sku-sync.md) | 1.0 | Office Depot store SKUs (400122/400123/400124) pushed to OptimumDesk by the worker1.5 RetailServices sync; open for the /api/skus payload rules, the 400122 work |
 | [TOGaRefresh 2026 — linkBuilderRefresh URL Routing (ODP)](features/togarefresh2026-linkbuilder-routing.md) | 1.0 | In TOGaRefresh 2026, service-builder buttons must route via `App_Model_ServiceRequest::linkBuilderRefresh()` (`serviceselection`), not legacy `linkBuilder()` (` |
 | [Office Depot](profile.md) | standalone | Office Depot uses TOGa Voice for inbound store-associate tech support and Desk ticketing; open for client scope and links to its voice configuration. |

package/knowledge/clients/office-depot/features/optimumdesk-sku-sync.md

@@ -0,0 +1,40 @@
+---
+title: Office Depot — OptimumDesk SKU Sync (RetailServices supplier 14, POST /api/skus)
+framework: "1.0"
+repo: worker1.5
+project: Worker 1.5
+client: office-depot
+type: client-feature
+status: active
+updated: 2026-10-23
+owners: [snaredla]
+files:
+  - worker1.5/crons/sync/retailservices/sync_retail_services_client_service.php
+  - toga/app/togarefresh2026/refurbishments/action.php
+related:
+  - clients/office-depot/profile.md
+  - clients/office-depot/features/togarefresh2026-linkbuilder-routing.md
+  - 1.0/apps/togaview/features/retail-commerce-lifecycle.md
+  - 1.0/apps/worker1.5/architecture.md
+---
+
+Office Depot store SKUs (400122/400123/400124) pushed to OptimumDesk by the worker1.5 RetailServices sync; open for the /api/skus payload rules, the 400122 workorder/businessUnit requirement, or stuck TOSYNC rows.
+
+## Summary
+
+`sync_retail_services_client_service.php` sends Office Depot service rows to OptimumDesk (`scuses.optimumdesk.com`, `POST /api/skus`). Only one `RetailServices.ClientSuppliers` row uses `api='SKUS'` (id 14, businessUnit 11110), so this branch affects only Office Depot SKUs 400122/400123/400124.
+
+## How it works
+
+- Payload always sends `customer.customerId`. All store refurbs use the store customer "Store Officedepot" = OptimumDesk customerId 1626767.
+- SKU 400122 ("Certified Open Box PC", created by togarefresh2026 `refurbishments/action.php`) opens a PC wipe ticket at OptimumDesk. It **requires** `workorder` and `businessUnit` in the payload. The sync adds both only when 400122 is in the order (TRUE-80576).
+- `workorder` = the TOGa- number; for a non-TOGa ref, ref + 1000000000.
+- `ClientAccounts.clientRefAccountId` `TOGa-<n>` = TOGA_ODP `ServiceRequests.serviceRequestNumber` `<n>`.
+- Success reply carries `data.workorder_id`. Outbound calls are logged in `Logs.API` (legacy cluster).
+- Login is the integration user stored on the `RetailServices.ClientSuppliers` row (never copy it into docs).
+
+## Gotchas
+
+- Without `workorder`/`businessUnit`, 400122 fails with HTTP 401 "Sku details not found or has been removed" — misleading; it is not auth and not the customer. Broken by commit bb70017cd (TRUE-76320, 2026-01-28, old worker repo) which trimmed the payload to customerId. 400124 works without them, so do not trim per-SKU fields again without testing 400122.
+- Failed rows stay `syncStatus = TOSYNC` and retry every cron run — 15 stuck orders produced 24,666 occurrences of one Tools error issue. A growing error count usually means a few stuck rows, not many failures.
+- To check the customer, `GET /customer/{id}` with the same login works.

package/knowledge/clients/office-depot/profile.md

@@ -11,11 +11,12 @@ apps:
   - dbchanges2
   - forward
   - store
+  - worker1.5
 project: TOGa Voice
 client: office-depot
 type: profile
 status: active
-updated: 2026-10-22
+updated: 2026-10-23
 owners: [akhokhani, mhammontree, jcardinal, snaredla, rgirish]
 files: []
 related:
@@ -42,6 +43,7 @@ Office Depot is the production support client of the standalone Python/LiveKit T
 - [Ticket API](../../standalone/apps/voice-to-voice/features/ticket-api-integration.md) owns signing and client/department routing.
 - [Post-call Lambda](../../standalone/apps/voice-to-voice/features/post-call-lambda.md) owns recordings/transcript attachments and its dated outage evidence.
 - [TOGa Desk](../../1.0/apps/togadesk/architecture.md) is the ticket system of record.
+- [OptimumDesk SKU sync](features/optimumdesk-sku-sync.md) — worker1.5 RetailServices push of store SKUs 400122/400123/400124.
 
 ## Gotchas
 

package/package.json

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