toga-ai 1.0.216 → 1.0.218

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

@@ -8,6 +8,7 @@
 | [Create Elastic Beanstalk Environment (script)](features/create-elastic-beanstalk.md) | `team/aws/create_elastic_beanstalk.php` is a **standalone** (no `App_` framework) constants-driven PHP generator. | test/team/aws/create_elastic_beanstalk.php |
 | [Developer Generators (password, UUID)](features/dev-generators.md) | Two tiny **1.0 `App_` framework** convenience scripts for everyday developer needs. | test/team/generate_password.php, test/team/uuid.php |
 | [Forecast vs NetSuite Discrepancy Analysis](features/forecast-netsuite-discrepancy-analysis.md) | `team/forecast-netsuite/discrepancy_analysis.php` detects discrepancies between our **Forecast database** and **NetSuite** (the source of truth for all sales da | test/team/forecast-netsuite/discrepancy_analysis.php |
+| [@goagilant.com → @togatech.com Email-Domain Migration (1.0 + 2.0)](features/goagilant-to-togatech-email-migration.md) | Reference + technique for migrating the company email domain `@goagilant.com` → `@togatech.com` across **both** platforms. | migrate_goagilant_to_togatech_2026-06-26.sql, migrate_goagilant_to_togatech_LEGACY_2026-06-26.sql |
 | [TableView Builder (2.0 TableViews SQL generator)](features/tableview-builder.md) | `team/tableViewBuilder/` generates SQL `INSERT` statements for the **2.0 `TableViews`**, `TableViewFields`, and `TableViewJoins` tables from a plain SQL `SELECT | test/team/tableViewBuilder/TableViewGenerator.php, test/team/tableViewBuilder/index.php, test/team/tableViewBuilder/Instructions.md |
 | [Talos Knowledge Base Pipeline (Uploader + Processor)](features/talos-kb-pipeline.md) | `team/talos/` holds the two-script web tooling that feeds the **TOGa Talos** (TOGa IQ) AI knowledge bases. | test/team/talos/kb_uploader.php, test/team/talos/kb_processor.php, test/team/talos/kb_processor.ini |
 | [TOGa 2.0 Client Onboarding SQL Generator](features/toga2-client-onboarding-sql.md) | `team/generate_toga2_onboarding_sql.php` generates the SQL needed to **onboard a new client** onto the 2.0 platform. | test/team/generate_toga2_onboarding_sql.php |

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

@@ -21,6 +21,7 @@ related:
   - ./features/url-domain-markdown-document.md
   - ./features/dev-generators.md
   - ./features/talos-kb-pipeline.md
+  - ./features/goagilant-to-togatech-email-migration.md
 ---
 
 ## Summary
@@ -83,6 +84,7 @@ manually against the target database; they do not execute changes themselves.
 | `generate_toga2_user_access_sql.php` | 1.0 | 2.0 client DBs | [toga2-user-cross-client-access-sql](./features/toga2-user-cross-client-access-sql.md) |
 | `generate_password.php`, `uuid.php` | 1.0 | dev utility | [dev-generators](./features/dev-generators.md) |
 | `talos/kb_uploader.php`, `talos/kb_processor.php` | standalone | S3 + AWS Bedrock KBs | [talos-kb-pipeline](./features/talos-kb-pipeline.md) |
+| `migrate_goagilant_to_togatech_*.sql` | standalone | 2.0 `Client_` DBs + 1.0 schemas | [goagilant-to-togatech-email-migration](./features/goagilant-to-togatech-email-migration.md) |
 
 **Retired / not documented:** `team/DOA_gitbook/` is being retired.
 
@@ -91,3 +93,5 @@ manually against the target database; they do not execute changes themselves.
 - 2026-06-16 — Initial capture of the `team/` folder. Registered repo in `registry.json`.
 - 2026-06-22 — Un-retired `team/DOA_talos/` → `team/talos/`; documented its uploader +
   processor in [talos-kb-pipeline](./features/talos-kb-pipeline.md).
+- 2026-06-26 — Documented the @goagilant.com → @togatech.com email-domain migration SQL
+  artifacts in [goagilant-to-togatech-email-migration](./features/goagilant-to-togatech-email-migration.md).

package/knowledge/1.0/apps/test/features/goagilant-to-togatech-email-migration.md

@@ -0,0 +1,134 @@
+---
+title: "@goagilant.com → @togatech.com Email-Domain Migration (1.0 + 2.0)"
+framework: "1.0"
+repo: test
+project: Test
+client: shared
+type: feature
+status: active
+updated: 2026-06-26
+owners: [bala]
+files:
+  - migrate_goagilant_to_togatech_2026-06-26.sql
+  - migrate_goagilant_to_togatech_LEGACY_2026-06-26.sql
+related:
+  - ../architecture.md
+  - ./2-0-deployment-client-sql.md
+  - ../../../2.0/apps/_underscore/features/email-template-sending.md
+  - ../../../2.0/apps/_underscore/features/per-client-database-connections.md
+---
+
+## Summary
+
+Reference + technique for migrating the company email domain `@goagilant.com` →
+`@togatech.com` across **both** platforms. Two standalone SQL artifacts (run manually
+against the right cluster, not framework code) were produced:
+
+- `migrate_goagilant_to_togatech_2026-06-26.sql` — 2.0 prod, per-tenant `Client_` DBs.
+- `migrate_goagilant_to_togatech_LEGACY_2026-06-26.sql` — 1.0 legacy.
+
+The durable value is the **email-column blast-radius map** for each environment and the
+**two collision gotchas** that make a blanket find/replace unsafe. Use this before any
+future email-domain change.
+
+## Where @goagilant.com emails live
+
+### 2.0 prod (per-tenant `Client_` DBs, prod-client cluster)
+
+Value columns that actually held `@goagilant.com` data:
+
+| Column | Notes |
+|---|---|
+| `Users.email` | **UNIQUE** — identity logins. See Client_True gotcha. |
+| `ContactEmailAddresses.emailAddress` | |
+| `EmailTemplates.sendFromEmailAddress` | Present in **all 32 clients**; outbound `From:` — deliverability-sensitive (sender-verification gate below). |
+| `IntegrationsEmail.fromEmailAddress` | Outbound `From:` — deliverability-sensitive. |
+| `SalesOrderEmailAddresses.emailAddress` | Composite UNIQUE `(salesOrderId, emailAddress)`. |
+| `EmailTemplateOutgoingEmailAddresses.emailAddress` | Composite UNIQUE. |
+
+Columns that exist but held **zero** `@goagilant.com` data (skip):
+`Campaigns.bookingEmailAddress`, `LocationEmailAddresses.emailAddress`,
+`IntegrationsEmailOutgoingEmailAddresses.emailAddress`.
+
+`ContactAttempts.c_contactEmail` exists **only** in `Client_True` (BDR).
+
+Tenants with `Users.email` hits included Compass, CompassCanada, Managelife, Quad, Growrk,
+Nychh, Prudential, Aig, Endeavorhealth, Erau, Masonite, Rate, Spglobal, Towfoundation, Wje,
+Wmchealth, Ynhh, plus True (special-cased).
+
+### 1.0 legacy
+
+| Table | Hits | Notes |
+|---|---|---|
+| `TOGA.Users.email` | 1117 goagilant | Main platform login. **NOT unique** (PRIMARY on `id` only). togatech migration already ~half done: 1077 togatech rows exist; 7 goagilant overlap a togatech local-part. |
+| `TOGA_<tenant>.ClientUsers.email` | 0 goagilant | Client-portal logins — clean across all 14 tenants. |
+| `TOGA_<tenant>.Contacts.emailAddress` | ~255 | CRM. `relayEmailAddress` = 0 everywhere. |
+| `Vision.Users` | 343 | Sibling-app login, 0 togatech twins. |
+| `RetailServices.DashboardUsers` | 6 | 0 togatech twins. |
+| `ITADPortal.Users` | 3 | 0 togatech twins. |
+| `TOGaDeskAdmin.users` | 2 | 0 togatech twins. |
+
+**Not migrated** (high-volume ancillary, out of scope): helpdesk `TOGaDeskSupport.tickets`
+(15725), `Common` directory (~3700), RetailServices customer data, Netsuite/Store. The
+**Advisor** and **GoAgilant (WordPress)** schemas are not queryable via the toga-db MCP tool
+and were not assessed here.
+
+## How it works (safe-rename technique)
+
+Swap **only** the 14-char domain suffix, preserving the local-part exactly:
+
+```sql
+UPDATE SomeTable
+SET col = CONCAT(LEFT(col, CHAR_LENGTH(col) - 14), '@togatech.com')
+WHERE col LIKE '%@goagilant.com';
+```
+
+Why not `REPLACE()`: `REPLACE` is case-sensitive (misses `@GoAgilant.com`) and can touch a
+mid-string match. `LEFT`/`CONCAT` on the trailing 14 chars touches only the domain and keeps
+apostrophes/odd local-parts intact (e.g. `do'connell@`). The `LIKE` is the natural
+case-insensitive guard for the match.
+
+For the non-unique 1.0 `TOGA.Users`, a guarded variant uses `NOT EXISTS` against a
+materialized derived table of existing `@togatech.com` addresses, so the 7 would-be
+duplicate logins are skipped rather than creating colliding identities.
+
+## Scope (explicit developer instructions)
+
+- **2.0:** exclude `Client_True.Users` (see gotcha); still migrate True's other email tables.
+- **1.0:** scoped to **USERS + CONTACTS only** — explicitly exclude `Customers`,
+  `SMBContracts` (contracts/work orders), and send-from in 1.0.
+- **Never** touch any `*Logs*` schemas.
+
+## Sender-address gate (deliverability)
+
+`EmailTemplates.sendFromEmailAddress` (~118 rows across all 2.0 clients) and
+`IntegrationsEmail.fromEmailAddress` change the outbound `From:` domain. These were gated
+as a separate step pending `togatech.com` sender verification (SPF/DKIM/DMARC). The domain
+was **confirmed verified 2026-06-26**, so the sender-address step is cleared to run. Do not
+flip a `From:` domain ahead of sender verification — it breaks deliverability.
+
+## Gotchas
+
+- **Client_True (2.0) UNIQUE twins.** `Users.email` is UNIQUE. Of 343 `@goagilant.com`
+  users, **325 already have a pre-staged `@togatech.com` twin** (twins mostly never logged
+  in, `dtLastLogin` NULL — a togatech cutover was partially staged). A blanket rename
+  collides on the UNIQUE constraint (fails, or with `IGNORE` **silently skips 325**). Of the
+  18 no-twin rows, ~13 are service/SFTP/support accounts (`odpsftp@`, `staplessftp@`,
+  `support@`, …) whose rename could break integrations. **Decision:** exclude
+  `Client_True.Users.email` from the migration; migrate only True's 64 non-identity rows
+  (ContactEmailAddresses 56, Campaigns 1, ContactAttempts 1, EmailTemplates.sendFromEmailAddress
+  6), which carry no UNIQUE-on-email risk.
+- **Legacy `TOGA.Users` is non-unique and half-migrated.** PRIMARY is on `id` only, so a
+  rename can produce duplicate login emails. 1077 togatech rows already exist and 7 goagilant
+  rows overlap a togatech local-part — use the `NOT EXISTS`-guarded variant to skip those 7.
+- **Run against the right cluster.** 2.0 lives in per-tenant `Client_` DBs on the prod-client
+  cluster; 1.0 in `TOGA` / `TOGA_<tenant>` / sibling-app schemas. Review the generated SQL
+  before executing — these are manual-run artifacts, nothing auto-executes.
+
+## Change history
+
+- 2026-06-26 — Initial capture. Mapped 2.0 + 1.0 email columns, recorded the Client_True
+  UNIQUE-twin and legacy non-unique-login collision gotchas, the LEFT/CONCAT safe-rename
+  technique, scope exclusions, and the cleared sender-verification gate. (bala)
+</content>
+</invoke>

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

@@ -4,6 +4,7 @@
 |-----|---------|-------|
 | [_underscore Framework Architecture](architecture.md) | `_underscore` is the shared PHP backend framework for **all 2.0 applications**. | _underscore/_underscore.php, _underscore/Loader.php, _underscore/Framework.php, _underscore/Model.php, _underscore/Database.php, _underscore/Query.php, _underscore/Route.php, _underscore/Component.php |
 | [ACL Permission Chain (Record & Field Authorization)](features/acl-permission-chain.md) | Authorization in the 2.0 API is **metadata-driven**: whether a role may Create/Read/Update/Delete a record is decided by rows across **four linked tables**, not | api2/Component/Api/V2/V2.php, _underscore/Model/Core/Page.php, dbchanges2/Client/2026-06-03- BLANK_CLIENT_DATABASE.sql, dbchanges2/Client/2026-06-23b - ItemTranslationsAcl.sql |
+| [Assortment Name Translation (AssortmentTranslations sidecar)](features/assortment-name-translation.md) | Serves Assortment (product-grouping) **names** in multiple languages by adding a per-language **sidecar** table `AssortmentTranslations`, reusing the platform's | _underscore/Model/Client/AssortmentTranslation.php, dbchanges2/Client/2026-06-26a - AssortmentTranslations.sql, dbchanges2/Core/2026-06-26a - AssortmentTranslationsRecord.sql, dbchanges2/Client/2026-06-26b - AssortmentTranslationsAcl.sql |
 | [Carrier Shipping Labels (UPS/FedEx) & NetSuite Item Fulfillment](features/carrier-shipping-labels.md) | Backend mechanics behind TOGa Supply's Fulfill & Ship: buying a carrier label (UPS/FedEx), persisting it, and creating the NetSuite Item Fulfillment with tracki | _underscore/Model/Client/ItemFulfillment.php, _underscore/Model/Client/ItemFulfillments/TrackingNumber.php, _underscore/Component/Library/LabelPdf/LabelPdf.php, _underscore/Component/Library/Carriers/Ups/Ups.php, _underscore/Component/Library/Carriers/Fedex/Fedex.php, _underscore/Trait/Netsuite/ItemFulfillment.php, _underscore/Trait/Netsuite/SalesOrder.php, _underscore/Component/Library/NetSuite/NetSuite.php, _underscore/Model/Client/TrackingNumber.php, _underscore/Model/Client/ShippingMethod.php, _underscore/Model.php, _underscore/Cloud.php |
 | [Client Email Template Sending](features/email-template-sending.md) | `_Model_Client_EmailTemplate` sends a stored, client-defined email template by UUID. | _underscore/Model/Client/EmailTemplate.php, _underscore/Model/Client/EmailTemplateOutgoingEmailAddress.php, _underscore/Email.php |
 | [Forecast.Sales NetSuite import engine (real-time webhook)](features/forecast-sale-import.md) | Real-time importer that takes a NetSuite **sale** record and writes its lines into `Forecast.Sales` (the Forecast2 revenue table). | _underscore/Component/Forecast/SaleImport/SaleImport.php, _underscore/Component/Forecast/Db/Db.php, worker2/Worker/Netsuite/Invoice.php, worker2/Worker/Netsuite/CashSale.php, worker2/Worker/Netsuite/CreditMemo.php, worker2/Worker/Netsuite/CashRefund.php, worker2/Worker/Netsuite/JournalEntry.php, worker2/Worker/Netsuite/Opportunity.php, worker2/Worker/Netsuite/SalesOrder.php, dbchanges2/Forecast/2026-06-26a - Add journalEntry to Sales transaction type enum.sql, test/@dave/test_invoice_lifecycle.php, test/@dave/test_je_lifecycle.php, test/@dave/test_creditmemo_lifecycle.php, test/@dave/test_cashsale_lifecycle.php, test/@dave/test_cashrefund_lifecycle.php, test/@dave/NetSuite/api-message-queue/ue_api_msg_queue_enqueue.js, test/@dave/NetSuite/api-message-queue/dev_ue_api_msg_queue_enqueue.js |

package/knowledge/2.0/apps/_underscore/features/assortment-name-translation.md

@@ -0,0 +1,86 @@
+---
+title: Assortment Name Translation (AssortmentTranslations sidecar)
+framework: "2.0"
+repo: _underscore
+project: _Underscore
+client: shared
+type: feature
+status: active
+updated: 2026-06-26
+owners: ["bala"]
+files:
+  - _underscore/Model/Client/AssortmentTranslation.php
+  - dbchanges2/Client/2026-06-26a - AssortmentTranslations.sql
+  - dbchanges2/Core/2026-06-26a - AssortmentTranslationsRecord.sql
+  - dbchanges2/Client/2026-06-26b - AssortmentTranslationsAcl.sql
+related:
+  - ../../api2/features/language-translation-layer.md
+  - ./acl-permission-chain.md
+---
+
+## Summary
+
+Serves Assortment (product-grouping) **names** in multiple languages by adding a per-language
+**sidecar** table `AssortmentTranslations`, reusing the platform's existing translation mechanism.
+English stays in `Assortments.name`; the sidecar holds only non-English overlays. Because the
+translation layer is fully metadata-driven (see
+[Language Translation Layer](../../api2/features/language-translation-layer.md)), wiring this up
+required **no api2 code change** — only a new table, model, Core record registration, ACL grant,
+and a single field link. Compass Canada's French (fr-CA) assortment names are seeded as the first
+consumer.
+
+## Key files / entry points
+
+- `_underscore/Model/Client/AssortmentTranslation.php` — the sidecar model (`_Model_Client_AssortmentTranslation`).
+- `dbchanges2/Client/2026-06-26a - AssortmentTranslations.sql` — the sidecar table (every client DB).
+- `dbchanges2/Core/2026-06-26a - AssortmentTranslationsRecord.sql` — Core record + fields + the field link.
+- `dbchanges2/Client/2026-06-26b - AssortmentTranslationsAcl.sql` — Base-role ACL grant (every client DB).
+
+## How it works
+
+The mechanism itself is the data-driven translation layer documented in
+[Language Translation Layer](../../api2/features/language-translation-layer.md) — this feature only
+**registers a new translatable field** into it:
+
+1. **Sidecar table.** `Client.AssortmentTranslations` holds non-English overlays for assortment names.
+   English remains in `Assortments.name`; a null/absent sidecar row falls back to English.
+2. **Model.** `_Model_Client_AssortmentTranslation` is the ORM model for the sidecar.
+3. **Core record registration.** `Core.Records` registers route `assortment-translations` →
+   model `\_Model_Client_AssortmentTranslation` (record id **332**, `aclDatabase = 'CLIENT'`), with
+   `Core.RecordFields` rows for `id`, `uuid`, `assortmentId`, `languageId`, and `name`.
+4. **The field link (what makes it translate automatically).** The translatable `Assortments.name`
+   RecordField gets its `Core.RecordFields.translationRecordFieldId` set to the sidecar's `name`
+   RecordField. The api2 V2 layer reads `translationRecordFieldId` for every field and automatically
+   returns the sidecar value for the caller's resolved language (falling back to English when absent) —
+   so assortment names now translate **without any api2 code change**.
+5. **ACL.** A full ACL chain grants the **Base** role read/write on the new record. Because the
+   record's `aclDatabase = 'CLIENT'`, the grant lives in each client DB — see
+   [ACL Permission Chain](./acl-permission-chain.md).
+
+## Data model
+
+- `Client.AssortmentTranslations` — `id, uuid, dtCreated, dtUpdated, assortmentId (FK Assortments),
+  languageId (FK Languages), name`; `UNIQUE(assortmentId, languageId)`. English stays in `Assortments`;
+  sidecar holds only non-English overlays (null → English fallback).
+- `Core.Records` **332** = `assortment-translations` (`aclDatabase = 'CLIENT'`); `Core.RecordFields`
+  for id/uuid/assortmentId/languageId/name.
+- `Assortments.name` RecordField → `translationRecordFieldId` points at the sidecar `name` RecordField.
+
+## Client variations
+
+- **Compass Canada** seeds fr-CA assortment names (16 rows) into `AssortmentTranslations`. The French
+  text was extracted from the existing bilingual `Assortments.name` values (stored as `"English/French"`),
+  and a companion migration cleans `Assortments.name` back to English-only so the base value is pure
+  English and the French overlay lives only in the sidecar. See the Compass Canada profile.
+
+## Change history
+
+- 2026-06-26 — Initial build: `AssortmentTranslations` sidecar table + `_Model_Client_AssortmentTranslation`
+  model + `Core.Records` 332 registration + `translationRecordFieldId` link on `Assortments.name` + Base-role
+  ACL chain. Reuses the existing metadata-driven translation layer, so no api2 code change was needed.
+  Compass Canada French (fr-CA) assortment names seeded, with `Assortments.name` cleaned to English-only. (bala)
+
+## Related docs
+
+- [Language Translation Layer](../../api2/features/language-translation-layer.md)
+- [ACL Permission Chain](./acl-permission-chain.md)

package/knowledge/INDEX.md

@@ -10,13 +10,13 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **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)
 - **walmarttechservices** (Walmart Tech Services) — 1 doc(s) → [1.0/apps/walmarttechservices/INDEX.md](1.0/apps/walmarttechservices/INDEX.md)
