toga-ai 1.0.714 → 1.0.716

package/knowledge/1.0/apps/worker/features/netsuite-togasupply-per-client-sync.md

@@ -6,7 +6,7 @@ project: Worker
 client: shared
 type: feature
 status: active
-updated: 2026-08-30
+updated: 2026-08-31
 owners: ["dfranks", "bala", "jcardinal", "mhammontree", "snaredla"]
 files:
   - worker/crons/toga2/netsuite/common_sync_togasupply.php
@@ -732,6 +732,35 @@ Parameters are stored **per client DB** but accessed **through the TOGa2 API**,
   line). **Fix (`library`):** skip lines whose `adjustQtyBy` is null in **BOTH** passes over
   `inventoryList->inventory` (the item-build pass and the serial/unit pass). Shared fix; unblocked NYCHH
   inventory adjustments.
+- **⚠ Item-receipt sync froze on a PARTIAL receipt's NULL-quantity PO lines — the item-receipt TWIN of the
+  inventory-adjustment NULL-quantity fix above (fixed 2026-08-31).** For a partial item receipt NetSuite
+  returns **all** the PO's linked lines but sets `quantity=null` on the lines **not received on this
+  receipt** (SuiteQL `transactionline.quantity` is NULL for an un-received PO line). The REST shim
+  `App_Api_Netsuite_Rest::fetchItemReceiptById` (`rest.php` ~L2196) faithfully carries that null, and
+  `syncItemReceiptFromNetsuite` wrote those null lines into the `POST /v2/item-receipts` payload →
+  `ItemReceiptItems.quantity` is `NOT NULL` → api2 `EV-10` / MySQL **1048** "Column 'quantity' cannot be
+  null", the section threw (no per-record try/catch — fail-loud by design), and froze at `1-RUNNING`
+  re-trying the same poison receipt every 5 min. Seen on **NYCHH** ITEM_RECEIPTS: stuck on receipt **#22302**
+  (NetSuite internalId 3425518, dated 2023-05-01; 5 PO lines, 2 received qty 260, 3 returned null), watermark
+  frozen at 2023-05-01, throwing every run (`Logs.Issue 578`, "Invalid API Response" from
+  `send()` `toga2.php:3517`). **Fix (`library`):** skip line items whose `quantity` **`is_null`** (NOT
+  `empty`, so a legitimate received qty of 0 still writes) in **BOTH** passes over
+  `$nsItemReceipt->itemList->item` — the payload-build loop (~L3376) and the unit/serial pass (~L3538).
+  Shared fix; no signature change, no SQL. Recovery is automatic: the watermark sits at the failing window's
+  start, so on deploy the section self-heals (RUNNING→IDLE, watermark advances past #22302, window regrows).
+  Diagnosis chain (reinforces the playbook above): `Client_Nychh.Parameters` to localize the stuck section
+  (`1-RUNNING` + frozen watermark) → `Logs.Event` filtered by `clientId=3` for the crash file:line +
+  `transactionId` (`Logs.Event` carries `clientId`, `Logs.Issue` does not) → `Logs_Nychh.Api` on that
+  `transactionId` for the untruncated `EV-10`/1048 rejection and the payload showing the `quantity:null`
+  lines.
+- **⚠ OPEN, not yet root-caused (found 2026-08-31): NYCHH ITEM_FULFILLMENTS watermark frozen at 2021-12-29.**
+  `NETSUITE_EXECUTION_MODE_ITEM_FULFILLMENTS='3-IDLE'` with the window collapsed to ~3s (it has been
+  throwing recently) but currently **IDLE** — so it crawls a few seconds per run rather than sitting in a
+  hard `1-RUNNING` freeze. Distinct from the fixed ITEM_RECEIPTS freeze above; needs its own investigation.
+  Context: the 2026-08-31 full 19-client togasupply prod sweep found all other clients healthy
+  (`864000-IDLE`) except Elite SALES_ORDERS `864000-RUNNING` (healthy mid-run, large window, not stuck) and
+  AIG SALES_ORDERS `8-RUNNING` (the known held account, already documented). Only NYCHH ITEM_RECEIPTS was in
+  a true `1-RUNNING` freeze.
 - **⚠ Item-fulfillment stale-item prune must delete tracking-number children before the unit AND the item
   (fixed 2026-08-30).** In `syncItemFulfillmentFromNetsuite`'s cleanup loop, deleting a stale
   item-fulfillment-item-**unit** failed api2 `EV-11` / MySQL **1451** (FK
@@ -792,6 +821,16 @@ Parameters are stored **per client DB** but accessed **through the TOGa2 API**,
 
 ## Change history
 
+- 2026-08-31 — **Item-receipt partial-receipt NULL-quantity fix (shared, `library`).**
+  `syncItemReceiptFromNetsuite` now **skips line items whose `quantity` is null** (unreceived PO lines on a
+  partial receipt) in both passes over `$nsItemReceipt->itemList->item` (payload-build ~L3376 + unit/serial
+  ~L3538), guarded on `is_null` so a received qty of 0 still writes. This is the item-receipt twin of the
+  2026-08-30 inventory-adjustment NULL-quantity skip — the receipt path never got that guard. It unfroze
+  NYCHH ITEM_RECEIPTS (stuck `1-RUNNING` on receipt #22302 / NetSuite 3425518 / 2023-05-01 → `EV-10`/1048
+  "quantity cannot be null", `Logs.Issue 578`); self-heals on deploy. Also flagged an OPEN item: NYCHH
+  ITEM_FULFILLMENTS watermark frozen at 2021-12-29 (`3-IDLE`, window collapsed to ~3s), not yet root-caused.
+  19-client sweep otherwise healthy. `library` only, no SQL, `php -l` clean; not deployed at capture time.
+  (jcardinal)
 - 2026-08-31 — **Invoice + serial-unit + duplicate-Item root-cause fixes (shared, `library`).**
   `syncInvoiceFromNetsuite` now assigns a **sequential 1..N invoice `lineNumber`** (NetSuite reuses `line`
   across multi-SO invoices → `InvoiceItems UNIQUE(invoiceId,lineNumber)` 1062 → atomic rollback → NYCHH

package/knowledge/2.0/apps/toga-blox/INDEX.md

@@ -7,8 +7,8 @@
 | [AdvancedSelect (virtualized single/multi select)](features/advanced-select.md) | `AdvancedSelect<T>` is a **fully controlled, virtualized** single/multi select built from scratch (not react-select) on **`@tanstack/react-virtual`**, for large | toga-blox/src/components/AdvancedSelect/AdvancedSelect.tsx, toga-blox/src/components/AdvancedSelect/AdvancedSelect.types.ts, toga-blox/src/components/AdvancedSelect/AdvancedSelect.module.css |
 | [API client (axios wrapper, auth, table-data fetchers)](features/api-client.md) | `src/api/` is a thin **axios** wrapper that standardizes the **2.0 API envelope**, manages auth (Bearer + refresh), serializes complex query options, and provid | toga-blox/src/reactQuery/queryHelpers.ts, toga-blox/src/api/index.ts, toga-blox/src/api/axiosInstance.ts, toga-blox/src/api/apiFunctions.ts, toga-blox/src/api/auth.ts, toga-blox/src/api/genericApi.ts, toga-blox/src/api/types.ts, toga-blox/src/api/tableData |
 | [BaseInput (react-hook-form field factory)](features/base-input.md) | `BaseInput` is a **form-field factory** driven by react-hook-form. | toga-blox/src/components/BaseInput/BaseInput.tsx, toga-blox/src/components/BaseInput/BaseInput.types.ts, toga-blox/src/components/BaseInput/BaseInput.module.css, toga-blox/src/components/BaseInput/components |
-| [blox authoring defect backlog (fix IN blox, not around it)](features/blox-authoring-defects.md) | The standing list of **defects to fix inside `@agilant/toga-blox`**. | toga-blox/src/components/BaseButton, toga-blox/src/api/auth.ts, toga-blox/src/api/axiosInstance.ts, toga-blox/src/reactQuery/queryHelpers.ts, toga-blox/src/components/BaseInput, toga-blox/tsconfig.json, toga-blox/package.json |
-| [Primary Table templates (server/client, sizing, virtualization)](features/primary-table-templates.md) | `src/templates/PrimaryTable/` is the **production, wired-up table** built on the [Table component](table.md). | toga-blox/src/components/Table/themeConfig/toga.module.css, toga-blox/src/templates/PrimaryTable/PrimaryTable.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableServerTemplate.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableClientTemplate.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableHeaderCell.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableBodyCell.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableRow.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableExpandableRow.tsx, toga-blox/src/templates/PrimaryTable/types.ts |
+| [blox authoring defect backlog (fix IN blox, not around it)](features/blox-authoring-defects.md) | The standing list of **defects to fix inside `@agilant/toga-blox`**. | toga-blox/src/components/BaseButton, toga-blox/src/components/Table/themeConfig/toga.module.css, toga-blox/src/api/auth.ts, toga-blox/src/api/axiosInstance.ts, toga-blox/src/reactQuery/queryHelpers.ts, toga-blox/src/components/BaseInput, toga-blox/tsconfig.json, toga-blox/package.json |
+| [Primary Table templates (server/client, sizing, virtualization)](features/primary-table-templates.md) | `src/templates/PrimaryTable/` is the **production, wired-up table** built on the [Table component](table.md). | toga-blox/src/components/Table/themeConfig/toga.module.css, toga25-supply/src/themeConfig.json, toga-blox/src/templates/PrimaryTable/PrimaryTable.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableServerTemplate.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableClientTemplate.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableHeaderCell.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableBodyCell.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableRow.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableExpandableRow.tsx, toga-blox/src/templates/PrimaryTable/types.ts |
 | [TableRecordModal (record-detail modal shell)](features/table-record-modal.md) | `TableRecordModal` is a **generic, presentational modal shell** for showing a single table record (row) in detail — typically opened from a table row click. | toga-blox/src/components/TableRecordModal/TableRecordModal.tsx, toga-blox/src/components/TableRecordModal/index.ts, toga-blox/src/components/TableRecordModal/tableRecordModal.module.css |
 | [Table component (cells, action cells, filters & sorts, hooks, theming)](features/table.md) | The `Table` component (`src/components/Table/`) is the **TanStack Table v8** building block behind the [Primary Table templates](primary-table-templates.md). | toga-blox/src/components/Table/hooks/useFetchTablePageMeta.ts, toga-blox/src/api/types.ts, toga-blox/src/components/Table/index.ts, toga-blox/src/components/Table/types.ts, toga-blox/src/components/Table/utils/buildTanstackColumns.tsx, toga-blox/src/components/Table/utils/resolveCellType.tsx, toga-blox/src/components/Table/components/cellTypes, toga-blox/src/components/Table/components/actionCells, toga-blox/src/components/Table/components/columnFiltersAndSorts, toga-blox/src/components/Table/hooks, toga-blox/src/components/Table/themeConfig |
 | [Talos AI-Assistant Component (launcher + docked/drawer chat panel)](features/talos-assistant.md) | `Talos` is a **shared, pure-UI** AI-assistant component in `@agilant/toga-blox`: a header launcher button (`TalosLauncher`) plus a chat panel (`TalosPanel`) tha | toga-blox/src/components/Talos/TalosLauncher.tsx, toga-blox/src/components/Talos/TalosPanel.tsx, toga-blox/src/components/Talos/TalosMessage.tsx, toga-blox/src/components/Talos/types.ts, toga-blox/src/components/Talos/theme.ts, toga-blox/src/components/Talos/helpers.tsx, toga-blox/src/components/Talos/stub.ts, toga-blox/src/components/Talos/Talos.module.css, toga-blox/src/components/Talos/index.ts, toga-blox/src/components/index.ts |

package/knowledge/2.0/apps/toga-blox/features/blox-authoring-defects.md

@@ -6,10 +6,11 @@ project: TOGa Blox
 client: shared
 type: feature
 status: active
-updated: 2026-08-28
-owners: [apeterson]
+updated: 2026-08-31
+owners: [apeterson, tcox]
 files:
   - toga-blox/src/components/BaseButton
+  - toga-blox/src/components/Table/themeConfig/toga.module.css
   - toga-blox/src/api/auth.ts
   - toga-blox/src/api/axiosInstance.ts
   - toga-blox/src/reactQuery/queryHelpers.ts
@@ -108,6 +109,32 @@ declarations to the base button class. Until then a consumer must compensate at
 [surface-frontend](../../toga25-supply/features/surface-frontend.md)). **Do not patch the shared blox
 stylesheet from a consumer**: every one of the ~40 call sites inherits it.
 
+### 5. Hardcoded visual values in the shared stylesheets are unremovable by a consumer
+
+**Mechanism.** blox styles are scoped CSS Modules driven by host tokens (frontend standard §13e), but
+several declarations still carry **literal** values instead of `var(--token, <value>)`. A literal has
+no escape hatch: the consuming app cannot override a class it cannot name, and the host-token layer
+is the only supported styling surface.
+
+**Consumer symptom.** "The design says remove this and I can't." Worked example (2026-08-31): the
+`supply`-skin table card shadow was a literal `box-shadow: 0 1px 3px rgba(0,0,0,0.1)` on
+`.tableAndPaginationInner.supply` / `.tableWrapper.supply`, so a toga25-supply design review that
+required *no* table shadow had nothing to set. **Fixed for that property** —
+`var(--primaryTable-box-shadow, 0 1px 3px rgba(0,0,0,0.1))`. The class of defect remains: audit the
+rest of `toga.module.css` and the other component stylesheets the same way.
+
+**Fix direction.** When a literal is found, convert it in place to
+`var(--<component>-<prop>, <the existing literal>)`. The fallback makes this **non-breaking** — every
+consumer that defines nothing keeps the exact historical look — so it does not need the coordinated
+bump the other defects here do. Do **not** solve it by patching the shared stylesheet from a consumer
+or by `!important` in app CSS.
+
+**Related smell — literals that reference tokens no app defines.** `.headerCell.edgeLeft::after` /
+`.edgeRight::before` styled a divider with `--toga-color-border-default`, a token no consuming app
+declares, on class names `getStickyClass` never emits. Dead rules like this look authoritative when
+someone greps for the divider. Both were deleted 2026-08-31; grep the emitting code before trusting a
+CSS rule, and check the token it names actually exists in a host theme.
+
 ## Already-known authoring items (carried over from §22)
 
 These are long-standing and were previously recorded only as consumer-side advice:
@@ -141,6 +168,12 @@ These are long-standing and were previously recorded only as consumer-side advic
   time**, with no PR. Sequence auth fixes deliberately.
 
 ## Change history
+- 2026-08-31 — Added styling defect **5: hardcoded visual values in the shared stylesheets cannot be
+  removed by a consumer** — a literal has no host-token escape hatch. Worked example: the `supply`
+  table card shadow, which a toga25-supply design review needed gone; converted to
+  `var(--primaryTable-box-shadow, <old literal>)`, which is non-breaking because the fallback
+  preserves the historical look. Recorded the related smell of dead CSS naming tokens/classes that
+  nothing emits (`edgeLeft`/`edgeRight` + `--toga-color-border-default`, both deleted). (tcox)
 - 2026-08-28 — Added styling defect **4: `BaseButton` `primary` vs `primaryAction` are not
   interchangeable** — `.primaryBtnAction` sets font-size **and** `height: 26px`, `.primaryBtn` sets
   neither, so swapping variants silently changes type size and button height. Found wiring the

package/knowledge/2.0/apps/toga-blox/features/primary-table-templates.md

@@ -6,10 +6,11 @@ project: TOGa Blox
 client: shared
 type: feature
 status: active
-updated: 2026-08-26
-owners: [apeterson]
+updated: 2026-08-31
+owners: [apeterson, tcox]
 files:
   - toga-blox/src/components/Table/themeConfig/toga.module.css
+  - toga25-supply/src/themeConfig.json
   - toga-blox/src/templates/PrimaryTable/PrimaryTable.tsx
   - toga-blox/src/templates/PrimaryTable/PrimaryTableServerTemplate.tsx
   - toga-blox/src/templates/PrimaryTable/PrimaryTableClientTemplate.tsx
@@ -83,6 +84,40 @@ spacer rows computed from the virtualizer item `.start`/`.end` minus `scrollMarg
 `supply-modal-table` skin **disables virtualization** (renders all rows, min-height 300px).
 Sticky columns use a `--sticky-offset` CSS variable summed from neighboring column widths.
 
+## Sticky columns: the divider line and first-column padding
+
+**The fixed-column divider is a rendered `<span>`, not a pseudo-element.**
+`PrimaryTableHeaderCell` / `PrimaryTableBodyCell` render an absolutely-positioned 1px
+`.stickyEdgeLine` (+ `.stickyEdgeLineLeft` / `.stickyEdgeLineRight`) inside the sticky cell,
+colored `--primaryTable-border-default`. The header variant (`.headerEdgeLine`) is
+`height: calc(100% + 1px)` so it covers the 1px transparent collapsed border on
+`.bodyRow:first-child` — without the overhang a white seam shows between the header's line and
+the first row's. Header cells are never clipped (`truncateCells` sets `overflow:hidden` on
+`.bodyCell` only), so the overhang is safe.
+
+**A sticky FIRST column needs its own padding rule.** `.bodyCell.stickyCell` (`padding: 12px 16px`)
+and `.bodyCell:first-child` (`padding: 10px 25px 10px 20px`) have **equal specificity**, so the
+later one in the file wins — a left-pinned first column silently dropped to 16px left padding
+while `.headerCell:first-child` kept 20px, misaligning header against body.
+`.bodyCell.stickyCell:first-child` restores the 20px, and it **must sit after
+`.bodyCell.stickyCell` and before `.bodyCell.stickyCell.actionCell`** so a start-positioned action
+column still wins its `padding: 0`.
+
+## Host tokens in `toga.module.css`
+
+Design tokens are `--primaryTable-*`; blox ships **class rules only, zero token values** (see
+frontend standard §13e), so each is written `var(--token, <historical value>)` and the fallback is
+what preserves the existing look for consumers that never define it.
+
+- **`--primaryTable-box-shadow`** — the `supply`-skin card shadow on
+  `.tableAndPaginationInner.supply` and `.tableWrapper.supply`. Fallback
+  `0 1px 3px rgba(0,0,0,0.1)` (the value that used to be hardcoded). `toga25-supply` sets
+  `"--primaryTable-box-shadow": "none"` in its `src/themeConfig.json` DEFAULT theme to remove the
+  shadow app-wide for every client build. The `desk` / nested skins set `box-shadow: none`
+  directly and are unaffected.
+- **`--primaryTable-border-default`** — every table rule line, including the sticky edge line.
+  `toga25-supply` resolves it to `--gray-300` (#D4D5D8).
+
 ## The "Show more" hover affordance is CSS-driven, not JS-driven
 
 A truncated body cell reveals its "Show more" toggle **on hover via CSS only**:
@@ -106,6 +141,15 @@ runs unconditionally — it no longer no-ops while `isExpanded`.
   cell's text ellipsizes marginally earlier until the next `mouseleave`. Cosmetically invisible;
   clearing it properly would need a per-cell scroll listener.
 
+- **Don't hardcode a themeable value in `toga.module.css`.** A hardcoded property is unremovable by
+  a consuming app — there is no `!important` escape hatch through the host-token layer. Expose it as
+  `var(--primaryTable-<prop>, <the current hardcoded value>)`: the app gains control and every other
+  consumer keeps the historical look with no change.
+- **`edgeLeft` / `edgeRight` were dead classes.** `.headerCell.edgeLeft::after` /
+  `.headerCell.edgeRight::before` were removed (2026-08-31) — `getStickyClass` never emitted those
+  class names in `src` **or** the published `dist`, and they referenced
+  `--toga-color-border-default`, a token no consuming app defines. Chasing the fixed-column divider
+  through them is a dead end; it is the `stickyEdgeLine` span above.
 - Frozen widths measure only **mounted** rows; virtualized tables size from the first paint set.
 - **Header labels must never abbreviate or overlap.** The full header width is a hard floor
   (above `maxColumnWidth`, `minColumnWidth`, and pinned `columnWidths`). Measure header width
@@ -120,6 +164,23 @@ runs unconditionally — it no longer no-ops while `isExpanded`.
   not the column set.
 
 ## Change history
+- 2026-08-31 — Host-tokenized the `supply`-skin table shadow: `.tableAndPaginationInner.supply` /
+  `.tableWrapper.supply` now use `box-shadow: var(--primaryTable-box-shadow, 0 1px 3px rgba(0,0,0,0.1))`,
+  adding `--primaryTable-box-shadow` to the host-token set (a design review needed the shadow gone and
+  no token existed; the fallback keeps every other consumer identical). `toga25-supply` sets it to
+  `none` in `src/themeConfig.json`. Also **removed dead** `.headerCell.edgeLeft::after` /
+  `.edgeRight::before` (never emitted by `getStickyClass` in src or dist; referenced an undefined
+  token) and documented the real `stickyEdgeLine` divider. Also fixed a latent misalignment: added
+  `.bodyCell.stickyCell:first-child { padding: 10px 25px 10px 20px }` (equal-specificity clash where
+  `.bodyCell.stickyCell` beat `.bodyCell:first-child`), placed before `.actionCell` so action columns
+  keep `padding: 0`. Blox side is working-tree-only on `TRUE-80767` — unpublished. (tcox)
+- 2026-08-31 — Verified the June-19 table clipping / overlapping-text report is **fully resolved** in
+  the production-channel release `1.1.1-production.139` that `toga25-supply` consumes: the Aug-17
+  `headerFloors` hard-floor + deterministic header measurement, the Aug-26 CSS-hover "Show more"
+  toggle fix, and the Aug-26 `NEVER_EXPANDABLE_TYPES` status-badge fix are all physically present in
+  the installed `dist`. Timeline for context: resizable columns + `table-layout: fixed` landed
+  2026-06-16 (`de00d067`) with the truncation system only half-built, so June-19 caught a mid-rollout
+  state; the durable fixes landed 2026-07-21 → 2026-08-26. No code change. (tcox)
 - 2026-08-26 — Fixed: the "Show more" toggle got stuck visible on cells the mouse was not hovering.
   `.toggle` already had `opacity: 0` + a CSS hover rule, but `PrimaryTableBodyCell` inline-set
   `opacity: 1` unconditionally (inline beats the cascade), so visibility depended entirely on the

package/knowledge/2.0/apps/toga-blox/features/table.md

@@ -6,8 +6,8 @@ project: TOGa Blox
 client: shared
 type: feature
 status: active
-updated: 2026-08-26
-owners: [apeterson]
+updated: 2026-08-31
+owners: [apeterson, tcox]
 files:
   - toga-blox/src/components/Table/hooks/useFetchTablePageMeta.ts
   - toga-blox/src/api/types.ts
@@ -217,6 +217,11 @@ layer and emits it — see
   requires `npm run build` before it takes effect at runtime.
 
 ## Change history
+- 2026-08-31 — Verified the `NEVER_EXPANDABLE_TYPES` status-badge fix (and the related header/
+  truncation fixes) are present in the **production-channel** release `1.1.1-production.139`, not just
+  the `sandbox-client` build below — the June-19 clipping/overlapping-text report is closed for
+  `toga25-supply`. See
+  [primary-table-templates](primary-table-templates.md). No code change. (tcox)
 - 2026-08-26 — Fixed: status columns rendered as truncated text with a "Show more" toggle instead of
   a badge. Root cause was in `resolveCellType` — the `isExpandableCell` branch **discards** the
   rendered `content` and re-renders the raw `value` in `ExpandableCell`. Added

package/knowledge/2.0/apps/toga-blox/workflows/local-link-into-a-consumer-app.md

@@ -127,6 +127,18 @@ The consumer reads blox's `dist`, so rebuild blox after every change.
 
 ## Gotchas
 
+- **Confirm the link actually exists before you trust it — docs and memory go stale.**
+  Verified 2026-08-31: `toga25-supply/node_modules/@agilant/toga-blox` is a **real registry install**
+  pinned exactly at `1.1.1-production.139`, **not** a junction to `toga-blox-npm` (checked with
+  PowerShell `(Get-Item <path>).LinkType` → empty). Its architecture doc still claimed a symlink. On a
+  registry install, editing blox `src` — even rebuilding blox — reaches the app **only** via publish +
+  pin bump ([dynamic-publish-pipeline](./dynamic-publish-pipeline.md)). Check `LinkType` (or
+  `ls -l` / `fsutil reparsepoint query`) first; the symptom of getting this wrong is "my change does
+  nothing" with a perfectly good build.
+- **The urgent-case escape hatch is patching the INSTALLED `dist`, and it is ephemeral.** Mirroring
+  the source edit into `node_modules/@agilant/toga-blox/dist/**` gives immediate dev visibility, but
+  the next `npm install` / `npm ci` (and every CI build) wipes it. It is a preview, never a
+  deliverable — the change still has to publish and the consumer still has to bump its pin.
 - **`prebuild` does `rm -rf dist`.** A consumer dev server that requests a chunk mid-rebuild
   serves a 500 and then recovers on the next compile. It is not a real failure — rebuild, reload.
 - **`.next/dev` is locked per app.** A second `next dev` refuses to start while another instance
@@ -142,6 +154,10 @@ The consumer reads blox's `dist`, so rebuild blox after every change.
   drags every component's CSS into the consumer bundle.
 
 ## Change history
+- 2026-08-31 — Added the "is it actually linked?" check: `toga25-supply` is on a **real registry
+  install** of `1.1.1-production.139` (`LinkType` empty), not a junction, so blox source edits reach
+  it only through publish + pin bump; and recorded that the urgent-case **installed-`dist` patch** is
+  ephemeral (wiped by the next `npm install`, never present in CI). (tcox)
 - 2026-08-31 — Closed out the duplicate-`react-query` case with the parts that made it hard:
   **both copies were the SAME version (5.101.4)** — identity, not version, is what breaks context;
   `optimizeDeps.include` pre-bundles blox with its nested copy so the throw appears to originate

package/package.json

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