toga-ai 1.0.546 → 1.0.548

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

@@ -13,7 +13,7 @@
 | [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/TrackingNumber.php, _underscore/Model/Client/ItemFulfillments/TrackingNumber.php, _underscore/Component/Library/LabelPdf/LabelPdf.php, _underscore/Component/Library/Carriers/ShipmentRequest/ShipmentRequest.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 |
 | [Running 2.0 code from a bare CLI script (bootstrap + transactions)](features/cli-script-bootstrap.md) | A throwaway CLI script (a data check, a backfill dry-run, a render harness) that wants the real 2.0 framework — `_Model`, `_Query`, `_Database` — is **not** the | _underscore/Database.php, _underscore/Environment.php, api2/Initialize.php |
 | [_Cloud S3 helpers (copy / get / delete / list)](features/cloud-s3-helpers.md) | `_Cloud` centralizes AWS SDK S3 usage for the 2.0 stack so the `S3Client` never leaks into workers or app code. | _underscore/Cloud.php |
-| [_Component_*/_Model_* project-namespace registration (autoloader) & backslash-qualify traps](features/component-model-namespace-registration.md) | Every **project-local** `_Component_*` and `_Model_*` class in a 2.0 app **must declare the project namespace** at the top of the file: ```php namespace <NAMESP | _underscore/Loader.php, worker2/_.php, api2/_.php, worker2/Component/Forecast/Db/Db.php, worker2/Component/Forecast/SaleImport/SaleImport.php, api2/Component/Api/Netsuite/Netsuite.php, _underscore/Component/Api/Paypal/Paypal.php |
+| [_Component_*/_Model_* project-namespace registration (autoloader) & backslash-qualify traps](features/component-model-namespace-registration.md) | Every **project-local** `_Component_*` and `_Model_*` class in a 2.0 app **must declare the project namespace** at the top of the file: ```php namespace <NAMESP | _underscore/Loader.php, worker2/_.php, api2/_.php, worker2/Component/Forecast/Db/Db.php, worker2/Component/Forecast/SaleImport/SaleImport.php, worker2/Component/Api/Oneuptime/Oneuptime.php, api2/Component/Api/Netsuite/Netsuite.php, _underscore/Component/Api/Paypal/Paypal.php |
 | [_Config group access — the two-argument "optional" form does NOT rescue a missing GROUP](features/config-group-access.md) | `_Config::<group>('<property>')` reads a value out of the active `Config/<ENVIRONMENT>.ini`, and **it throws when the requested group is absent from the ini.** | _underscore/Config.php, _underscore/Component/Api/Paypal/Paypal.php |
 | [Re-pointing a DB alias mid-request (_Database::register park/restore)](features/database-alias-repointing.md) | `_Database` keys **all live per-database runtime state by the connection ALIAS** (`Client` / `_underscore::DB_CLIENT`, `ClientLogs`, `Archive`), **not** by the | _underscore/Database.php, _underscore/Query.php, api2/Component/Api/V2/V2.php, api2/Component/Api/CrossClient/CrossClient.php |
 | [2.0 Email Send Pipeline (queue + Send worker)](features/email-send-pipeline.md) | In 2.0, `_Email::send()` **does not transmit** — it queues the message. | _underscore/Email.php, _underscore/String.php, worker2/Worker/Infrastructure/Email/Send.php |

package/knowledge/2.0/apps/_underscore/features/component-model-namespace-registration.md

@@ -6,14 +6,15 @@ project: _Underscore
 client: shared
 type: feature
 status: active
-updated: 2026-08-04
-owners: [dfranks, mhammontree]
+updated: 2026-08-10
+owners: [dfranks, mhammontree, jcardinal]
 files:
   - _underscore/Loader.php
   - worker2/_.php
   - api2/_.php
   - worker2/Component/Forecast/Db/Db.php
   - worker2/Component/Forecast/SaleImport/SaleImport.php
+  - worker2/Component/Api/Oneuptime/Oneuptime.php
   - api2/Component/Api/Netsuite/Netsuite.php
   - _underscore/Component/Api/Paypal/Paypal.php
 related:
@@ -113,8 +114,19 @@ project-local `_Component_*`/`_Model_*` must still declare the project namespace
   runtime-only failure.
 - A global-namespace `_Component_*`/`_Model_*` fails **loudly** (the throw above). An
   unqualified `catch (Exception $e)` fails **silently** — the more insidious of the two.
+- **The namespace rule is APP-repo-only.** `_Component_*` classes that live in the
+  `_underscore` **core** repo (e.g. `_Component_Api_Togaiq`, `_Component_Api_Clickup`) are
+  declared in the **global** namespace and do **not** `extend \_Component`. Do not copy a core
+  `_Component_*` as the template for a new worker2/api2 one — copy a *project-local* precedent
+  (e.g. `worker2/Component/Forecast/Db/Db.php`, `api2/Component/Api/Netsuite/Netsuite.php`).
 
 ## Change history
+- 2026-08-10 — Confirmed again in worker2 building `_Component_Api_Oneuptime`
+  (`Component/Api/Oneuptime/Oneuptime.php`): the component threw the Loader
+  "namespace … has not been defined" fatal until `namespace worker;` + `extends \_Component`
+  + `\`-prefixed framework refs (`\_ApiRequest`, `\_Config`, `\_Query`, `\Exception`, …) were
+  applied. Added the app-repo-only clarification — core-repo `_Component_*` (Togaiq, Clickup)
+  are global-namespace and don't extend `\_Component`, so they're the wrong template. (jcardinal)
 - 2026-08-04 — TRUE-80282: documented the **file-layout** half of `_Component_*` loading, which
   precedes the namespace rule — `_Loader::autoloader()` (`Loader.php:60-67`) pops the trailing
   `_`-segment and appends it as **both a directory and the filename**, so

package/knowledge/2.0/apps/worker2/features/oneuptime-incident-clickup-sync.md

@@ -19,6 +19,7 @@ related:
   - ./error-escalation-cron.md
   - ./creating-worker-actions.md
   - ./team-sprint-management.md
+  - ../../_underscore/features/component-model-namespace-registration.md
 ---
 
 ## Summary

package/knowledge/sessions/2026-08-10-elite-supply-fe-tcox.md

@@ -1,7 +1,7 @@
 ---
 type: session
 slug: elite-supply-fe
-title: Elite Service Requests (Orders) + Inventory FE in toga2-supply — code complete, blocked on backend Page.php context-setting fatal
+title: Elite Service Requests + Inventory FE in toga2-supply — Service Requests VERIFIED end-to-end; remaining: orphan-modal decision, regression pass, PR
 author: tcox
 repos: [toga2-supply]
 framework: "2.0"
@@ -14,69 +14,60 @@ updated: 2026-08-10
 # Session: elite-supply-fe
 **Date:** 2026-08-10
 **Project/Repo:** toga2-supply (2.0)
-**Task:** Elite's full supply2 FE surface — Service Requests page (retitled Orders page on the new `service-requests` backend view) + details modal + the previously built Inventory page — code complete and iteratively debugged against beta; currently blocked by a backend Page.php fatal that the new service-requests context-setting triggers on the inventory page.
+**Task:** Elite's full supply2 FE surface — Service Requests page (retitled Orders page on the backend `service-requests` view) + details modal, plus the previously built Inventory page. Service Requests is now VERIFIED working end-to-end on beta; remaining work is a design decision, the regression pass, and PR mechanics.
 
-> Supersedes session `elite-inventory-fe` (2026-08-06). All Inventory findings there still stand.
+> Supersedes session `elite-inventory-fe` (2026-08-06). KB docs for everything durable were captured 2026-08-10 (`/capture`): see `clients/elite/features/supply2-scope.md`, `2.0/apps/toga2-supply/workflows/client-host-scoping.md`, `2.0/apps/_underscore/features/page-meta-context-field-settings.md`, `clients/elite/features/supply2-tableview-config-drift.md`.
 
 ---
 
 ## What WORKED
-- **"Service Requests" is NOT a new page.** The mockup source (`TOGa Supply mockup Elite/elite/elite-app.jsx`: `VIEW_META.Orders.title = "Service Requests"`, nav `{label:"Orders", text:"Service Requests"}`) defines it as the Elite Orders view retitled; the "details modal" is a details-only order modal (`elite-modal.jsx`, titles itself "Order INC…"). Implemented as config on the existing OrdersPage — no new route.
-- **Sales Orders / Service Requests FE (all tsc-clean, uncommitted on local `_production`):**
-  - `src/pages/Orders/viewModel/FIELDS/ELITE/BASE.json` (new): `pageTitle: "Service Requests"`, `tableSlug: "service-requests"`, `listingSlug: "sales-orders-listing"`, `hasQuoteFilter: false`, `approvalsButton.isEnabled: false`, `exportButton.isEnabled: true`, NO `approvalActionOptions`.
-  - `useOrdersPageViewModel.ts`: explicit `ELITE: {base: BASE_ELITE}` + `if (hostName === "ELITE") return hostFields.base;` (PRUDENTIAL precedent). L63 `|| fieldMapping.compass` fallback untouched.
-  - `OrdersPage.tsx`: all 8 hardcoded `sales-orders` references now `fields?.tableSlug || "sales-orders"` (listing meta, tableDisplayData, setSlug, ResetFilters, both providers); ACL check optional-chained + slug-keyed with a TS cast; `pageTitle` initialized from `fields?.pageTitle || "Orders"`; `isQuote: false` in additionalData is now conditional — omitted when `fields?.hasQuoteFilter === false` (backend confirmed FE-side fix: ServiceRequests has no isQuote column).
-  - `SlideMenu.tsx` ELITE branch: "Service Requests" (link `/`) + Inventory deep-link.
-  - `renderModalContent.tsx` untouched — DEFAULT routes ELITE row-clicks to OrderDetailsModal only (verified: no ELITE key, no ApprovalsModal).
-- **Review fixes (CodeRabbit) on Inventory work:** `InventoryPage.tsx` re-seeds `selectedGrouping` when the stored uuid isn't in the resolved host's array (corrupt JSON handled); `InventoryRouter.tsx` redirects `/inventory_items` → `/inventory` for hosts whose default view lacks `subTableParent` (data-driven, no host literal). Both no-ops for NYCHH/Compass/Quad.
-- **`convertConstructorColumnTitles.ts`** null-guarded — a page slug without backend meta degrades to "" labels instead of crashing the table (was the white-screen when `service-requests-listing` didn't exist).
-- **Post-merge diagnostics (2026-08-07 prod→beta refresh rebuilt Client_Elite at 11:55 + beta API redeploy) — root causes found via DB reads:**
-  1. Login failure → re-seeded devteam user had an EMPTY password → fixed by hash copy from `Client_Compass.Users` id 127046 (login verified working after).
-  2. `service-requests` table view wiped by merge → backend recreated it (ServiceRequests-record view joined to Tickets/Customers/ServiceRequestTypes/SalesOrders with Elite-tailored status CASE).
-  3. Service Requests table 500 → OUR `isQuote: false` filter against ServiceRequests → fixed FE-side (above), backend confirmed.
-  4. Inventory `/pages/meta?slug=inventory` 500 "Undefined array key 190" → fully diagnosed (see Blockers).
+- **Service Requests verified end-to-end on beta (2026-08-10):** table loads on the `service-requests` view → row click opens the details modal → ServiceRequest→SalesOrder uuid resolution → order details/items/invoices/shipments render. Verified on the one SR with a linked SalesOrder (ticket INC-13982, SR uuid cfc6ea32-dcfa-46c0-bf1b-f40733117a0e).
+- **Modal-not-opening fix:** `renderModalContent.tsx` registry is keyed by **pageTitle** — retitling the page to "Service Requests" silently unhooked the modal (`clientConfig[pageTitle]` → undefined → null). Fixed with an additive `"Service Requests": [{component: OrderDetailsModal}]` key in DEFAULT.
+- **uuid mismatch fix:** rows carry ServiceRequests uuids; detail routes are /sales-orders record routes → `GET /sales-orders/{srUuid}` 404'd. Added `getSalesOrderUuidForServiceRequest()` (OrdersApi.ts: GET /sales-orders + ServiceRequests join + where ServiceRequests.uuid) and threaded `detailsUuid` through `useOrderDetailsViewModel.ts` via a react-query gated `enabled: hostName === "ELITE"` — other hosts bypass entirely.
+- All Service Requests config/slug-threading work from earlier (ELITE BASE.json with pageTitle/tableSlug/listingSlug/hasQuoteFilter/approvals-off; OrdersPage 8-literal slug threading; conditional isQuote; SlideMenu entry) — see superseded session + KB scope doc for detail. tsc clean throughout.
+- Post-merge fixes that held: devteam password restored (hash copy from Client_Compass id 127046); `convertConstructorColumnTitles` null guard; `listingSlug` = `sales-orders-listing` (no service-requests-listing page exists in Core.Pages).
 
 ## What did NOT work — DO NOT RETRY THESE
-- **`listingSlug: "service-requests-listing"`** — no such page exists: `Core.Pages` has only `sales-orders-listing` (id 2) etc. The null pageMeta then crashed `convertConstructorColumnTitles` (`Cannot read properties of null (reading 'settings')`). Reverted to `sales-orders-listing`; if backend ever creates a service-requests page, it's a one-line JSON change.
-- **Assuming the service-requests view is a renamed SalesOrders view** — it's a ServiceRequests-record view (`SalesOrders.serviceRequestId = ServiceRequests.id` 1:1). Consequence: table rows carry ServiceRequests uuids; the details modal fetches by uuid via sales-orders record routes → probable uuid mismatch on row click (untested — see Not tried).
-- **Theory: empty `ClientPageSettings` caused the inventory meta 500** — WRONG: NYCHH's is empty too; that table (and `Pages_DefaultTableViewGroups`/`TableViewGroups`) is unused everywhere. The real cause is the context-setting fatal (Blockers).
-- **Sending `isQuote` unconditionally in OrdersPage additionalData** — 1054 "Unknown column 'ServiceRequests.isQuote'". It's a SalesOrders-only column.
-- (Carried from previous session) `/login` redirect ≠ Domains row exists; devteam lives only in dev-sandbox `Client_Compass` (127046); MCP env `client-beta` exposes no schemas — beta API client DBs are on the **dev-sandbox** cluster.
+- **Retitling a page without adding a matching `renderModalContent` DEFAULT key** — modal silently never opens; registry lookup is `clientConfig[pageTitle]`.
+- **`listingSlug: "service-requests-listing"`** — no such page in `Core.Pages`; null pageMeta crashed the table until the null guard + revert to `sales-orders-listing`.
+- **Fetching order details directly with the row uuid on ELITE** — 404 EV-6; row uuid is the ServiceRequests uuid, not SalesOrders.
+- **Assuming an empty modal means a broken fetch** — 5 of 6 Elite dev-sandbox ServiceRequests have NO linked SalesOrder (only SR id 2 / INC-13982 does); the resolver correctly yields null and the modal is empty by design. Verify against INC-13982 before debugging.
+- **Sending `isQuote` unconditionally** — ServiceRequests has no isQuote column (1054). Config-gated via `hasQuoteFilter: false`.
+- (Carried) `/login` redirect ≠ Domains row; devteam lives in dev-sandbox Client_Compass (127046); MCP env `client-beta` empty — query `dev-sandbox`; beta hand-inserted rows are eaten by prod→beta refreshes.
 
 ## Not tried yet (candidates for next session)
-- **Row-click details modal on Service Requests** — expect uuid mismatch (ServiceRequests uuid vs sales-orders fetch routes). Fix is either backend (expose linked `SalesOrders.uuid` as the drill identifier) or FE (ELITE detail `apiFields` pointing at service-requests routes in `useOrderDetailsViewModel` — structure already supports per-host apiFields).
-- Inventory nested-expand re-validation (blocked again post-merge: prod's stale TableViewJoins were re-imported; the 3-statement fix from the drift doc applies but join ROW IDS may have shifted — match by tableViewId + joinRecordId + joinOnRecordFieldId, not row id).
-- Four-client regression pass (NYCHH/ENDEAVORHEALTH/COMPASS/COMPASSCANADA, same browser) before PR.
-- Branch + PR (tcox branches personally; bare ticket-ID name; ask first).
-- gitignore check: `TOGa Supply mockup Elite/` folder sits untracked in the repo root — must not ride into the PR.
+- **Orphan-SR modal state (design decision, then ~minutes of FE):** options are (1) "No sales order linked" empty-state message wired to the resolver's null, (2) SR-level detail view (needs backend routes + design), (3) non-clickable orderless rows. Waiting on backend/product: is an order-less SR a legitimate lifecycle state?
+- Inventory nested-expand re-validation — still blocked on backend TableViewJoins drift fix (dbchanges2 migration; match rows by tableViewId+joinRecordId+joinOnRecordFieldId, ids shifted in the 08-07 re-import) and the Page.php:824 isset() guard for the inventory /pages/meta 500 (KB: page-meta-context-field-settings.md).
+- Four-client regression pass: NYCHH, ENDEAVORHEALTH, COMPASS, COMPASSCANADA inventory + orders in ONE browser session — release blocker per the host-scoping playbook.
+- gitignore `TOGa Supply mockup Elite/` (untracked in repo root) before branching.
+- Branch + PR: tcox branches personally (bare ticket-ID name, ask tcox first). Work sits uncommitted on local `_production`; beta already runs a deployed copy of it.
 
 ## Current file state
 | File | Status | Notes |
 |------|--------|-------|
-| src/pages/Orders/viewModel/FIELDS/ELITE/BASE.json | new, uncommitted | full ELITE page config (see What WORKED) |
-| src/pages/Orders/viewModel/index.ts | modified, uncommitted | BASE_ELITE export |
-| src/pages/Orders/viewModel/useOrdersPageViewModel.ts | modified, uncommitted | ELITE fieldMapping entry + base branch |
-| src/pages/Orders/OrdersPage.tsx | modified, uncommitted | slug threading, pageTitle from fields, conditional isQuote, null-safe ACL |
+| src/pages/Orders/viewModel/FIELDS/ELITE/BASE.json | new, uncommitted | pageTitle/tableSlug/listingSlug(sales-orders-listing)/hasQuoteFilter:false/approvals off/export on |
+| src/pages/Orders/viewModel/index.ts + useOrdersPageViewModel.ts | modified, uncommitted | BASE_ELITE export + ELITE base entry/branch |
+| src/pages/Orders/OrdersPage.tsx | modified, uncommitted | slug threading, fields-driven pageTitle, conditional isQuote, null-safe ACL |
+| src/pages/Orders/api/OrdersApi.ts | modified, uncommitted | getSalesOrderUuidForServiceRequest() resolver |
+| src/pages/Orders/view/OrderView/viewModel/useOrderDetailsViewModel.ts | modified, uncommitted | ELITE-gated uuid resolution; all detail fetches keyed on detailsUuid |
+| src/components/ui/Tables/PrimaryTable/helperFunctions/renderModalContent.tsx | modified, uncommitted | DEFAULT "Service Requests" → OrderDetailsModal |
 | src/components/layout/SlideMenu/SlideMenu.tsx | modified, uncommitted | ELITE: Service Requests + Inventory |
-| src/utils/convertConstructorColumnTitles.ts | modified, uncommitted | null-guarded pageMeta/settings |
-| src/pages/Inventory/** (7 files, from elite-inventory-fe session) | modified/new, uncommitted | host-scoped group options etc. + CodeRabbit fixes (selectedGrouping re-seed, InventoryRouter guard) |
-| src/utils/resolveClientHostName.ts | new, uncommitted | store-first + subdomain fallback |
-| package.json | modified, uncommitted | `npm run elite` script |
-| dev-sandbox Client_Elite.Users | hand-fixed, KEPT | devteam password restored via Compass hash copy |
+| src/utils/convertConstructorColumnTitles.ts | modified, uncommitted | null-safe pageMeta/settings |
+| src/pages/Inventory/** + src/utils/resolveClientHostName.ts (from inventory session) | modified/new, uncommitted | host-scoped statics + CodeRabbit fixes (selectedGrouping re-seed, InventoryRouter subtable guard) |
+| package.json | modified, uncommitted | `npm run elite` |
+| dev-sandbox Client_Elite.Users | hand-fixed, KEPT | devteam password restored 08-10; note: any future prod→beta refresh re-empties it |
 
 ## Decisions made
-- Service Requests = config on OrdersPage (pageTitle/tableSlug/listingSlug/hasQuoteFilter in FIELDS), NOT a new route — mockup defines it as the Orders view retitled; supply2.0 components render it (2.5 mockup = spec for WHAT, 2.0 = HOW).
-- Slug threading via FIELDS with `|| "sales-orders"` fallbacks — other hosts have no tableSlug key, provably unchanged. Rejected: fixing the broken lowercase-`compass` fallback (cross-client risk).
-- Reuse `sales-orders-listing` page meta for Elite until a service-requests page exists (headers come from the table-view meta, so only ACL/search-labels are affected).
-- Keep devteam seeding + document every hand-fix — the 08-07 merge proved hand-inserted beta rows get eaten; everything must eventually be dbchanges2 migrations.
+- Modal registry fix as an additive DEFAULT pageTitle key (idiomatic to the registry) — rejected refactoring the lookup to a title-independent pageType (shared-code churn).
+- uuid resolution FE-side, host-gated in the detail view model — self-contained, no backend work, other hosts provably bypass (enabled flag + detailsUuid === activeUuid). Rejected: backend exposing SalesOrders.uuid as the drill identifier (still needed an FE change and backend coordination).
+- Orphan-SR modal handling deliberately deferred — mockup doesn't cover the state; it's a product/backend decision first.
 
 ## Blockers
-- **Backend: `/pages/meta?slug=inventory` fatal "Undefined array key 190"** — `Client_Elite.ClientRecordFieldSettings` row id 1 (field 58 → label "Total" in context of field 190 = ServiceRequests.id, created for the new service-requests view) is fetched for ANY page whose field set includes field 58; `_underscore/Model/Core/Page.php:824` resolves `contextRecordFieldId` against a lookup built only from the current page's fields → key 190 missing on inventory → warning made fatal by the newly deployed strict error handler. Fix: isset()-guard Page.php ~L822-829 (skip context settings whose context field isn't on the page). Deleting the row would un-break inventory but lose the service-requests "Total" label. Reported to backend 2026-08-07.
-- Inventory nested-expand still blocked by the re-imported TableViewJoins drift (see drift doc `clients/elite/features/supply2-tableview-config-drift.md`).
-- Details-modal uuid mismatch (suspected, untested) — see Not tried.
+- Backend (all reported + documented in KB): Page.php:824 isset() guard; TableViewJoins drift migration; answer on order-less ServiceRequests lifecycle.
+- None on the Service Requests happy path — verified working.
 
 ## Exact next step
-> Confirm with backend that the Page.php:824 isset() guard (or equivalent) is deployed, then `npm run elite`, log in as devteam, and verify BOTH pages render: Inventory (columns + chevron) and Service Requests (table loads without isQuote error). Then click a Service Request row and capture the modal's network call — the expected failure is the ServiceRequests-uuid-vs-sales-orders-route mismatch.
+> Get the orphan-SR answer from backend/product; implement the chosen modal state (option 1 is a few lines wired to the resolver's null). Then run the four-client regression pass (NYCHH/ENDEAVORHEALTH/COMPASS/COMPASSCANADA, one browser session), gitignore `TOGa Supply mockup Elite/`, and branch for PR (ask tcox for the ticket-ID branch name).
 
 ---
 _Saved by /session-save on 2026-08-10_

package/package.json

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