toga-ai 1.0.900 → 1.0.901

package/knowledge/INDEX.md

@@ -39,7 +39,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 
 ## standalone framework
 
-- **togatech** (TOGA Technology Website) — 6 doc(s) → [standalone/apps/togatech/INDEX.md](standalone/apps/togatech/INDEX.md)
+- **togatech** (TOGA Technology Website) — 7 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

@@ -5,5 +5,6 @@
 | [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 |
 | [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 |
 | [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/architecture.md

@@ -6,8 +6,8 @@ project: TOGA Technology Website
 client: shared
 type: architecture
 status: active
-updated: 2026-09-16
-owners: [jcardinal]
+updated: 2026-09-25
+owners: [jcardinal, tcox]
 files:
   - togatech/src/main.tsx
   - togatech/src/App.tsx
@@ -17,6 +17,9 @@ files:
   - togatech/src/themeConfig/ThemeContext.tsx
   - togatech/vite.config.ts
   - togatech/package.json
+  - togatech/src/components/NavV2/navRoutes.ts
+  - togatech/src/components/templates/AppLayout/AppLayout.tsx
+  - togatech/src/routes.config.json
 related: []
 ---
 
@@ -51,7 +54,7 @@ Public-facing TOGA Technology corporate/marketing website. Standalone single-pag
 
 ## Routing
 
-`src/routes.tsx` = single `createBrowserRouter`. All routes render under `components/templates/AppLayout` (shared header/footer chrome); the index route group has `ErrorPage` as its `ErrorBoundary`.
+`src/routes.tsx` = single `createBrowserRouter`. All routes render under `components/templates/AppLayout` (NavV2 header + footer chrome); the `/` route group has `ErrorPage` as its `ErrorBoundary`.
 
 | Path | Page |
 |---|---|
@@ -60,11 +63,16 @@ Public-facing TOGA Technology corporate/marketing website. Standalone single-pag
 | `/what-we-do` | `pages/WhatWeDo` |
 | `/our-platform` | `pages/OurPlatform` |
 | `/contact` | `pages/Contact` |
+| `/talos` | `pages/Talos` (code-split — see features/talos-product-page.md) |
 | `/privacy-policy` | `pages/PrivacyPolicy` |
 | `/terms-and-conditions` | `pages/TermsAndConditions` |
+| every `STUB_ROUTES` path | `pages/Stub` placeholder (`<StubPage title>`) |
 | `*` | `pages/NotFound` |
 
-- Lazy-route scaffolding present but commented out (pages eagerly imported today).
+- **Nav destinations are data** in `components/NavV2/navRoutes.ts`: `LIVE_ROUTES` (real pages) and `STUB_ROUTES` (placeholder until built — delete the line to retire a stub). Blog routes are commented out.
+- **Prerender list:** `src/routes.config.json` lists the static routes to prerender + sitemap. Add every new live route there (rules: features/seo-aeo-geo-prerender.md).
+- Pages are imported eagerly except `/talos` (`React.lazy` + `<Suspense>` inside the route Component — never the router's `lazy`, it breaks hydration).
+- **AppLayout → page contract:** `<Outlet context={{ openTalosChat }} />`; pages read it via `useAppLayoutContext()` (`AppLayout/appLayoutContext.ts`) to open the global Talos chat modal. `ROUTES_WITH_OWN_FOOTER` (only `/talos`) hides the old site footer on pages that render the redesigned one.
 - A Cypress-only test route swaps `WhatWeDoPage` for a throwing component to exercise the error boundary (`VITE_CY_TEST` / `window.Cypress`).
 
 ## Page structure — MVVM per page
@@ -85,8 +93,8 @@ pages/Home/
 
 ## Shared layers
 
-- `src/components/` — reusable UI (Header, Footer, Hero, Carousel/Swiper wrappers, Modal, TalosChat + TalosChatInput, motion/animation helpers, animated SVGs, etc.).
-- `src/components/templates/` — layout primitives: `AppLayout` (router root chrome), `DefaultContainer`, `MarginContainer`, `GlowingContainer`, `ErrorContainer`.
+- `src/components/` — reusable UI (NavV2 global nav incl. `TalosFab`, Header, Footer, Hero, Carousel/Swiper wrappers, Modal, TalosChat + TalosChatInput, motion/animation helpers, animated SVGs, etc.).
+- `src/components/templates/` — layout primitives: `AppLayout` (router root chrome; Outlet context + `appLayoutContext.ts`), `DefaultContainer`, `MarginContainer`, `GlowingContainer`, `ErrorContainer`.
 - `src/lib/` — data/integration:
   - `api.ts` — `useSendEmail` (contact form) and `postTalosMessage` (AI chat).
   - `contentful.ts` — Contentful delivery client (`createClient`).
@@ -106,7 +114,7 @@ All via Vite `VITE_*` env vars (values in `.env`, never in repo docs):
 
 ## Build, environments, deploy
 
-- `package.json` scripts: `dev`, `togatech` (dev with `--host togatech`), `build` (`tsc && vite build`), `buildBeta` (`--mode beta`), `buildGamma` (`--mode gamma`), `preview`, `lint` (ESLint, `--max-warnings 0`).
+- `package.json` scripts: `dev`, `togatech` (dev with `--host togatech`), `build` (`tsc && vite build`), `buildBeta` (`--mode beta`), `buildGamma` (`--mode gamma`), `preview`, `lint` (ESLint — non-functional: no eslint dependency or config; see workflows/local-dev-and-headless-verification.md). `build` also runs the Puppeteer prerender (see features/seo-aeo-geo-prerender.md).
 - Multi-environment: `development`, `beta`, `gamma`, `production` (Vite modes).
 - Vite `base: "/"`, output to `dist/`, `publicDir: public`. A custom `robotsPlugin` copies `public/robots.prod.txt` or `public/robots.dev.txt` to `dist/robots.txt` at `closeBundle`, depending on prod detection (`NODE_ENV` + `VITE_ENV`).
 - `@` path alias → `./src` (Vite `resolve.alias`).

package/knowledge/standalone/apps/togatech/features/seo-aeo-geo-prerender.md

@@ -71,7 +71,11 @@ Makes togatech.com visible and citable to search engines **and** AI answer engin
 - **🔴 Hosting requirement:** CloudFront/S3 must serve each prerendered `dist/<route>/index.html` for its path; a blanket SPA rewrite to root `index.html` serves the empty shell and defeats the prerender.
 - **og:image dedupe:** static OG/Twitter tags were removed from `index.html` because `<Seo>` emits per-page ones (Helmet appends rather than replacing pre-existing static tags → duplicates otherwise).
 - **Verified data corrections:** real positioning is *integrated IT services + the ERA TOGa Platform*; real socials are LinkedIn `/toga-tech` + YouTube + Instagram (no Twitter/GitHub/Crunchbase); contact is `website@togatech.com` / `+1 (212) 736-0111`; **5** offices. Prior planning docs had several wrong specifics — verify schema/llms.txt against FIELDS before shipping.
-- **Build size:** JS bundle is ~14.8 MB (4.9 MB gzip) — a real CWV/LCP risk; code-splitting is a separate follow-up.
+- **Build size:** JS bundle is ~14.8 MB (4.9 MB gzip) — a real CWV/LCP risk. Only `/talos` is code-split so far.
+- **🔴 Code-split a prerendered route with `React.lazy` + `<Suspense>` inside the route `Component` — never react-router's route `lazy`.** Router `lazy` without a `HydrateFallback` renders blank and throws away the prerendered HTML; a Suspense boundary keeps the server HTML until the chunk arrives. Pattern: `TalosRoute` in `routes.tsx`.
+- **🔴 Hooks must never append child nodes into React-owned elements.** The snapshot captures the appended nodes → hydration mismatch. Render a host element with `dangerouslySetInnerHTML={{__html:""}}` and clear it on start and cleanup.
+- **Prerender UA tag:** `prerender.mjs` sets a user agent containing `TOGAPrerender`. `App.tsx` skips analytics on it; canvas/animation engines must skip start on it too (e.g. `useTalosSparks.ts`).
+- **New route checklist:** add it to `src/routes.config.json` (prerender + sitemap list); a nav destination also moves from `STUB_ROUTES` to `LIVE_ROUTES` in `NavV2/navRoutes.ts` (removing the stub line retires the placeholder page).
 - **FIELDS JSON is component-coupled — no free-prose body slot:** each page's `*FIELDS*.json` is shaped to specific components (hero, cardScroll, businessProblems, kpi, carousel), so there is **no place to drop a long prose block**. An audit's "rewrite to 900 words" is not structurally possible without building new components — you can only sharpen titles/descriptions/keywords/card copy that already have slots. (`/our-platform` was left unchanged: it is already content-dense — 7 app modules + 4 stacks + testimonials + KPIs — and the original audit under-counted because that content is JS-rendered.)
 - **`personSchemas` duplicate guard:** a leader can be in both `boardMembers` and `members` in `ABOUTPAGEFIELDS` — `personSchemas` must de-dup by lowercased trimmed name, or it emits duplicate `Person` nodes.
 - **🔴 Brand name is "TOGA Technology" only — never "Agilant":** an earlier draft adding `alternateName: "Agilant"` / "(formerly Agilant)" to the org schema was explicitly reverted. Do not reintroduce "Agilant" in schema, copy, or meta. (Captured as a team brand standard — see Related docs.)
@@ -79,4 +83,8 @@ Makes togatech.com visible and citable to search engines **and** AI answer engin
 ## Related
 
 - standalone/apps/togatech/architecture.md (update its Build/deploy section once PR #30 merges — robotsPlugin gating + prerender step).
+- standalone/apps/togatech/features/talos-product-page.md — first code-split + canvas page under prerender.
 - standalone/apps/togatech/workflows/creating-pull-requests.md — how PRs get opened on this repo (gh CLI is unauthenticated; uses curl + osxkeychain token; base `_production`).
+
+## Change history
+- 2026-09-25 — Added lazy-route, no-DOM-append, TOGAPrerender UA and new-route rules from the /talos build (tcox)

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

@@ -0,0 +1,58 @@
+---
+title: Talos Product Page (/talos) — ported designer prototype
+framework: "standalone"
+repo: togatech
+project: TOGA Technology Website
+client: shared
+type: feature
+status: active
+updated: 2026-09-25
+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/view/shared/Reveal.tsx
+  - togatech/src/routes.tsx
+  - togatech/src/components/templates/AppLayout/AppLayout.tsx
+  - togatech/src/components/templates/AppLayout/appLayoutContext.ts
+  - togatech/src/components/NavV2/view/TalosFab.tsx
+related:
+  - ../architecture.md
+  - seo-aeo-geo-prerender.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.
+
+## 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.
+
+## 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.
+- **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).
+
+**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).
+
+**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).
+
+## Gotchas
+
+- Design `body{background:transparent}` collapses onto `.talosPage` and wipes the page colour — drop the body background when porting.
+- `.talosPage` needs `isolation: isolate` so negative/low `z-index` backdrop layers paint above its background (it stands in for `<html>`).
+- Site-global `src/styles/index.css` sets `word-spacing: 0.08em` on `p`, `h2`–`h6`, `a`, `li`, `button` — changes line breaks vs the design. Reset to `normal` inside the page.
+- 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-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-16
+updated: 2026-09-25
 owners: ["tcox"]
 files:
   - togatech/package.json
@@ -28,17 +28,21 @@ The gotcha-avoidance path for getting `togatech` up on a dev machine and actuall
 1. **`npm install` before anything else, every time you pull.** A stale `node_modules` shows up as a Vite resolve error, not as a missing dependency: `"react-helmet-async" is imported by … but could not be resolved`. Both `react-helmet-async` and `react-google-recaptcha-v3` are declared in `package.json` (added by the SEO work) but absent from an older install, and the site simply will not load.
 2. **Start the dev server** — `npm run dev`, or `npm run togatech` for the `--host togatech` variant (Vite `allowedHosts: ["togatech"]`).
 3. **Clear localStorage before judging any data fetch.** `App.tsx` wraps the app in `PersistQueryClientProvider` with the persister key **`"commerce"`** and a **24h `staleTime`**, so a previously cached query (e.g. `jobPosts`) renders from localStorage with **no network request at all**. Clear the persisted cache **and** `accessToken` / `refreshToken` — a stale public token from `POST /v2/auth/public` will otherwise be reused too.
-4. **Do not expect `npm run lint` to work.** The script is `eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0`, but **`eslint` is not in `package.json` dependencies or devDependencies at all** — there is no local binary, so a clean install cannot lint. Rely on `tsc` (`npm run build` = `tsc && vite build && …`) for type safety and review manually, or install eslint ad hoc.
+4. **Do not expect `npm run lint` to work.** The script is `eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0`, but **`eslint` is not in `package.json` dependencies or devDependencies at all** — there is no local binary, so a clean install cannot lint. There is also **no ESLint config** — ad hoc `npx eslint` fails with "couldn't find an eslint.config.* file". Type-check with `npx tsc --noEmit -p tsconfig.app.json`; it has **many pre-existing unrelated errors**, so filter the output by the paths you touched.
 5. **If Cypress won't run, verify headlessly with the repo's Puppeteer.** `cypress` 15.11 fails its own binary verification on this Windows machine — `bad option: --smoke-test` — and `npx cypress install` does **not** fix it. Workaround: `puppeteer` is already a dependency, so drive **system Chrome** directly by passing `executablePath` to `puppeteer.launch()`, navigate to the dev-server URL, and assert on the rendered DOM (the section testids, e.g. `job-posting-section` / `job-opening-cards`). Same technique the production build already uses in `scripts/prerender.mjs`.
 
 ## Gotchas
 
 - 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 is added to the repo's dev dependencies; do not treat a lint failure-to-start as a code problem.
+- `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/`.
 - Watching the network tab is not proof a fetch is broken: see step 3 (persisted query cache).
 
 ## Related
 
 - [togatech architecture](../architecture.md)
 - [Careers Section — Live Paylocity Job Openings](../features/careers-paylocity-job-openings.md)
+
+## Change history
+- 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.900",
+  "version": "1.0.901",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",