Reach common actions with keyboard shortcuts

Purpose

Frequent console actions have consistent keyboard entry points for staff.

How It Works

A staff member invokes a common action from the keyboard. The frame handles search, Configuration and the assistant shortcuts. Navigation collapse has a separate handler supplied by the sidebar. Search authority determines whether the frame handles a search chord. Ordinary text entry keeps the slash when focus is in an editable control. The product should make the Configuration label as device-aware as the search label.

Relationships

Quick Search belongs to Queries; the shell provides its keyboard entry.
Page layout responds when navigation is collapsed with a shortcut.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes: Common actions remain reachable without pointer navigation.Search shortcuts respect the person’s search authority.
Surfaces: console

Controls

18 controls apply, from the corpus control catalogue.

TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-DAT-001 TC-DAT-003 TC-LOG-005 TC-PI-001 TC-PI-003 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

Key	Checked at	Scope
`console.quick-search`	console	tenant
`platform.quick-search.read`	api	tenant

Business Rules

7 rules, 4 to be proved before approval. A rule's product intent is derived from its origin: 0 confirmed by a product decision, the rest inheriting this capability's proposed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	The console handles a recognized search command only when search is permitted and otherwise leaves the event to the browser. no proof recorded yet	permission	console	observed react-console:components/console/console-provider.tsx:ConsoleProvider; lib/quick-search/shortcut.ts:isQuickSearchShortcut
`02`must prove Proposed	Quick Search does not recognize bare K, Shift+K, Alt+K or a different modified letter as its search chord. no proof recorded yet	validation	console	test react-console:lib/quick-search/__tests__/shortcut.test.ts#leaves a bare K alone, so typing a name never opens a dialog
`03`must prove Proposed	An unmodified slash opens permitted Quick Search except when focus is in an input, textarea, select or editable element. no proof recorded yet	policy	console	observed react-console:components/console/console-provider.tsx:ConsoleProvider
`04` Proposed	Command or Ctrl with comma navigates to Configuration’s first destination, while the same modifier with J toggles the assistant panel.	policy	console	observed react-console:components/console/console-provider.tsx:ConsoleProvider
`05` Proposed	Command or Ctrl with B toggles navigation between expanded and collapsed states.	policy	console	test react-console:e2e/layout/page-layouts.spec.ts#the keyboard shortcut collapses it too
`06` Proposed	Quick Search labels its shortcut for Apple or other hardware, while Configuration’s menu label always uses the Command symbol.	policy	console	observed react-console:lib/quick-search/shortcut.ts:quickSearchShortcutLabel; components/console/app-sidebar.tsx:AppSidebar
`07`must prove Proposed	The search-command matcher accepts Command with K or Ctrl with K on any device, including uppercase K. no proof recorded yet	validation	console	test react-console:lib/quick-search/__tests__/shortcut.test.ts#accepts Cmd+K and Ctrl+K, whatever the machine is; lib/quick-search/__tests__/shortcut.test.ts#accepts an upper-case K, which is what some layouts report

Scenarios

Id	Given	When	Then	Provenance
`01`	Search is not permitted for the current person.	They press Ctrl+K.	The frame leaves the chord unhandled and opens no search dialog.	observed react-console:components/console/console-provider.tsx:ConsoleProvider
`02`	Focus is in a contact-name input.	The person enters a slash.	The field receives the character without opening search.	observed react-console:components/console/console-provider.tsx:isTypingTarget

Planning

Reach common actions with keyboard shortcuts ​

Purpose ​

How It Works ​

Relationships ​