toga-ai 1.0.1000 → 1.0.1001

package/knowledge/standalone/apps/claude/workflows/knowledge-publish-pipeline.md

@@ -6,8 +6,8 @@ project: Claude Harness
 client: shared
 type: workflow
 status: active
-updated: 2026-09-16
-owners: ["jcardinal"]
+updated: 2026-10-12
+owners: ["jcardinal", "tcox"]
 files:
   - claude/knowledge.js
 related:
@@ -47,6 +47,8 @@ Publish sequence, run inside the team repo clone (`~/toga-tech`):
 - **`.claude/settings.json` is tracked in this repo and is edited by the harness itself**, so local drift there is expected and recurring. It was the dirty file that made the failure 100% reproducible on at least one machine. `--autostash` makes publish tolerate it, but the drift still wants a periodic `git diff .claude/settings.json` decision — commit it or revert it. It is also the file most likely to make `npx toga-ai`'s `git pull --ff-only` refuse (see the harness distribution doc).
 - **A `catch` that discards `stderr` disguises a deterministic bug as a flaky one.** This bug went undiagnosed for months purely because `catch (e)` threw git's stderr away while git was naming the exact cause on every single run. Any retry wrapper around a shell command in this repo must surface `e.stderr || e.stdout` on final failure.
 
+- **`--mirror` copies the whole KB into `<repo>/.claude/knowledge`** (~784 files in togatech), untracked in app repos. Never commit it to an app repo. Hide it locally with `.git/info/exclude` (add `.claude/knowledge/`) — do not edit the app's `.gitignore` for it.
+
 ## Related
 
 - [Harness Distribution](harness-distribution.md)

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

