toga-ai 1.0.684 → 1.0.685

package/knowledge/clients/nychh/INDEX.md

@@ -5,4 +5,4 @@
 | [NYCHH NetSuite → TransferOrders import (stocking-flag routing, PO bridges, origin location)](features/netsuite-transfer-order-import.md) | 1.0 | NYCHH's NetSuite **transfer orders are represented as NetSuite sales orders** (same as the GroWrk pattern), so the shared NetSuite → TOGa Supply importer (`App_ | library/app/api/toga2.php, library/app/api/netsuite/rest.php, library/app/netsuite.php, worker/crons/toga2/netsuite/sync_togasupply_hh.php, worker/crons/toga2/netsuite/common_sync_togasupply.php |
 | [NYCHH PO links are UPSTREAM — the downstream SO→PO route returns empty](features/po-number-upstream-direction.md) | 2.0 | NYCHH's sales orders are created **from the customer's purchase order**, so their SO↔PO links live in the **upstream** table `PurchaseOrders_SalesOrders` (route | _underscore/Model/Client/SalesOrder.php, _underscore/Trait/Netsuite/SalesOrder.php, toga25-supply/src/pages/SalesOrders/view/SalesOrderRecordModalLayout/hooks/usePurchaseOrderDetails.ts, dbchanges2/Client/2026-08-11b - SalesOrderPurchaseOrdersField.sql, dbchanges2/Client/2026-08-25 - SalesOrderPurchaseOrdersFieldAllClients.sql |
 | [NYCHH transfer-order 2.0 model — inventory quantities + V2 field enablement](features/transfer-order-inventory-quantities.md) | 2.0 | The 2.0 (`_underscore`) side of NYCHH transfer-order support: a **two-branch inventory quantity model** on the NYCHH `Item` override, plus the **client-override | _underscore/Model/Nychh/Item.php, _underscore/Model/Nychh/TransferOrder.php, _underscore/Model/Nychh/TransferOrderStage.php, _underscore/Model/Client/TransferOrder.php, dbchanges2/Client_Nychh/2026-08-27a - TransferOrderCustomFieldWritePermission.sql, dbchanges2/Client_Nychh/2026-08-27b - TransferOrderStageStatusIdentifier.sql |
-| [NYC Health & Hospitals](profile.md) | 2.0 | NYC Health & Hospitals (NYCHH) is a TOGA 2.0 client on the `_underscore` platform, prod schema `Client_Nychh`. | dbchanges2/Client_Nychh/2026-08-18 - InventoryUnitsItemColumns.sql, dbchanges2/Client_Nychh/2026-08-24 - FixInventoryGroupingsUnitsTopologyOverrideIds.sql, dbchanges2/Client_Nychh/2026-08-27a - TransferOrderCustomFieldWritePermission.sql, dbchanges2/Client_Nychh/2026-08-27b - TransferOrderStageStatusIdentifier.sql |
+| [NYC Health & Hospitals](profile.md) | 2.0 | NYC Health & Hospitals (NYCHH) is a TOGA 2.0 client on the `_underscore` platform, prod schema `Client_Nychh`. | dbchanges2/Client_Nychh/2026-08-18 - InventoryUnitsItemColumns.sql, dbchanges2/Client_Nychh/2026-08-24 - FixInventoryGroupingsUnitsTopologyOverrideIds.sql, dbchanges2/Client_Nychh/2026-08-27a - TransferOrderCustomFieldWritePermission.sql, dbchanges2/Client_Nychh/2026-08-27b - TransferOrderStageStatusIdentifier.sql, dbchanges2/Client_Nychh/2026-08-28a - TransferOrdersTableView.sql, dbchanges2/Client_Nychh/2026-08-28b - TransferOrdersNavigationEnable.sql |

package/knowledge/clients/nychh/features/po-number-upstream-direction.md

@@ -6,7 +6,7 @@ project: _Underscore
 client: nychh
 type: client-feature
 status: active
-updated: 2026-08-26
+updated: 2026-08-28
 owners: [apeterson, bala]
 files:
   - _underscore/Model/Client/SalesOrder.php
@@ -70,10 +70,19 @@ the **upstream** table.
   safe **only** because NYCHH's upstream bridge is coincidentally 1:1 (823 rows / 823 distinct sales
   orders). Copying that join into a shared single-record fetch breaks Compass (up to 6,440 POs on one
   order), Compass Canada (empty upstream bridge) and Prudential (1,868 of 26,843 upstream).
