Wave U — R14-V2 convergent fixes: state honesty round 2 + felt interaction

R14-V2: design 7.5 · kw 7.4 · competitor 7.3 · a11y 7.2 · brand 7.5 (min 7.2, avg 7.38; V1 was 7.0/7.08 — the regime responds to fixes). This wave ships the seven convergent asks. Same vocabulary + honesty contract as waves P-T. Surgical; both themes; testids/aria survive. NO cross-lane files. Per-lane gate: related vitest green + eslint on touched files. Orchestrator: full gates + kit-v3 capture + R15-V3.

Verification context (read before "re-fixing" anything): the agents hover tier, bee response, chat action-row reveal, and marketplace NL bridge ALL work in the live product — R13/R14 capture scripts missed them (now fixed in kit v3). Wave U items below are the judges' ESCALATIONS, not regressions. Do not rebuild what Wave T built — strengthen exactly what each item names.

Lane A — workspace shelf loading truth (5/5 judges, HIGH)

Files: apps/AllWorkspacesApp.tsx (+test).

The shelf renders "No workspaces yet — Create your first workspace" for ~0.5s before data lands. Loading, empty, and error are THREE distinct states: while the workspace query is unresolved, render 3 skeleton cards matching the fixed-slot card geometry (min-h 132, identity/tag/preview/metrics slot shimmer); the empty state (with its Create CTA) may render ONLY after a resolved, genuinely-empty answer. Follow the memory surface's cache pattern (memory-list-cache.ts): seed from session cache so a revisit shows last-known cards instantly.
Card kebab + row affordances: visible at rest at low opacity (the chat action-row pattern from Wave T Lane E: rest ~0.6 → hover/focus-within 1.0) — hover-only reveal excludes keyboard/touch (a11y). Keep the existing hover tier as-is.

Lane B — briefing interruption discipline (4/5 judges, HIGH)

Files: os/AppShell.tsx (briefing gating only), os/overlays/LoginBriefing.tsx (numbers reconciliation only), tests.

The "Catching you up" modal must fire ONLY on true session start AND only when Home is the landing surface. In-session navigation to Home (s02: Settings→Home) must never pop it. Gate on both (a) once per app session (in-memory flag, not localStorage — a new session should show it again) and (b) the first mounted surface being Home. When suppressed by (b), do NOT drop the content — the home hero already tells the story (judges call the modal+hero a "double catch-up").
Numbers reconciliation: the modal says "2 workspaces" while the home hero says "6 workspaces waiting" — the modal filters test/canned workspaces, the hero doesn't (or vice versa). Find both sources, make them share ONE filtered count. Never present two different truths about the same store in the same viewport.

Lane C — marketplace NL: run the promise (4/5 judges)

Files: apps/MarketplaceApp.tsx, tests (+ the search box component if it lives in a marketplace-owned file — verify with grep; if the search box is shared outside marketplace, wire from MarketplaceApp side only).

When the debounced query is natural-language (≥3 words) and name-filtering finds nothing: AUTO-RUN the semantic skill-match (the Search-button path) after a ~600ms settle, rendering ranked results inline under a quiet "Matched to your request" section label. No dead-end frame: while matching, show the BeeLoader (components/ui/BeeLoader.tsx) + "Matching skills to this job…".
Restyle the no-match composition: kill the gray "No job matches … by name" line as the lead voice. If semantic matching also finds nothing, show 2-3 nearest catalog entries ("Closest in the catalog") + the Free Zone escape as a real button, not a text link.
Keep the existing filter behavior for 1-2 word queries exactly as-is.

Lane D — boot warm-start (competitor HIGH)

Files: os/AppShell.tsx (boot hold logic), BootScreen component, tests.

Returning users wait ~3.5s of branded boot before every session vs ~1s time-to-content on Claude/ChatGPT. The boot screen's minimum display time should be perceptual, not fixed: when the shell's data dependencies (onboarding known + briefing prefetch fired + workspace store warm) resolve early, exit boot at ~800ms-1s (enough for the brand moment, no dead air). Keep the current longer hold ONLY while dependencies are genuinely unresolved. Do NOT remove the boot screen or its choreography — shorten its floor.
Verify the exit is choreographed (existing fade), not a hard cut, at the shorter floor. Reduced-motion: instant swap stays.

Files: apps/agents/SuggestedAgentCards.tsx (text tokens only), apps/SettingsApp.tsx / model-gate/ModelGate.tsx (light amber tier labels only), apps/memory/MemoryCenterTab.tsx

apps/memory/MemoryTrustManage.tsx (tab-swap motion + loading skeleton only), tests. NOTE: this lane touches settings + memory files that no other Wave U lane touches — verify with git status before editing that no other lane claimed them.

Agent-card second lines (the whisper tier) probe ~2.3:1 in dark — lift informative text to ≥4.5:1 both themes (token step, not new colors). Compute in lane notes.
Light-theme amber tier labels in Model Pilot ("Primary/Fallback/Budget Saver") probe ~3.1:1 — one token step darker in light. Compute in lane notes.
Memory "Loading memories…" generic spinner → skeleton rows (the surface's own row heights) with BeeLoader only if a full-surface wait is unavoidable.
One micro-motion tier on panel swaps: Memory Trust↔Memories tab change gets a ~150ms fade-slide (motion-safe gated); same token timing as the Wave T hover tier. Do NOT add route-level transitions (out of scope).

Lane F — chat action row: Claude-level presence (4/5 judges, medium but daily)

Files: apps/ChatApp.tsx + the message action-row component, tests.

The Wave T reveal works (verified) but under-reads: raise rest opacity one step (0.6 → 0.75), bump icon size 14→16px and row height accordingly, and give the revealed state a surface (subtle --surface-2 pill behind the icons) so the row reads as a toolbar, not floating glyphs. Keep the 150ms reveal + focus-within parity exactly as shipped.
Send-button micro-pulse when it fills honey (brand ask): one ~200ms scale pulse on the empty→ready transition, motion-safe gated, once per transition (no loop).

Deferred

Memories-tab composition depth (needs product thought, not polish); route-level shared-element transitions; onboarding chip-style unification (design minor); BeeLoader adoption beyond marketplace/memory loading states.

Per-lane gate

Related vitest green + eslint; NO cross-lane files; contrast math in lane notes where demanded. Orchestrator after merge: web tsc + full vitest + browser QA + kit-v3 capture + R15-V3 judge round.

6.8 KiB Raw Blame History