toga-ai 1.0.192 → 1.0.194

package/knowledge/2.0/apps/_underscore/features/email-template-sending.md

@@ -6,13 +6,14 @@ project: _Underscore
 client: shared
 type: feature
 status: active
-updated: 2026-06-18
-owners: ["jcardinal", "bala"]
+updated: 2026-06-24
+owners: ["jcardinal", "bala", "mhammontree"]
 files:
   - _underscore/Model/Client/EmailTemplate.php
   - _underscore/Model/Client/EmailTemplateOutgoingEmailAddress.php
   - _underscore/Email.php
-related: []
+related:
+  - ../../worker2/features/notification-email.md
 ---
 
 ## Summary
@@ -33,6 +34,17 @@ sends via `_Email`. The only client-specific input the send actually needs is th
     non-API entry point. Caller passes the client identifier directly; no `$api` object.
   - **`dispatch(string $clientIdentifier, ...): bool`** (private) — the shared body both
     entry points call. Holds all the real logic.
+  - **`renderWrappedBody(string $subject, string $body): ?string`** — the **branded-wrapper**
+    path (distinct from the send-by-uuid path above). Loads the reserved wrapper row
+    (`uuid = WRAPPER_UUID`) and injects the subject/body into its `{subject}`/`{body}`
+    placeholders via `strtr` (simultaneous, so a `{body}` literal in the subject can't be
+    re-expanded). Returns `null` if there is no active wrapper row. Does **not** send — the caller
+    feeds the result to `_Email`.
+- **`const WRAPPER_UUID = '11111111-1111-4111-8111-111111111111'`** — the reserved uuid of the
+  per-client branded "wrapper" template row. The model lookup and the dbchanges2 seed migration
+  must use this same literal. The row is seeded by dbchanges2 (`Client/` blank-client baseline so
+  every new client inherits it, plus per-client backfills). Its body is the branded HTML shell
+  holding `{subject}`/`{body}` placeholders.
 - `_Model_Client_EmailTemplateOutgoingEmailAddress` — per-template stored TO/CC/BCC
   addresses (`toCcBcc` enum), merged into the caller-supplied recipients.
 - `_underscore/Email.php` — `_Email` requires a non-empty `clientIdentifier` (throws
@@ -91,6 +103,11 @@ can keep using `sendEmail($api, ...)`.
 
 ## Change history
 
+- 2026-06-24 — Added the **branded-wrapper** path: `WRAPPER_UUID` + `renderWrappedBody()` load a
+  reserved per-client `EmailTemplates` row and inject `{subject}`/`{body}`. Consumed by the new
+  worker2 `_Worker_Notification_Email::Send` for internal/notification mail; the wrapper row is
+  seeded across clients by dbchanges2. See
+  [`worker2/notification-email.md`](../../worker2/features/notification-email.md). (mhammontree)
 - 2026-06-18 — Hardened against silent failure: `dispatch()` throws on an inactive template
   (was `return false`) and `_Email::send()` throws + logs `isSuccess`/`error` when
   `PHPMailer::Send()` fails (was swallowed with no return/throw/log). Affects all clients;

package/knowledge/2.0/apps/toga2-view/INDEX.md

@@ -3,3 +3,5 @@
 | Doc | Summary | Files |
 |-----|---------|-------|
 | [TOGa View Frontend (toga2-view) Architecture](architecture.md) | `toga2-view` is the **React/TypeScript single-page frontend** for the TOGa 2.0 platform — the customer-facing web app (home warranty / tech-support portals). | toga2-view/src/main.tsx, toga2-view/src/App.tsx, toga2-view/src/routes.tsx, toga2-view/src/api/axiosInstance.ts, toga2-view/src/api/apiFunctions.ts, toga2-view/src/utils/queryHelpers.ts, toga2-view/src/contexts/AuthContext.tsx, toga2-view/src/contexts/useUserStore.ts, toga2-view/src/hooks/useAuthenticationFlow.ts, toga2-view/vite.config.ts, toga2-view/package.json |
+| [Mobile Nav Header](features/mobile-nav-header.md) | The `MobileNavToggle` component renders the fixed 72 px header (hamburger + Rate logo) and the slide-in drawer nav. | toga2-view/src/components/MobileNav/MobileNav.tsx, toga2-view/public/assets/Rate_Logo.svg |
+| [Service Card Component](features/service-card.md) | The `ServiceCard` component renders a single service subscription (tech support or home warranty) on both the Home and Services pages. | toga2-view/src/components/ServiceCard/ServiceCard.tsx, toga2-view/src/pages/Services/view/ServicesPage.tsx, toga2-view/src/pages/Home/view/HomePage.tsx, toga2-view/src/constants/bundleConstants.ts, toga2-view/src/pages/Services/viewModels/DUMMYFIELDS/SERVICESDUMMYFIELDS.json |

package/knowledge/2.0/apps/toga2-view/features/mobile-nav-header.md

@@ -0,0 +1,53 @@
+---
+title: Mobile Nav Header
+framework: "2.0"
+repo: toga2-view
+project: TOGa View Frontend
+client: rate
+type: feature
+status: active
+updated: 2026-06-24
+owners: ["bala"]
+files:
+  - toga2-view/src/components/MobileNav/MobileNav.tsx
+  - toga2-view/public/assets/Rate_Logo.svg
+related:
+  - clients/rate/profile.md
+  - 2.0/apps/toga2-view/features/service-card.md
+---
+
+## Summary
+
+The `MobileNavToggle` component renders the fixed 72 px header (hamburger + Rate logo) and the slide-in drawer nav. Header dimensions and spacing match Figma file `lQxDR8fCBXPnStWzI9BCv1`, node `9203-10323`.
+
+## Key files / entry points
+
+- `MobileNav.tsx` — exports both `MobileNav` (drawer) and `MobileNavToggle` (page shell + fixed header)
+- `public/assets/Rate_Logo.svg` — exported from Figma "Logos → Rate → Small" component (58.5 × 24 px); use SVG, not PNG, for correct aspect ratio
+
+## How it works
+
+**Header layout (Figma spec):**
+- Container: `fixed top-0 left-0 w-full z-50 bg-white h-[72px]`
+- Inner flex row: `flex items-center h-[72px] px-4 gap-6`
+  - `px-4` = 16 px left/right (Figma X:16)
+  - `gap-6` = 24 px between hamburger and logo (derived from Figma: logo X:64 − hamburger X:16 − hamburger W:24 = 24 px)
+- Hamburger button: `w-[24px] h-[24px]` at X:16, Y:24
+- Rate logo: `<img src="./assets/Rate_Logo.svg" className="h-[24px] w-auto" />`
+  - Height 24 px → equal 24 px top/bottom padding in 72 px header (`items-center` on h-[72px])
+  - SVG scales to natural 58.5 px wide — matches Figma Logos component W:58.5 Hug H:24 Hug
+- No `border-b`, no `shadow` on header (Figma has none)
+
+**Drawer (MobileNav):**
+- Logo in drawer: `w-[117px] h-[72px]` (3× the header logo, same `rateDark1.png`)
+- Slide-in from left via framer-motion spring animation
+
+## Gotchas / known issues
+
+- **Use `Rate_Logo.svg`, not `rateDark1.png` in the header.** The PNG has a 1.625:1 aspect ratio; at `h-[24px]` it renders only 39 px wide. The Figma Logos component is 58.5 × 24 px — only the SVG export matches this.
+- **`EnvironmentBadge` is intentionally kept** in `App.tsx` — it is a dev/QA tool and must not be removed.
+- **Page content top offset**: pages behind the fixed header need `mt-[72px]` to avoid overlap. The `allowedPaths` list in `MobileNavToggle` controls which routes get the nav shell.
+
+## Change history
+
+- 2026-06-24 — Switched header logo to Rate_Logo.svg; fixed hamburger/logo spacing to match Figma (px-4, gap-6, h-[72px] items-center); removed border-b/shadow from header (bala)

package/knowledge/2.0/apps/toga2-view/features/service-card.md

@@ -0,0 +1,66 @@
+---
+title: Service Card Component
+framework: "2.0"
+repo: toga2-view
+project: TOGa View Frontend
+client: rate
+type: feature
+status: active
+updated: 2026-06-24
+owners: ["bala"]
+files:
+  - toga2-view/src/components/ServiceCard/ServiceCard.tsx
+  - toga2-view/src/pages/Services/view/ServicesPage.tsx
+  - toga2-view/src/pages/Home/view/HomePage.tsx
+  - toga2-view/src/constants/bundleConstants.ts
+  - toga2-view/src/pages/Services/viewModels/DUMMYFIELDS/SERVICESDUMMYFIELDS.json
+related:
+  - clients/rate/profile.md
+---
+
+## Summary
+
+The `ServiceCard` component renders a single service subscription (tech support or home warranty) on both the Home and Services pages. It shows a hero image, title, Active badge, contract data rows, and a Manage button. Display names are normalised from raw API titles via a data-driven mapping.
+
+## Key files / entry points
+
+- `ServiceCard.tsx` — presentational component; all sizing/spacing must match Figma node `9203-10283`
+- `ServicesPage.tsx` — renders cards in a `flex flex-col gap-4 p-4` section (16 px uniform padding)
+- `HomePage.tsx` — renders cards inside `DynamicSection`; content wrapper must have **no** extra `px-4` (outer `dynamicSectionContainer` already supplies 16 px)
+- `bundleConstants.ts` — exports `mapServiceTitle()` which reads from `SERVICESDUMMYFIELDS.json`
+- `SERVICESDUMMYFIELDS.json` — `serviceTitleMap` array; add/rename display names here without touching code
+
+## How it works
+
+1. View model calls `mapServiceTitle(bs.title)` before setting state — raw API title becomes the branded display name.
+2. `mapServiceTitle` iterates `serviceTitleMap` in the JSON, checking each entry's `keywords` array (lowercase includes-match). First match wins; unmatched titles pass through unchanged.
+3. `ServiceCard` renders with `bg-[#e9eff2] rounded-[8px] overflow-clip` (no border, no hover shadow).
+4. Hero image uses `aspect-[1482/604]` (40.75 % height ratio) — not the old padding-bottom hack.
+5. Card body: `flex flex-col gap-5 p-4` (gap = 20 px, padding = 16 px all sides per Figma).
+6. Data section (divider + rows): `flex flex-col gap-3` (12 px between divider and rows).
+7. Plan/Renews column: explicit `w-[91px]` — not `w-24` (96 px).
+8. Manage button: `p-3 rounded-full` (12 px uniform padding, `rounded-[99px]` equivalent).
+9. Divider: `border-t border-gray-300` (Figma token `Gray/gray-300`).
+
+## Data model
+
+- `Client_Rate.Items.title` — raw service title (e.g. `1 Year Unlimited Tech Support - Annual`)
+- Display names live in `SERVICESDUMMYFIELDS.json → serviceTitleMap`
+- Current mappings:
+  - `"1 year unlimited tech support - annual"` → `Rate Whole Home Tech Services`
+  - `"whole home warranty - monthly"` → `Rate Whole Home Warranty`
+
+## Client variations
+
+Rate-specific — title mapping and image paths are Rate-only. The `ServiceCard` component itself is generic.
+
+## Gotchas / known issues
+
+- **Double padding on Home page**: `dynamicSectionContainer` has `px-4`; the services content wrapper inside `DynamicSection` must NOT add another `px-4` or cards appear too narrow.
+- **`rounded-lg` ≠ exact Figma match**: use `rounded-[8px]` explicitly — the Tailwind config extends `borderRadius` with custom values that could shift defaults.
+- **`overflow-hidden` vs `overflow-clip`**: Figma uses CSS `overflow: clip`; use Tailwind `overflow-clip` to match exactly.
+- **`mapServiceTitle` uses the original API title for image matching** — pass `bs.title` (not the mapped title) to `determineServiceImage` so keyword matching still works.
+
+## Change history
+
+- 2026-06-24 — Aligned all spacing/radius/overflow to Figma node 9203-10283; added data-driven title mapping from SERVICESDUMMYFIELDS.json; fixed double-padding on Home page (bala)

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

@@ -11,6 +11,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/Notification/Email.php, dbchanges2/Core/2026-05-21 - Monitors.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, 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 |
+| [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 |
 | [Team Sprint Management & Reporting](features/team-sprint-management.md) | `_Worker_Team_Sprint` (file `Worker/Team/Sprint.php`) is the engine behind TOGA's internal **development-sprint process and reporting**. | worker2/Worker/Team/Sprint.php |
 | [Teams Meeting Transcript Export](features/teams-transcript-export.md) | `_Worker_Team_Transcripts` (action `Team/Transcripts/Export`) polls Microsoft Graph for Teams meeting transcripts produced by a set of organizers, classifies ea | worker2/Worker/Team/Transcripts.php, worker2/Config/production.ini, worker2/Database/TeamsTranscriptExports.sql, dbchanges2/Core/2026-06-18a - Teams Transcript Export schedule.sql |

package/knowledge/2.0/apps/worker2/features/creating-worker-actions.md

@@ -7,7 +7,7 @@ client: shared
 type: feature
 status: active
 updated: 2026-06-18
-owners: [jcardinal, dfranks]
+owners: [jcardinal, dfranks, mhammontree]
 files:
   - worker2/Worker/
   - worker2/Controller/Index.php
@@ -34,7 +34,10 @@ Lambda code changes are needed** — you just create the PHP file.
    - Method: `MethodName`
    - Example: `Client/Acme/ImportData` → `Worker/Client/Acme.php`, `_Worker_Client_Acme::ImportData`.
 2. **Parameters** — name + PHP type (`string`/`int`/`bool`/`array`/`float`); optional ones
-   get PHP defaults. The framework spreads the `parameters` JSON as positional arguments.
+   get PHP defaults. The framework spreads the **string-keyed** `parameters` array into the method
+   (`$class::$method(...$parameters)`), which PHP binds as **named arguments** — so each method
+   parameter name *is* the queue's parameter contract. Do **not** collapse a multi-param action
+   into a single `array` argument: named-argument dispatch then has no key to bind to and breaks.
 3. **Return** — return `string`; `json_encode()` structured data.
 4. **`initialize()`** — optional `public static function initialize()` the framework calls
    automatically before any method in the class (register DB connections / shared setup).
@@ -160,6 +163,9 @@ be reattempted.
   commit-before-SQS transaction pattern that the worker relies on.
 
 ## Change history
+- 2026-06-24 — Clarified that the dispatcher spreads the string-keyed `parameters` as PHP **named
+  arguments** (`$class::$method(...$parameters)`), so parameter names are the queue contract — do
+  not collapse a multi-param action into a single `array` arg. (mhammontree)
 - 2026-06-18 — Documented worker-action **exception/retry semantics**: dispatcher catches `Throwable` →
   `isSuccess=0`+`failureReason`, **always HTTP 200, no DLQ, no auto-retry**; throwing surfaces a failure
   but does not re-run — retry via `_Worker::runTask` re-enqueue (attempt-counter), in-process loop, or

package/knowledge/2.0/apps/worker2/features/notification-email.md

@@ -0,0 +1,144 @@
+---
+title: DB-Driven Notification (Internal) Email
+framework: "2.0"
+repo: worker2
+project: Worker
+client: shared
+type: feature
+status: active
+updated: 2026-06-24
+owners: ["mhammontree"]
+files:
+  - 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
+related:
+  - ../../_underscore/features/email-template-sending.md
+  - ./creating-worker-actions.md
+---
+
+## Summary
+
+Internal/notification emails (merge-conflict alerts, ops notices — anything system-generated,
+not client-facing transactional mail) are sent through one worker action,
+`_Worker_Notification_Email::Send(...)`, which wraps a plain subject/body in the client's
+**DB-stored branded shell** before sending via `_Email`. The branded shell used to be a
+hardcoded PHP class (`_Email_Template`, now **deleted**); it now lives in the client DB as a
+reserved `EmailTemplates` row so the branding can change without a code deploy. This is a
+**shared/core 2.0 mechanism** — every client inherits the wrapper row from the dbchanges2
+`Client/` baseline; it is not specific to any one tenant (`True` is only the pilot tenant the
+migration backfilled first).
+
+## Key files / entry points
+
+- `worker2/Worker/Notification/Email.php` — `abstract _Worker_Notification_Email`. One method:
+  `Send(string $clientIdentifier, string $subject, string $body, string|array $to=[],
+  string|array $cc=[], string|array $bcc=[], string $fromEmail='donotreply@togatech.com',
+  string $fromName='TOGA Technology')`. The entry point. Self-registers the client DB (no
+  `initialize()` — see below), wraps the body, and sends.
+- `_underscore/Model/Client/EmailTemplate.php` — supplies `WRAPPER_UUID` and
+  `renderWrappedBody($subject, $body)`. Documented in
+  [`email-template-sending.md`](../../_underscore/features/email-template-sending.md).
+- `dbchanges2/Client/2026-06-23a - EmailTemplateWrapper.sql` — blank-client baseline; seeds the
+  wrapper row so **every new client** inherits it.
+- `dbchanges2/Client_True/2026-06-23a - EmailTemplateWrapper.sql` — backfills the pilot tenant.
+
+## How it works
+
+1. **Validate the identifier.** `$clientIdentifier` is interpolated into a schema name
+   (`Client_<id>`), so `Send()` first rejects anything that isn't `^[A-Za-z0-9]+$` (matches
+   `Core.Clients.clientIdentifier`, e.g. `True`, `CompassCanada`). This is the injection guard —
+   keep it.
+2. **Register the client DB under the `DB_CLIENT` alias** via
+   `_Database::register('Client_'.$id, _Config::databaseClient(...), …, _underscore::DB_CLIENT)`.
+   This points the process-global `Client` alias at the concrete `Client_<id>` schema so the
+   `DATABASE = DB_CLIENT` model resolves to the right tenant. Only the `Client` alias is
+   registered — **not** `DB_CLIENT_LOGS` (see gotchas).
+3. **Wrap the body.** `_Model_Client_EmailTemplate::renderWrappedBody($subject, $body)` loads the
+   active wrapper row (uuid = `WRAPPER_UUID`) and `strtr()`-substitutes `{subject}`/`{body}`.
+   Returns `null` if there is no active wrapper row.
+4. **Graceful degrade.** If `renderWrappedBody` returns `null`, `Send()` `error_log()`s the
+   missing wrapper (with the uuid + client) and sends the **raw, unwrapped** body. These are
+   internal alerts — delivering unbranded mail beats dropping the alert. (Revisit if this path is
+   ever reused for client-facing email, where branding should be guaranteed.)
+5. **Send** via a plain `_Email`: `setClientIdentifier`, `addTo/Cc/Bcc`, `setFrom`,
+   `setSubject`, `setBody($wrapped ?? $raw)`, `send()`.
+
+### Enqueuing it
+
+`_Worker::runTask('Notification/Email/Send', ['clientIdentifier'=>…, 'subject'=>…, 'body'=>…, …])`
+inserts a WorkerJob. The dispatcher (`worker2/Controller/Index.php`) resolves
+`'Notification/Email/Send'` → `_Worker_Notification_Email::Send`, then spreads the **string-keyed**
+parameters array as PHP **named arguments**. So the method's named parameters *are* the queue's
+parameter contract — see [`creating-worker-actions.md`](./creating-worker-actions.md).
+
+**Proven caller:** `_Worker_Team_GitHub::Merge()` (`worker2/Worker/Team/Github.php`) enqueues
+`Notification/Email/Send` on a git merge conflict, so merge-conflict alerts now go out branded.
+
+## The wrapper row (data model)
+
+A single reserved `EmailTemplates` row per client DB:
+
+- **uuid** = `_Model_Client_EmailTemplate::WRAPPER_UUID` (`11111111-1111-4111-8111-111111111111`).
+  This literal is the contract between the model lookup and the seed SQL — both must use it.
+- **body** holds the full branded HTML with `{subject}` and `{body}` placeholders.
+- Seeded once in `dbchanges2/Client/…` (baseline, so new clients inherit it) and backfilled per
+  existing client (`dbchanges2/Client_True/…` did the pilot). In the seed SQL the CSS font names
+  are left **unquoted** so the `INSERT` has no single quotes to escape.
+
+## Branded header — Outlook bulletproofing (load-bearing recipe)
+
+The wrapper's header must render the TOGA line-art logo
+(`TOGA-TECHNOLOGY-Header-Logo-Vector.png`, sized **exactly 600×69** = the header box) in
+**both** classic Outlook and new Outlook/Gmail/Apple, **without** the logo rendering twice. The
+working recipe — verified in classic + new Outlook:
+
+- **Classic Outlook:** VML — `<v:rect>` with `<v:fill type="frame" src=…>` and a `<v:textbox>`
+  holding the title.
+- **New Outlook / Gmail / Apple Mail:** the HTML `background=` **attribute** on the cell.
+- **No CSS `background-image`** on the header — only `background-color`. New Outlook would
+  otherwise render the CSS image *and* the `background=` attribute = the double-render.
+- **Horizontal inset belongs on the title `<div>`** (`padding: 22px 90px`), **not** on the `<td>`.
+  Putting padding on the `<td>` squeezes the VML/background image inward in classic Outlook so it
+  no longer fills the full header width.
+- The **footer** logo is a normal `<img>` (no VML needed).
+
+## Gotchas / known issues
+
+- **No `initialize()` on this action.** `_Worker_Notification_Email` does not define
+  `initialize()`, so the dispatcher never calls one — `Send()` registers its own client DB inline.
+  (The dispatcher only calls `initialize()` when the class defines it.)
+- **A `DATABASE = DB_CLIENT` model resolves only after the `Client` alias is registered** to the
+  concrete `Client_<x>` schema. `renderWrappedBody()` will load the wrong (or no) tenant if you
+  call it before `_Database::register(..., _underscore::DB_CLIENT)`. Authoritative pattern:
+  `_Worker_Ai_Bdr_Netsuite::initialize()`.
+- **Do not register `DB_CLIENT_LOGS` for this path.** `_Email` logs to CloudWatch, not a Logs DB,
+  so the notification path never needs it — and `[databaseLogs]` only exists in `production.ini`,
+  so registering it in dev/beta throws.
+- **Debug mode redirects, doesn't suppress.** When `_Email::isDebugMode()` is on, `_Email::send()`
+  redirects the recipient to `[_underscore] send_debug_emails_to` and prepends a
+  "DEVELOPMENT MODE - Intended Recipients" banner — the email still sends.
+- **Missing wrapper row → unbranded send, logged.** If a client has no active wrapper row the alert
+  still goes out (raw body) and an `error_log` line records the missing uuid. Branding is *not*
+  guaranteed on this path by design (internal mail). Don't rely on it for client-facing email.
+- **`{subject}`/`{body}` substitution is `strtr`, not sequential `str_replace`.** All placeholders
+  are replaced simultaneously, so a `{body}` literal inside the subject can't be re-expanded.
+
+## Change history
+- 2026-06-24 — Built the DB-driven notification-email mechanism (TRUE-79240): new
+  `_Worker_Notification_Email::Send` entry point; branded shell moved out of code (deleted
+  `_underscore/Email/Template.php`, which also carried the 1.0 double-render bug) into a reserved
+  per-client `EmailTemplates` wrapper row seeded by dbchanges2 (`Client/` baseline +
+  `Client_True/` backfill). Missing wrapper degrades to an unbranded send (logged). Documented the
+  Outlook-bulletproof header recipe (VML + `background=` attribute, no CSS background-image, inset
+  on the title `<div>`). Merge-conflict alerts (`_Worker_Team_GitHub::Merge`) now use this path.
+  (mhammontree)
+
+## Related docs
+- [`2.0/apps/_underscore/features/email-template-sending.md`](../../_underscore/features/email-template-sending.md)
+  — the `_Model_Client_EmailTemplate` model, including `WRAPPER_UUID` + `renderWrappedBody()`.
+- [`creating-worker-actions.md`](./creating-worker-actions.md) — worker action dispatch +
+  named-argument parameter contract.
+- `1.0/apps/library/features/email-templates.md` — the **1.0** `App_Email_Template` (a different
+  framework/mechanism; cross-link only, do not conflate).

package/knowledge/INDEX.md

@@ -16,12 +16,12 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 ## 2.0 framework
 
 - **_underscore** (_Underscore) _(framework core)_ — 12 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
-- **worker2** (Worker) — 13 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
+- **worker2** (Worker) — 14 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
 - **api2** (API) — 6 doc(s) → [2.0/apps/api2/INDEX.md](2.0/apps/api2/INDEX.md)
 - **dbchanges2** (Database Changes) _(framework core)_ — 2 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)
 - **saml** (SAML SSO Gateway) — 2 doc(s) → [2.0/apps/saml/INDEX.md](2.0/apps/saml/INDEX.md)
-- **toga2-view** (TOGa View Frontend) — 2 doc(s) → [2.0/apps/toga2-view/INDEX.md](2.0/apps/toga2-view/INDEX.md)
+- **toga2-view** (TOGa View Frontend) — 4 doc(s) → [2.0/apps/toga2-view/INDEX.md](2.0/apps/toga2-view/INDEX.md)
 - **toga2-hub** (TOGa Hub) — 2 doc(s) → [2.0/apps/toga2-hub/INDEX.md](2.0/apps/toga2-hub/INDEX.md)
 - **talos** (TOGa IQ) — 6 doc(s) → [2.0/apps/talos/INDEX.md](2.0/apps/talos/INDEX.md)
 - **voice-to-voice** (TOGa Voice) — 4 doc(s) → [2.0/apps/voice-to-voice/INDEX.md](2.0/apps/voice-to-voice/INDEX.md)

package/knowledge/clients/rate/profile.md

@@ -10,8 +10,8 @@ project: SAML SSO Gateway
 client: rate
 type: profile
 status: active
-updated: 2026-06-16
-owners: ["rgirish"]
+updated: 2026-06-24
+owners: ["rgirish", "bala"]
 files: []
 related:
   - clients/rate/features/saml-sso.md

package/package.json

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