Add command palette feature tip

[brennanb2025]

Summary

• Adds a concrete in-app feature tip for the Cmd+J command palette, teaching users they can jump across worktrees, settings, tabs, and quick actions from one search surface.
• Renders the live, platform-correct binding via useShortcutKeys('worktree.palette') so the keycap cue stays accurate after a rebind (and shows Ctrl+Shift+J on Linux/Windows), with the description pointing to Settings for rebinding.
• Hand-authored an Orca-style CSS/keyframes animation (keypress cue → palette entrance → selection sweep across a worktree, the Shortcuts setting, and a quick action). No runtime GIF/video.
• Passive education tip: single Got it acknowledgement CTA, no secondary "Maybe Later". Priority sits just after the Orca CLI tip.

Test plan

• pnpm exec vitest run --config config/vitest.config.ts src/shared/feature-tips.test.ts src/renderer/src/components/feature-tips/feature-tip-modal-state.test.ts src/renderer/src/components/feature-tips/feature-tip-startup-gate.test.ts
• Typecheck (tsgo -p config/tsconfig.tc.web.json) and oxlint on changed files
• Animation + modal composition verified via Playwright-screenshotted mock mirroring the React port's classes/timing. Live Electron renderer not spun up to avoid disturbing concurrent dev sessions.

Generated after feature-tip candidate review.

Made with Orca 🐋

Summary by CodeRabbit

• New Features
  • Added a Cmd+J palette feature tip: interactive visual demo, dialog with actions, reduced-motion support, animations, and telemetry for "shown" and "acknowledged".
• Chores
  • Updated UI wording from "workspace" to "worktree".
• Tests
  • Added/updated tests for the new tip, visuals, telemetry, ordering, and startup gating.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 805fae83-cef6-4b3d-afe3-0a379f31fca8

📥 Commits

Reviewing files that changed from the base of the PR and between c255e1f and 355bf9d.

📒 Files selected for processing (2)

• src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.tsx
• src/renderer/src/components/feature-tips/CmdJPaletteTipDialog.tsx

🚧 Files skipped from review as they are similar to previous changes (2)

• src/renderer/src/components/feature-tips/CmdJPaletteTipDialog.tsx
• src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.tsx

---

Walkthrough

Adds a Cmd+J command-palette feature tip end-to-end: feature-tip types and registry, telemetry schemas and helpers, animated visual + CSS, dialog and shared actions, modal routing/handlers, workspace→worktree copy updates, and tests covering behavior and telemetry.

Changes

Cmd+J Palette Feature Tip

Layer / File(s)	Summary
Feature tip contract and telemetry schema src/shared/feature-tips.ts, src/shared/telemetry-events.ts, src/shared/feature-tips.test.ts	FeatureTipId adds 'cmd-j-palette', FeatureTipAction adds 'learn-cmd-j-palette', FEATURE_TIPS includes the new tip. Zod schemas for cmd_j_palette_feature_tip_shown and cmd_j_palette_feature_tip_acknowledged are registered. Tests updated for ordering, seen filtering, and tip shape.
Telemetry tracking infrastructure src/renderer/src/components/feature-tips/feature-tip-telemetry.ts, src/renderer/src/components/feature-tips/feature-tip-telemetry.test.ts	Adds CmdJPaletteFeatureTipSource type and trackCmdJPaletteFeatureTipShown / trackCmdJPaletteFeatureTipAcknowledged helpers; tests assert telemetry events and payload source values.
Cmd+J palette visual component src/renderer/src/assets/main.css, src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.tsx, src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.test.tsx	New CmdJPaletteFeatureTipVisual renders animated demo with staged typing, shortcut chips, filtered worktree results, and conditional "Create worktree" row. CSS adds caret/results animations with reduced-motion fallbacks. Tests cover reduced-motion, timers, shortcut fallbacks, and rendering.
Dialog wrapper and shared actions component src/renderer/src/components/feature-tips/FeatureTipActions.tsx, src/renderer/src/components/feature-tips/CmdJPaletteTipDialog.tsx, src/renderer/src/components/feature-tips/CmdJPaletteTipDialog.test.tsx	Adds FeatureTipActions (skip + primary CTA with busy state) and CmdJPaletteTipDialog that renders inline shortcut <kbd> chips, eyebrow/description, rebind link, visual, and footer actions. Tests verify static rendering and fallbacks.
Feature tips modal integration src/renderer/src/components/feature-tips/FeatureTipsModal.tsx	Routes learn-cmd-j-palette through CmdJPaletteTipDialog, renders CmdJPaletteFeatureTipVisual in visual branch, tracks acknowledgment telemetry on primary action, and adds openShortcutsSettings helper to mark tip seen and navigate to shortcuts settings.
Terminology updates: workspace → worktree src/renderer/src/components/WorktreeJumpPalette.tsx, src/renderer/src/components/cmd-j/quick-actions.ts, src/renderer/src/components/cmd-j/palette-results.test.ts	Updates UI copy and test fixtures from "workspace" to "worktree": headers, hints, empty-state messages, placeholders, quick-action titles/descriptions/verb keywords, and test ranking queries.
Feature tip selection and sequencing tests src/renderer/src/components/feature-tips/feature-tip-modal-state.test.ts, src/renderer/src/components/feature-tips/feature-tip-startup-gate.test.ts	Adds tests asserting fallback to cmd-j-palette after CLI tip seen and updates seenTipIds across scenarios to include cmd-j-palette where appropriate.
App-level integration src/renderer/src/App.tsx, src/main/startup/dev-education-suppression.test.ts	Imports trackCmdJPaletteFeatureTipShown and calls it with 'app_open' when feature tip decision opens; dev-education suppression test updated to expect cmd-j-palette in suppressed featureTipsSeenIds.

