Feat: update complete onboarding helper

[YellowSnnowmann]

Summary

• completeOnboardingIfVisible now delegates unconditionally to walkOnboarding instead of gating on a pre-check that could fire before the overlay rendered.
• walkOnboarding already polls up to 8 × 400 ms for the overlay, so the extra guard was redundant and introduced a race window.
• conversations-web-channel-flow spec updated to use completeOnboardingIfVisible (matching the rest of the suite and removing the direct walkOnboarding call).
• e2e/Dockerfile gains clang libclang-dev cmake, required by whisper-rs-sys (bindgen + CMake build of whisper.cpp) on the Linux E2E runner.

Problem

• completeOnboardingIfVisible called onboardingOverlayLikelyVisible() synchronously before the overlay had time to render after auth. If the check ran too early it returned false and the helper silently skipped onboarding, leaving the app stuck behind the overlay for the rest of the spec.
• The conversations spec called walkOnboarding directly rather than the shared helper, diverging from the pattern the rest of the suite uses.
• The Linux E2E Docker image was missing clang, libclang-dev, and cmake, causing whisper-rs-sys to fail at the bindgen and CMake stages during test:e2e:build.

Solution

• Removed the if (await onboardingOverlayLikelyVisible()) guard from completeOnboardingIfVisible; the function now calls walkOnboarding directly.
• walkOnboarding's internal polling loop handles the timing safely — it waits for the overlay and exits cleanly when it never appears (already on Home), so no extra guard is needed.
• Updated the conversations spec import and call site to use completeOnboardingIfVisible.
• Added clang libclang-dev cmake to the apt-get install block in e2e/Dockerfile so the image can build whisper-rs-sys cleanly on both x86-64 and aarch64 Linux.

Submission Checklist

• Unit tests — N/A; change is E2E harness only, no unit-testable logic added.
• E2E / integration — Directly modifies E2E helpers and specs; the fix is verified by the specs that were previously flaking due to the race.
• Doc comments — Updated JSDoc on completeOnboardingIfVisible to describe delegation and polling behaviour.
• Inline comments — Onboarding section comment updated to document the current 5-step flow (Welcome → Local AI → Screen & Accessibility → Tools → Skills).

Impact

• Desktop E2E only. No runtime, sidecar, or product code changed.
• Removes a flake class from all specs that call completeOnboardingIfVisible after auth.
• Docker image rebuild required to pick up the new system dependencies (clang libclang-dev cmake).

Related

• Issue(s): [Feature] E2E: Update completeOnboardingIfVisible() across specs #201

Summary by CodeRabbit

Release Notes

This release contains internal testing and infrastructure improvements with no user-facing changes.

• Tests

  • Updated end-to-end test helpers and specifications for onboarding flow execution.

• Chores

  • Enhanced E2E Docker build environment with additional system dependencies.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2b496447-9ee7-4d07-9693-0568ce3d61db

📥 Commits

Reviewing files that changed from the base of the PR and between b7b3d62 and 13637d9.

📒 Files selected for processing (3)

• app/test/e2e/helpers/shared-flows.ts
• app/test/e2e/specs/conversations-web-channel-flow.spec.ts
• e2e/Dockerfile

---

📝 Walkthrough

Walkthrough

Modified the E2E onboarding helper to unconditionally delegate to walkOnboarding instead of pre-checking visibility, updated test specs to use the revised helper, and added system build dependencies (clang, libclang-dev, cmake) to the E2E Docker image.

Changes

Cohort / File(s)	Summary
E2E Onboarding Flow Helpers and Tests app/test/e2e/helpers/shared-flows.ts, app/test/e2e/specs/conversations-web-channel-flow.spec.ts	Simplified completeOnboardingIfVisible to always delegate to walkOnboarding (which internally polls for overlay visibility); removed pre-check conditional. Updated test spec to call completeOnboardingIfVisible instead of walkOnboarding directly.
Docker Build Configuration e2e/Dockerfile	Added system packages clang, libclang-dev, and cmake to apt-get install layer for E2E environment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

• [Feature] E2E: Update completeOnboardingIfVisible() across specs #201: Main change directly addresses updating completeOnboardingIfVisible helper and spec usage to align with current onboarding flow.
• [Feature] Fix onboarding bugs and update E2E tests for Login → Onboarding → Home flow #189: Change to always delegate onboarding handling via completeOnboardingIfVisible across E2E specs directly matches this issue's explicit task.

Possibly related PRs

• enhance(onboarding): standardize Next/Continue button across all steps #277: Both PRs modify E2E onboarding flow helpers; this PR simplifies completeOnboardingIfVisible delegation while the retrieved PR adjusts walkOnboarding button label handling.
• fix(e2e): overhaul all E2E specs for Linux tauri-driver #180: Both PRs modify the shared onboarding control flow in shared-flows helpers that the retrieved PR originally introduced.
• feat(e2e): move CI to Linux by default, keep macOS optional #141: Both PRs refactor E2E onboarding flow logic and test helpers to make onboarding conditional and update how specs invoke it.

Suggested reviewers

• senamakel

Poem

🐰 A helper now trusts its delegate,
No pre-checks, just graceful elate!
One function calls another with care,
While Docker prepares the build's layer,
Simpler flows—oh, what a state! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Feat: update complete onboarding helper' directly corresponds to the primary change: refactoring the completeOnboardingIfVisible helper function to remove synchronous pre-checks and always delegate to walkOnboarding.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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