settings-basic.yaml

version: 2
name: settings-basic
tier: manual
description: Settings navigation smoke — open Settings via gear icon, navigate all 9 sections (v0.12.119+ redesign)
app: com.omi.computer-macos
covers:
  - desktop/macos/Desktop/Sources/MainWindow/Pages/Settings/HiddenSettingsSurfacesPolicy.swift
  - desktop/macos/Desktop/Sources/MainWindow/Pages/Settings/Sections/SettingsContentView+DeveloperKeys.swift
  - desktop/macos/Desktop/Sources/MainWindow/Pages/SettingsPage.swift
  # `SettingsPage` mounts the shell-drawn confirmation on Advanced → Reset Onboarding, which S9b
  # opens and cancels. A system `.alert` dimmed the *window* here, and this window is a transparent
  # rectangle larger than the panels inside it.
  - desktop/macos/Desktop/Sources/MainWindow/ShellConfirmationDialog.swift
  - desktop/macos/Desktop/Sources/Services/APIClient/APIClient+Settings.swift
  - desktop/macos/Desktop/Sources/MainWindow/Pages/Settings/Components/AppRuleEditorView.swift
  - desktop/macos/Desktop/Sources/MainWindow/Pages/Settings/Sections/SettingsContentView+General.swift
  - desktop/macos/Desktop/Sources/MainWindow/SettingsSidebar.swift
  - desktop/macos/Desktop/Sources/MainWindow/Pages/Settings/Sections/SettingsContentView+Transcription.swift
  - desktop/macos/Desktop/Sources/MainWindow/Pages/Settings/Sections/MicrophonePickerCard.swift
preconditions:
  - auth_ready

steps:
  - id: S1
    name: Open Settings via gear icon
    do: "Click the Settings gear icon (label 'gearshape') in the top-right of the nav bar. Verify Settings page opens showing all 9 section names."
    expect:
      interactive_count: { min: 9 }
      text_visible:
        - Settings
        - General

  - id: S2
    name: Navigate to General section
    do: "Click 'General' in the Settings section list. Verify General settings load with app preferences and startup behavior options."
    expect:
      text_visible:
        - General

  - id: S3
    name: Navigate to Account & Plan section
    do: "Click 'Account & Plan' in the Settings section list. Verify account information shows user name, email, Sign Out and Delete buttons. Plan and Usage section should show current subscription."
    expect:
      text_visible:
        - Account & Plan

  - id: S4
    name: Navigate to Transcription section
    do: "Click 'Transcription' in the Settings section list. Verify Language Mode card appears with 'Auto-Detect (Multi-Language)' and 'Single Language (Better Accuracy)' options. Voice Assistant Languages and Custom Vocabulary sections should be visible."
    expect:
      text_visible:
        - Transcription
        - Language Mode

  - id: S5
    name: Navigate to Floating Bar section
    do: "Click 'Floating Bar' in the Settings section list. Verify Floating Bar settings load with toggles for show/hide, background style, draggable, typed questions, screen sharing, and voice selection."
    expect:
      text_visible:
        - Floating Bar

  - id: S6
    name: Navigate to Notifications & Privacy section
    do: "Click 'Notifications & Privacy' in the Settings section list. Verify notification preferences appear with frequency slider, focus/task/insight/memory notification toggles, and Daily Summary settings."
    expect:
      text_visible:
        - Notifications & Privacy

  - id: S7
    name: Navigate to Rewind section
    do: "Click 'Rewind' in the Settings section list. Verify Rewind settings show storage info (frames count, size) and Excluded Apps list with Reset to Defaults button."
    expect:
      text_visible:
        - Rewind
        - Storage

  - id: S8
    name: Navigate to Shortcuts section
    do: "Click 'Shortcuts' in the Settings section list. Verify shortcut settings show Open Omi Shortcut options, Push to Talk key options, PTT microphone selector, and toggle options."
    expect:
      text_visible:
        - Shortcuts

  - id: S9
    name: Navigate to Advanced section
    do: "Click 'Advanced' in the Settings section list. Verify Advanced settings show AI Setup section with Voice Model and AI Provider dropdowns, Workspace browser, Browser Extension toggle, and Dev Mode toggle."
    expect:
      text_visible:
        - Advanced
        - AI Setup

  - id: S9b
    name: A destructive confirmation dims the shell, not the desktop
    # Open and cancel only — confirming restarts the app. What is being checked is where the dim
    # lands: a SwiftUI `.alert` is presented by AppKit against the host window and dims to that
    # window's frame, which on this shell paints a rounded rectangle, window shadow and all, onto the
    # wallpaper between and around the panels. The shell draws its own instead.
    do: "In Advanced, press 'Reset Onboarding'. Verify a confirmation card titled 'Reset Onboarding?' appears with a sentence naming what it does, a 'Reset & Restart' button, and a way out. Verify the dim behind it stops at the settings panel's own rounded edges — the wallpaper around and between the panels, and the drag band above the top bar, must stay undimmed. Then press Escape, and reopen it and click outside the card: both must cancel. Never press 'Reset & Restart'."
    expect:
      interactive_count: { min: 2 }
      text_visible:
        - Reset Onboarding?

  - id: S10
    name: Navigate to About section
    do: "Click 'About' in the Settings section list. Verify About section shows app name, version info, links (What's New, Visit Website, Help Center, Privacy Policy, Terms of Service), Software Updates with Check Now button, and Update Channel."
    expect:
      text_visible:
        - About

  - id: S11
    name: Return to app via Back button
    do: "Click the Back button to return from Settings. Verify the previous tab loads with the top nav bar visible."
    expect:
      text_visible:
        - Home