toga-ai 1.0.413 → 1.0.415

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

@@ -22,6 +22,7 @@
 | [_Model::save() vs raw _Query — no atomic conditional update](features/model-save-vs-query-atomic-update.md) | `_Model::save()` is a plain load-then-write ORM primitive and **cannot express an atomic conditional update** (an optimistic-concurrency / row-claim guard such | _underscore/Model.php, _underscore/Query.php |
 | [NetSuite REST Client (_Component_Api_Netsuite) — record writes & SuiteQL](features/netsuite-rest-client.md) | `_Component_Api_Netsuite` is the **2.0 `_underscore` NetSuite REST client** — the shared primitive every worker2/api2 NetSuite caller uses for record GETs, Suit | _underscore/Component/Api/Netsuite/Netsuite.php |
 | [Per-Client Database Connections & the Local Logs Trap](features/per-client-database-connections.md) | When `_underscore` serves a request for a client it opens **three distinct per-client database connections**, not one. | _underscore/Database.php, _underscore/ApiRequest.php, _underscore/Model/Client/Logs/Api.php |
+| [Persona Name Translation (PersonaTranslations sidecar)](features/persona-name-translation.md) | Serves Persona **names** in multiple languages by adding a per-language **sidecar** table `PersonaTranslations`, reusing the platform's existing metadata-driven | _underscore/Model/Client/PersonaTranslation.php, dbchanges2/Client/2026-07-22a - PersonaTranslations.sql, dbchanges2/Core/2026-07-22a - PersonaTranslationsRecord.sql, dbchanges2/Client/2026-07-22b - PersonaTranslationsAcl.sql, dbchanges2/Client_CompassCanada/2026-07-22a - PersonaTranslationsFrench.sql |
 | [Recursive Item Fulfillments (upstream mirroring)](features/recursive-item-fulfillments.md) | In a multi-tier supply chain a sales order (SO) spawns a purchase order (PO) that becomes another SO downstream, and so on. | _underscore/Model/Client/ItemFulfillment.php, _underscore/Model/Client/ItemFulfillmentItem.php, _underscore/Model/Client/ItemFulfillmentItemUnit.php, _underscore/Model/Client/ItemFulfillmentPackage.php, _underscore/Model/Compass/AdvanceShippingNotice.php, dbchanges2/Core/2026-02-13 - 75601 - RecursiveItemFulfillmentCreation.sql, dbchanges2/Core/2026-06-04 - RecursiveItemFulfillmentPut.sql, dbchanges2/Client_Compass/2026-07-02a - FixSA133377TrackingSerialAndDuplicateIF.sql |
 | [Surface Resolver (_Model_Core_Surface::resolve — replaces Page::meta)](features/surface-resolver.md) | The runtime for the platform-wide **Surface** UI presentation layer: 9 `_underscore` models plus a cached resolver, `_Model_Core_Surface::resolve(&$api, string | _underscore/Model/Core/Surface.php, _underscore/Model/Client/AclRecordScript.php, _underscore/Model/Core/RecordScript.php, dbchanges2/Core/2026-06-30a - SurfaceMetaGroupAndSalesOrderSections.sql, dbchanges2/Client/2026-06-30a - SurfaceMetaGroupAcl.sql, dbchanges2/Client_Quad/2026-07-01a - GrantSurfacesMetaGroupScriptAcl.sql, dbchanges2/Client_CompassCanada/2026-07-01a - GrantSurfacesMetaGroupScriptAcl.sql, dbchanges2/Core/2026-06-29b - SurfaceMetaPublicReadAcl.sql, dbchanges2/Client/2026-06-29c - SurfaceRecordScriptAcl.sql, dbchanges2/Core/2026-06-29c - SurfaceDebugPhpMethodFix.sql, dbchanges2/Client_Compass/2026-07-15f - SalesOrderRecordActionsRemoveDeadConfigRuleOverrides.sql, dbchanges2/Core/2026-07-17h - Update - ClearApprovalsFilterButtonConfig.sql, dbchanges2/Client_Compass/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_Compass/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Client_CompassCanada/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_CompassCanada/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Client_Quad/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_Quad/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, _underscore/Model/Core/SurfaceElement.php, _underscore/Model/Core/Action.php, _underscore/Model/Core/Vocabulary.php, _underscore/Model/Core/VocabularyTerm.php, _underscore/Model/Core/Message.php, _underscore/Model/Client/SurfaceOverride.php, _underscore/Model/Client/MessageTranslation.php, _underscore/Model/Client/ThemeToken.php, _underscore/Model/Core/Page.php, api2/Component/Api/V2/V2.php |
 | [Table-View Hyperlink Columns (meta → ACL → computed URL → render)](features/tableview-hyperlink-columns.md) | Any 2.0 table-view column can render its value as a clickable link instead of plain text. | _underscore/Model/Client/TableView.php, _underscore/Model/Client/TrackingNumber.php, api2/Component/Api/V2/V2.php, toga2-supply/src/api/toga.ts, toga2-supply/src/components/ui/Tables/PrimaryTable/helperFunctions/formatTableData.tsx, toga2-supply/src/components/ui/Tables/PrimaryTable/helperFunctions/convertData.tsx, toga2-supply/src/components/ui/Tables/hooks/useDataTableState.tsx, dbchanges2/Client/2026-07-20 - TrackingNumberHyperlinkAndFieldPermission.sql |

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

@@ -0,0 +1,146 @@
+---
+title: Persona Name Translation (PersonaTranslations sidecar)
+framework: "2.0"
+repo: _underscore
+project: _Underscore
+client: shared
+type: feature
+status: draft
+updated: 2026-07-22
+owners: ["tcox"]
+files:
+  - _underscore/Model/Client/PersonaTranslation.php
+  - dbchanges2/Client/2026-07-22a - PersonaTranslations.sql
+  - dbchanges2/Core/2026-07-22a - PersonaTranslationsRecord.sql
+  - dbchanges2/Client/2026-07-22b - PersonaTranslationsAcl.sql
+  - dbchanges2/Client_CompassCanada/2026-07-22a - PersonaTranslationsFrench.sql
+related:
+  - ./assortment-name-translation.md
+  - ../../api2/features/language-translation-layer.md
+  - ./acl-permission-chain.md
+  - ../../toga2-commerce/features/client-fields.md
+  - ../../../clients/compass-canada/profile.md
+---
+
+## Summary
+
+Serves Persona **names** in multiple languages by adding a per-language **sidecar** table
+`PersonaTranslations`, reusing the platform's existing metadata-driven translation mechanism —
+built as an exact copy of the [Assortment Name Translation](./assortment-name-translation.md)
+pattern. English stays in `Personas.name`; the sidecar holds only non-English overlays (null →
+English fallback). Because the translation layer is fully metadata-driven (see
+[Language Translation Layer](../../api2/features/language-translation-layer.md)), wiring this up
+required **no api2 PHP logic change**: `GET /personas` names flow through `getTranslatedFieldValue`
+at the top-level serialization sites. Compass Canada's French (fr-CA) persona names are the first
+(and so far only) intended consumer.
+
+> **Status (2026-07-22): DRAFTED / DEFERRED — not committed, not run.** All five artifacts live in
+> local working trees only; the developer explicitly deferred the backend/DB changes this session.
+> `sql-reviewer` verdict was **SAFE TO MERGE (0 critical)**. See **Rollout / pre-run verification**
+> before executing — several ids and row-matches are *assumed* and must be confirmed against the live
+> DB first. DB verification could not be completed this session: all RDS endpoints (prod readers,
+> global, sandbox) are VPC-restricted from the dev machine — needs VPN or the claude.ai TOGa DB
+> connector.
+
+## Key files / entry points
+
+- `_underscore/Model/Client/PersonaTranslation.php` — the sidecar model
+  (`_Model_Client_PersonaTranslation`), a declarative copy of `AssortmentTranslation.php`.
+- `dbchanges2/Client/2026-07-22a - PersonaTranslations.sql` — the sidecar table (every client DB).
+- `dbchanges2/Core/2026-07-22a - PersonaTranslationsRecord.sql` — Core record + fields + the field link.
+- `dbchanges2/Client/2026-07-22b - PersonaTranslationsAcl.sql` — Base-role ACL grant (every client DB).
+- `dbchanges2/Client_CompassCanada/2026-07-22a - PersonaTranslationsFrench.sql` — fr-CA seed.
+
+## 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 (identical shape to the assortment sidecar):
+
+1. **Sidecar table.** `Client.PersonaTranslations` holds non-English overlays for persona names.
+   English remains in `Personas.name`; a null/absent sidecar row falls back to English.
+   `UNIQUE(personaId, languageId)`; collation `utf8mb4_unicode_ci` to match the translation-sidecar
+   family (`AssortmentTranslations`, `ItemTranslations`, the feature sidecars).
+2. **Model.** `_Model_Client_PersonaTranslation` is the ORM model for the sidecar (declarative copy
+   of `AssortmentTranslation.php`).
+3. **Core record registration.** `Core.Records` registers route `persona-translations` →
+   model `\_Model_Client_PersonaTranslation` at record **id 346** (assumed next-free), with
+   `Core.RecordFields` rows **2458–2462** for `id`, `uuid`, `personaId`, `languageId`, `name`, and an
+   `UPDATE ... JOIN` that sets `translationRecordFieldId` on the `Personas.name` RecordField.
+4. **The field link (what makes it translate automatically).** The translatable `Personas.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).
+   For persona names this works with **no api2 code change** because `GET /personas` name is emitted
+   only at top-level serialization sites, all of which run through `getTranslatedFieldValue`.
+   (Contrast the assortment sidecar, which additionally needed a `join=`/joined-select fix — persona
+   names are not surfaced via a joined-select read path, so that 5th-serialization-site concern does
+   not apply here.)
+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.PersonaTranslations` — `id, uuid, dtCreated, dtUpdated, personaId (FK Personas),
+  languageId (FK Languages), name`; `UNIQUE(personaId, languageId)`; `utf8mb4_unicode_ci`. English
+  stays in `Personas.name`; sidecar holds only non-English overlays (null → English fallback).
+- `Core.Records` **346** (assumed) = `persona-translations` (`aclDatabase = 'CLIENT'`);
+  `Core.RecordFields` **2458–2462** (assumed) for id/uuid/personaId/languageId/name.
+- `Personas.name` RecordField → `translationRecordFieldId` points at the sidecar `name` RecordField.
+
+## Rollout / pre-run verification (do this BEFORE executing)
+
+The ids and several row-matches in these migrations are **assumptions from a repo scan**, not
+confirmed against the live DB. Before running:
+
+1. **Verify next-free Core ids.** Confirm live `MAX(Core.Records.id) = 345` and
+   `MAX(Core.RecordFields.id) = 2457` so that 346 and 2458–2462 are actually free. (Consistent with
+   the feature-translation work, which used Records 343/344/345 + RecordFields 2442–2457.) If the live
+   maxima differ, renumber the record/field ids in `PersonaTranslationsRecord.sql` and the ACL SQL.
+2. **Verify the 3 out-of-band personas.** The fr-CA seed matches 30 personas by known `Personas.uuid`
+   (from the 2025-12-19 Personas seed), plus **3 personas matched by exact English name** — *Admin
+   Canada*, *MacBooks*, *Managers/VIPs* — that exist only in the live DB (no repo migration). Confirm
+   those three exist with those exact names and that `Personas` has **no duplicate names** (the
+   name-match would double-seed otherwise).
+3. **Confirm the glossary is complete.** The business-glossary screenshot the fr-CA text came from was
+   cut off after "Managers/VIPs → Gestionnaires/VIP" — confirm there are no additional personas below
+   that line before treating the seed as complete.
+
+fr-CA is `languageId 2` (same as the item-feature translations — see the Compass Canada profile and
+`UserGlobalSettings.settingId = 2`).
+
+## Frontend consumption (toga2-commerce)
+
+For the translated names to appear on the storefront **without a full reload** after a language
+switch, the persona React Query caches must be language-sensitive. The persona query keys
+`userPersonaDataOnLogin` and `userPersonaDataOnViewAs` were added to `LANGUAGE_SENSITIVE_QUERY_KEYS`
+in `src/queries/queries.ts` (toga2-commerce) so they refetch on language change — see
+[Client Fields](../../toga2-commerce/features/client-fields.md). This frontend change shipped this
+session; the backend above did not.
+
+## Client variations
+
+- **Compass Canada** is the intended first consumer: `2026-07-22a - PersonaTranslationsFrench.sql`
+  seeds fr-CA names for 33 personas (30 by uuid + 3 by exact English name). Deferred / not yet run —
+  see the Compass Canada profile.
+
+## Change history
+
+- 2026-07-22 — Drafted the `PersonaTranslations` sidecar end-to-end following the
+  `AssortmentTranslations` pattern exactly: sidecar table + `_Model_Client_PersonaTranslation` model +
+  Core record 346 / RecordFields 2458–2462 registration + `translationRecordFieldId` link on
+  `Personas.name` + Base-role ACL chain + Compass Canada fr-CA seed (33 personas). `sql-reviewer` SAFE
+  TO MERGE (0 critical). **Not committed, not run** — ids and the 3 name-matched personas need live-DB
+  verification first (RDS was VPC-unreachable this session). No api2 code change required (persona
+  names serialize only at top-level `getTranslatedFieldValue` sites). (tcox)
+
+## Related docs
+
+- [Assortment Name Translation](./assortment-name-translation.md) — the pattern this copies.
+- [Language Translation Layer](../../api2/features/language-translation-layer.md)
+- [ACL Permission Chain](./acl-permission-chain.md)
+- [Client Fields](../../toga2-commerce/features/client-fields.md) — storefront language switching.
+- [Compass Canada profile](../../../clients/compass-canada/profile.md)
+</content>
+</invoke>

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

@@ -3,5 +3,5 @@
 | Doc | Summary | Files |
 |-----|---------|-------|
 | [Database Changes (dbchanges2) Repository Architecture](architecture.md) | `dbchanges2` is the **schema-migration / SQL change-set repository** for the entire 2.0 platform. | Core/, Client/, Client_<Tenant>/, Logs/, Logs_Client/, _modules/ |
-| [Surface Layer Schema (UI presentation/config tables)](features/surface-layer-schema.md) | The persistent schema for the platform-wide **Surface** UI presentation/configuration layer (see the `_underscore` [surface-resolver](../../_underscore/features | dbchanges2/Client/2026-06-25a - SurfaceClientTables.sql, dbchanges2/Client_Compass/2026-06-25d - SalesOrderSurfaceClientSeed.sql, _underscore/Model/Client/ThemeToken.php, toga25-supply/src/themeConfig.json, dbchanges2/Core/2026-06-25a - SurfaceCoreTables.sql, dbchanges2/Core/2026-06-25b - SurfaceRecordsAndFields.sql, dbchanges2/Core/2026-06-25c - SalesOrderLoginSurfaceSeed.sql, dbchanges2/Core/2026-06-29a - ItemsSurfaceSeed.sql, dbchanges2/Core/2026-06-29b - SurfaceMetaPublicReadAcl.sql, dbchanges2/Client/2026-06-29c - SurfaceRecordScriptAcl.sql, dbchanges2/Core/2026-06-29c - SurfaceDebugPhpMethodFix.sql, dbchanges2/Core/2026-06-29d - VendorItemsSurfaceSeed.sql, dbchanges2/Core/2026-06-29e - InventorySurfaceSeed.sql, dbchanges2/Core/2026-06-30a - SurfaceMetaGroupAndSalesOrderSections.sql, dbchanges2/Client/2026-06-30a - SurfaceMetaGroupAcl.sql, dbchanges2/Client_Compass/2026-06-30a - SalesOrderDisplaySectionManagerOverrides.sql, dbchanges2/Client_CompassCanada/2026-06-30a - SalesOrderSurfaceManagerOverrides.sql, dbchanges2/Client_Quad/2026-06-30a - SalesOrderSurfaceClientOverrides.sql, dbchanges2/Client/2026-06-25a - SurfaceClientTables.sql, dbchanges2/Client/2026-06-25b - SurfaceClientSeed.sql, dbchanges2/Client/2026-06-25c - SurfaceClientAcl.sql, dbchanges2/Client/2026-06-03- BLANK_CLIENT_DATABASE.sql, dbchanges2/Core/2026-07-17h - Update - ClearApprovalsFilterButtonConfig.sql, dbchanges2/Client_Compass/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_Compass/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Client_CompassCanada/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_CompassCanada/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Client_Quad/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_Quad/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Core/2026-07-20a - Update - HideAdminNotesSectionByDefault.sql, dbchanges2/Core/2026-07-20b - Update - NotesSectionFieldElements.sql, dbchanges2/Client_Compass/2026-07-20a - AdminNotesSectionVisibilityOverride.sql, dbchanges2/Client_Compass/2026-07-20b - NotesSectionFieldsOverride.sql, dbchanges2/Client_CompassCanada/2026-07-20a - AdminNotesSectionVisibilityOverride.sql, dbchanges2/Client_CompassCanada/2026-07-20b - NotesSectionFieldsOverride.sql, dbchanges2/Client_Quad/2026-07-20a - NotesSectionFieldsOverride.sql, dbchanges2/Core/2026-07-20c - Update - VendorItemsToggleSurfaceSeed.sql, dbchanges2/Client_Compass/2026-07-20c - ItemRecordEditButtonEnable.sql, dbchanges2/Client_Compass/2026-07-20d - ItemRecordVendorItemsEnable.sql, dbchanges2/Client_CompassCanada/2026-07-20c - ItemRecordEditButtonEnable.sql, dbchanges2/Client_CompassCanada/2026-07-20d - ItemRecordVendorItemsEnable.sql, dbchanges2/Core/2026-07-20e - RestoreApproveDenyRowActions.sql, dbchanges2/Client_Compass/2026-07-20e - RowActionsApprovalWorkflowAdminEnable.sql, dbchanges2/Client_CompassCanada/2026-07-20e - RowActionsApprovalWorkflowAdminEnable.sql, dbchanges2/Core/2026-07-17 - README - RUN ORDER.md, dbchanges2/Client_Compass/2026-07-21a - SalesOrderApproveEnabledRuleOverride.sql, dbchanges2/Client_Compass/2026-07-21b - SalesOrderApprovalsGateEnable.sql, dbchanges2/Client_CompassCanada/2026-07-21a - SalesOrderApproveEnabledRuleOverride.sql, dbchanges2/Client_CompassCanada/2026-07-21b - SalesOrderApprovalsGateEnable.sql, dbchanges2/Client_Quad/2026-07-21a - SalesOrderApproveEnabledRuleOverride.sql, dbchanges2/Client_Quad/2026-07-21b - SalesOrderApproveDisabledTooltipTranslation.sql, dbchanges2/Core/2026-07-21a - SalesOrderDecisionSummarySurfaceSeed.sql, dbchanges2/Core/2026-07-21b - SalesOrderDecisionActionSurfaceSeed.sql |
+| [Surface Layer Schema (UI presentation/config tables)](features/surface-layer-schema.md) | The persistent schema for the platform-wide **Surface** UI presentation/configuration layer (see the `_underscore` [surface-resolver](../../_underscore/features | dbchanges2/Client/2026-06-25a - SurfaceClientTables.sql, dbchanges2/Client_Compass/2026-06-25d - SalesOrderSurfaceClientSeed.sql, _underscore/Model/Client/ThemeToken.php, toga25-supply/src/themeConfig.json, dbchanges2/Core/2026-06-25a - SurfaceCoreTables.sql, dbchanges2/Core/2026-06-25b - SurfaceRecordsAndFields.sql, dbchanges2/Core/2026-06-25c - SalesOrderLoginSurfaceSeed.sql, dbchanges2/Core/2026-06-29a - ItemsSurfaceSeed.sql, dbchanges2/Core/2026-06-29b - SurfaceMetaPublicReadAcl.sql, dbchanges2/Client/2026-06-29c - SurfaceRecordScriptAcl.sql, dbchanges2/Core/2026-06-29c - SurfaceDebugPhpMethodFix.sql, dbchanges2/Core/2026-06-29d - VendorItemsSurfaceSeed.sql, dbchanges2/Core/2026-06-29e - InventorySurfaceSeed.sql, dbchanges2/Core/2026-06-30a - SurfaceMetaGroupAndSalesOrderSections.sql, dbchanges2/Client/2026-06-30a - SurfaceMetaGroupAcl.sql, dbchanges2/Client_Compass/2026-06-30a - SalesOrderDisplaySectionManagerOverrides.sql, dbchanges2/Client_CompassCanada/2026-06-30a - SalesOrderSurfaceManagerOverrides.sql, dbchanges2/Client_Quad/2026-06-30a - SalesOrderSurfaceClientOverrides.sql, dbchanges2/Client/2026-06-25a - SurfaceClientTables.sql, dbchanges2/Client/2026-06-25b - SurfaceClientSeed.sql, dbchanges2/Client/2026-06-25c - SurfaceClientAcl.sql, dbchanges2/Client/2026-06-03- BLANK_CLIENT_DATABASE.sql, dbchanges2/Core/2026-07-17h - Update - ClearApprovalsFilterButtonConfig.sql, dbchanges2/Client_Compass/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_Compass/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Client_CompassCanada/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_CompassCanada/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Client_Quad/2026-07-17a - SalesOrderApprovalActionsOverride.sql, dbchanges2/Client_Quad/2026-07-17b - SalesOrderApprovalsFilterButtonOverride.sql, dbchanges2/Core/2026-07-20a - Update - HideAdminNotesSectionByDefault.sql, dbchanges2/Core/2026-07-20b - Update - NotesSectionFieldElements.sql, dbchanges2/Client_Compass/2026-07-20a - AdminNotesSectionVisibilityOverride.sql, dbchanges2/Client_Compass/2026-07-20b - NotesSectionFieldsOverride.sql, dbchanges2/Client_CompassCanada/2026-07-20a - AdminNotesSectionVisibilityOverride.sql, dbchanges2/Client_CompassCanada/2026-07-20b - NotesSectionFieldsOverride.sql, dbchanges2/Client_Quad/2026-07-20a - NotesSectionFieldsOverride.sql, dbchanges2/Core/2026-07-20c - Update - VendorItemsToggleSurfaceSeed.sql, dbchanges2/Client_Compass/2026-07-20c - ItemRecordEditButtonEnable.sql, dbchanges2/Client_Compass/2026-07-20d - ItemRecordVendorItemsEnable.sql, dbchanges2/Client_CompassCanada/2026-07-20c - ItemRecordEditButtonEnable.sql, dbchanges2/Client_CompassCanada/2026-07-20d - ItemRecordVendorItemsEnable.sql, dbchanges2/Core/2026-07-20e - RestoreApproveDenyRowActions.sql, dbchanges2/Client_Compass/2026-07-20e - RowActionsApprovalWorkflowAdminEnable.sql, dbchanges2/Client_CompassCanada/2026-07-20e - RowActionsApprovalWorkflowAdminEnable.sql, dbchanges2/Core/2026-07-17 - README - RUN ORDER.md, dbchanges2/Client_Compass/2026-07-21a - SalesOrderApproveEnabledRuleOverride.sql, dbchanges2/Client_Compass/2026-07-21b - SalesOrderApprovalsGateEnable.sql, dbchanges2/Client_CompassCanada/2026-07-21a - SalesOrderApproveEnabledRuleOverride.sql, dbchanges2/Client_CompassCanada/2026-07-21b - SalesOrderApprovalsGateEnable.sql, dbchanges2/Client_Quad/2026-07-21a - SalesOrderApproveEnabledRuleOverride.sql, dbchanges2/Client_Quad/2026-07-21b - SalesOrderApproveDisabledTooltipTranslation.sql, dbchanges2/Core/2026-07-21a - SalesOrderDecisionSummarySurfaceSeed.sql, dbchanges2/Core/2026-07-21b - SalesOrderDecisionActionSurfaceSeed.sql, dbchanges2/Client_Quad/2026-07-21c - SalesOrderDecisionSummaryOverride.sql, dbchanges2/Client_Compass/2026-07-21c - SalesOrderDecisionSummaryTotalConcat.sql, dbchanges2/Client_CompassCanada/2026-07-21c - SalesOrderDecisionSummaryTotalConcat.sql |
 | [2.0 New-Client Onboarding (manual process)](workflows/client-onboarding.md) | > **A local browser wizard now automates this.** Steps 2–9 below (create DBs, generate Core/API > inserts, append to `Clients_Db.txt`) — plus the dbchanges2 bla | Client/, Client_<Tenant>/, Core/, Logs_Client/ |

package/knowledge/2.0/apps/dbchanges2/features/surface-layer-schema.md

@@ -62,6 +62,9 @@ files:
   - dbchanges2/Client_Quad/2026-07-21b - SalesOrderApproveDisabledTooltipTranslation.sql
   - dbchanges2/Core/2026-07-21a - SalesOrderDecisionSummarySurfaceSeed.sql
   - dbchanges2/Core/2026-07-21b - SalesOrderDecisionActionSurfaceSeed.sql
+  - dbchanges2/Client_Quad/2026-07-21c - SalesOrderDecisionSummaryOverride.sql
+  - dbchanges2/Client_Compass/2026-07-21c - SalesOrderDecisionSummaryTotalConcat.sql
+  - dbchanges2/Client_CompassCanada/2026-07-21c - SalesOrderDecisionSummaryTotalConcat.sql
 related:
   - ../../_underscore/features/surface-resolver.md
 ---
@@ -306,8 +309,31 @@ Both seeds are **ADDITIVE, id-agnostic, and re-runnable**: `NOT EXISTS`-guarded
 `config.role`/`valueKey`; Messages guarded by `messageKey`; the surfaces inherit `appId`/`recordId`
 from the existing `order-details` sibling surface **by slug** (never a hardcoded id). Same authoring
 pattern as the `2026-07-17g` seed. These are **Core→Core only** (prod-safe — no cross-DB Client
-subselect). Per-client divergence (via `SurfaceOverride`) for Compass / Compass Canada / Quad is **not
-yet seeded** — this session is the shared Core default + FE wiring only.
+subselect).
+
+### Per-client decision-summary overrides (Quad hides + Compass/CC concat Total, 2026-07-21c)
+The per-client divergence off the shared `sales-order-decision-summary` surface was seeded (all three
+files use suffix `c`; `b` was already taken in each client folder, and each `run after Core/2026-07-21a`
+per the RUN ORDER README). All are **client-level** (`roleId`/`personaId`/`languageId` NULL — see the
+decision below), id-agnostic (resolved by `Surfaces.slug` + `config.valueKey`, never a hardcoded id),
+and `NOT EXISTS`-guarded.
+
+- **Quad field hides** (`Client_Quad/2026-07-21c`) — three `IS_VISIBLE='0'` overrides hiding **Assigned
+  Manager** (`assignedTo._name`), **Cost Center** (`c_erpEntityId`), and **Reason for Request**
+  (`reasonForRequest`, the read-only summary row — **NOT** the editable reason input). `IS_VISIBLE` is
+  in the base attribute ENUM (no widener needed). Renders end-to-end with **no FE change** (the resolver
+  applies visibility; the summary adapter already honors `el.isVisible`). Applied to local Client_Quad
+  and verified.
+- **Compass + Compass Canada concatenated Total** (`Client_Compass/2026-07-21c`,
+  `Client_CompassCanada/2026-07-21c`) — a `CONFIG` override on the Total element setting the **full**
+  config `{"valueKey":"_totalPurchase","isConcatenated":{"valueKey":"_totalLease","suffix":"/mo",
+  "layout":"stacked","valueType":"currency"}}` — stacks the monthly lease figure under the purchase
+  Total for the lease clients. Because a `CONFIG` override **replaces the whole object** (see the resolver
+  doc), the override **must** carry the base `valueKey` (`_totalPurchase`), not just the added
+  `isConcatenated` key — omitting it silently drops the base binding. Resolved by slug +
+  `config.valueKey='_totalPurchase'`. Requires the small FE adapter extension to emit `isConcatenated`
+  (see [surface-frontend](../../toga25-supply/features/surface-frontend.md)). Authored this session;
+  only Quad confirmed applied locally.
 
 ## ThemeTokens — per-tenant, physically isolated in each client DB
 
@@ -473,6 +499,17 @@ rule resumes.
   override is added). **Open follow-up.**
 
 ## Change history
+- 2026-07-21 — Seeded the **per-client decision-summary overrides** off the shared
+  `sales-order-decision-summary` surface (all `2026-07-21c`, client-level — `roleId`/`personaId`/
+  `languageId` NULL): **Quad** hides three summary rows (`assignedTo._name`, `c_erpEntityId`,
+  `reasonForRequest` — the read-only row, not the reason input) via `IS_VISIBLE='0'` (base ENUM, no FE
+  change); **Compass + Compass Canada** stack the monthly lease figure under Total via a `CONFIG`
+  override carrying the **full** config (`_totalPurchase` + `isConcatenated{_totalLease, suffix "/mo",
+  layout stacked, currency}`). All id-agnostic (slug + `config.valueKey`), NOT EXISTS-guarded, registered
+  in the RUN ORDER README (`run after Core/2026-07-21a`). Reinforces the CONFIG-replaces-wholesale rule:
+  a partial CONFIG override silently drops the base `valueKey`. Scoped client-level not role-scoped (a
+  display flourish for every tenant user; open follow-up to re-scope Compass concat to a role if wanted).
+  Only Quad confirmed applied locally. (apeterson)
 - 2026-07-21 — Seeded the **SalesOrder decision-modal (approve + deny) surfaces**, migrating the
   per-client `approvalActionFields.json` display config to metadata. `Core/2026-07-21a` = one SHARED
   `sales-order-decision-summary` SECTION surface (cardType `decisionSummary`, 8 read-only FIELD summary

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

@@ -6,7 +6,7 @@
 | [Cart Bundle Submission & the bundleUuid Identity Contract](features/cart-bundle-submission-and-identity.md) | How cart **bundles** (kits) are turned into `SalesOrderItems` when a cart is submitted or an existing order is edited, and the **identity-field contract** every | src/api/syncSalesOrderItemsFromLocalStorageCartToApi.ts, src/utils/formatSalesOrderBundlesFromApi.ts, src/stores/useCartStoreZu.ts, src/pages/OrderDetails/helpers/formatSalesOrderDataFromLocalStorage.ts, src/pages/OrderDetails/view/components/OrderItems.tsx |
 | [Cart Notification Emails — duplicate prevention](features/cart-notification-emails.md) | On the cart "Notifications" section a user can add CC email addresses to an order. | src/pages/Cart/CartPage.tsx, src/pages/Cart/view/cartForm/CartForm.tsx, src/stores/useEmailOptionsStore.ts, src/stores/useCartSalesQuoteZu.ts, src/pages/Cart/viewModel/FIELDS/*/*/*/CARTPAGE.ts |
 | [Cart Page — config-driven form architecture (current state + planned refactor)](features/cart-page-config-architecture.md) | The Cart page (`src/pages/Cart/`) is the most config-heavy page in `toga2-commerce`. | src/pages/Cart/CartPage.tsx, src/pages/Cart/view/cartForm/CartForm.tsx, src/pages/Cart/view/cartForm/CartFormSection.tsx, src/pages/Cart/view/cartForm/CartFormRenderer.tsx, src/pages/Cart/view/EditCart.tsx, src/pages/Cart/view/EditOrder.tsx, src/pages/Cart/viewModel/useEditOrderOrEditCartViewModel.ts, src/pages/Cart/viewModel/FIELDS/*/*/*/CARTPAGE.ts, src/hooks/useAssignClientFields.ts |
-| [Client Fields — per-tenant / language / role content & config](features/client-fields.md) | Almost no user-facing text, field layout, or page config is hard-coded in `toga2-commerce`. | src/fieldsConfig/index.ts, src/fieldsConfig/getClientLoginFields.ts, src/fieldsConfig/clientFields/COMPASS.json, src/fieldsConfig/clientFields/COMPASSCANADA.json, src/fieldsConfig/clientFields/QUAD.json, src/pages/Cart/api/CartApi.ts, src/hooks/useAuthenticationFlow.ts, src/contexts/AuthContext.tsx, src/pages/Login/viewModel/useLoginPageViewModel.ts, src/hooks/useAssignClientFields.ts, src/hooks/useDynamicConditionalFieldOptions.ts, src/stores/useFieldsStore.ts, src/components/BaseDetailField/BaseDetailField.tsx |
+| [Client Fields — per-tenant / language / role content & config](features/client-fields.md) | Almost no user-facing text, field layout, or page config is hard-coded in `toga2-commerce`. | src/fieldsConfig/index.ts, src/fieldsConfig/getClientLoginFields.ts, src/fieldsConfig/clientFields/COMPASS.json, src/fieldsConfig/clientFields/COMPASSCANADA.json, src/fieldsConfig/clientFields/QUAD.json, src/pages/Cart/api/CartApi.ts, src/hooks/useAuthenticationFlow.ts, src/contexts/AuthContext.tsx, src/pages/Login/viewModel/useLoginPageViewModel.ts, src/hooks/useAssignClientFields.ts, src/hooks/useDynamicConditionalFieldOptions.ts, src/stores/useFieldsStore.ts, src/components/BaseDetailField/BaseDetailField.tsx, src/components/NavIcons/NavIconItem.tsx, src/components/Submenus/AlertSubmenu.tsx, src/components/Submenus/types.ts, src/pages/Account/AccountPage.tsx, src/pages/Account/view/MyOrdersView.tsx, src/pages/GetSupport/GetSupportPage.tsx, src/pages/GetSupport/viewModel/useGetSupportViewModel.ts, src/queries/queries.ts |
 | [Config-Driven Expedited Shipping Gating (Cart)](features/expedited-shipping-gating.md) | On the toga2-commerce **Cart** page, expedited shipping options (**"2nd Day EOB"** and **"Next Day Air"**) are only offered in the *Shipping Method* dropdown wh | toga2-commerce/src/pages/Cart/helpers/shippingOptionGates.ts, toga2-commerce/src/pages/Cart/viewModel/FIELDS/shared/shippingOptionGates.ts, toga2-commerce/src/pages/Cart/view/cartForm/CartForm.tsx, toga2-commerce/src/pages/Cart/CartPage.tsx |
 | [Multi-Tenant Resolution & Theming](features/multi-tenant-theming.md) | `toga2-commerce` serves multiple clients from one codebase. | src/themeConfig/themes.json, src/themeConfig/ThemeContext.tsx, src/themeConfig/types.ts, src/components/ThemeSwitcher/ThemeSwitcher.tsx, src/components/AuthLayout/AuthLayout.tsx, src/api/axiosInstance.ts, src/contexts/AuthContext.tsx, tailwind.config.js |
 | [AWS Amplify Build & Deploy (non-prod environments)](workflows/amplify-build-and-deploy.md) | How `toga2-commerce` (React + Vite, "commerce2-react") builds and deploys on **AWS Amplify**. | toga2-commerce/amplify.yml, toga2-commerce/.gitattributes, toga2-commerce/package.json, toga2-commerce/.github/workflows/sync-stage-environments.yml |

package/knowledge/2.0/apps/toga2-commerce/features/client-fields.md

@@ -6,7 +6,7 @@ project: TOGa Commerce
 client: shared
 type: feature
 status: active
-updated: 2026-07-15
+updated: 2026-07-22
 owners: ["apeterson", "tcox"]
 files:
   - src/fieldsConfig/index.ts
@@ -22,11 +22,20 @@ files:
   - src/hooks/useDynamicConditionalFieldOptions.ts
   - src/stores/useFieldsStore.ts
   - src/components/BaseDetailField/BaseDetailField.tsx
+  - src/components/NavIcons/NavIconItem.tsx
+  - src/components/Submenus/AlertSubmenu.tsx
+  - src/components/Submenus/types.ts
+  - src/pages/Account/AccountPage.tsx
+  - src/pages/Account/view/MyOrdersView.tsx
+  - src/pages/GetSupport/GetSupportPage.tsx
+  - src/pages/GetSupport/viewModel/useGetSupportViewModel.ts
+  - src/queries/queries.ts
 related:
   - 2.0/apps/toga2-commerce/architecture.md
   - 2.0/apps/toga2-commerce/features/multi-tenant-theming.md
   - 2.0/apps/toga2-commerce/features/cart-notification-emails.md
   - 2.0/apps/toga2-commerce/features/cart-page-config-architecture.md
+  - 2.0/apps/_underscore/features/persona-name-translation.md
 ---
 
 ## Summary
@@ -141,7 +150,7 @@ export const FIELDS: Record<string, any> = {
       USER:      { ... },
     },
   },
-  COMPASSCANADA: { en: { ADMIN, SUPERUSER, MANAGER, USER }, fr: { ... } },
+  COMPASSCANADA: { en: { ADMIN, SUPERUSER, MANAGER, USER }, "fr-CA": { ... } },
   QUAD: { en: { GLOBALADMIN, BUYER, ITSHOPPER /*, USER */ } },
 };
 ```
