toga-ai 1.0.955 → 1.0.956

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

@@ -9,6 +9,7 @@
 | [Client-Configurable Fields (useClientFields / fieldsConfig)](features/client-configurable-fields.md) | Config that varies by client (or client × role) — field overrides, filter buttons, group-by, column pickers, layout toggles — resolved through `src/fieldsConfig |
 | [Column State (URL-driven show/hide, order & pinning)](features/column-visibility.md) | URL-driven "Columns" button + modal (`cols` param) for show/hide + order + pinning of table columns, client-configurable then Surface-driven; open for column-vi |
 | [Force Logout on Deployment (useDeploymentGuard)](features/force-logout-on-deployment.md) | Force-signs-out every user when a deploy bumps a Core parameter, so session + caches reset to the new build; open when debugging surprise logouts or `useDeploym |
+| [Loading & save-error states (table skeletons, shimmers, Refresh busy pill, save-error toaster)](features/loading-and-error-states.md) | Owning doc for how supply shows loading (table skeleton, sub-section shimmer, Refresh busy pill, sales-order modal skeletons) and failed saves (error toaster, n |
 | [Meta-Driven Page & Table Setup](features/meta-driven-table-data.md) | A page is meta-driven end to end — page meta + table meta + table data, each keyed by slug via toga-blox hooks; pagination-vs-infinite is decided solely by meta |
 | [Persisted React Query cache (localStorage `supply-chain-query-cache`)](features/persisted-query-cache.md) | `localStorage["supply-chain-query-cache"]` is the whole React Query cache dehydrated to disk (survives reloads AND sessions); the owning doc for staleTime rules |
 | [Record Modals & Nested Tables](features/record-modals-and-nested-tables.md) | The repo's modal + nested-table patterns over toga-blox `TableRecordModal` / `PrimaryTable*Layout` — six load-bearing UI patterns (row-click record modal, neste |

package/knowledge/2.0/apps/toga25-supply/features/loading-and-error-states.md

@@ -0,0 +1,64 @@
+---
+title: Loading & save-error states (table skeletons, shimmers, Refresh busy pill, save-error toaster)
+framework: "2.0"
+repo: toga25-supply
+project: TOGa 2.5 Supply
+client: shared
+type: feature
+status: active
+updated: 2026-10-06
+owners: ["tcox"]
+files:
+  - toga25-supply/src/components/TableSkeleton/TableSkeleton.tsx
+  - toga25-supply/src/components/TableSkeleton/useTableGeometryMemory.ts
+  - toga25-supply/src/components/SubSectionShimmer/SubSectionShimmer.tsx
+  - toga25-supply/src/components/Shimmer/Shimmer.tsx
+  - toga25-supply/src/hooks/useIsTableRefreshing.ts
+  - toga25-supply/src/layout/PrimaryTableServerLayout/PrimaryTableServerLayout.tsx
+  - toga25-supply/src/layout/PrimaryTableClientLayout/PrimaryTableClientLayout.tsx
+  - toga25-supply/src/pages/SalesOrders/view/SalesOrderRecordModalLayout/helpers/recordShapeMemory.ts
+  - toga25-supply/src/utils/saveErrorToaster.ts
+related:
+  - ./record-modals-and-nested-tables.md
+  - ./transfer-orders-page.md
+  - ./persisted-query-cache.md
+  - ../workflows/cypress-testing.md
+---
+
+Owning doc for how supply shows loading (table skeleton, sub-section shimmer, Refresh busy pill, sales-order modal skeletons) and failed saves (error toaster, never a modal banner); open before touching any loading/error UI or reviving the old TRUE-79502/79505 branches.
+
+## Summary
+
+- **Cold table load** → `TableSkeleton` (real header chrome + remembered column widths, no column shift).
+- **Background refetch** (save, focus, Refresh on warm data) → rows stay; Refresh button shows a busy pill via `useIsTableRefreshing`.
+- **Record modal** (Sales Orders, Transfer Orders) → cold / warm / sub-section skeletons, shaped by remembered record shape.
+- **Failed save/create/edit** → error toaster with `SAVE_ERROR_TOASTER_MESSAGE`. The red `ModalBanner` "error" variant is **retired** (decided 2026-08-25).
+
+## How it works
+
+### Table skeleton gate (`PrimaryTableServerLayout` / `PrimaryTableClientLayout`)
+- Render order: full-body error (`TableStateBlock`) → skeleton → empty/no-results → table.
+- `showSkeleton = isLoadingTableDataLoading || !displayRecords`. Never gate on `isFetching` — `useTableData` keeps prior rows via `placeholderData`, and gating on `isFetching` flashes the skeleton on every modal save / focus refetch. Page Refresh resets the table queries, so it still re-enters the skeleton.
+- `useTableGeometryMemory(slug, …)` stores header fields + pixel widths in `localStorage["toga-table-chrome:<slug>"]` so the skeleton draws the real header before the meta fetch returns. Live fields are label-less until page meta merges labels — skeleton holds the remembered fields until then.
+
+### Refresh busy pill — `useIsTableRefreshing()`
+True while a `["table-data"]` query **that already has data** refetches. Excludes cold loads (skeleton covers them) and infinite-scroll `fetchMore` (scrolling is not a refresh).
+
+### Sales-order modal skeletons — `recordShapeMemory.ts`
+Per-record shape (`itemCount`, `hasInvoices`, `hasShipments`) in `sessionStorage["toga-so-shape:<uuid>"]`, merge-saved as each query settles. The skeleton only draws frames for sections that will exist — no section pops in then vanishes. `SubSectionShimmer` / `Shimmer` give the shared texture.
+
+### Save-error toaster — `src/utils/saveErrorToaster.ts`
+Item, vendor-item, bundle and bundle-item create/edit hooks call `useToaster().addToaster({ status: "error", ...SAVE_ERROR_TOASTER_MESSAGE })`. Raw error goes to the console, never to the user. New save hooks must use the same constant.
+
+### Visual review — temporary dev gallery
+To eyeball every state at once: restore the old gallery with `git show TRUE-79502:src/pages/DevLoadingStates/DevLoadingStatesPage.tsx`, register it in `src/routes.tsx` **inside `AllowedRoutes`** behind `import.meta.env.DEV` at `/dev/loading-states` (needs login). Newer blox `TablePagination` needs `recordsPerPage` inside `paginationMeta` — the old page must be patched. **Delete it before merge**; it is not shipped.
+
+## Gotchas
+- **⚠ blox `useFetchTablePageMeta` has no `isError`.** A failed meta fetch leaves the table on its skeleton forever. Open follow-up.
+- **⚠ `isPageFetch` path in `PrimaryTableServerLayout` is dead code** (never true in practice). Open follow-up — do not build on it.
+- **⚠ Do not merge `_production` into the stale TRUE-79502 / TRUE-79505 branches** — it drops newer prod features. Cut a fresh branch from `_production` and port pieces by hand (done as TRUE-82385).
+- Old-branch pieces deliberately **not** ported: `ModalBanner` error variant + `DevErrorStates` page (TRUE-79505), `BulkProgressToast` (no consumers), `DevLoadingStatesPage` (demo), `SalesOrderItemsTableLayout` (deleted in `_production` 97d20ff). TRUE-79502-update's `useClientFields` / Prudential CSV-BOM edits are unrelated to loading. TRUE-79505-updated, TRUE-79505-prod and TRUE-79501 are already fully in `_production`. TRUE-79506 never existed.
+- A disabled React Query v5 query reports `pending` forever — see [transfer-orders-page](./transfer-orders-page.md) before deriving a skeleton flag from one.
+
+## Change history
+- 2026-10-06 — Ported loading states (TRUE-79502-update) + save-error toaster onto fresh `_production` as TRUE-82385; Transfer Orders wired; Cypress expectations updated. (tcox)

package/knowledge/INDEX.md

@@ -33,7 +33,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **voice-to-voice** (TOGa Voice) — 4 doc(s) → [2.0/apps/voice-to-voice/INDEX.md](2.0/apps/voice-to-voice/INDEX.md)
 - **ai-bdr** (AI-BDR) — 13 doc(s) → [2.0/apps/ai-bdr/INDEX.md](2.0/apps/ai-bdr/INDEX.md)
 - **toga2-commerce** (TOGa Commerce) — 29 doc(s) → [2.0/apps/toga2-commerce/INDEX.md](2.0/apps/toga2-commerce/INDEX.md)
-- **toga25-supply** (TOGa 2.5 Supply) — 22 doc(s) → [2.0/apps/toga25-supply/INDEX.md](2.0/apps/toga25-supply/INDEX.md)
+- **toga25-supply** (TOGa 2.5 Supply) — 23 doc(s) → [2.0/apps/toga25-supply/INDEX.md](2.0/apps/toga25-supply/INDEX.md)
 - **toga25-iq** (TOGa IQ) — 1 doc(s) → [2.0/apps/toga25-iq/INDEX.md](2.0/apps/toga25-iq/INDEX.md)
 - **toga25-desk** (TOGa Desk 2.5) — 1 doc(s) → [2.0/apps/toga25-desk/INDEX.md](2.0/apps/toga25-desk/INDEX.md)
 - **toga25-blox** (TOGa Blox 2.5) — 1 doc(s) → [2.0/apps/toga25-blox/INDEX.md](2.0/apps/toga25-blox/INDEX.md)
@@ -42,7 +42,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 
 ## standalone framework
 
-- **togatech** (TOGA Technology Website) — 7 doc(s) → [standalone/apps/togatech/INDEX.md](standalone/apps/togatech/INDEX.md)
+- **togatech** (TOGA Technology Website) — 8 doc(s) → [standalone/apps/togatech/INDEX.md](standalone/apps/togatech/INDEX.md)
 - **websocket** (WebSocket Server) — 2 doc(s) → [standalone/apps/websocket/INDEX.md](standalone/apps/websocket/INDEX.md)
 - **forward** (Forwarder) — 3 doc(s) → [standalone/apps/forward/INDEX.md](standalone/apps/forward/INDEX.md)
 - **claude** (Claude Harness) — 8 doc(s) → [standalone/apps/claude/INDEX.md](standalone/apps/claude/INDEX.md)

package/knowledge/standalone/apps/togatech/INDEX.md

@@ -4,7 +4,8 @@
 |-----|---------|
 | [TOGA Technology Website Architecture](architecture.md) | Public TOGA Technology marketing site — standalone React/TS SPA (no PHP framework); open for stack, bootstrap, routing, page layout, integrations, build/deploy. |
 | [Careers Section — Live Paylocity Job Openings (About page + /v2/campaigns/jobs proxy)](features/careers-paylocity-job-openings.md) | togatech About page "Join Our Team" section — live Paylocity jobs via unauthenticated `GET /v2/campaigns/jobs` record-script proxy; open for the fetch→proxy→map |
+| [NavV2 Global Nav — menus, scroll reveal, Talos FAB](features/navv2-global-nav.md) | togatech NavV2 header (designer "phase one"): data-driven menus, `data-nav-reveal` scroll hide/show, opt-in `data-nav-pinned` for sticky scenes, Talos FAB rules |
 | [SEO / AEO / GEO — Prerendering, Single-Source Meta & Structured Data](features/seo-aeo-geo-prerender.md) | togatech SEO/AEO/GEO — build-time Puppeteer prerender + single-source per-page meta + JSON-LD; open for the robots-gating de-index bug and Amplify build require |
-| [Talos Product Page (/talos) — ported designer prototype](features/talos-product-page.md) | togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS prototype; open for the design-port CSS approach, lazy-load + prerender rules, page |
+| [Talos Product Page (/talos) — ported designer prototype](features/talos-product-page.md) | togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS prototype; open for the design-port CSS approach, re-porting a new design drop, laz |
 | [Creating Pull Requests on togatech](workflows/creating-pull-requests.md) | Open a PR on `agilantsolutions/togatech` — `gh` CLI lacks `read:org`, so use a raw GitHub REST call with the keychain token; base is `_production`. |
 | [Running togatech Locally & Verifying a Page Without Cypress](workflows/local-dev-and-headless-verification.md) | Get togatech running on a dev machine and verify a data-driven section without Cypress — `npm install` first, `lint` is dead, Cypress 15 fails on Windows. |

package/knowledge/standalone/apps/togatech/features/navv2-global-nav.md

@@ -0,0 +1,68 @@
+---
+title: NavV2 Global Nav — menus, scroll reveal, Talos FAB
+framework: "standalone"
+repo: togatech
+project: TOGA Technology Website
+client: shared
+type: feature
+status: active
+updated: 2026-10-05
+owners: ["tcox"]
+files:
+  - togatech/src/components/NavV2/view/NavV2.tsx
+  - togatech/src/components/NavV2/view/TalosFab.tsx
+  - togatech/src/components/NavV2/view/NavDestLink.tsx
+  - togatech/src/components/NavV2/view/panels/WhatPanel.tsx
+  - togatech/src/components/NavV2/view/panels/CompanyPanel.tsx
+  - togatech/src/components/NavV2/view/panels/PanelFooter.tsx
+  - togatech/src/components/NavV2/navV2.module.css
+  - togatech/src/components/NavV2/types.ts
+  - togatech/src/components/NavV2/navRoutes.ts
+  - togatech/src/components/NavV2/viewModel/useNavV2.ts
+  - togatech/src/components/NavV2/viewModel/useNavReveal.ts
+  - togatech/src/components/NavV2/viewModel/useCompactViewport.ts
+  - togatech/src/components/NavV2/viewModel/useRovingTabs.ts
+  - togatech/src/components/NavV2/viewModel/useDockedState.ts
+  - togatech/src/components/NavV2/viewModel/FIELDS/NAVFIELDS.json
+  - togatech/src/components/MobileNav/MobileNav.tsx
+  - togatech/src/styles/index.css
+related:
+  - ../architecture.md
+  - talos-product-page.md
+---
+
+togatech NavV2 header (designer "phase one"): data-driven menus, `data-nav-reveal` scroll hide/show, opt-in `data-nav-pinned` for sticky scenes, Talos FAB rules, design-anchor rule. Open before touching the nav or adding a full-screen sticky section.
+
+## Summary
+
+Global header in `src/components/NavV2/` (MVVM: `view/`, `viewModel/`, menu data in `viewModel/FIELDS/NAVFIELDS.json`). Mobile is `components/MobileNav/MobileNav.tsx`. Destinations come from `navRoutes.ts` (`LIVE_ROUTES` / `STUB_ROUTES`) — see [architecture.md](../architecture.md) Routing.
+
+## How it works
+
+**Menus (data-driven):**
+- Two menus shown: What we do, Company. Industries / Resources are hidden in `NAVFIELDS.json`; their panel code is kept for a later phase — re-enable via data, do not rebuild.
+- Flat links are `flatLinks[]` (was single `flatLink`): The TOGA Blog → `/blog` stub, Contact.
+- What we do has 2 tabs (Business Units, Platforms). Tab hover switches the tab but never moves keyboard focus (`useRovingTabs`).
+- Company panel and What-we-do share `panels/PanelFooter.tsx`.
+
+**Scroll reveal (`useNavReveal.ts`):** sets `data-nav-reveal = top | hidden | shown` on the **nav root**, not `<html>`.
+- `top` within 80px of page top. Hides after 8px scroll down; shows after 8px scroll up.
+- Never hides while a menu is open, the pointer is over the bar, or keyboard focus is inside (`focusin` forces `shown`; a mouse click does not pin it).
+- Initial render is always `top` (prerender gives the same output every time); the real state is computed on mount.
+- Glass look (blur / grain / edge) only in `shown`.
+- `useCompactViewport.ts`: compact padding when viewport height ≤ 1000px.
+
+**Pinned scenes (opt-in):** a full-screen sticky scene must carry `data-nav-pinned` so the bar does not pop back during it. Current users: Home `Difference.tsx`, WhatWeDo `CardScroll.tsx`. Add the attribute to any new scroll-pinned section.
+
+**Section anchors:** `src/styles/index.css` has `:where(section[id]:not(#top)) { scroll-margin-top: 104px }` (zero specificity — a page rule overrides it freely).
+
+**Talos FAB (`TalosFab.tsx`):** a `<button>` that opens the global chat via `openTalosChat` (same as the bar pill) — not a `Link` to `/talos`. Visible only past one screen of scroll **and** while the bar is not `shown`; unfocusable while hidden. Ask Talos pill + FAB use the design's light-trail ring — no box-shadow glow in any state.
+
+## Gotchas
+
+- **Design anchors usually do not exist on our pages.** Use a design link anchor (`#apps`, `#solutions`, `#culture`, `#mission`, `#team`, `#why-us`, …) only if that id exists on the target page; otherwise keep the `navRoutes.ts` route / `/company/*` stub. None of the phase-one anchors exist today.
+- Between ~88px scroll and one screen, neither bar nor FAB shows. Matches the design; open question with tcox — do not "fix" without asking.
+- `/ai-solutions` stub is no longer linked from the nav.
+
+## Change history
+- 2026-10-05 — Phase-one redesign: 4 → 2 menus, `flatLinks[]`, Platforms/Company panels rebuilt, scroll reveal + `data-nav-pinned`, compact viewport, FAB visibility rules (tcox)

package/knowledge/standalone/apps/togatech/features/talos-product-page.md

@@ -6,13 +6,18 @@ project: TOGA Technology Website
 client: shared
 type: feature
 status: active
-updated: 2026-09-25
+updated: 2026-10-05
 owners: ["tcox"]
 files:
   - togatech/src/pages/Talos/TalosPage.tsx
   - togatech/src/pages/Talos/talos.css
   - togatech/src/pages/Talos/viewModel/useTalosSparks.ts
+  - togatech/src/pages/Talos/viewModel/useGlassPanes.ts
+  - togatech/src/pages/Talos/viewModel/useTalosPanelSky.ts
   - togatech/src/pages/Talos/view/shared/Reveal.tsx
+  - togatech/src/pages/Talos/view/sections/TalosHero
+  - togatech/src/pages/Talos/view/sections/TalosVoice
+  - togatech/src/pages/Talos/view/sections/TalosGovernance
   - togatech/src/routes.tsx
   - togatech/src/components/templates/AppLayout/AppLayout.tsx
   - togatech/src/components/templates/AppLayout/appLayoutContext.ts
@@ -20,32 +25,48 @@ files:
 related:
   - ../architecture.md
   - seo-aeo-geo-prerender.md
+  - navv2-global-nav.md
 ---
 
-togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS prototype; open for the design-port CSS approach, lazy-load + prerender rules, page-owned footer, and opening the Talos chat from a page.
+togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS prototype; open for the design-port CSS approach, re-porting a new design drop, lazy-load + prerender rules, page-owned footer, opening the Talos chat from a page.
 
 ## Summary
 
-`/talos` is a 15-section product page (`src/pages/Talos/`) ported from a designer prototype (static HTML + in-browser JSX + CSS; the drop-in at `togatech/_design/talos/` is temporary and never committed). Standard MVVM page layout: `view/sections/<Section>/` (incl. `TalosSparks` canvas backdrop and `TalosFooter`), `view/shared/Reveal.tsx`, `viewModel/use*.ts` hooks, copy in `viewModel/FIELDS/*.json`, images in `public/assets/talos/`. Live route, prerendered, in the sitemap list.
+`/talos` is a 15-section product page (`src/pages/Talos/`) ported from a designer prototype (static HTML + in-browser JSX + CSS). Design drops are temporary and never committed — latest at `togatech/project_html/uploads/New TOGA WEBSITE/TOGA Website/` (untracked; first drop was `_design/talos/`). Standard MVVM page layout: `view/sections/<Section>/` (incl. `TalosSparks` canvas backdrop and `TalosFooter`), `view/shared/Reveal.tsx`, `viewModel/use*.ts` hooks, copy in `viewModel/FIELDS/*.json`, images in `public/assets/talos/`. Live route, prerendered, in the sitemap list.
 
 ## How it works
 
 **CSS port (the reusable approach for any designer prototype):**
-- All design CSS is concatenated **in original cascade order** into one plain file, `talos.css`, every selector prefixed `.talosPage `. `:root` / `html` / `body` selectors map to `.talosPage`. Generated by a one-off postcss prefix script (not in `scripts/`) — regenerate the same way if the design CSS changes.
+- All design CSS is concatenated **in original cascade order** into one plain file, `talos.css`, every selector prefixed `.talosPage `. `:root` / `html` / `body` selectors map to `.talosPage`.
+- Generated by a postcss prefix+concat script, `build-talos-css.cjs`, that lives **outside the repo** (session scratchpad, not `scripts/`). If it is lost, re-create it before the next design CSS change — never hand-edit a regenerated `talos.css` in bulk.
+- After regenerating, re-apply the port edits: add any design token the CSS uses but our copy lacks (the first port missed `--ease-enter`, so `.reveal` / `.tlh-enter` / `.tpl-rev` had no valid transition); drop `.needs-dev*`, `.tvq*`, and design `.talos-fab{display:none !important}` (it is for the design's orb launcher and would hide our NavV2 FAB until the orb is ported).
 - **Not a CSS module:** the design JS finds elements by raw class names/ids and sets keyframe names inline; CSS-module hashing breaks all of that. (CTO-reviewed choice.)
 - Design timing workarounds are kept on purpose: IntersectionObserver + rect-poll backstops and `setTimeout` retry chains (rAF / ResizeObserver can go silent on cold load). Animation loops pause off-screen and on hidden tab.
 - `<html>`-level styles (`overflow-x: clip` so `position: sticky` works — never `hidden`; `scroll-behavior: smooth`) are set in `useLayoutEffect` and **removed** on unmount, not "restored" (a prerendered snapshot already carries them, so the "previous" value is wrong).
 
-**Code-split + prerender:** `routes.tsx` wraps the page in `React.lazy` + `<Suspense fallback={null}>` inside the route `Component`. Rules for this live in [seo-aeo-geo-prerender.md](seo-aeo-geo-prerender.md) (router `lazy` vs `React.lazy`, no DOM appends into React-owned nodes, `TOGAPrerender` UA skip for canvas engines).
+**Code-split + prerender:** `routes.tsx` wraps the page in `React.lazy` + `<Suspense fallback={null}>` inside the route `Component`. Rules in [seo-aeo-geo-prerender.md](seo-aeo-geo-prerender.md). Page-specific: `useGlassPanes` `useFitGap` (56px under the lede) skips on the `TOGAPrerender` UA so the snapshot does not bake the crawler-viewport margin.
 
 **Layout hooks this page uses:**
-- **Opening the Talos chat:** AppLayout owns the global Talos chat modal and passes `<Outlet context={{ openTalosChat }} />`. Pages call `useAppLayoutContext().openTalosChat()` (`AppLayout/appLayoutContext.ts`). Use this — do not mount a second chat.
-- **Own footer:** `ROUTES_WITH_OWN_FOOTER` in `AppLayout.tsx` (only `/talos` today, tcox's call) hides the old site footer (with contact form); the page renders `TalosFooter`. The old footer stays on all other pages until the redesigned footer goes site-wide — then retire the list.
-- **NavV2 floating Talos button** (`TalosFab.tsx`) is a `<button>` that opens the chat (same as the bar pill), not a `Link` to `/talos`; unfocusable while hidden. Styled from the design's `.talos-persist.talos-fab` (light-trail ring, icon-only, 44px, rises 20px on entrance).
+- **Opening the Talos chat:** AppLayout owns the global Talos chat modal and passes `<Outlet context={{ openTalosChat }} />`. Pages call `useAppLayoutContext().openTalosChat()` (`AppLayout/appLayoutContext.ts`). Use this — do not mount a second chat. The Hero's second button ("Ask Talos", `btn-talos-boxed is-lg is-hero`) uses it; there is no expanded chat mode yet.
+- **Own footer:** `ROUTES_WITH_OWN_FOOTER` in `AppLayout.tsx` (only `/talos` today, tcox's call) hides the old site footer; the page renders `TalosFooter`. Retire the list when the redesigned footer goes site-wide.
+- **Floating Talos button:** NavV2's `TalosFab` — see [navv2-global-nav.md](navv2-global-nav.md).
+
+**Section notes:** Voice sits at the end of `.tpanel2` as a `.tproof-*` stat + quote row (moved out of `.tpanel`). Governance `RAIL_COLUMNS = points.length` (7 points). PanelSky has no `.tp2-tw` twinkle; it fades over 360px to `PAGE_FILL`.
 
 **Routing:** `/talos` is in `LIVE_ROUTES` (`NavV2/navRoutes.ts`) and `src/routes.config.json`. Sub-pages `/talos/one|flow|engage` are still `STUB_ROUTES`.
 
-**Copy:** uses the design's "Katie" copy set (Katie signs off copy). Still placeholder: FAQ answers (`[Answer not written. Needs Jeff.]`), the Voice section quote, and the demo stage (no video).
+**Copy:** the design's default `COPY.katie` set (Katie signs off copy). Still placeholder: FAQ answers and the demo stage (no video).
+
+## Port status (design drop 2, 2026-10)
+
+Done: batches 1–2 (CSS regen, copy, Hero ask, Voice move, Governance, PanelSky). Left:
+1. Compare rebuild — half-stars, info popover, key.
+2. FAQ two-column, 9 items, per-item ask. Then **delete the temporary bridge rules** under `#talos-faq:not(:has(.tfq-cols))` in `talos.css`.
+3. ProductLine "What can X do?" ask buttons + `useTalosSweep`.
+4. Re-sync `talosSparksRoute.ts` — the sparks line loops wrong around the moved Voice section.
+5. `TalosOrbLauncher` / `talos-orb.js` replacing the FAB on `/talos`, `.tfab-label`, TalosGuide bubbles, chat API `open(q, {expanded})` / `close()`.
+
+Design's `HeroWeave` / `HeroDots` / old Hero are dead code — do not port.
 
 ## Gotchas
 
@@ -55,4 +76,5 @@ togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS pro
 - Tailwind preflight is global and can differ from the design's browser defaults — check margins/list/button resets when a section looks off.
 
 ## Change history
+- 2026-10-05 — Design drop 2, batches 1–2: talos.css regen (+`--ease-enter`, `.talos-mark`), Hero "Ask Talos", Voice → `.tproof-*`, FAQ bridge rules, useFitGap prerender skip (tcox)
 - 2026-09-25 — Built /talos from the designer prototype; added Outlet context `openTalosChat`, `ROUTES_WITH_OWN_FOOTER`, TalosFab now opens chat (tcox)

package/knowledge/standalone/apps/togatech/workflows/local-dev-and-headless-verification.md

@@ -6,7 +6,7 @@ project: TOGA Technology Website
 client: shared
 type: workflow
 status: active
-updated: 2026-09-25
+updated: 2026-10-05
 owners: ["tcox"]
 files:
   - togatech/package.json
@@ -36,7 +36,8 @@ The gotcha-avoidance path for getting `togatech` up on a dev machine and actuall
 - A Vite "imported but could not be resolved" error almost always means **stale install**, not a missing package — check `package.json` before adding a dependency.
 - `npm run lint` is effectively dead until eslint and an `eslint.config.*` are added to the repo; do not treat a lint failure-to-start as a code problem.
 - Cypress specs are still the source of truth for e2e coverage — the Puppeteer route is a *local verification* workaround, not a replacement. Don't delete or rewrite specs because Cypress won't launch locally.
-- `robotsPlugin` writes `robots.txt` to `./dist` even when you build with `--outDir <other>` — a scratch build still touches `dist/`.
+- `robotsPlugin` hardcodes `./dist`: a `--outDir <other>` scratch build still writes `dist/robots.txt`, and its `closeBundle` errors if `dist/` does not exist. Harmless for scratch builds.
+- A production `vite build` sends GA4 hits even when served from localhost — headless checks against a prod build log real `localhost/...` page views. Verify against `npm run dev` where you can.
 - Watching the network tab is not proof a fetch is broken: see step 3 (persisted query cache).
 
 ## Related
@@ -45,4 +46,5 @@ The gotcha-avoidance path for getting `togatech` up on a dev machine and actuall
 - [Careers Section — Live Paylocity Job Openings](../features/careers-paylocity-job-openings.md)
 
 ## Change history
+- 2026-10-05 — Prod build sends GA hits from localhost; robotsPlugin closeBundle fails without dist/ (tcox)
 - 2026-09-25 — No eslint config either; `tsc -p tsconfig.app.json` path-filter tip; robotsPlugin ignores --outDir (tcox)

package/package.json

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