Skip to content

Standardize permission-action vocabulary in the setup wizard #1181

Description

@malpern

Current behavior

The Accessibility and Input Monitoring pages use Turn On, Add in Settings, and Open Settings Manually for related permission actions. The underlying flows are now distinct and reliable, but the labels do not consistently explain which action will occur.

Narrow scope

Standardize copy on the two permission pages without changing permission detection, polling, deep links, drag-to-authorize behavior, or installer execution:

  • Turn On — KeyPath will ask macOS for permission automatically.
  • Add in Settings — the app or engine must be added manually or through the drag-to-authorize flow.
  • Open Settings — navigation only; no automatic request or add operation.

Keep helper and DriverKit terminology out of this slice because those actions have different semantics.

Acceptance criteria

  • Equivalent actions use equivalent labels on Accessibility and Input Monitoring pages.
  • A label never promises an automatic action when the button only opens System Settings.
  • Existing accessibility identifiers remain stable.
  • Focused wizard tests or snapshots pin the copy/state mapping.
  • No installer, permission-oracle, or runtime behavior changes.

Priority

Valid polish, but not a prerequisite for the 1.1 dependency graph. Keep on hold unless clean-account testing shows the wording causes a real setup failure.

Split from #934.

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent-okImplementation can be agent-led once the issue is current and not on holddevuxenhancementNew feature or requestkeypathScope: KeyPath product, app, installer, or repository workon-holdValid work intentionally deferred pending evidence, dependency, or product decisionpost-releasePost-public-1.0 work; not required before stable 1.0 releasetier-3

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions