toga-ai 1.0.114 → 1.0.115

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

@@ -4,3 +4,4 @@
 |-----|---------|-------|
 | [TOGa Supply (toga2-supply) Architecture](architecture.md) | `toga2-supply` is the **React + Vite frontend** for TOGa Supply — warehouse fulfillment tooling (shipment selection, fulfill & ship against carrier APIs, NetSui | toga2-supply/src/api/toga.ts, toga2-supply/src/pages/ShipmentItems/view/ShipmentItemsPage.tsx, toga2-supply/src/pages/EditShipment/view/EditShipmentPage.tsx, toga2-supply/src/pages/EditShipment/api/UpdateShipmentApi.ts, toga2-supply/src/pages/Shipments/view/components/ShipmentsCardTableForm/ShipmentsCardTableForm.tsx |
 | [Fulfill & Ship](features/fulfill-and-ship.md) | Fulfill & Ship lets a warehouse user select sales-order line items, enter serials, pick a carrier/method, and in one action: create the Item Fulfillment records | toga2-supply/src/pages/ShipmentItems/view/ShipmentItemsPage.tsx, toga2-supply/src/pages/EditShipment/view/EditShipmentPage.tsx, toga2-supply/src/pages/EditShipment/view/components/forms/EditShipmentForm.tsx, toga2-supply/src/pages/EditShipment/api/UpdateShipmentApi.ts, toga2-supply/src/pages/Shipments/view/components/ShipmentsCardTableForm/ShipmentsCardTableForm.tsx, toga2-supply/src/pages/Shipments/api/ShipmentsApi.ts, _underscore/Model/Client/ItemFulfillment.php, _underscore/Trait/Netsuite/ItemFulfillment.php, _underscore/Component/Library/Carriers/Ups/Ups.php |
+| [AWS Amplify Build & Deploy (non-prod environments)](workflows/amplify-build-and-deploy.md) | How `toga2-supply` (React + Vite) builds and deploys to **AWS Amplify** for non-prod environments (qc-security, qc-performance, alpha, beta, gamma, …). | toga2-supply/amplify.yml, toga2-supply/package.json, toga2-supply/.env.qc-security |

package/knowledge/2.0/apps/toga2-supply/workflows/amplify-build-and-deploy.md

@@ -0,0 +1,77 @@
+---
+title: AWS Amplify Build & Deploy (non-prod environments)
+framework: "2.0"
+repo: toga2-supply
+project: TOGa Supply
+client: shared
+type: workflow
+status: active
+updated: 2026-06-17
+owners: ["jcardinal"]
+files:
+  - toga2-supply/amplify.yml
+  - toga2-supply/package.json
+  - toga2-supply/.env.qc-security
+related:
+  - ../architecture.md
+---
+
+## Summary
+
+How `toga2-supply` (React + Vite) builds and deploys to **AWS Amplify** for non-prod
+environments (qc-security, qc-performance, alpha, beta, gamma, …). Note that the
+**alpha/beta/gamma/production** environments historically deploy via **GitHub Actions**
+(`.github/workflows/*.yml`) into the `agilantsolutions/toga2-supply-build` repo — Amplify
+is the newer path used when standing up additional non-prod environments. The first Amplify
+build of this app failed with a JavaScript heap OOM; this doc records the fix and the
+scalable per-environment build setup.
+
+## Steps
+
+1. **`amplify.yml` at the repo root drives the build.** When present, it **overrides the
+   Amplify console build settings entirely, for every branch of the app** — you cannot split
+   "memory in the file, build command in the console." Whichever owns the build phase owns all
+   of it. Our `amplify.yml`:
+   - Sets `NODE_OPTIONS=--max-old-space-size=4096` in both `preBuild` and `build` (the OOM fix).
+   - Runs `npx tsc && npx vite build --mode "$VITE_BUILD_MODE"` — the build mode is **not**
+     hardcoded.
+   - Publishes `dist/` as the artifact baseDirectory.
+2. **Per environment, set one Amplify env var on that branch:** `VITE_BUILD_MODE` =
+   `qc-security` | `qc-performance` | `alpha` | `beta` | `gamma`. No new npm script per env.
+3. **Each mode needs a matching `.env.<mode>` file** committed in the repo (Vite loads
+   `.env.<mode>` for `--mode <mode>`). e.g. `.env.qc-security` provides `VITE_API`. A new
+   environment requires creating its `.env.<mode>` file.
+4. Commit `amplify.yml` + the env file, push the branch; Amplify rebuilds.
+
+## Systems involved
+
+- AWS Amplify (build + hosting), per-branch environment variables.
+- Vite 4 build (`vite build --mode <mode>`), TypeScript `tsc` precompile.
+- Sentry source-map upload via `@sentry/vite-plugin` (source maps are **on** —
+  `build.sourcemap: true` in `vite.config.ts`).
+
+## Edge cases & escalation
+
+- **OOM root cause:** Amplify gives Node the default ~2 GB old-space heap. This app
+  (1793 modules + source maps on) exceeds it during Rollup's `rendering chunks` phase →
+  `FATAL ERROR: Ineffective mark-compacts near heap limit`. Fix = raise `NODE_OPTIONS`.
+- **Heap vs. instance RAM:** `--max-old-space-size=4096` only helps if the build container
+  has ≥4 GB. Amplify **Standard** compute is 4 GB (tight with source maps on). If it OOMs
+  again, switch to the **Large build instance** (Amplify → App settings → Build settings)
+  and raise to `6144`/`7168`. Setting the heap above physical RAM makes it worse, not better.
+- **Mode/filename mismatch:** `--mode qc-security` loads `.env.qc-security` exactly — a file
+  named `.env.qc-security.beta` is silently ignored (build succeeds but ships with no
+  `VITE_API`). Name the env file to match the mode.
+- **Secret hygiene:** `.env.<mode>` files have historically carried a live
+  `SENTRY_AUTH_TOKEN`. Prefer rotating it and moving it to an Amplify env var rather than
+  committing it.
+
+## Change history
+
+- 2026-06-17 — Created on first Amplify setup of a new QC environment: added root `amplify.yml`
+  with raised Node heap + parameterized `VITE_BUILD_MODE`; renamed `.env.qc-security.beta` →
+  `.env.qc-security` (jcardinal)
+
+## Related docs
+
+- [TOGa Supply architecture](../architecture.md)

package/knowledge/INDEX.md

@@ -18,7 +18,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **worker2** (Worker) — 8 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
 - **api2** (API) — 3 doc(s) → [2.0/apps/api2/INDEX.md](2.0/apps/api2/INDEX.md)
 - **dbchanges2** (Database Changes) _(framework core)_ — 1 doc(s) → [2.0/apps/dbchanges2/INDEX.md](2.0/apps/dbchanges2/INDEX.md)
-- **toga2-supply** (TOGa Supply) — 2 doc(s) → [2.0/apps/toga2-supply/INDEX.md](2.0/apps/toga2-supply/INDEX.md)
+- **toga2-supply** (TOGa Supply) — 3 doc(s) → [2.0/apps/toga2-supply/INDEX.md](2.0/apps/toga2-supply/INDEX.md)
 - **saml** (SAML SSO Gateway) — 2 doc(s) → [2.0/apps/saml/INDEX.md](2.0/apps/saml/INDEX.md)
 - **toga2-view** (TOGa View Frontend) — 0 doc(s) → [2.0/apps/toga2-view/INDEX.md](2.0/apps/toga2-view/INDEX.md)
 - **toga2-hub** (TOGa Hub) — 2 doc(s) → [2.0/apps/toga2-hub/INDEX.md](2.0/apps/toga2-hub/INDEX.md)

package/package.json

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