toga-ai 1.0.616 → 1.0.617

package/knowledge/2.0/apps/toga2-commerce/features/expedited-shipping-gating.md

@@ -27,8 +27,12 @@ selected expedited method auto-resets to **"Standard Ground"**. The behavior is
 driven** — a tenant opts in per shipping-method field via an `optionGates` entry; there is no
 `if (clientSlug === ...)` branching. Omitting `optionGates` means expedited is always shown.
 
-Applies today to all three tenants: **COMPASS**, **COMPASSCANADA** (English + French), and
-**QUAD**.
+Applies today to: **COMPASS** (USER/MANAGER/SUPERUSER — **not ADMIN**, see below),
+**COMPASSCANADA** (English + French), and **QUAD**. Because configs are **per role**
+(`.../FIELDS/<CLIENT>/<LANG>/<ROLE>/CARTPAGE.ts`), opting a single role out of the gate is done
+by dropping `optionGates: [EXPEDITED_SHIPPING_GATE]` from that one role's shipping-method field —
+no shared-logic or client-branching change. **Compass USA ADMIN** now omits the gate, so admins
+always see every method (Standard Ground + both expedited) in both regular and edit-order mode.
 
 ## Key files / entry points
 - `src/pages/Cart/helpers/shippingOptionGates.ts` (NEW) — pure helpers + types:
@@ -40,8 +44,10 @@ Applies today to all three tenants: **COMPASS**, **COMPASSCANADA** (English + Fr
   `EXPEDITED_SHIPPING_GATE` config constant: `optionNames` `["2nd Day EOB","Next Day Air"]`,
   `visibleWhen { item: "primaryItem", path: "item.itemCategory.name", operator: "equals",
   value: "COMPUTERS" }`.
-- 15 `CARTPAGE.ts` files (COMPASS x4 roles, COMPASSCANADA ENGLISH x4 + FRENCH x4, QUAD x3) —
-  each shipping-method field opts in via `optionGates: [EXPEDITED_SHIPPING_GATE]`.
+- `CARTPAGE.ts` files (COMPASS USER/MANAGER/SUPERUSER — **ADMIN opted out**, COMPASSCANADA
+  ENGLISH x4 + FRENCH x4, QUAD x3) — each shipping-method field opts in via
+  `optionGates: [EXPEDITED_SHIPPING_GATE]`. `COMPASS/ENGLISH/ADMIN/CARTPAGE.ts` intentionally
+  omits it (and its now-unused import).
 - `src/pages/Cart/view/cartForm/CartForm.tsx` — filters `shippingMethodOptions` through the
   gates (reactive on `cartData.cartBundles`) before the select renders; resolves the shipping
   field via `findShippingMethodField`; uses `SHIPPING_OPTION_LABEL_SEPARATOR` for the
@@ -103,6 +109,14 @@ behavior is expressed in config, not in code branches.
   on that doc's slice-2 work-list.
 
 ## Change history
+- 2026-08-19 — **Compass USA ADMIN role opted out of the expedited gate.** Removed
+  `optionGates: [EXPEDITED_SHIPPING_GATE]` (and the now-unused import) from
+  `COMPASS/ENGLISH/ADMIN/CARTPAGE.ts`, so admins always see Standard Ground + Next Day Air +
+  2nd Day EOB in both regular commerce mode **and** edit-order mode. Because configs are per
+  role, dropping the gate on the ADMIN config alone is the scoped customization — no
+  shared-logic or client-branching change. Side effect: in edit-order mode an existing order's
+  expedited selection is no longer hidden/reset to Standard Ground for admins.
+  USER/MANAGER/SUPERUSER still gate expedited behind a computer kit. (apeterson)
 - 2026-08-19 — No change to expedited visibility. Noted that the shared shipping-rule type
   gained an optional `requireNoOtherItemsInKit` flag (+ `bundleHasOtherItems()` helper) used by
   the separate Standard Ground cost waiver — see

package/knowledge/2.0/apps/toga2-commerce/features/shipping-cost-waiver-gating.md

@@ -51,9 +51,18 @@ four Compass USA role configs (USER/ADMIN/MANAGER/SUPERUSER).
 4. When the selected method qualifies, the effect in `CartPage` waives its `c_cost` to 0 before
    writing `salesOrder.shipping`.
 
-Resulting Compass USA behavior: bare computer kit (primary computer only) → Standard Ground
-free; computer kit **with** other items → charged $10; all non-computer kits → charged;
-expedited methods unchanged (still priced).
+Resulting Compass USA behavior (full truth table, confirmed complete — no further code change):
+- **Solo computer kit on Standard Ground** → **$0** (waived; the freight is covered by the
+  `LT-FREIGHT` fee). "Solo" is scoped to the **kit** (`bundleProgressContents` has no non-primary
+  items), not the whole order.
+- **Computer kit WITH other items in the kit, or any non-computer kit** → charged Standard
+  Ground **$10** (not waived).
+- **Expedited (Next Day Air / 2nd Day EOB) + computers** → charged the method's `c_cost`
+  (2nd Day **$50**, Next Day **$100**), **never waived**.
+
+All dollar amounts live in **`ShippingMethods.c_cost` in the Compass USA client DB** (developer
+confirmed correct), **not** in frontend code — the waiver logic only zeroes a `c_cost`, it never
+sets a price.
 
 ## Gotchas
 - **The waiver only means what the flag says.** Before this fix the gate had no
@@ -68,6 +77,12 @@ expedited methods unchanged (still priced).
   a computer kit mis-categorized in the catalog will neither waive nor gate.
 
 ## Change history
+- 2026-08-19 — Confirmed the Compass USA shipping-charge truth table is fully satisfied by the
+  existing logic (no code change): solo computer kit on Standard Ground → $0 (waived, covered by
+  `LT-FREIGHT`); kit with other items or any non-computer kit → $10; expedited + computers →
+  method `c_cost` (2nd Day $50 / Next Day $100), never waived. Documented that all dollar amounts
+  live in `ShippingMethods.c_cost` in the Compass USA client DB, not in frontend code, and that
+  "solo computer" is scoped to the kit not the order. (apeterson)
 - 2026-08-19 — Fixed an over-broad Standard Ground waiver for Compass USA computer-kit carts:
   added the optional `requireNoOtherItemsInKit` flag on `PrimaryItemShippingRule` and the
   `bundleHasOtherItems()` helper, and set the flag on

package/package.json

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