toga-ai 1.0.852 → 1.0.853

package/knowledge/1.0/apps/worker/INDEX.md

@@ -16,6 +16,7 @@
 | [OneUptime external uptime monitoring for 1.0 workers](features/oneuptime-worker-uptime-monitoring.md) | Per-minute external OneUptime "Incoming Request" heartbeat from every 1.0 worker box (Degraded 3 min / Offline 5 min); open for the heartbeat push, monitor prov |
 | [Prudential: Send Shipments for the Day report (daily cron)](features/send-shipments-for-the-day.md) | Daily 9:00 PM Prudential/Dell cron emailing an Excel of every device shipped today (tracking, serial, XID, FedEx status, vendor); open for the ASN join chain an |
 | [Staples cXML Order Import (SFTP → NetSuite)](features/staples-cxml-order-import.md) | Hourly cron importing Staples cXML POs from SFTP into NetSuite Sales Orders (writes 855 ack back); open for the per-file flow, saved-search-8412 Location resolu |
+| [Walmart Daily Sales Report (send_toga_walmart_report.php)](features/walmart-daily-sales-report.md) | The two Walmart sales workbooks (summary + details) built from `TOGA_Walmart` (in-store) and `TOGA_WalmartEComm` (.COM); open for the pseudo-store 1472 channel |
 | [Diagnosing frozen 1.0 worker cron check-ins (Sentry "missed" flood)](workflows/diagnosing-frozen-cron-checkins.md) | Ordered path to diagnose frozen 1.0 worker cron timestamps + a Sentry `worker1` "missed" flood; open when check-ins stall and you suspect a wedged lock. |
 | [isFulfillable Multi-Client Backfill (all togasupply clients)](workflows/isfulfillable-multi-client-backfill.md) | One-time backfill catching up `Items.isFulfillable` on existing items across all 17 togasupply clients; open when running/re-running it or deciding whether rema |
 | [Deduplicating NetSuite duplicate Items across client DBs (recursive MERGE)](workflows/netsuite-duplicate-items-dedup.md) | Per-client cleanup collapsing duplicate `Items` rows (same `partNumber`) to one canonical via recursive MERGE; open before running it — and read the catalog-bli |

package/knowledge/1.0/apps/worker/features/walmart-daily-sales-report.md