@@ -156,8 +165,11 @@ export const FIELDS: Record<string, any> = {
 `ERRORFIELDS`, `LOGINSETTINGSFIELDS`, …).
 
 - **Tenant** keys: `COMPASS`, `COMPASSCANADA`, `QUAD`.
-- **Language** keys are **lowercase `en` / `fr`** in the registry. ⚠️ This differs from the on-disk
-  **folder** names, which are uppercase `ENGLISH` / `FRENCH`. Only COMPASSCANADA has `fr`.
+- **Language** keys are **`en` / `fr-CA`** in the registry (verified `src/fieldsConfig/index.ts`).
+  ⚠️ Two mismatches to keep straight: (1) the registry French key is **`fr-CA`**, *not* `fr`; and
+  (2) both differ from the on-disk **folder** names, which are uppercase `ENGLISH` / `FRENCH`. Only
+  COMPASSCANADA has `fr-CA`. See the "Language value & persistence" note and gotchas below — code that
+  compares the language must match `fr-CA` (use `startsWith("fr")`), never `=== "fr"`.
 - **Role** keys: COMPASS/COMPASSCANADA → `ADMIN`, `SUPERUSER`, `MANAGER`, `USER`;
   QUAD → `GLOBALADMIN`, `BUYER`, `ITSHOPPER` (+ `USER`).
 
