npm - @skyhook-io/radar-app - Versions diffs - 0.2.2 → 0.3.1 - Mend

@skyhook-io/radar-app 0.2.2 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (177) hide show

package/README.md +7 -1
package/package.json +33 -25
package/src/App.tsx +1449 -382
package/src/RadarApp.tsx +132 -19
package/src/api/apiResources.ts +1 -1
package/src/api/client.argoResourceSync.test.ts +69 -0
package/src/api/client.delta.test.ts +89 -0
package/src/api/client.deltaSync.test.ts +216 -0
package/src/api/client.metrics.test.ts +106 -0
package/src/api/client.rightsizing.test.ts +32 -0
package/src/api/client.ts +2730 -271
package/src/api/client.yaml.test.ts +45 -0
package/src/api/diagnose.ts +289 -0
package/src/api/quotas.ts +16 -0
package/src/api/rbac.ts +57 -0
package/src/api/timelineSource.test.ts +217 -0
package/src/api/timelineSource.ts +582 -0
package/src/components/ConnectionErrorView.tsx +186 -70
package/src/components/ContextSwitcher.tsx +63 -18
package/src/components/DebugOverlay.tsx +5 -3
package/src/components/NamespaceSwitcher.tsx +41 -0
package/src/components/UserMenu.tsx +69 -21
package/src/components/applications/ApplicationsView.tsx +936 -0
package/src/components/audit/AuditSettingsDialog.tsx +79 -17
package/src/components/audit/AuditView.tsx +65 -62
package/src/components/compare/CompareViewRoute.tsx +124 -0
package/src/components/compare/useCompareCandidates.ts +27 -0
package/src/components/compare/useCompareLauncher.tsx +79 -0
package/src/components/cost/ApplicationCostTab.test.ts +204 -0
package/src/components/cost/ApplicationCostTab.tsx +571 -0
package/src/components/cost/CostTrendChart.tsx +106 -75
package/src/components/cost/CostView.test.ts +12 -0
package/src/components/cost/CostView.tsx +507 -223
package/src/components/cost/CostViewTabs.test.tsx +21 -0
package/src/components/cost/CostViewTabs.tsx +40 -0
package/src/components/cost/CurrentAllocationUse.test.ts +21 -0
package/src/components/cost/CurrentAllocationUse.tsx +126 -0
package/src/components/cost/WorkloadCostTab.test.ts +153 -0
package/src/components/cost/WorkloadCostTab.tsx +372 -0
package/src/components/cost/cloud-console.test.ts +39 -0
package/src/components/cost/cloud-console.ts +81 -0
package/src/components/cost/errors.ts +8 -0
package/src/components/cost/format.test.ts +27 -0
package/src/components/cost/format.ts +46 -0
package/src/components/cost/kinds.ts +5 -0
package/src/components/curl/ServiceCurlButton.tsx +445 -0
package/src/components/diagnose/AISettings.tsx +147 -0
package/src/components/diagnose/DiagnoseContext.tsx +495 -0
package/src/components/diagnose/DiagnoseSurface.tsx +394 -0
package/src/components/diagnose/Home.tsx +163 -0
package/src/components/diagnose/InvestigationView.tsx +622 -0
package/src/components/diagnose/LocalDiagnoseAction.tsx +162 -0
package/src/components/diagnose/launch.ts +65 -0
package/src/components/diagnose/parts.tsx +1756 -0
package/src/components/dock/BottomDock.tsx +2 -3
package/src/components/dock/DockContext.tsx +1 -0
package/src/components/dock/TerminalTab.tsx +1 -1
package/src/components/dock/WorkloadLogsTab.tsx +21 -5
package/src/components/dock/index.ts +1 -1
package/src/components/execution/BatchExecutionView.test.ts +170 -0
package/src/components/execution/BatchExecutionView.tsx +1329 -0
package/src/components/execution/batch-run-actions.test.ts +48 -0
package/src/components/execution/batch-run-actions.ts +24 -0
package/src/components/execution/batch-timeline.test.ts +57 -0
package/src/components/execution/batch-timeline.ts +46 -0
package/src/components/execution/execution-definition.test.ts +208 -0
package/src/components/execution/execution-definition.ts +245 -0
package/src/components/gitops/ArgoResourceDiffLoader.tsx +23 -0
package/src/components/gitops/GitOpsView.tsx +1042 -0
package/src/components/gitops/RevisionMetaChip.tsx +63 -0
package/src/components/helm/ChartBrowser.tsx +87 -31
package/src/components/helm/HelmCompareRoute.tsx +1341 -0
package/src/components/helm/HelmReleaseDrawer.test.ts +17 -0
package/src/components/helm/HelmReleaseDrawer.tsx +1073 -102
package/src/components/helm/HelmView.tsx +237 -96
package/src/components/helm/InstallWizard.tsx +94 -38
package/src/components/helm/ManifestDiffViewer.tsx +8 -27
package/src/components/helm/OwnedResources.tsx +34 -59
package/src/components/helm/RevisionHistory.tsx +52 -3
package/src/components/helm/RoleGatedPanel.tsx +3 -3
package/src/components/helm/TrackChartSourceDialog.tsx +185 -0
package/src/components/helm/ValuesDiffPreview.tsx +17 -7
package/src/components/helm/ValuesViewer.tsx +49 -53
package/src/components/helm/helm-utils.ts +4 -0
package/src/components/home/ActivitySummary.tsx +4 -1
package/src/components/home/ClusterHealthCard.tsx +56 -42
package/src/components/home/CostCard.tsx +21 -36
package/src/components/home/GitOpsControllersCard.tsx +110 -0
package/src/components/home/HelmSummary.tsx +3 -1
package/src/components/home/HomeView.tsx +339 -105
package/src/components/home/MCPSetupDialog.tsx +29 -87
package/src/components/home/TrafficSummary.tsx +2 -2
package/src/components/home/mcpToolCatalog.ts +333 -0
package/src/components/issues/IssuesPane.tsx +151 -0
package/src/components/logs/LogsViewer.tsx +4 -1
package/src/components/logs/ScheduledWorkloadLogsViewer.tsx +135 -0
package/src/components/logs/WorkloadLogsViewer.tsx +4 -1
package/src/components/nav/PrimaryNavRail.tsx +285 -0
package/src/components/portforward/PortForwardButton.tsx +118 -47
package/src/components/portforward/PortForwardManager.tsx +253 -131
package/src/components/resource/HPACharts.tsx +237 -0
package/src/components/resource/PVCUsageBar.tsx +59 -0
package/src/components/resource/PrometheusCharts.tsx +160 -584
package/src/components/resource/PrometheusChartsGrid.tsx +270 -0
package/src/components/resource/RestartChart.tsx +133 -0
package/src/components/resource/RightsizingStrip.test.ts +109 -0
package/src/components/resource/RightsizingStrip.tsx +363 -0
package/src/components/resource-drawer/ResourceDrawer.tsx +3 -1
package/src/components/resources/CompositeRenderer.tsx +101 -0
package/src/components/resources/ImageFilesystemModal.tsx +19 -12
package/src/components/resources/PodFilesystemModal.tsx +6 -5
package/src/components/resources/ResourceDetailDrawer.tsx +13 -3
package/src/components/resources/ResourcesView.tsx +194 -17
package/src/components/resources/renderers/CronWorkflowRenderer.tsx +1 -0
package/src/components/resources/renderers/HPARenderer.tsx +20 -1
package/src/components/resources/renderers/NamespaceRenderer.tsx +31 -0
package/src/components/resources/renderers/NodeRenderer.tsx +10 -4
package/src/components/resources/renderers/PVCRenderer.tsx +19 -1
package/src/components/resources/renderers/PodRenderer.tsx +30 -6
package/src/components/resources/renderers/RoleBindingRenderer.tsx +45 -1
package/src/components/resources/renderers/RoleRenderer.tsx +27 -1
package/src/components/resources/renderers/ServiceAccountRenderer.tsx +28 -1
package/src/components/resources/renderers/ServiceRenderer.tsx +81 -8
package/src/components/resources/renderers/WorkloadRenderer.tsx +51 -4
package/src/components/resources/renderers/index.ts +2 -0
package/src/components/resources/resource-utils.ts +2 -1
package/src/components/rightsizing/RightsizingScanView.tsx +938 -0
package/src/components/rightsizing/copy.test.ts +56 -0
package/src/components/rightsizing/model.test.ts +227 -0
package/src/components/rightsizing/model.ts +158 -0
package/src/components/rightsizing/presentation.test.ts +104 -0
package/src/components/rightsizing/presentation.ts +94 -0
package/src/components/settings/MyPermissionsDialog.tsx +241 -0
package/src/components/settings/SettingsDialog.tsx +1505 -165
package/src/components/shared/CreateResourceDialog.tsx +9 -2
package/src/components/shared/LargeClusterNamespacePicker.tsx +3 -3
package/src/components/timeline/LocalTimelineScrubber.tsx +212 -0
package/src/components/timeline/RetainedTimelineScrubber.tsx +311 -0
package/src/components/timeline/TimelineList.tsx +86 -13
package/src/components/timeline/TimelineSwimlanes.tsx +9 -1299
package/src/components/timeline/TimelineView.tsx +873 -24
package/src/components/timeline/TimelineView.urlparams.test.ts +335 -0
package/src/components/traffic/TrafficFilterSidebar.tsx +10 -45
package/src/components/traffic/TrafficFlowList.tsx +29 -15
package/src/components/traffic/TrafficGraph.tsx +42 -24
package/src/components/traffic/TrafficView.tsx +32 -19
package/src/components/ui/CommandPalette.tsx +8 -215
package/src/components/ui/DiagnosticsOverlay.tsx +219 -9
package/src/components/ui/Markdown.tsx +3 -3
package/src/components/ui/Omnibar.tsx +602 -0
package/src/components/ui/RadarOmnibar.tsx +52 -0
package/src/components/ui/SearchSyntaxHelp.tsx +89 -0
package/src/components/ui/ShortcutHelpOverlay.tsx +3 -2
package/src/components/ui/UpdateNotification.tsx +48 -36
package/src/components/ui/command-items.ts +178 -0
package/src/components/workload/WorkloadView.tsx +1342 -158
package/src/context/ConnectionContext.tsx +146 -21
package/src/context/DiagnoseCustomization.tsx +93 -0
package/src/context/NavCustomization.tsx +75 -0
package/src/context/TimelineSource.tsx +50 -0
package/src/contexts/CapabilitiesContext.tsx +32 -8
package/src/filter/FilterLocationBridge.tsx +30 -0
package/src/hooks/useClusterLoadState.ts +73 -0
package/src/hooks/useDocumentTitle.ts +25 -0
package/src/hooks/useEventSource.ts +6 -0
package/src/hooks/useKeyboardShortcuts.tsx +1 -0
package/src/hooks/useMediaQuery.ts +21 -0
package/src/hooks/useNavRailPinned.ts +46 -0
package/src/hooks/useRecentResources.ts +49 -0
package/src/index.css +162 -1
package/src/index.ts +73 -1
package/src/main.tsx +7 -5
package/src/types/clusterLoadState.ts +33 -0
package/src/types.ts +2 -0
package/src/utils/auditBadges.ts +53 -0
package/src/utils/navigation.ts +64 -1
package/src/components/ui/NamespaceSelector.tsx +0 -436

