93 lines
6.0 KiB
Markdown
93 lines
6.0 KiB
Markdown
# Wave V — R15-V3 convergent fixes: memory parity, single-truth banners, motion tier 2
|
|
|
|
R15-V3: design 7.5 · kw 7.8 · competitor 7.6 · a11y 7.3 · brand 7.4 (min 7.3, avg
|
|
7.52; regime trajectory 7.08 → 7.38 → 7.52). Same vocabulary + honesty contract as
|
|
waves P-U. Surgical; both themes; testids/aria survive. NO cross-lane files.
|
|
Per-lane gate: related vitest green + eslint on touched files.
|
|
|
|
Already fixed inline (do NOT redo): s03 empty-flash root cause — ShellContext now
|
|
forwards `workspacesLoading`; the shelf gates its empty state on it (`32507dd9`).
|
|
|
|
## Lane A — memory surface to hero parity (5/5 judges)
|
|
Files: `apps/memory/*` (MemoryTrustManage.tsx, MemoryCenterTab.tsx, memory-list-cache.ts), tests.
|
|
1. Hero count NEVER paints 0 mid-load, including tab RETURNS: gate on cache — show
|
|
the cached last-known count (or skeleton digit when truly unknown), never a
|
|
transient 0. The count-up animation runs ONCE per app session (module-level
|
|
flag, mirrors shelfSessionResolved), then settles instantly on later mounts.
|
|
2. Memories tab to Trust-hero standard: a designed container (result-count header
|
|
row "448 memories · filtered by X", aligned filter chips, consistent row grid) —
|
|
kill the "one card floating in a black void" composition. While the list loads:
|
|
skeleton rows (existing pattern), or when a filter pins results, an explicit
|
|
state label ("Showing 1 pinned result — loading the rest…").
|
|
3. Keep all existing behavior (cache, erase flows, testids) intact.
|
|
|
|
## Lane B — settings verdict single-truth (kw + competitor HIGH)
|
|
Files: `apps/SettingsApp.tsx`, `model-gate/ModelGate.tsx` (verdict/banner logic only), tests.
|
|
1. The status banner currently flips "No working model" → "you're ready to go" →
|
|
provider error within ~1s as async probes land. Introduce ONE resolution phase:
|
|
while any provider probe is in flight show a neutral "Checking your models…"
|
|
banner (BeeLoader mark optional), then render EXACTLY ONE final verdict. No
|
|
intermediate verdict may paint.
|
|
2. Do not slow the happy path: if all probes resolve <300ms, skip the checking
|
|
state entirely (verdict paints once, immediately).
|
|
|
|
## Lane C — motion tier 2: cards answer with lift + bloom (design + brand)
|
|
Files: `apps/AllWorkspacesApp.tsx`, `apps/agents/SuggestedAgentCards.tsx`,
|
|
`apps/extend/ExtensionCard.tsx`, tests.
|
|
1. Hover/focus-visible on workspace cards, bee cards, marketplace rows adds a
|
|
subtle translate lift (2-4px) + a honey glow bloom (shadow token step) ON TOP of
|
|
the existing ring/border tier. 150-200ms ease-out, motion-safe gated (reduced
|
|
motion keeps the color tier). Use existing --shadow-honey / timing tokens; if a
|
|
token is missing, note it — don't invent values inline.
|
|
2. Specialists strip: show the → arrow at rest (dim), brighten on hover (a11y
|
|
rest-hint ask). Audit these three files for other hover-only reveals; give each
|
|
a rest-state hint or focus-visible parity.
|
|
|
|
## Lane D — signature theme crossfade + route settle (brand HIGH)
|
|
Files: `providers/ThemeProvider.tsx` (or wherever the theme stamp lives — verify),
|
|
`index.css` (transition rules only), tests.
|
|
1. Theme switch: a 300-400ms warm crossfade ("sunset over the hive") instead of an
|
|
instant token swap — CSS transition on background/color tokens at the root, NOT
|
|
a JS animation; guard against transitioning layout properties (colors/opacity
|
|
only, no width/position). motion-safe gated; reduced-motion keeps the instant swap.
|
|
2. Verify the s02 Settings→Home gap: the route lands on Home whose shelf section
|
|
skeletons paint inside the FULL page scaffold (sidebar+header persist — they
|
|
should already; if a blank frame exists outside the shelf, find and close it).
|
|
3. Do NOT add route-level shared-element transitions (out of scope).
|
|
|
|
## Lane E — loading vocabulary close-out (design + kw)
|
|
Files: `os/WorkspaceDesktopApp.tsx` (entry loader only), `apps/MarketplaceApp.tsx` +
|
|
`apps/extend/AgentSearchBox.tsx` (debounce presentation only), tests.
|
|
1. Chat/workspace cold entry: replace the bare centered "Loading workspace…" text
|
|
with a layout-preserving skeleton (sidebar/header persist; thread-shaped
|
|
placeholders in the content area — reuse the WorkspaceBriefing skeleton idiom).
|
|
2. Marketplace: during the search debounce, keep prior results visible at reduced
|
|
opacity (dimmed, aria-busy) instead of collapsing the list between keystrokes;
|
|
stabilize the MATCHES section so it doesn't mount/unmount across adjacent
|
|
debounce ticks (reserve its container once shown until the query clears).
|
|
|
|
## Lane F — a11y utility-text sweep + chip semantics (a11y HIGH)
|
|
Files: `os/StatusBar.tsx`, `os/Sidebar.tsx`, `overlays/onboarding/WelcomeStep.tsx` +
|
|
the wizard step shell (mascot carry + step transition), `apps/ChatApp.tsx`
|
|
(aria/tooltips ONLY — no visual changes), tests.
|
|
1. AA sweep at 11-12px in BOTH themes (compute, don't eyeball; math in lane notes):
|
|
"Skip setup", "Don't show again", statusbar plan/search/date chrome, sidebar
|
|
section labels (PINNED · POWER TOOLS / GENERAL), marketplace suggestion pills
|
|
(if that token lives in a shared tier, fix the token, else note it).
|
|
2. Composer chips + message-action icons: aria-label + title tooltips on every
|
|
control (several have neither); no visual changes in this lane.
|
|
3. Onboarding: keep the (breathing) mascot as the persistent step header across
|
|
wizard steps (it currently swaps to a generic glyph after Welcome); ease the
|
|
step transition (slide/fade ~200ms, motion-safe). Replace the native OS
|
|
<select> for Industry with the app's themed select primitive (grep for an
|
|
existing themed select/dropdown — one exists in settings; reuse, don't build).
|
|
|
|
## Deferred
|
|
Briefing-modal row streaming (prefetch already covers the common path); route
|
|
shared-element transitions; marketplace row typography tier-up; s06 panel-swap
|
|
choreography (surface already at 8.5).
|
|
|
|
## Per-lane gate
|
|
Related vitest green + eslint on touched files; contrast math where demanded.
|
|
Orchestrator: web tsc + apps/web vitest suite + browser smoke + R16-V4 capture/judge.
|