feat(app): add global shortcut help dialog

packages/app/src/keyboard/actions.ts

@@ -18,6 +18,7 @@ export type KeyboardActionId =
   | "sidebar.toggle.right"
   | "sidebar.navigate.shortcut"
   | "command-center.toggle"
+  | "shortcuts.dialog.toggle"
   | "message-input.action";
 
 export type KeyboardShortcutPayload =

packages/app/src/keyboard/keyboard-shortcuts.test.ts

@@ -31,6 +31,32 @@ function shortcutContext(
 }
 
 describe("keyboard-shortcuts", () => {
+  it("matches question-mark shortcut to toggle the shortcuts dialog", () => {
+    const match = resolveKeyboardShortcut({
+      event: keyboardEvent({
+        key: "?",
+        code: "Slash",
+        shiftKey: true,
+      }),
+      context: shortcutContext({ focusScope: "other" }),
+    });
+
+    expect(match?.action).toBe("shortcuts.dialog.toggle");
+  });
+
+  it("does not match question-mark shortcut inside editable scopes", () => {
+    const match = resolveKeyboardShortcut({
+      event: keyboardEvent({
+        key: "?",
+        code: "Slash",
+        shiftKey: true,
+      }),
+      context: shortcutContext({ focusScope: "message-input" }),
+    });
+
+    expect(match).toBeNull();
+  });
+
   it("matches Cmd+B sidebar toggle on macOS", () => {
     const match = resolveKeyboardShortcut({
       event: keyboardEvent({
@@ -97,6 +123,31 @@ describe("keyboard-shortcuts", () => {
     expect(match).toBeNull();
   });
 
+  it("keeps space typing available in message input", () => {
+    const match = resolveKeyboardShortcut({
+      event: keyboardEvent({
+        key: " ",
+        code: "Space",
+      }),
+      context: shortcutContext({ focusScope: "message-input" }),
+    });
+
+    expect(match).toBeNull();
+  });
+
+  it("routes space to voice mute toggle outside editable scopes", () => {
+    const match = resolveKeyboardShortcut({
+      event: keyboardEvent({
+        key: " ",
+        code: "Space",
+      }),
+      context: shortcutContext({ focusScope: "other" }),
+    });
+
+    expect(match?.action).toBe("message-input.action");
+    expect(match?.payload).toEqual({ kind: "voice-mute-toggle" });
+  });
+
   it("parses Alt+digit sidebar shortcut payload", () => {
     const match = resolveKeyboardShortcut({
       event: keyboardEvent({

packages/app/src/keyboard/keyboard-shortcuts.ts

@@ -55,6 +55,17 @@ function hasDigit(event: KeyboardEvent): boolean {
   return parseDigit(event) !== null;
 }
 
+function isQuestionMarkShortcut(event: KeyboardEvent): boolean {
+  return (
+    !event.metaKey &&
+    !event.ctrlKey &&
+    !event.altKey &&
+    event.shiftKey &&
+    !event.repeat &&
+    (event.key === "?" || event.code === "Slash")
+  );
+}
+
 function withMessageInputAction(
   kind: MessageInputKeyboardActionKind
 ): (event: KeyboardEvent) => KeyboardShortcutPayload {
@@ -92,6 +103,12 @@ const SHORTCUT_BINDINGS: readonly KeyboardShortcutBinding[] = [
       (event.code === "KeyK" || event.key.toLowerCase() === "k"),
     when: () => true,
   },
+  {
+    id: "shortcuts-dialog-toggle-question-mark",
+    action: "shortcuts.dialog.toggle",
+    matches: isQuestionMarkShortcut,
+    when: (context) => context.focusScope === "other",
+  },
   {
     id: "sidebar-toggle-left-mac-cmd-b",
     action: "sidebar.toggle.left",
@@ -179,7 +196,7 @@ const SHORTCUT_BINDINGS: readonly KeyboardShortcutBinding[] = [
       !event.repeat,
     payload: withMessageInputAction("voice-mute-toggle"),
     when: (context) =>
-      !context.commandCenterOpen && context.focusScope !== "terminal",
+      !context.commandCenterOpen && context.focusScope === "other",
   },
   {
     id: "sidebar-shortcut-alt-digit",