package/src/components/ui/SearchSyntaxHelp.tsx ADDED Viewed

@@ -0,0 +1,89 @@
+import { useState, useRef, useEffect, useCallback } from 'react'
+import { createPortal } from 'react-dom'
+import { HelpCircle } from 'lucide-react'
+import { clsx } from 'clsx'
+// The query operators recognized by the search engine (internal/search/parse.go).
+const OPERATORS: { syntax: string; desc: string }[] = [
+  { syntax: 'ns:prod', desc: 'filter by namespace' },
+  { syntax: 'kind:Deployment', desc: 'filter by resource kind' },
+  { syntax: 'label:app=api', desc: 'filter by label' },
+  { syntax: 'image:nginx', desc: 'match container image' },
+  { syntax: 'redis cache', desc: 'multiple terms — all must match' },
+]
+// A "?" affordance that reveals the search query syntax on HOVER (a transient
+// reference tooltip, not a second click-to-open panel stacked over the results).
+// Self-contained + portaled to <body> so the header's stacking context can't
+// trap it; a short close grace lets the pointer travel onto the card.
+export function SearchSyntaxHelp() {
+  const [open, setOpen] = useState(false)
+  const btnRef = useRef<HTMLButtonElement>(null)
+  const popRef = useRef<HTMLDivElement>(null)
+  const closeTimer = useRef<ReturnType<typeof setTimeout>>(undefined)
+  const [anchor, setAnchor] = useState<{ right: number; top: number } | null>(null)
+  const show = useCallback(() => { clearTimeout(closeTimer.current); setOpen(true) }, [])
+  const scheduleHide = useCallback(() => {
+    clearTimeout(closeTimer.current)
+    closeTimer.current = setTimeout(() => setOpen(false), 120)
+  }, [])
+  useEffect(() => () => clearTimeout(closeTimer.current), [])
+  useEffect(() => {
+    if (!open) { setAnchor(null); return }
+    const update = () => {
+      const el = btnRef.current
+      if (el) { const r = el.getBoundingClientRect(); setAnchor({ right: window.innerWidth - r.right, top: r.bottom + 6 }) }
+    }
+    update()
+    window.addEventListener('resize', update)
+    window.addEventListener('scroll', update, true)
+    return () => {
+      window.removeEventListener('resize', update)
+      window.removeEventListener('scroll', update, true)
+    }
+  }, [open])
+  return (
+    <>
+      <button
+        ref={btnRef}
+        type="button"
+        tabIndex={-1}
+        aria-label="Search syntax help"
+        onMouseEnter={show}
+        onMouseLeave={scheduleHide}
+        onMouseDown={(e) => e.preventDefault()}
+        className={clsx('shrink-0 rounded p-0.5 cursor-help transition-colors', open ? 'text-theme-text-secondary' : 'text-theme-text-tertiary hover:text-theme-text-secondary')}
+      >
+        <HelpCircle className="w-3.5 h-3.5" />
+      </button>
+      {open && anchor && createPortal(
+        <div
+          ref={popRef}
+          onMouseEnter={show}
+          onMouseLeave={scheduleHide}
+          onMouseDown={(e) => e.stopPropagation()}
+          style={{ position: 'fixed', top: anchor.top, right: anchor.right, width: 280 }}
+          className="z-[130] dialog shadow-theme-lg p-3"
+        >
+          <div className="text-[10px] font-semibold uppercase tracking-wider text-theme-text-tertiary mb-2">Search syntax</div>
+          <div className="space-y-1.5">
+            {OPERATORS.map((op) => (
+              <div key={op.syntax} className="flex items-baseline gap-2">
+                <code className="shrink-0 rounded bg-theme-elevated border border-theme-border-light px-1.5 py-0.5 text-xs text-theme-text-primary">{op.syntax}</code>
+                <span className="text-xs text-theme-text-secondary">{op.desc}</span>
+              </div>
+            ))}
+          </div>
+          <div className="mt-2.5 pt-2 border-t border-theme-border text-[11px] text-theme-text-tertiary">
+            Type <code className="text-theme-text-secondary">ns:</code> or <code className="text-theme-text-secondary">kind:</code> for value suggestions.
+          </div>
+        </div>,
+        document.body,
+      )}
+    </>
+  )
+}

