Summary

Every interactive control in Settings and the menu-bar quick-controls panel now has a .help("...") tooltip explaining what it does, with the trade-off named when there is one (latency vs. context, CPU vs. snappiness, etc.). Self-explanatory buttons (Open Folder, Quit, Open Welcome Guide) are intentionally left untipped to avoid noise. The redundant description paragraphs above the Languages, Custom Rules, and Suggestion Delay controls have been removed, since the new tooltips carry their copy and the body text was hurting density.

Validation

xcodebuild -project Cotabby.xcodeproj -scheme Cotabby -destination 'platform=macOS' build
# ** BUILD SUCCEEDED **

swiftlint lint --quiet
# 3 pre-existing warnings in SuggestionCoordinator+Input.swift and FocusTracker.swift;
# 0 violations in any file touched by this PR.

awk 'length > 140' on the four edited files
# no lines exceed the 140-char line-length limit

Not verified in the running app: I did not manually hover every control to read the rendered tooltip popovers, since tooltip strings are inert at compile time and the failure mode for a typo is just bad copy on hover, not a crash.

Linked issues

No tracked issue. Direct request.

Risk / rollout notes

• Tooltips are additive .help(...) calls on existing controls. No behavior changes, no settings migrations, no pbxproj edits.
• One real semantic change: the Use LM Studio button now picks its tooltip based on whether ~/.lmstudio/models exists. Reuses the same FileManager.default.fileExists check that already drives .disabled(...), so no extra IO. Worst case if that check ever drifts, the tooltip wording disagrees with the disabled state, which is purely cosmetic.
• Existing tooltip copy on Accept Punctuation With Word and Fast Mode was rewritten for consistent voice (no em dashes, lead with the verb / outcome). The Fast Mode change appears in both Settings and the menu-bar panel so they stay in sync.
• Three caption-style Text(...) rows were removed (LanguageTagsEditor line 43, CustomRulesEditor line 44, SettingsView Performance section). If you'd rather keep that copy visible without hovering, easy to put back.

Greptile Summary

This PR adds .help(...) tooltip strings to every interactive control in SettingsView, MenuBarView, CustomRulesEditor, and LanguageTagsEditor, and removes three now-redundant caption Text rows whose copy has been folded into the new tooltips.

• Tooltips are purely additive .help() modifiers; no logic, state, or layout is changed beyond extracting lmStudioAvailable as a local let so the existing FileManager.default.fileExists check is shared between .disabled() and the new conditional .help() (net I/O is unchanged).
• Three caption Text views (LanguageTagsEditor, CustomRulesEditor, SettingsView Performance section) are removed; their content is preserved in the tooltip copy, at the cost of requiring a hover to read it.

Confidence Score: 5/5

Safe to merge; all changes are additive tooltip strings with no behavioral side effects.

Every change is a .help(...) string or a cosmetic copy tweak. The one structural change — extracting lmStudioAvailable — is a clean refactor that reduces the number of fileExists calls from one-per-modifier to one-per-render. The three removed caption Text views are matched by equivalent tooltip copy, so no information is lost. No logic, state, navigation, or persistence is altered.

No files require special attention.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User hovers control] --> B{Has .help modifier?}
    B -- Yes --> C[Show tooltip popover]
    B -- No --> D[No tooltip shown]

    subgraph LM Studio Path
        E[Render LabeledContent Folder]
        E --> F["let lmStudioAvailable = FileManager.fileExists(...)"]
        F --> G[".disabled(!lmStudioAvailable)"]
        F --> H{lmStudioAvailable?}
        H -- true --> I["tooltip: Point Cotabby at LM Studio..."]
        H -- false --> J["tooltip: Install LM Studio first..."]
    end

_{Reviews (1): Last reviewed commit: "Mirror the new Settings tooltips on the ..." | Re-trigger Greptile}

Greptile also left 1 inline comment on this PR.