Suggested reviewers

• Jinwoo-H

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pullfrog]

✅ No new issues found.

Reviewed changes — adds a passive education feature tip for the Cmd+J command palette with a JS-driven animation, platform-correct shortcut rendering, and telemetry. Also renames "Workspaces" → "Worktrees" throughout the jump palette.

• Add cmd-j-palette feature tip — new tip entry in FEATURE_TIPS with 'learn-cmd-j-palette' action, priority 'new', positioned after the CLI tip in the ordering. Title uses a <shortcut> placeholder token for live binding injection.
• Add CmdJPaletteFeatureTipVisual — phase-machine animation (idle → pressed → open → typing → loop) with reduced-motion support, live shortcut-key chips with per-key stagger, and demo worktree filtering that mirrors the real palette behavior.
• Add CmdJPaletteTipDialog — custom horizontal layout dialog matching the CLI tip presentation, with live shortcut rendered as a <kbd> chip in the title, a clickable rebind link to Settings → Shortcuts, and a single "Got it" acknowledgement CTA.
• Extract FeatureTipActions into its own component from FeatureTipsModal, adding a getPrimaryBusyLabel helper keyed on the tip action.
• Add telemetry — cmd_j_palette_feature_tip_shown and cmd_j_palette_feature_tip_acknowledged events with source field, wired into the startup gate and modal dismiss paths.
• Rename Workspaces → Worktrees — updates copy throughout WorktreeJumpPalette, quick-actions.ts, palette-results.test.ts, and related test expectations.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.tsx`:
- Around line 7-8: Update the in-file comment in CmdJPaletteFeatureTipVisual
(around the top comment block) to replace "workspace" with "worktree" so it
reads "live worktree switcher" and otherwise maintain the existing note about
recent worktrees and typing behavior; locate the comment near the existing text
"// Why: the real palette lists recent worktrees on open; typing only narrows
the list. Mix done + running states so the tip reads like a live workspace
switcher." and change the final phrase to "live worktree switcher".

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 94877fd3-fdba-43c5-97c9-dbcfe7503886

📥 Commits

Reviewing files that changed from the base of the PR and between 4106cc4 and 1547475.

📒 Files selected for processing (19)

• src/main/startup/dev-education-suppression.test.ts
• src/renderer/src/App.tsx
• src/renderer/src/assets/main.css
• src/renderer/src/components/WorktreeJumpPalette.tsx
• src/renderer/src/components/cmd-j/palette-results.test.ts
• src/renderer/src/components/cmd-j/quick-actions.ts
• src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.test.tsx
• src/renderer/src/components/feature-tips/CmdJPaletteFeatureTipVisual.tsx
• src/renderer/src/components/feature-tips/CmdJPaletteTipDialog.test.tsx
• src/renderer/src/components/feature-tips/CmdJPaletteTipDialog.tsx
• src/renderer/src/components/feature-tips/FeatureTipActions.tsx
• src/renderer/src/components/feature-tips/FeatureTipsModal.tsx
• src/renderer/src/components/feature-tips/feature-tip-modal-state.test.ts
• src/renderer/src/components/feature-tips/feature-tip-startup-gate.test.ts
• src/renderer/src/components/feature-tips/feature-tip-telemetry.test.ts
• src/renderer/src/components/feature-tips/feature-tip-telemetry.ts
• src/shared/feature-tips.test.ts
• src/shared/feature-tips.ts
• src/shared/telemetry-events.ts

[pullfrog]

✅ No new issues found.

Reviewed changes — one commit since the prior review: fixes a visual glitch in the command palette feature tip animation where the loop reset briefly flashed the unfiltered worktree list before the closing fade completed.

• Add closing phase to animation cycle — freezes the final filtered state (query, worktrees, create-row) into a ClosingFrame snapshot before resetting, so the palette fades out with its last content intact rather than flashing back to the pre-search list.
• Hide palette during pressed phase — uses pointer-events-none invisible opacity-0 instead of just opacity-0, preventing an empty search shell from briefly appearing between animation cycles.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}