package/src/components/ui/ShortcutHelpOverlay.tsx CHANGED Viewed

@@ -19,7 +19,7 @@ const CONTEXT_CATEGORIES: ShortcutCategory[] = ['Drawer', 'Dock']
 // Preferred ordering within the view section
 const VIEW_CATEGORY_ORDER: ShortcutCategory[] = [
-  'Search', 'Table', 'Resource Actions', 'Topology', 'Timeline', 'Helm',
+  'Search', 'Table', 'Resource Actions', 'Topology', 'Timeline', 'Helm', 'GitOps',
 ]
 const VIEW_LABELS: Record<string, string> = {
@@ -28,7 +28,8 @@ const VIEW_LABELS: Record<string, string> = {
   resources: 'Resources',
   timeline: 'Timeline',
   helm: 'Helm',
-  traffic: 'Traffic',
+  gitops: 'GitOps',
+  traffic: 'Live Traffic',
 }
 type ShortcutEntry = { description: string; keys: string[] }

package/src/components/ui/UpdateNotification.tsx CHANGED Viewed

@@ -8,6 +8,7 @@ import {
   useApplyDesktopUpdate,
 } from '../../api/client'
 import type { DesktopUpdateState } from '../../api/client'
+import { WithTooltip } from './Tooltip'
 const DISMISSED_KEY = 'radar-update-dismissed'
@@ -26,21 +27,16 @@ export function UpdateNotification() {
   const isDesktop = versionInfo?.installMethod === 'desktop'
-  // Listen for "Check for Updates" menu item in desktop app (Wails runtime event).
-  // Un-dismisses the notification and invalidates the version check cache.
+  // Listen for "Check for Updates" menu item in desktop app.
   useEffect(() => {
-    const wailsRuntime = (window as unknown as Record<string, unknown>).runtime as
-      | { EventsOn?: (event: string, callback: () => void) => () => void }
-      | undefined
-    if (!wailsRuntime?.EventsOn) return
-    const cleanup = wailsRuntime.EventsOn('check-for-updates', () => {
+    const handler = () => {
       setDismissed(false)
       try { localStorage.removeItem(DISMISSED_KEY) } catch { /* ignore */ }
       queryClient.invalidateQueries({ queryKey: ['version-check'] })
-    })
+    }
-    return cleanup
+    window.addEventListener('radar:check-for-updates', handler)
+    return () => window.removeEventListener('radar:check-for-updates', handler)
   }, [queryClient])
   // Log version check errors for debugging
@@ -111,13 +107,13 @@ export function UpdateNotification() {
   const effectiveState: DesktopUpdateState = updateStatus?.state ?? 'idle'
   return (
-    <div className="fixed bottom-4 right-4 z-50 max-w-sm bg-theme-surface border border-blue-500/50 rounded-lg shadow-xl p-4 animate-in slide-in-from-right">
+    <div className="fixed bottom-4 right-4 z-50 max-w-sm bg-theme-surface border border-accent/50 rounded-lg shadow-xl p-4 animate-in slide-in-from-right">
       <div className="flex items-start gap-3">
-        <div className="flex items-center justify-center w-8 h-8 bg-blue-500/20 rounded-full shrink-0">
+        <div className="flex items-center justify-center w-8 h-8 bg-accent-muted rounded-full shrink-0">
           <UpdateIcon state={effectiveState} />
         </div>
         <div className="flex-1 min-w-0">
-          <h4 className="text-sm font-medium text-theme-text-primary">
+          <h4 className="text-sm font-medium text-theme-text-primary pr-6">
             <UpdateTitle state={effectiveState} />
           </h4>
           <p className="text-xs text-theme-text-secondary mt-1">
@@ -140,38 +136,54 @@ export function UpdateNotification() {
           {/* CLI: show update command with copy button for package managers */}
           {!isDesktop && versionInfo.updateCommand ? (
-            <button
-              onClick={handleCopyCommand}
-              className="flex items-center gap-2 mt-2 px-2 py-1.5 bg-theme-elevated rounded text-xs font-mono text-theme-text-primary hover:bg-theme-surface-hover transition-colors w-full"
-            >
-              <code className="flex-1 text-left truncate">{versionInfo.updateCommand}</code>
-              <CopyIcon copied={copied} failed={copyFailed} />
-            </button>
+            <>
+              <WithTooltip tip={versionInfo.updateCommand} delay={100}>
+                <button
+                  onClick={handleCopyCommand}
+                  className="flex items-center gap-2 mt-2 px-2 py-1.5 bg-theme-elevated rounded font-mono text-theme-text-primary hover:bg-theme-surface-hover transition-colors w-full"
+                >
+                  <code className="inline-code flex-1 truncate text-left text-[11px]">{versionInfo.updateCommand}</code>
+                  <CopyIcon copied={copied} failed={copyFailed} />
+                </button>
+              </WithTooltip>
+              {/* Direct installs may have placed the binary somewhere the install
+                  script won't touch — surface a download link as a fallback. */}
+              {versionInfo.installMethod === 'direct' && versionInfo.releaseUrl && (
+                <a
+                  href={versionInfo.releaseUrl}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="inline-flex items-center gap-1 mt-1.5 text-xs text-theme-text-tertiary hover:text-theme-text-secondary hover:underline"
+                >
+                  or download from GitHub →
+                </a>
+              )}
+            </>
           ) : (
-            /* Direct download - show release link */
             !isDesktop && versionInfo.releaseUrl && (
               <a
                 href={versionInfo.releaseUrl}
                 target="_blank"
                 rel="noopener noreferrer"
-                className="inline-flex items-center gap-1 mt-2 text-xs font-medium text-blue-400 hover:text-blue-300"
+                className="inline-flex items-center gap-1 mt-2 text-xs font-medium text-accent-text hover:underline"
               >
                 Download from GitHub →
               </a>
             )
           )}
         </div>
-        {/* Don't show dismiss during active update */}
-        {effectiveState !== 'downloading' && effectiveState !== 'applying' && (
-          <button
-            onClick={handleDismiss}
-            className="p-1 text-theme-text-secondary hover:text-theme-text-primary hover:bg-theme-elevated rounded shrink-0"
-            aria-label="Dismiss"
-          >
-            <X className="w-4 h-4" />
-          </button>
-        )}
       </div>
+      {/* Dismiss is absolute so it doesn't compress the chip's width.
+          fixed on the parent already establishes the positioning context. */}
+      {effectiveState !== 'downloading' && effectiveState !== 'applying' && (
+        <button
+          onClick={handleDismiss}
+          className="absolute top-2 right-2 p-1 text-theme-text-secondary hover:text-theme-text-primary hover:bg-theme-elevated rounded"
+          aria-label="Dismiss"
+        >
+          <X className="w-4 h-4" />
+        </button>
+      )}
     </div>
   )
 }
@@ -186,11 +198,11 @@ function UpdateIcon({ state }: { state: DesktopUpdateState }) {
   switch (state) {
     case 'downloading':
     case 'applying':
-      return <Loader2 className="w-4 h-4 text-blue-400 animate-spin" />
+      return <Loader2 className="w-4 h-4 text-accent animate-spin" />
     case 'ready':
       return <ArrowDownToLine className="w-4 h-4 text-green-400" />
     default:
-      return <Download className="w-4 h-4 text-blue-400" />
+      return <Download className="w-4 h-4 text-accent" />
   }
 }
@@ -247,7 +259,7 @@ function DesktopUpdateControls({
         <div className="mt-2 space-y-1">
           <div className="w-full bg-theme-elevated rounded-full h-1.5 overflow-hidden">
             <div
-              className="bg-blue-500 h-full rounded-full transition-all duration-300"
+              className="bg-accent h-full rounded-full transition-all duration-300"
               style={{ width: `${Math.round((progress ?? 0) * 100)}%` }}
             />
           </div>
@@ -272,7 +284,7 @@ function DesktopUpdateControls({
     case 'applying':
       return (
         <div className="mt-2 flex items-center gap-2">
-          <Loader2 className="w-3.5 h-3.5 text-blue-400 animate-spin" />
+          <Loader2 className="w-3.5 h-3.5 text-accent animate-spin" />
           <p className="text-xs text-theme-text-secondary">Applying update...</p>
         </div>
       )

package/src/components/ui/command-items.ts ADDED Viewed

@@ -0,0 +1,178 @@
+import { useMemo } from 'react'
+import { Home, Network, List, Clock, Package, Activity, Sun, Stethoscope, DollarSign, ShieldCheck, GitBranch, AlertTriangle, Boxes, Server } from 'lucide-react'
+import { useNamespaces, useContexts } from '../../api/client'
+import { CORE_RESOURCES, useAPIResources } from '../../api/apiResources'
+import { getResourceIcon } from '../../utils/resource-icons'
+import { parseContextName } from '../../utils/context-name'
+// Drop the disambiguating " (source)" suffix the context list appends, so the
+// GKE/EKS/AKS parser sees the bare context name (mirrors the cluster picker).
+function stripSourceSuffix(name: string, source?: string): string {
+  if (!source) return name
+  const escaped = source.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  return name.replace(new RegExp(`\\s+\\(${escaped}(?:\\s+#\\d+)?\\)$`), '')
+}
+export type MainView = 'home' | 'topology' | 'resources' | 'timeline' | 'issues' | 'helm' | 'traffic' | 'cost' | 'checks' | 'gitops' | 'applications'
+export interface CommandItem {
+  id: string
+  label: string
+  sublabel?: string
+  category: string
+  icon?: React.ComponentType<{ className?: string }>
+  shortcut?: string
+  action: () => void
+  /** Extra terms to match against during search (not displayed). */
+  searchTerms?: string[]
+  /** Small priority bonus added to the final score (only if the item matched). */
+  priorityBonus?: number
+}
+// Built-in k8s API groups. Used to nudge these above CRDs on tied matches.
+const CORE_GROUP_BONUS = 10
+const WELL_KNOWN_GROUP_BONUS = 5
+const WELL_KNOWN_GROUPS = new Set([
+  'apps', 'batch', 'autoscaling', 'policy', 'networking.k8s.io', 'rbac.authorization.k8s.io',
+  'storage.k8s.io', 'scheduling.k8s.io', 'coordination.k8s.io', 'apiextensions.k8s.io',
+  'admissionregistration.k8s.io', 'apiregistration.k8s.io', 'certificates.k8s.io',
+  'events.k8s.io', 'discovery.k8s.io', 'flowcontrol.apiserver.k8s.io', 'node.k8s.io',
+  'authentication.k8s.io', 'authorization.k8s.io',
+])
+function groupPriorityBonus(group: string): number {
+  if (!group) return CORE_GROUP_BONUS
+  if (WELL_KNOWN_GROUPS.has(group)) return WELL_KNOWN_GROUP_BONUS
+  return 0
+}
+// Fuzzy match scoring: exact > prefix > word boundary > substring. Within a
+// tier, a coverage bonus (up to +20) breaks ties in favor of shorter labels.
+export function scoreMatch(text: string, query: string): number {
+  const lower = text.toLowerCase()
+  const q = query.toLowerCase()
+  if (!lower.includes(q)) return 0
+  let base: number
+  if (lower === q) base = 150
+  else if (lower.startsWith(q)) base = 100
+  else {
+    const wordStart = lower.indexOf(q)
+    const prev = lower[wordStart - 1]
+    base = wordStart > 0 && (prev === ' ' || prev === '/' || prev === '-' || prev === '.') ? 75 : 50
+  }
+  return base + (q.length / lower.length) * 20
+}
+export function bestScore(item: CommandItem, query: string): number {
+  let best = scoreMatch(item.label, query)
+  const secondary = Math.floor(Math.max(scoreMatch(item.sublabel || '', query), scoreMatch(item.category, query)) * 0.6)
+  best = Math.max(best, secondary)
+  if (item.searchTerms) {
+    for (const term of item.searchTerms) best = Math.max(best, scoreMatch(term, query))
+  }
+  return best > 0 ? best + (item.priorityBonus || 0) : 0
+}
+export interface CommandItemCallbacks {
+  onNavigateView: (view: MainView) => void
+  onNavigateKind: (kind: string, group: string) => void
+  onSwitchContext: (name: string) => void
+  onSetNamespaces: (ns: string[]) => void
+  onToggleTheme: () => void
+  onShowDiagnostics?: () => void
+}
+const VIEW_ENTRIES: { view: MainView; label: string; icon: React.ComponentType<{ className?: string }>; shortcut: string }[] = [
+  { view: 'home', label: 'Home', icon: Home, shortcut: 'g h' },
+  { view: 'resources', label: 'Resources', icon: List, shortcut: 'g r' },
+  { view: 'issues', label: 'Issues', icon: AlertTriangle, shortcut: 'g i' },
+  { view: 'topology', label: 'Topology', icon: Network, shortcut: 'g t' },
+  { view: 'applications', label: 'Applications', icon: Boxes, shortcut: 'g a' },
+  { view: 'timeline', label: 'Timeline', icon: Clock, shortcut: 'g l' },
+  { view: 'helm', label: 'Helm', icon: Package, shortcut: 'g m' },
+  { view: 'gitops', label: 'GitOps', icon: GitBranch, shortcut: 'g o' },
+  { view: 'traffic', label: 'Live Traffic', icon: Activity, shortcut: 'g f' },
+  { view: 'checks', label: 'Checks', icon: ShieldCheck, shortcut: 'g u' },
+  { view: 'cost', label: 'Cost', icon: DollarSign, shortcut: 'g c' },
+]
+// The static command-palette items (Views, Resource Kinds, Contexts,
+// Namespaces, Actions) — shared by the centered modal (embedded) and the
+// standalone omnibar so the two never drift.
+export function useCommandItems(cb: CommandItemCallbacks): CommandItem[] {
+  const { data: namespacesData } = useNamespaces()
+  const { data: contexts } = useContexts()
+  const { data: apiResources } = useAPIResources()
+  return useMemo<CommandItem[]>(() => {
+    const result: CommandItem[] = []
+    for (const v of VIEW_ENTRIES) {
+      result.push({ id: `view-${v.view}`, label: `Go to ${v.label}`, category: 'Views', icon: v.icon, shortcut: v.shortcut, action: () => cb.onNavigateView(v.view) })
+    }
+    const resources = apiResources || CORE_RESOURCES
+    const seenKinds = new Set<string>()
+    for (const r of resources) {
+      if (!r.verbs?.includes('list')) continue
+      const kindKey = `${r.name}/${r.group}`
+      if (seenKinds.has(kindKey)) continue
+      seenKinds.add(kindKey)
+      result.push({
+        // Group shown only when it disambiguates (CRDs) — "core" is noise on
+        // built-in kinds. priorityBonus still nudges core/well-known above CRDs.
+        id: `kind-${r.name}-${r.group}`, label: r.kind, sublabel: r.group || undefined, category: 'Resource Kinds',
+        icon: getResourceIcon(r.kind), action: () => cb.onNavigateKind(r.name, r.group),
+        searchTerms: [r.name, r.kind], priorityBonus: groupPriorityBonus(r.group),
+      })
+    }
+    if (contexts) {
+      // Show the friendly parsed cluster name (like the cluster picker), not the
+      // raw ARN/gke context string. provider/region may live in the cluster id
+      // (e.g. EKS ARN) when the context name is already friendly — fall back to
+      // it. Count display names so genuine duplicates (same cluster name from
+      // different kubeconfig sources) stay distinguishable; unique ones stay clean.
+      const parsedCtx = contexts.map((ctx) => {
+        const parsed = parseContextName(stripSourceSuffix(ctx.name, ctx.source))
+        const fromCluster = ctx.cluster ? parseContextName(ctx.cluster) : null
+        const meta = [parsed.provider ?? fromCluster?.provider, parsed.region ?? fromCluster?.region].filter(Boolean).join(' · ')
+        return { ctx, clusterName: parsed.clusterName, account: parsed.account, base: ctx.isCurrent ? 'current' : meta }
+      })
+      // Disambiguate on the FINAL visible (label, sublabel) pair, not just the
+      // cluster name — same name + same provider/region from the same kubeconfig
+      // file would otherwise render identically while switching different
+      // contexts. Collisions fall back to the raw context name (unique by id).
+      const pairCount = new Map<string, number>()
+      for (const p of parsedCtx) pairCount.set(`${p.clusterName}\x00${p.base}`, (pairCount.get(`${p.clusterName}\x00${p.base}`) ?? 0) + 1)
+      for (const { ctx, clusterName, account, base } of parsedCtx) {
+        const collides = (pairCount.get(`${clusterName}\x00${base}`) ?? 0) > 1
+        const sub = [base, collides ? ctx.name : ''].filter(Boolean).join(' · ')
+        result.push({
+          id: `context-${ctx.name}`,
+          label: clusterName,
+          sublabel: sub || undefined,
+          category: 'Clusters',
+          icon: Server,
+          action: () => { if (!ctx.isCurrent) cb.onSwitchContext(ctx.name) },
+          searchTerms: [ctx.name, account || ''].filter(Boolean),
+        })
+      }
+    }
+    if (namespacesData) {
+      for (const ns of namespacesData) {
+        result.push({ id: `ns-${ns.name}`, label: ns.name, category: 'Namespaces', action: () => cb.onSetNamespaces([ns.name]) })
+      }
+      result.push({ id: 'ns-all', label: 'All Namespaces', category: 'Namespaces', action: () => cb.onSetNamespaces([]) })
+    }
+    result.push({ id: 'action-theme', label: 'Toggle Theme', category: 'Actions', icon: Sun, shortcut: 't', action: () => cb.onToggleTheme() })
+    if (cb.onShowDiagnostics) {
+      result.push({ id: 'action-diagnostics', label: 'Diagnostics', category: 'Actions', icon: Stethoscope, action: () => cb.onShowDiagnostics?.(), searchTerms: ['debug', 'health', 'status', 'snapshot'] })
+    }
+    return result
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [apiResources, contexts, namespacesData, cb.onNavigateView, cb.onNavigateKind, cb.onSwitchContext, cb.onSetNamespaces, cb.onToggleTheme, cb.onShowDiagnostics])
+}