[oddurs]

Carries over oddurs/common-command#10, which was closed when the app moved here. The diff is the same, applied under apps/command/. It touches only the command area, not CommonKit or shared/.

Problem

A result could be opened, or revealed with ⌘↩, and nothing else. Finder and Spotlight let you preview a file, copy its path, or quit the app you just found.

Approach

• ItemCommand.commands(for:isRunning:) in CommandKit (tested) decides what each result offers:
  • files and apps: Open, Show in Finder, Quick Look, Copy Path, plus Hide and Quit when the app is running
  • links and panes: Open and Copy
  • a calculation: Copy only
• ⌘K pops up a native NSMenu under the field for the selected result. A right-click shows the same commands through SwiftUI's contextMenu, which is also an NSMenu. Menu items carry their symbols and the panel's own keys.
• ⌘Y shows Quick Look beside the panel. It is a QLPreviewView in a non-activating panel that can never become key, so the keyboard stays in the search field:
  • ↑ ↓ move the selection and the preview follows
  • ⎋ closes the preview first
  • the app you were in stays active throughout
• ⌘⇧C copies the path, the link, or the result. A path is also copied as a file, so pasting into Finder or Mail attaches it.

Look at sceptically

• The first approach failed live. The system QLPreviewPanel needs the app to be active before it can take the keyboard, and the launcher never activates. The preview opened while the previous app kept focus, the launcher closed itself, and keystrokes went to the other app. The in-panel preview above replaces it. The replacement has not been seen on screen yet.
• QLPreviewView renders through Quick Look's service, so it can't be checked offscreen. The ⌘K and right-click menus are NSMenus, which the snapshot can't draw either, so there are no screenshots. The result list itself is unchanged.
• The preview sits to the right of the panel, or to the left when the screen has no room on the right. It is at least 380 pt tall and follows the panel as it resizes.
• The ⌘K menu opens at a fixed point under the field, not beside the selected row. In the live test it appeared and listed Open ↩, Show in Finder ⌘↩, Quick Look ⌘Y, and Copy Path ⇧⌘C.

Checklist

• scripts/task check command passes locally: lint, 112 tests, universal build
• Tests for which commands each result offers
• Under ## [Unreleased] in apps/command/CHANGELOG.md
• Screenshots: not possible offscreen (system menu and Quick Look). The ⌘Y preview still needs a live check before the next release.