@@ -0,0 +1,76 @@
+---
+title: Walmart Daily Sales Report (send_toga_walmart_report.php)
+framework: "1.0"
+repo: worker
+project: Worker
+client: walmart
+type: feature
+status: active
+updated: 2026-09-21
+owners: ["mhammontree"]
+files:
+  - worker/crons/notifications/reports/send_toga_walmart_report.php
+  - worker/crons/notifications/reports/send_incomm_report.php
+related:
+  - ../../../clients/walmart/profile.md
+  - ../workflows/tracing-a-worker-cron-run-in-production.md
+  - ../../library/features/email-test-mode-and-write-free-sends.md
+---
+
+The two Walmart sales workbooks (summary + details) built from `TOGA_Walmart` (in-store) and `TOGA_WalmartEComm` (.COM); open for the pseudo-store 1472 channel trap, the registration-not-sale counting rule, and the unmapped-category hole.
+
+## Summary
+
+`send_toga_walmart_report.php` emails two Excel workbooks:
+
+- `WalmartTOGaSales_<date>.xlsx` — "Stores *" summary tabs (Weekly / Prior Week / YTD), categories in columns.
+- `WalmartTOGaSalesDetails_<date>.xlsx` — item-level tabs, one row per paid sale.
+
+Data comes from two databases, unioned: **`TOGA_Walmart`** (in-store) and
+**`TOGA_WalmartEComm`** (online, rendered as a pseudo-store `.COM`). The report reads
+`togaClientId = 6` with database `TOGA_Walmart` — **not** the `TOGA.Clients.id = 7` on the
+[Walmart profile](../../../clients/walmart/profile.md). Both identifiers are live; do not
+"correct" one to the other.
+
+## How it works
+
+1. `$storeNumberSql` (defined once at the top) is the shared channel-label expression, reused
+   by the item-level query and both store-level queries so every tab labels a sale the same way.
+   Named constants: `$multiChannelStoreId = 1472`, `$areaNumberNoStoreArea = '998'`,
+   `$areaNumberEComm = '999'`.
+2. Store-level tabs: `UNION ALL` of the `TOGA_Walmart` in-store leg and the
+   `TOGA_WalmartEComm` `.COM` leg, in both the "get stores" and "get data" queries. The store
+   list is scoped to stores that **actually sold in the reporting period**, so the ~29 dormant
+   stores stay off the tab.
+3. Item-level tabs: `LEFT OUTER JOIN Stores ON Stores.id = ServiceRequests.storeId`, grouped by
+   `$storeNumberSql` (not `Stores.id`).
+4. Rows are bucketed into columns by `$cntCategoryMapping` / `$amountCategoryMapping`.
+
+## Gotchas
+
+- **`TOGA_Walmart.Stores.id = 1472` is a pseudo-store catch-all, and its own `storeNumber` is
+  wrong.** Every non-store sale hangs off id 1472. The real channel lives on
+  **`ServiceRequests.storeNumber`**, not `Stores.storeNumber`. Verified in prod: id 1472 carries
+  `WB` (219 rows, 2023-06-29 → 2026-09-20), `WM+` (118 rows, ended 2023-09-27), and one NULL
+  (2025-02-13) — while `Stores.storeNumber` for id 1472 says `WM+`. Reading the Stores row
+  mislabels every current sale. Store 1472 also has no `Addresses` row, so City/State render blank.
+- **Never `INNER JOIN Stores` off `ServiceRequests.storeId`** — `storeId` is nullable and the
+  inner join silently deletes paid sales (4 lost since 2026-07-01, incl. the 2026-09-13 sale the
+  business flagged missing from `WalmartTOGaSalesDetails_20260915.xlsx`).
+- **The report counts registrations, not sales.** `ServiceRequests` rows are created when a
+  customer registers the card, never when Walmart rings it up. The InComm SFTP feed is **never
+  imported**: `send_incomm_report.php` only downloads the day's files and emails them as
+  attachments — no DB write anywhere. So the report's in-store count is structurally lower than
+  the InComm file. Investigated under TRUE-81324; **no importer is being built** because Mike
+  confirmed Walmart no longer does in-store sales. Do not re-investigate this gap.
+  (InComm product: `TOGA_Walmart.Services` id 43558, SKU 302010001, UPC 643570190193,
+  `reportingCategory` 'Support'; FY26-to-date 44 units / $3,996.)
+- **Open defect — unmapped categories vanish from the Stores tabs.** The category mappings cover
+  only Phone Repair, Tablet Repair, Set-up, Repair, Support, In-Home, Associate Performed.
+  Anything else lands in no column and is excluded from the Total. Verified: `TOGA_WalmartEComm`
+  has 181 items / $14,118 YTD with `reportingCategory = '0'` that are invisible on the report;
+  `TOGA_Walmart` has 6 such services. Fix for a future ticket: add an "Other" catch-all column.
+
+## Change history
+
+- 2026-09-21 — Restored the in-store `TOGA_Walmart` leg on the Stores tabs (deleted by 4d8e48803 / TRUE-60157 in 2025-03), switched the item query to `LEFT OUTER JOIN Stores`, and extracted the shared `$storeNumberSql` label expression (TRUE-81324). (mhammontree)

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)_ — 26 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
-- **worker** (Worker) — 36 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
+- **worker** (Worker) — 37 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) — 0 doc(s) → [1.0/apps/worker1.5/INDEX.md](1.0/apps/worker1.5/INDEX.md)
 - **togadesk** (TOGa Desk) — 13 doc(s) → [1.0/apps/togadesk/INDEX.md](1.0/apps/togadesk/INDEX.md)

package/knowledge/clients/walmart/profile.md

@@ -9,7 +9,7 @@ apps:
 client: walmart
 type: client-feature
 status: active
-updated: 2026-09-16
+updated: 2026-09-21
 owners: ["mhammontree"]
 files:
   - library/app/client/walmart.php
@@ -19,6 +19,7 @@ related:
   - clients/walmart/features/domain-migration.md
   - clients/walmart/features/registration-route.md
   - clients/walmart/features/customer-email-lifecycle.md
+  - 1.0/apps/worker/features/walmart-daily-sales-report.md
 ---
 
 Walmart B2C tech-services tenant (client id 7); open for its identifiers, key files, and the `requireRegistrationUrl` DB rule.

package/package.json

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