# ISIS v2 WS11-008: Global Command Palette and Quick-Action Workflows

## Scope

`WS11-008` adds a global command execution surface for high-velocity operators,
creators, and reviewers:

- searchable command palette (`Ctrl/Cmd+K`),
- cross-workspace quick actions,
- keyboard-driven command execution.

## Research and Existing Implementation Alignment

Implementation aligned with:

- ISIS keyboard/accessibility shell baseline:
  `apps/isis/web/src/components/AppLayout.tsx`
- in-repo command-palette patterns already proven in OSHUN:
  `apps/oshun/web/src/components/CommandPalette.tsx`,
  `apps/oshun/web/src/components/ShellLayout.tsx`

## Deliverables

1. Added reusable command palette component:

- `apps/isis/web/src/components/IsisCommandPalette.tsx`
- supports grouped commands (`Navigation`, `Context`, `Quick Actions`),
- supports query filtering across labels/descriptions/keywords,
- supports keyboard execution model (`ArrowUp/ArrowDown/Enter/Escape`),
- provides accessible dialog/listbox semantics and empty-state handling.

2. Integrated global command palette into ISIS shell (`AppLayout`):

- global toggle shortcut: `Ctrl/Cmd+K`,
- command palette + keyboard shortcuts guide coexistence controls,
- context-strip button to launch/close command palette.

3. Implemented command catalog and quick-action workflows:

- permission-aware navigation commands for all available routes,
- context switch commands (`Creator` / `Reviewer` / `Operator`),
- quick actions: focus primary search, refresh active workspace, open
  keyboard-shortcuts guide.

4. Added UI/UX styling for command palette:

- overlay, panel, search rail, grouped command list, selected-item states,
- responsive behavior for tablet/mobile viewport constraints.

5. Added focused command palette tests:

- `apps/isis/web/src/components/IsisCommandPalette.spec.tsx`
- updated `apps/isis/web/src/components/AppLayout.spec.tsx` with command-palette
  open and execute coverage.

## Verification Commands

```bash
pnpm --filter @isis/web exec vitest run src/components/IsisCommandPalette.spec.tsx src/components/AppLayout.spec.tsx src/components/CreativeWorkflowFrame.spec.tsx src/components/IsisLoadingState.spec.tsx src/components/IsisEmptyState.spec.tsx --reporter=dot
pnpm --filter @isis/web run typecheck
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
```

## Verification Notes

- Targeted command-palette and shell accessibility tests pass.
- Workspace typecheck remains red due pre-existing unrelated
  cross-package/rootDir typing failures in baseline repository state.