-- **test** (Test) — 11 doc(s) → [1.0/apps/test/INDEX.md](1.0/apps/test/INDEX.md)
+- **test** (Test) — 12 doc(s) → [1.0/apps/test/INDEX.md](1.0/apps/test/INDEX.md)
 - **toga** (TOGa) — 2 doc(s) → [1.0/apps/toga/INDEX.md](1.0/apps/toga/INDEX.md)
 - **tools** (Tools) — 5 doc(s) → [1.0/apps/tools/INDEX.md](1.0/apps/tools/INDEX.md)
 
 ## 2.0 framework
 
-- **_underscore** (_Underscore) _(framework core)_ — 16 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
+- **_underscore** (_Underscore) _(framework core)_ — 17 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
 - **worker2** (Worker) — 17 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)

package/knowledge/clients/compass-canada/profile.md

@@ -44,5 +44,9 @@ to but distinct from Compass USA. Like Compass USA it spans the **2.0** commerce
 ## Notes
 - Customer language preference: `UserGlobalSettings.settingId = 2` (`en` / `fr-CA`); customer-
   facing emails are sent in EN or FR accordingly.
+- Assortment (product-grouping) names are served in fr-CA via the `AssortmentTranslations` sidecar
+  (16 rows seeded). French was extracted from the old bilingual `"English/French"` `Assortments.name`
+  values, which were then cleaned to English-only. See
+  [Assortment Name Translation](../../2.0/apps/_underscore/features/assortment-name-translation.md).
 - The 2026-06-08 ASN → ItemFulfillment work was for **Compass USA**, not Compass Canada.
 - Related: [Compass USA](../compass-usa/profile.md).

package/package.json

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