@@ -195,7 +207,7 @@ const data = FIELDS?.[clientName]?.[language]?.[role] || null;
 
 Inputs:
 - **`clientName`** = `useFieldsStore.fieldKey` (the tenant `host`, set at login — see architecture doc).
-- **`language`** = `useFieldsStore.language` (default `"en"`; set to `"fr"` etc. via `setLanguage`
+- **`language`** = `useFieldsStore.language` (default `"en"`; set to `"fr-CA"` via `setLanguage`
   from the login settings switcher or `MySettingsView`).
 - **`user`** = the logged-in user (role flags).
 
@@ -203,6 +215,16 @@ It returns `{ fields, loading, error, resetFieldsMapCache }`; `resetFieldsMapCac
 `["clientFields"]` query (used when role/language/tenant changes mid-session). Page ViewModels then
 pluck the section they need, e.g. `fieldsCall["MYACCOUNTFIELDS"]`.
 
+### Language value & persistence
+
+`useFieldsStore.language` is the resolved registry language key — **`"en"` or `"fr-CA"`** for
+COMPASSCANADA. It is persisted to `localStorage` via the zustand `persist` key **`"fields-key"`**
+(`src/stores/useFieldsStore.ts`), so a chosen language survives reload. The Account settings save
+(`MySettingsView`) stores the selected option's **uuid** (`"en"` / `"fr-CA"`) through `setLanguage`.
+Any code that branches on the current language must compare against **`"fr-CA"`** — the safe test is
+`language.startsWith("fr")`, **never `language === "fr"`** (that comparison silently fails and was the
+root cause of the Get Support image bug — see gotchas).
+
 ## What's inside a FIELDS JSON
 
 Shape varies by page, but common forms:
@@ -235,14 +257,56 @@ Common field attributes: `uuid`, `label`, `valueKey` (path into the data object)
 - **New role:** extend the role-derivation in `useAssignClientFields.ts` **and** add the role key
   under each `FIELDS[tenant][lang]` branch + per-page role folders.
 - **New language:** set `languageSwitcher.isEnabled` in the tenant's `clientFields` JSON, add the
-  `fr`/`xx` branch to `FIELDS[tenant]`, and the `<LANGUAGE>` on-disk folders.
+  `fr-CA`/`xx` branch to `FIELDS[tenant]` (use the exact registry key the switcher option's uuid
+  yields), and the `<LANGUAGE>` on-disk folders.
 - **Editing copy:** change the page's `FIELDS/<CLIENT>/[<LANG>/][<ROLE>/]<NAME>FIELDS.json`. Remember
   to update **all** affected role/language variants — there is no inheritance/fallback between roles.
 
+## Keying previously-hardcoded JSX through FIELDS (with an in-code English fallback)
+
+When a piece of UI text was hard-coded in JSX and now needs to render French for COMPASSCANADA, the
+pattern is: **add the key to the COMPASSCANADA FIELDS JSON only (EN + FR × every role), and read it in
+the component with an in-code English literal fallback** — e.g. `fields?.alertsSubmenu?.markAllAsRead
+?? "Mark all as read"`. Because COMPASS/QUAD never get the key, they fall through to the English
+literal and are **unaffected** — this is the deliberate way to add a COMPASSCANADA-only translation
+without touching other tenants' JSON (distinct from the "no fallback" rule for whole role/section
+lookups, which still holds). Examples shipped 2026-07-22 (all wired to fall back to English):
+
+- **`HEADERFIELDS`** — new `adminSubmenu.manageRequests` ("Gérer les demandes") and an `alertsSubmenu`
+  group (`markAllAsRead` "Tout marquer comme lu", `openExternalLink` "Ouvrir TOGa Supply",
+  `alertSingular`/`alertPlural` "alerte"/"alertes", `allUpToDate` "Tout est à jour !"). Added to all
+  **8** COMPASSCANADA HEADERFIELDS files (EN+FR × 4 roles); consumed in
+  `src/components/NavIcons/NavIconItem.tsx` and `src/components/Submenus/AlertSubmenu.tsx` (+ `types.ts`).
+- **`ORDERHISTORYFIELDS`** — Orders-for-Others page `ordersForOthersHeading` /
+  `ordersForOthersSubheading`, and the order-search box `pageSearchInput` ("Rechercher un numéro de
+  commande" / placeholder "Rechercher un nº de commande..."). Added to all 8 files; consumed in
+  `src/pages/Account/AccountPage.tsx` and `src/pages/Account/view/MyOrdersView.tsx`.
+- **Get Support illustration is language-switched** (not a FIELDS key — an asset swap): the viewModel
+  (`src/pages/GetSupport/viewModel/useGetSupportViewModel.ts`) exposes `language`, and
+  `GetSupportPage.tsx` picks `assets/get-support-img-french.svg` when `language.startsWith("fr")`.
+
+## Language-sensitive React Query caches (`LANGUAGE_SENSITIVE_QUERY_KEYS`)
+
+`FIELDS` covers static copy, but **server data** that itself comes back translated (e.g. persona names
+via the [Persona Name Translation](../_underscore/features/persona-name-translation.md) sidecar) is
+cached by React Query and does **not** refetch on a language switch by default. `src/queries/queries.ts`
+keeps a `LANGUAGE_SENSITIVE_QUERY_KEYS` allow-list of query keys to invalidate/refetch when the
+language changes. The persona query keys `userPersonaDataOnLogin` and `userPersonaDataOnViewAs` were
+added to it 2026-07-22 so translated persona names appear after a language switch without a full page
+reload. When you add a new API-driven string that must respond to the language switcher, add its query
+key here.
+
 ## Gotchas
 
-- **`en`/`fr` (registry) vs `ENGLISH`/`FRENCH` (folders)** — mismatching these is the classic bug;
-  the runtime lookup uses lowercase.
+- **Registry French key is `fr-CA`, not `fr` — and never compare with `=== "fr"`.** The COMPASSCANADA
+  French registry key is `"fr-CA"`; any language branch must use `startsWith("fr")`. Comparing
+  `language === "fr"` silently never matches and shipped a real bug this session (Get Support kept the
+  English illustration in French mode). The doc previously mis-stated this key as `fr`.
+- **`en`/`fr-CA` (registry) vs `ENGLISH`/`FRENCH` (folders)** — mismatching these is the classic bug;
+  the runtime lookup uses the registry keys, not the folder names.
+- **The header "Admin" nav button stays "Admin" in French — do not "fix" it.** Decided 2026-07-22:
+  "Admin" is the natural French abbreviation of "administration", so the top-level button is left
+  untranslated on purpose (the dropdown *contents* are translated). It is not a localization gap.
 - **No fallback** in `FIELDS[client][language][role]` — a missing tenant/role/language combo returns
   `null` and the page renders empty. Keep all role variants in sync.
 - Role is derived from string `"1"` flags on the user (`user?._isAdmin === "1"`), not booleans.
@@ -262,6 +326,16 @@ Common field attributes: `uuid`, `label`, `valueKey` (path into the data object)
   slip. Do not "reconcile" the two lists.
 
 ## Change history
+- 2026-07-22 — **Correction:** the registry French key for COMPASSCANADA is **`fr-CA`, not `fr`**
+  (verified `src/fieldsConfig/index.ts`); documented language persistence (zustand `persist` key
+  `"fields-key"`, `setLanguage` stores the option uuid `en`/`fr-CA`) and the `startsWith("fr")` rule —
+  a `=== "fr"` comparison caused a real Get Support illustration bug. Documented the "key hard-coded
+  JSX through COMPASSCANADA FIELDS with an in-code English fallback so COMPASS/QUAD are unaffected"
+  pattern and the 2026-07-22 French-completion keys (`HEADERFIELDS` `adminSubmenu.manageRequests` +
+  `alertsSubmenu` group; `ORDERHISTORYFIELDS` orders-for-others headings + `pageSearchInput`; Get
+  Support language-switched illustration). Added the `LANGUAGE_SENSITIVE_QUERY_KEYS` mechanism (persona
+  query keys now refetch on language switch). Recorded the decision that the "Admin" nav button stays
+  "Admin" in French. (tcox)
 - 2026-06-23 — Initial: documented the two-layer field system (global `clientFields/<TENANT>.json`
   + the per-page `FIELDS` registry), the `tenant→language→role` resolution in `useAssignClientFields`,
   the `en`/`fr` vs `ENGLISH`/`FRENCH` distinction, role derivation per tenant, and field JSON shapes

package/knowledge/2.0/apps/toga25-supply/features/surface-frontend.md

@@ -292,6 +292,17 @@ values, so JSON-only functional fields survive: **Surface owns all display attri
 visibility, icons, `isRequired`, placeholder, `textAreaHeight`); JSON fills gaps and functional
 wiring. The per-client `approvalActionFields.json` files are kept on disk as reference (not deleted).
 
+**Concatenated summary values (`isConcatenated`).** `surfaceBundlesToDecisionFields.ts` now passes an
+element's `config.isConcatenated` through **verbatim** onto the decision-summary row: it exports a
+`DecisionSummaryConcat` type (string shorthand | descriptor `{valueKey, prefix?, suffix?, valueType?,
+layout?: 'inline'|'stacked', label?}`, mirroring blox `BaseDetailField`'s `isConcatenated`) and added an
+optional `isConcatenated?` to `DecisionSummaryField`; `buildSummaryFields` copies `config.isConcatenated`
+straight through. This is purely additive — before it, the adapter dropped the concat config, so the
+Compass / Compass Canada Total `CONFIG` override (stacking `_totalLease` under `_totalPurchase`, seed
+side in [surface-layer-schema](../../dbchanges2/features/surface-layer-schema.md)) would have seeded data
+the FE ignored. blox `BaseDetailField` (`renderBaseDetailFieldValue.tsx`) already supports
+`valueKey`+`suffix`+`layout:'stacked'`+`valueType:'currency'`. tsc + eslint clean.
+
 **Shared summary, separate per-action chrome (decision).** The 8 order-summary rows are identical for
 approve and deny, so they come from **one** shared surface (`sales-order-decision-summary`); the action
 chrome (title, reason-input required-ness, confirm button, icons, toasts) diverges, so it is **two**
@@ -460,6 +471,14 @@ now carry it (2026-07-21):
   treat type-checking as pending. Runtime `GET /v2/surfaces/{slug}/meta` also not yet exercised.
 
 ## Change history
+- 2026-07-21 — Extended `surfaceBundlesToDecisionFields.ts` to emit **`isConcatenated`** on
+  decision-summary rows: new exported `DecisionSummaryConcat` type (string shorthand | descriptor
+  `{valueKey, prefix?, suffix?, valueType?, layout?, label?}`, mirroring blox `BaseDetailField`); optional
+  `isConcatenated?` added to `DecisionSummaryField`; `buildSummaryFields` passes `config.isConcatenated`
+  through verbatim. Purely additive (tsc + eslint clean). The adapter previously dropped concat config, so
+  the Compass / Compass Canada Total `CONFIG` override (stacks `_totalLease` under `_totalPurchase`)
+  would have been ignored FE-side; blox `renderBaseDetailFieldValue.tsx` already renders
+  valueKey+suffix+stacked+currency. (apeterson)
 - 2026-07-21 — Migrated the **SalesOrders approve/deny decision modal** display config onto Surface via
   an **overlay** adapter seam. New `surfaceBundlesToDecisionFields.ts` adapts the 3 resolved bundles
   (`DECISION_SURFACE_SLUGS`) into `{orderContentDetails, approve, deny}`, finding elements by

package/knowledge/INDEX.md

@@ -17,7 +17,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 
 ## 2.0 framework
 
-- **_underscore** (_Underscore) _(framework core)_ — 36 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
+- **_underscore** (_Underscore) _(framework core)_ — 37 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
 - **worker2** (Worker) — 31 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
 - **api2** (API) — 13 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

@@ -14,7 +14,7 @@ project: _Underscore
 client: compass-canada
 type: profile
 status: active
-updated: 2026-07-16
+updated: 2026-07-22
 owners: [jcardinal, bala, tcox, apeterson]
 files: []
 related:
@@ -70,6 +70,15 @@ to but distinct from Compass USA. Like Compass USA it spans the **2.0** commerce
   (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).
+- **Persona names (fr-CA) — DRAFTED / DEFERRED, not yet run.** A `PersonaTranslations` sidecar copying
+  the assortment pattern (Core record 346, fr-CA seed for 33 personas) is fully drafted in working
+  trees and `sql-reviewer`-approved but **not committed or run** — ids and 3 name-matched personas need
+  live-DB verification first (RDS was VPC-unreachable). The storefront side (persona query keys made
+  language-sensitive) already shipped. See
+  [Persona Name Translation](../../2.0/apps/_underscore/features/persona-name-translation.md).
+- **Storefront French localization** (labels, submenus, orders-for-others, Get Support illustration) is
+  driven by the COMPASSCANADA FIELDS JSON; the registry language key is **`fr-CA`** (not `fr`). See
+  [Client Fields](../../2.0/apps/toga2-commerce/features/client-fields.md).
 - The 2026-06-08 ASN → ItemFulfillment work was for **Compass USA**, not Compass Canada.
 - **Order status is shipped-only**, same as Compass USA (shared `_Model_Compass_SalesOrder`).
   Compass Canada's own IF lifecycle stages (picked/packed/shipped) + shipped backfill are seeded by

package/package.json

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