toga-ai 1.0.905 → 1.0.906

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 |
+| [UMA Student Roster Sync (SFTP → TOGaDeskSupport customers) + Ivanti Ticket Sync](features/uma-student-sync.md) | Daily SFTP full-roster file loads UMA students into TOGaDeskSupport.customers (clientId 10); open for the file format, insert/deactivate rules, how the Ivanti t |
 | [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 |

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

@@ -138,7 +138,7 @@ worker/
 | `vendorinvoiceretrieval/` | 18 | Automated vendor-invoice retrieval. |
 | `catalog/` | 17 | Catalog DB reconciliation (Office Depot inventory imports). |
 | `maintenance/` | 9 | Hourly/daily/weekly maintenance + TOGaDesk ticket archiving. |
-| `togadesk/` | 8 | TOGaDesk helpdesk: inactive-people cleanup, UMA customer/ticket sync, task reminders, repair-order status. |
+| `togadesk/` | 8 | TOGaDesk helpdesk: inactive-people cleanup, UMA customer/ticket sync ([uma-student-sync](features/uma-student-sync.md)), task reminders, repair-order status. |
 | `test_active_directory/` | 5 | AD integration test scripts. |
 | `database/` | 4 | Backups, restores, restore scheduling. |
 | `worker/` | 2 | `worker_heartbeat.php` (self-healing heartbeat) + helper. |

package/knowledge/1.0/apps/worker/features/uma-student-sync.md

@@ -0,0 +1,59 @@
+---
+title: UMA Student Roster Sync (SFTP → TOGaDeskSupport customers) + Ivanti Ticket Sync
+framework: "1.0"
+repo: worker
+project: Worker
+client: uma
+type: client-feature
+status: active
+updated: 2026-09-28
+owners: ["mhammontree"]
+files:
+  - worker/crons/togadesk/sync_uma_customers.php
+  - worker/crons/togadesk/sync_uma_tickets.php
+  - worker/schedules/cron.worker.togadesk.json
+  - library/app/api/uma.php
+related:
+  - 1.0/apps/worker/architecture.md
+---
+
+Daily SFTP full-roster file loads UMA students into TOGaDeskSupport.customers (clientId 10); open for the file format, insert/deactivate rules, how the Ivanti ticket sync depends on it, health-check queries, and the PII/hardcoded-credential traps.
+
+## Summary
+
+UMA students reach our system through a **daily SFTP file**, not an API. `togadesk/sync_uma_customers.php` runs `0 15 * * *` (America/Chicago) on the `togadesk` worker role (`schedules/cron.worker.togadesk.json`) and maintains `TOGaDeskSupport.customers` for **clientId 10**. `sync_uma_tickets.php` then turns UMA Ivanti incidents into TOGaDesk tickets — only for students already loaded.
+
+## How it works
+
+**Customer sync (`sync_uma_customers.php`):**
+1. Log into SFTP `sftp.ultimatemedical.edu`, download every file in `/`.
+2. Save each file to `Logs.FileLog` (link `db_logs`, job `UMA_CUSTOMERS`), then **delete it from the SFTP**.
+3. Parse **only the newest** FileLog row. File `UMA_upload_MMDDYY.txt`, pipe-delimited, header row, 9 columns:
+   `studentId | firstName | lastName | phonePrimary | phoneSecondary | emailPersonal | emailWork | DOB (MMDDYYYY) | ssnLast4`
+4. Write `TOGaDeskSupport.customers` (link `db_togadesk`), clientId 10, matched on `customers.reference = studentId`:
+   - new → insert, active;
+   - existing → **untouched** (name/email/phone are never updated);
+   - existing but absent from the file → `isActive = 0`. The file is the **full roster**.
+
+**Ticket sync (`sync_uma_tickets.php`):** uses `App_Api_UMA` (`library/app/api/uma.php`, extends `App_Api_Ivanti`, endpoint `umaservicecenter.saasit.com`) to pull new student incidents and push TOGaDesk tickets. A ticket is created only when the incident email matches a student's `emailPersonal`/`emailWork`.
+
+## Health check (read-only prod, env `legacy`)
+
+- **Files received:** `Logs.FileLog WHERE job = 'UMA_CUSTOMERS'` (indexed on `job`). Select dates + `fileName` only. Never `LENGTH(fileData)` — timed out at 300 s.
+- **Runs:** `Common.CronJobExecutions` (~120M rows, **no index** on `job`/`dtCheckIn`). Bound by id range (~750k rows/day, e.g. `id > MAX(id) - N`) and match `job = '/var/www/html/crons/togadesk/sync_uma_customers.php'`.
+  - `dtCheckOut` set = finished cleanly; a thrown error leaves it NULL.
+  - ~12-13 s = file processed; ~2 s = SFTP root was empty.
+- **Normal pattern:** one file/day. Occasional misses or a late file arriving with the next day's — harmless, since only the newest (full roster) is parsed.
+
+## Gotchas
+
+- **Empty/truncated file mass-deactivates.** Rows without exactly 9 columns are skipped silently, then every missing student goes `isActive = 0`. No row-count guard, no alert.
+- **Silent failure modes.** Throws only on SFTP login/download failure. An empty SFTP is a clean ~2 s run — nothing flags "no file today". Check FileLog dates.
+- **Unloaded student = skipped tickets.** If a student is not in customers yet, their Ivanti incidents are skipped with no log.
+- **Existing rows never refresh.** A student's changed email in UMA's file does not reach us, so their tickets stop matching.
+- **PII.** Files hold DOB and SSN last 4. When investigating, pull only dates/file names from FileLog, never `fileData`.
+- **Hardcoded credentials — treat as leaked, rotate.** SFTP login is hardcoded in `sync_uma_customers.php`; the Ivanti API key is hardcoded in `library/app/api/uma.php`. Do not copy them anywhere.
+- Does not call `App_Database::closeConnections()`.
+
+## Change history
+- 2026-09-28 — Documented (TRUE-82352 investigation). Open incident: no UMA file since 2026-09-20; runs 9-21..9-27 clean with empty SFTP; togadesk worker instance changed that day but SFTP login still works from the new box — likely UMA stopped uploading, awaiting UMA confirmation. No wrong deactivations; new students and their tickets missing since 9-20. (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)_ — 28 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
-- **worker** (Worker) — 39 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
+- **worker** (Worker) — 40 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/package.json

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