hermes-krates-connector/design/spotlight.md

Spotlight Feature

Purpose: Global search overlay that lets users find any Kubernetes object, existing krates, namespaces, or collection categories, and open specific views.

Trigger:

• Click on empty canvas.
• Type any printable key when no input is focused (pre‑seeds query).
• / key opens an empty spotlight.

Layout:

• Full‑screen dark backdrop rgba(7,9,13,.55) with backdrop‑filter: blur(2px).
• Centered panel (max 660 px, 93 % viewport width) with background rgba(16,20,28,.97), border 1px solid rgba(140,165,200,.26), border‑radius 14px.
• Input row (≈ 52 px high) containing:
  • Search glyph ⌕ (accent color).
  • Optional type‑filter pill.
  • Text input (font‑size 18 px, IBM Plex Sans).
  • Optional Tab‑ghost hint.
• Horizontal type chips row (scrollable on narrow screens) for all object kinds (pods, svc, deploy, secret, cm, sts, …).
• Results list (max‑height 48 vh, overflow‑auto) – each row shows:
  • Shape glyph (type‑specific).
  • Name.
  • Subtext type · ns/namespace.
  • CRD badge if applicable.
  • Type badge.
• View chips appear on the selected result only: ⌥L logs · ⌥S shell · ⌥D describe · ⌥Y yaml. Views are limited to object capabilities (e.g., logs & shell only for pods, deployments, daemonsets, statefulsets).
• Footer hint line.

Fuzzy Search Algorithm (used in the prototype):

• Score = character‑match score × 10 + type boost.
• Type boost values: crd 60, deployment 50, statefulset 48, service 46, daemonset 44, ingress 42, secret 24, configmap 22, pvc 18, pod 16.
• Character match: sequential chars, +3 for consecutive, +5 for word‑boundary start.
• Top 8 results displayed.

Tab Quick‑Filter:

• Typing a type alias (pod, svc, deploy, etc.) shows a ghost hint ⇥ Pods.
• Press Tab to lock filter as a pill; Backspace removes it.
• Tab also cycles through recently used type filters (most‑recent first).

Keyboard Shortcuts (Alt/Option required):

• Alt+L = open Logs view for selected result.
• Alt+S = open Shell view.
• Alt+D = open Describe view.
• Alt+Y = open YAML view.
• Enter = open default view (logs for pods, describe for workloads, yaml for config resources) and close spotlight.
• Esc = close spotlight; if a krate was summoned it is placed on canvas.
• ↑/↓ = navigate results.
• Tab = apply/cycle type filter.

Auto‑Close: after 500 ms of keyboard idle the spotlight auto‑closes and the camera flies to the newly created krate.