@@ -4,7 +4,7 @@
 |-----|---------|
 | [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 |
+| [NavV2 Global Nav — menus, panel shell, scroll reveal, Talos FAB](features/navv2-global-nav.md) | togatech NavV2 header (designer "phase one"): data-driven menus, one shared panel shell + WebGL canvas, `data-nav-reveal` scroll hide/show, opt-in `data-nav-pin |
 | [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, 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`. |

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

@@ -1,5 +1,5 @@
 ---
-title: NavV2 Global Nav — menus, scroll reveal, Talos FAB
+title: NavV2 Global Nav — menus, panel shell, scroll reveal, Talos FAB
 framework: "standalone"
 repo: togatech
 project: TOGA Technology Website
@@ -12,8 +12,11 @@ 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/SilkCanvas.tsx
   - togatech/src/components/NavV2/view/panels/WhatPanel.tsx
   - togatech/src/components/NavV2/view/panels/CompanyPanel.tsx
+  - togatech/src/components/NavV2/view/panels/IndustriesPanel.tsx
+  - togatech/src/components/NavV2/view/panels/ResourcesPanel.tsx
   - togatech/src/components/NavV2/view/panels/PanelFooter.tsx
   - togatech/src/components/NavV2/navV2.module.css
   - togatech/src/components/NavV2/types.ts
@@ -26,12 +29,15 @@ files:
   - togatech/src/components/NavV2/viewModel/FIELDS/NAVFIELDS.json
   - togatech/src/components/MobileNav/MobileNav.tsx
   - togatech/src/styles/index.css
+  - togatech/public/assets/nav/logo-talos-ai.svg
+  - togatech/public/assets/nav/logo-toga-platform.svg
+  - togatech/tailwind.config.js
 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.
+togatech NavV2 header (designer "phase one"): data-driven menus, one shared panel shell + WebGL canvas, `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
 
@@ -44,6 +50,16 @@ Global header in `src/components/NavV2/` (MVVM: `view/`, `viewModel/`, menu data
 - 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`.
+- Platforms tab titles ("Talos AI", "TOGa Platform") show a brand logo on the left: data is `logo: {src, size}` in `NAVFIELDS.json` (`PlatformLogo` in `types.ts`), files in `public/assets/nav/` (Talos 38px, TOGa Platform 32px), 9px gap, class `.platformTitle`.
+
+**Panel shell (one for all menus):** `NavV2.tsx` renders the only `.panel` (`hidden={!anyOpen}`) with the only `<SilkCanvas active={anyOpen}/>` + `.panelScrimOverlay`. Panel components (What / Industries / Company / Resources) return just their `.panelPad` div with `id` (the `aria-controls` target) and `data-screen-label`.
+- **Never put a `.panel` shell or a `SilkCanvas` inside a panel component.** Each canvas is a WebGL context; one canvas per panel made a new context on every menu open (Chrome keeps only ~16 live).
+- `.panel[hidden]{display:none}` is required — `.panel{display:flex}` beats the `hidden` attribute.
+- `navPanelIn` slide-in plays on open (display none → flex restarts it); switching menu to menu does not replay it.
+
+**Type:** matches the designer type spec (see Gotchas). `navV2.module.css` resets the site-wide word-spacing inside the nav: `.root :where(p,h2,h3,h4,h5,h6,a,li,button){word-spacing:normal}` (same idea as `/talos` — see [talos-product-page.md](talos-product-page.md) Gotchas).
+
+**Mobile:** `MobileNav` closes on resize only when width > 1280 (`MOBILE_NAV_MAX_WIDTH_PX`), matching `tailwind.config.js` `md: {max:'1280px'}` (AppLayout: NavV2 `md:hidden`, hamburger `hidden md:block`).
 
 **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.
@@ -63,7 +79,11 @@ Global header in `src/components/NavV2/` (MVVM: `view/`, `viewModel/`, menu data
 - **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.
+- **Tailwind screens here are max-width (desktop-first):** `md:` means "≤ 1280px", not "≥ 768px".
+- **Tailwind line-height traps:** `text-xs/sm/base/lg` set their own line-height; `leading-normal` is `1.5`, not CSS `line-height: normal`. When the design says "normal", use `leading-[normal]`.
+- **Set logo size by inline style, not the `height` attribute** — Tailwind preflight `img{height:auto}` overrides it (the TOGa Platform SVG is 98x100, not square).
 - Nav type spec (sizes, weights, spacing, line-height, colour) is `navigation-type-spec.md`, attached to ClickUp TRUE-82043. Check nav type changes against it.
 
 ## Change history
+- 2026-10-12 — Type spec match, Platforms logos, one shared panel shell + SilkCanvas (WebGL context leak fix), MobileNav closes only above 1280px (TRUE-82042, tcox)
 - 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,7 +6,7 @@ project: TOGA Technology Website
 client: shared
 type: feature
 status: active
-updated: 2026-10-05
+updated: 2026-10-12
 owners: ["tcox"]
 files:
   - togatech/src/pages/Talos/TalosPage.tsx
@@ -14,6 +14,9 @@ files:
   - 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/viewModel/useTalosSubnav.ts
+  - togatech/src/pages/Talos/viewModel/FIELDS
+  - togatech/src/pages/Talos/view/sections/TalosChoosing/TalosChoosing.tsx
   - togatech/src/pages/Talos/view/shared/Reveal.tsx
   - togatech/src/pages/Talos/view/sections/TalosHero
   - togatech/src/pages/Talos/view/sections/TalosVoice
@@ -42,7 +45,8 @@ togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS pro
 - 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).
+- `<html>`-level styles (`overflow-x: clip` so `position: sticky` works — never `hidden`; `scroll-behavior: smooth`) are set in `useLayoutEffect` (`useRootStyles` in `TalosPage.tsx`) and **removed** on unmount, not "restored" (a prerendered snapshot already carries them, so the "previous" value is wrong).
+- **Reduced motion:** under `prefers-reduced-motion`, `useRootStyles` skips `scroll-behavior: smooth` and `useTalosSubnav` scrolls with `behavior: "instant"` — `"auto"` inherits the `<html>` smooth setting.
 
 **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.
 
@@ -55,7 +59,11 @@ togatech `/talos` Talos AI product page, ported from a designer HTML/JSX/CSS pro
 
 **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:** the design's default `COPY.katie` set (Katie signs off copy). Still placeholder: FAQ answers and the demo stage (no video).
+**Copy:** the design's default `COPY.katie` set (Katie signs off copy). Not production-ready yet (new ticket pending, as of 2026-10-12):
+- `TALOSFAQFIELDS.json` — 6 answers are "[Answer not written. Needs Jeff.]"; "Certification three/four" are placeholders.
+- `TALOSVOICEFIELDS.json` — quote still flagged as placeholder.
+- `TalosChoosing` card CTAs ("Book a demo", "See TOGa Platform") are plain spans with no link.
+- Demo stage has no video.
 
 ## Port status (design drop 2, 2026-10)
 
@@ -76,5 +84,6 @@ Design's `HeroWeave` / `HeroDots` / old Hero are dead code — do not port.
 - 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-12 — Reduced-motion: no smooth scroll on `<html>`, instant subnav jumps; listed open placeholder copy/CTAs (TRUE-82042, tcox)
 - 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,12 +6,14 @@ project: TOGA Technology Website
 client: shared
 type: workflow
 status: active
-updated: 2026-10-05
+updated: 2026-10-12
 owners: ["tcox"]
 files:
   - togatech/package.json
   - togatech/cypress.config.ts
   - togatech/src/App.tsx
+  - togatech/tsconfig.json
+  - togatech/tsconfig.app.json
 related:
   - ../architecture.md
   - ../features/careers-paylocity-job-openings.md
@@ -28,7 +30,7 @@ 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. 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.
+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` — **not** `-p .`: root `tsconfig.json` has `"files": []` (references only), so `tsc -p .` and the `tsc` step in `npm run build` check nothing. It has pre-existing errors (13 on 2026-10-12, in Modal.tsx, PinScroll.tsx, TalosChat.tsx, IQ.tsx, OurHistory.tsx, routes.tsx, getFontAwesomeIcon.tsx), 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
@@ -46,5 +48,6 @@ 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-12 — Root tsconfig checks nothing (build's `tsc` does not type-check); 13 known errors (tcox)
 - 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.1000",
+  "version": "1.0.1001",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",