+- **The transfer-order items table inherits the same blank.** `TransferOrderItems` has no
+  line-level PO, so that column binds the **parent order's** `purchaseOrder.number` and repeats on
+  every row — and for NYCHH it resolves NULL, because their PO links are upstream and
+  `TransferOrders.purchaseOrderId` is not populated for this tenant. The column is deliberately left
+  visible in the Core surface (neutral default; other tenants do populate it). See
+  [Transfer Orders page](../../../2.0/apps/toga25-supply/features/transfer-orders-page.md).
 - Do not "fix" this by adding downstream rows. The direction is correct for NYCHH's business model;
   the shared field is what was incomplete.
 
 ## Change history
+- 2026-08-28 — Noted that the new Transfer Orders items table shows the **order-level** PO
+  (`TransferOrderItems` has no line-level PO), so it repeats per row and resolves **NULL for NYCHH**
+  for the same upstream-direction reason — left visible in Core as the neutral default. (apeterson)
 - 2026-08-26 — Closed the open `_purchaseOrders` gap: fixed in the **base** field as a
   downstream-then-upstream `COALESCE` (not a NYCHH override), taking NYCHH from 64 to **819 of 819**
   orders with a PO and changing no existing value; currently on `_beta`, not `_production`. Refined

package/knowledge/clients/nychh/profile.md

@@ -15,13 +15,15 @@ project: _Underscore
 client: nychh
 type: profile
 status: active
-updated: 2026-08-27
+updated: 2026-08-28
 owners: ["jcardinal", "apeterson", "bala"]
 files:
   - dbchanges2/Client_Nychh/2026-08-18 - InventoryUnitsItemColumns.sql
   - dbchanges2/Client_Nychh/2026-08-24 - FixInventoryGroupingsUnitsTopologyOverrideIds.sql
   - dbchanges2/Client_Nychh/2026-08-27a - TransferOrderCustomFieldWritePermission.sql
   - dbchanges2/Client_Nychh/2026-08-27b - TransferOrderStageStatusIdentifier.sql
+  - dbchanges2/Client_Nychh/2026-08-28a - TransferOrdersTableView.sql
+  - dbchanges2/Client_Nychh/2026-08-28b - TransferOrdersNavigationEnable.sql
 related:
   - ../../2.0/apps/_underscore/features/tracking-number-bridges.md
   - ../../2.0/apps/_underscore/features/tableview-joins.md
@@ -29,6 +31,7 @@ related:
   - ./features/netsuite-transfer-order-import.md
   - ./features/transfer-order-inventory-quantities.md
   - ../../2.0/apps/_underscore/features/sales-order-purchase-order-bridge-direction.md
+  - ../../2.0/apps/toga25-supply/features/transfer-orders-page.md
 ---
 
 ## Summary
@@ -61,6 +64,15 @@ table views. Client-specific DB change-sets live in `dbchanges2/Client_Nychh/`.
   arrive as sales orders; the 1.0 importer routes them by the `custbody_stocking_order` flag (not the
   dollar amount), bridges the PO, and resolves origin/destination locations. See
   [NYCHH NetSuite → TransferOrders import](./features/netsuite-transfer-order-import.md).
+- **Transfer Orders is an NYCHH-only screen (2026-08-28, local only).** NYCHH is the first — and
+  today the only — tenant with a `transfer-orders` TableView (`Client_Nychh/2026-08-28a`, which also
+  seeds the ACL chain for record 351 that the Status column silently depends on) and the one
+  `SurfaceOverrides` row that reveals the nav item (`2026-08-28b`, client-wide, matching how this
+  tenant already grants Sales Orders and Inventory — NYCHH does not scope navigation by role). The
+  Core surfaces and the stage colour tokens are **shared/neutral**, hidden for every other client
+  until they opt in. Not yet run on sandbox-client or production; **beta is blocked** because it
+  lacks the `TransferOrderStages` table. See
+  [Transfer Orders page](../../2.0/apps/toga25-supply/features/transfer-orders-page.md).
 - **Two-branch inventory quantities + TransferOrder V2 enablement** — NYCHH-only on-hand/available/
   fulfilled/backordered model on `_Model_Nychh_Item`, plus the client-override models + ACL rows that
   let a NetSuite TransferOrder POST succeed. See

package/package.json

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