@skyhook-io/radar-app 1.12.3 → 1.13.0

package/src/components/cost/CurrentAllocationUse.tsx

@@ -2,6 +2,7 @@ import { clsx } from 'clsx'
 import { HelpCircle } from 'lucide-react'
 import { Tooltip } from '../ui/Tooltip'
 import { formatCostPerHour, formatProjectedMonthlyRate } from './format'
+import { costRateLabels } from './source'
 
 interface CurrentAllocationUseProps {
   currency: string
@@ -14,10 +15,11 @@ interface CurrentAllocationUseProps {
   cpuUsageAvailable: boolean
   memoryUsageAvailable: boolean
   scopeNote?: string
+  window?: string
 }
 
 export const ALLOCATION_USE_TOOLTIP =
-  'OpenCost allocation uses the greater of requested or observed CPU and memory. The percentages compare observed use with that allocated amount; they are not request headroom or a right-sizing recommendation.'
+  'Cost allocation uses the greater of requested or observed CPU and memory. The percentages compare observed use with that allocated amount; they are not request headroom or a right-sizing recommendation.'
 
 export function formatAllocatedUse(
   allocationCost: number,
@@ -43,23 +45,25 @@ export function CurrentAllocationUse({
   cpuUsageAvailable,
   memoryUsageAvailable,
   scopeNote,
+  window,
 }: CurrentAllocationUseProps) {
   const splitTotal = cpuCost + memoryCost
   const cpuPct = splitTotal > 0 ? (cpuCost / splitTotal) * 100 : 0
   const memoryPct = splitTotal > 0 ? (memoryCost / splitTotal) * 100 : 0
+  const labels = costRateLabels(window)
 
   return (
     <section className="rounded-lg border border-theme-border bg-theme-surface/50 p-4">
       <div className="mb-3 flex items-center justify-between gap-3">
         <div>
           <div className="flex items-center gap-1.5">
-            <div className="text-sm font-semibold text-theme-text-primary">Current allocation and use</div>
+            <div className="text-sm font-semibold text-theme-text-primary">{labels.allocationTitle}</div>
             <Tooltip content={ALLOCATION_USE_TOOLTIP} className="max-w-[320px] whitespace-normal text-left" delay={150}>
               <HelpCircle className="h-3.5 w-3.5 cursor-help text-theme-text-tertiary transition-colors hover:text-theme-text-secondary" />
             </Tooltip>
           </div>
           <div className="text-xs text-theme-text-tertiary">
-            Allocation and CPU use: 1h average · Memory use: current
+            {labels.allocationPeriod}
             {scopeNote ? ` · ${scopeNote}` : ''}
           </div>
         </div>
@@ -69,7 +73,7 @@ export function CurrentAllocationUse({
           </div>
           {dataAvailable && (
             <div className="text-[10px] text-theme-text-tertiary tabular-nums">
-              {formatCostPerHour(hourlyCost, currency)} current rate
+              {formatCostPerHour(hourlyCost, currency)} · {labels.rate}
             </div>
           )}
         </div>

package/src/components/cost/WorkloadCostTab.test.ts

@@ -69,6 +69,53 @@ describe('getWorkloadCostState', () => {
     expect(getWorkloadCostState(current, trend, false)).toBe('partial_missing_history')
   })
 
+  it('keeps Kubecost current cost visible when history is unsupported', () => {
+    const current: OpenCostWorkloadDetailResponse = {
+      available: true,
+      source: 'kubecost',
+      currency: 'USD',
+      namespace: 'default',
+      kind: 'StatefulSet',
+      name: 'queue',
+      current: {
+        name: 'queue', kind: 'StatefulSet', hourlyCost: 0.2, cpuCost: 0.12,
+        memoryCost: 0.08, replicas: 1, cpuUsageAvailable: true,
+        memoryUsageAvailable: true, cpuAllocationUse: 25, memoryAllocationUse: 25,
+      },
+    }
+    const trend: OpenCostWorkloadTrendResponse = {
+      available: false,
+      source: 'kubecost',
+      reason: 'history_unsupported',
+      currency: 'USD',
+      namespace: 'default',
+      kind: 'StatefulSet',
+      name: 'queue',
+      range: '24h',
+    }
+
+    expect(getWorkloadCostState(current, trend, false)).toBe('partial_missing_history')
+  })
+
+  it('does not let unsupported history mask current loading or errors', () => {
+    const trend: OpenCostWorkloadTrendResponse = {
+      available: false,
+      source: 'kubecost',
+      reason: 'history_unsupported',
+      currency: 'USD',
+      namespace: 'default',
+      kind: 'StatefulSet',
+      name: 'queue',
+      range: '24h',
+    }
+
+    expect(getWorkloadCostState(undefined, trend, { currentLoading: true })).toBe('loading')
+    expect(getWorkloadCostState(undefined, trend, { currentError: true })).toBe('load_error')
+    expect(
+      getWorkloadCostState(undefined, trend, { currentError: new ApiError('denied', 403) }),
+    ).toBe('access_denied')
+  })
+
   it('keeps current cost visible while historical owner metrics are still loading', () => {
     const current: OpenCostWorkloadDetailResponse = {
       available: true,
@@ -146,6 +193,9 @@ describe('getWorkloadCostState', () => {
     expect(getWorkloadCostState(undefined, missing, false)).toBe('not_found')
     expect(getWorkloadCostState(undefined, undefined, { currentError: new ApiError('denied', 403) })).toBe('access_denied')
     expect(getWorkloadCostState(undefined, undefined, { trendError: new ApiError('missing', 404) })).toBe('not_found')
+
+    current.reason = 'configuration_mismatch'
+    expect(getWorkloadCostState(current, undefined, false)).toBe('configuration_mismatch')
   })
 
   it('shows Prometheus discovery as soon as one query reports it', () => {

package/src/components/cost/WorkloadCostTab.tsx

@@ -20,6 +20,14 @@ import {
 } from './format'
 import { CurrentAllocationUse } from './CurrentAllocationUse'
 import { costUnavailableReasonFromError } from './errors'
+import {
+  costFreshnessLabel,
+  costIntegrationUnavailableMessage,
+  costRateLabels,
+  costSourceLabel,
+  isCostDiscoveryPending,
+} from './source'
+import { useNavCustomization } from '../../context/NavCustomization'
 
 type WorkloadCostState =
   | 'loading'
@@ -44,8 +52,9 @@ interface WorkloadCostTabProps {
 }
 
 export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps) {
+  const settingsAvailable = !useNavCustomization().embedded
   const [range, setRange] = useState<CostTimeRange>('24h')
-  const [noPrometheusSince, setNoPrometheusSince] = useState<number | null>(null)
+  const [discoverySince, setDiscoverySince] = useState<number | null>(null)
   const currentQuery = useOpenCostWorkload(kind, namespace, name)
   const trendQuery = useOpenCostWorkloadTrend(kind, namespace, name, range)
   const trendMatchesRange = trendQuery.data?.range === range
@@ -62,10 +71,10 @@ export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps)
   })
 
   useEffect(() => {
-    if (state === 'no_prometheus') {
-      setNoPrometheusSince((prev) => prev ?? Date.now())
+    if (isCostDiscoveryPending(state)) {
+      setDiscoverySince((prev) => prev ?? Date.now())
     } else {
-      setNoPrometheusSince(null)
+      setDiscoverySince(null)
     }
   }, [state])
 
@@ -84,22 +93,28 @@ export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps)
     state === 'query_error' ||
     state === 'access_denied' ||
     state === 'not_found' ||
+    state === 'no_cost_source' ||
+    state === 'source_unavailable' ||
+    state === 'authentication_error' ||
+    state === 'configuration_mismatch' ||
+    state === 'deployment_configuration_error' ||
+    state === 'history_unsupported' ||
     state === 'load_error'
   ) {
-    const discoveryAgeMs = noPrometheusSince == null ? 0 : Date.now() - noPrometheusSince
-    if (state === 'no_prometheus' && discoveryAgeMs < COST_DISCOVERY_GRACE_MS) {
+    const discoveryAgeMs = discoverySince == null ? 0 : Date.now() - discoverySince
+    if (isCostDiscoveryPending(state) && discoveryAgeMs < COST_DISCOVERY_GRACE_MS) {
       return (
         <WorkloadCostDiscovering
           isFetching={currentQuery.isFetching || trendQuery.isFetching}
           onRetry={() => {
-            setNoPrometheusSince(Date.now())
+            setDiscoverySince(Date.now())
             currentQuery.refetch()
             trendQuery.refetch()
           }}
         />
       )
     }
-    return <WorkloadCostUnavailable state={state} />
+    return <WorkloadCostUnavailable state={state} settingsAvailable={settingsAvailable} />
   }
 
   const current = currentQuery.data?.current
@@ -119,6 +134,10 @@ export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps)
     trendLoading || state === 'partial_missing_history',
     trendCurrency,
   )
+  const source = currentQuery.data?.source ?? trend?.source
+  const historyUnsupported = trend?.reason === 'history_unsupported'
+  const currentWindow = currentQuery.data?.window
+  const rateLabels = costRateLabels(currentWindow)
 
   return (
     <div className="mx-auto w-full max-w-[1600px] space-y-4">
@@ -129,65 +148,76 @@ export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps)
             <div>
               <div className="flex items-center gap-1.5">
                 <div className="text-sm font-semibold text-theme-text-primary">
-                  Historical compute cost
+                  {historyUnsupported ? 'Compute allocation cost' : 'Historical compute cost'}
                 </div>
-                <MetricInfoTooltip content="Values are based on OpenCost CPU and memory allocation over time, not raw utilization. OpenCost allocation uses the greater of requested or observed resources." />
+                <MetricInfoTooltip content="Values are based on CPU and memory allocation, not raw utilization. The cost provider attributes the greater of requested or observed resources." />
               </div>
               <div className="text-xs text-theme-text-tertiary">
-                OpenCost CPU and memory allocation rate ({trendCurrency}/hr) attributed by workload
-                ownership
+                CPU and memory allocation rate ({trendCurrency}/hr) attributed by workload ownership
               </div>
             </div>
           </div>
-          <CostTimeRangeSelector value={range} onChange={setRange} />
+          {!historyUnsupported && <CostTimeRangeSelector value={range} onChange={setRange} />}
         </div>
 
-        <div className="grid gap-4 p-4 lg:grid-cols-[220px_minmax(0,1fr)]">
-          <div className="space-y-4">
+        {historyUnsupported ? (
+          <div className="grid gap-4 p-4 sm:grid-cols-2">
             <MetricBlock
-              label={`Spend over ${range}`}
-              value={windowSpendValue}
-              subvalue={
-                state === 'partial_missing_history' ? 'Historical data unavailable' : undefined
-              }
+              label={rateLabels.hourly}
+              value={hasCurrent ? formatCostPerHour(hourly, currentCurrency) : '—'}
+              subvalue="CPU and memory allocation"
             />
             <MetricBlock
               label="Projected monthly"
               value={hasCurrent ? formatProjectedMonthlyCost(hourly, currentCurrency) : '—'}
-              subvalue={
-                hasCurrent
-                  ? `${formatCostPerHour(hourly, currentCurrency)} current rate`
-                  : 'Current allocation unavailable'
-              }
+              subvalue={`${rateLabels.rate} × 730 hours`}
             />
           </div>
-          <div className="min-w-0">
-            {trendLoading ? (
-              <div className="flex h-[240px] items-center justify-center rounded-md border border-dashed border-theme-border bg-theme-base/60 text-sm text-theme-text-tertiary">
-                <Loader2 className="mr-2 h-4 w-4 animate-spin" />
-                Loading historical cost…
-              </div>
-            ) : hasTrend ? (
-              <StackedAreaChart
-                series={[{ namespace: 'Allocation rate', dataPoints: points }]}
-                currency={trendCurrency}
+        ) : (
+          <div className="grid gap-4 p-4 lg:grid-cols-[220px_minmax(0,1fr)]">
+            <div className="space-y-4">
+              <MetricBlock
+                label={`Spend over ${range}`}
+                value={windowSpendValue}
+                subvalue={
+                  state === 'partial_missing_history' ? 'Historical data unavailable' : undefined
+                }
               />
-            ) : (
-              <div className="flex h-[240px] items-center justify-center rounded-md border border-dashed border-theme-border bg-theme-base/60 text-sm text-theme-text-tertiary">
-                No historical workload owner cost points for this range.
-              </div>
-            )}
+              <MetricBlock
+                label="Projected monthly"
+                value={hasCurrent ? formatProjectedMonthlyCost(hourly, currentCurrency) : '—'}
+                subvalue={
+                  hasCurrent
+                    ? `${formatCostPerHour(hourly, currentCurrency)} · ${rateLabels.rate}`
+                    : 'Current allocation unavailable'
+                }
+              />
+            </div>
+            <div className="min-w-0">
+              {trendLoading ? (
+                <div className="flex h-[240px] items-center justify-center rounded-md border border-dashed border-theme-border bg-theme-base/60 text-sm text-theme-text-tertiary">
+                  <Loader2 className="mr-2 h-4 w-4 animate-spin" />
+                  Loading historical cost…
+                </div>
+              ) : hasTrend ? (
+                <StackedAreaChart
+                  series={[{ namespace: 'Allocation rate', dataPoints: points }]}
+                  currency={trendCurrency}
+                />
+              ) : (
+                <div className="flex h-[240px] items-center justify-center rounded-md border border-dashed border-theme-border bg-theme-base/60 text-sm text-theme-text-tertiary">
+                  No historical workload owner cost points for this range.
+                </div>
+              )}
+            </div>
           </div>
-        </div>
+        )}
       </section>
 
-      {state === 'partial_missing_history' && (
+      {state === 'partial_missing_history' && !historyUnsupported && (
         <div className="flex items-start gap-2 rounded-lg border border-theme-border bg-theme-base px-3 py-2 text-sm text-theme-text-secondary">
           <AlertCircle className="mt-0.5 h-4 w-4 shrink-0 text-theme-text-tertiary" />
-          <span>
-            Current cost is available, but historical workload owner metrics are not available for
-            this range.
-          </span>
+          <span>Current cost is available, but historical workload owner metrics are not available for this range.</span>
         </div>
       )}
       {state === 'partial_missing_current' && (
@@ -200,13 +230,13 @@ export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps)
       )}
 
       <div className="grid gap-4 md:grid-cols-2">
-        <MetricTile label="Replicas" value={hasCurrent ? String(current?.replicas ?? 0) : '—'} />
+        <MetricTile label="Live replicas" value={hasCurrent ? String(current?.replicas ?? 0) : '—'} />
         <MetricTile
           label="Projected daily"
           value={hasCurrent ? formatProjectedDailyRate(hourly, currentCurrency) : '—'}
           subvalue={
             hasCurrent
-              ? `${formatCostPerHour(hourly, currentCurrency)} current hourly rate`
+              ? `${formatCostPerHour(hourly, currentCurrency)} · ${rateLabels.rate}`
               : 'Current allocation unavailable'
           }
         />
@@ -222,15 +252,19 @@ export function WorkloadCostTab({ kind, namespace, name }: WorkloadCostTabProps)
         memoryAllocationUse={current?.memoryAllocationUse ?? 0}
         cpuUsageAvailable={current?.cpuUsageAvailable ?? false}
         memoryUsageAvailable={current?.memoryUsageAvailable ?? false}
+        window={source === 'kubecost' ? currentWindow : undefined}
       />
 
       <div className="text-xs text-theme-text-tertiary">
-        Powered by OpenCost via Prometheus.{' '}
+        {costSourceLabel(source)} &middot; {costFreshnessLabel(source, source === 'kubecost' ? currentWindow : '1h', currentQuery.data?.dataThrough)}.{' '}
         {currentCurrency !== DEFAULT_COST_CURRENCY && (
           <>Labeled {currentCurrency}; no conversion. </>
         )}
-        Historical spend uses the selected range; projected monthly values multiply the current
-        hourly allocation. Storage/PVC attribution remains at namespace and cluster level.
+        {historyUnsupported
+          ? 'Historical workload charts are not available for Kubecost yet. '
+          : 'Historical spend uses the selected range. '}
+        Projected monthly values multiply the {rateLabels.rate}. Storage/PVC attribution
+        remains at namespace and cluster level.
       </div>
     </div>
   )
@@ -260,14 +294,19 @@ export function getWorkloadCostState(
   if (trendHasData) return 'partial_missing_current'
   const reason =
     current?.reason ??
-    trend?.reason ??
     costUnavailableReasonFromError(queryStatus.currentError) ??
+    trend?.reason ??
     costUnavailableReasonFromError(queryStatus.trendError)
   if (
     reason === 'no_prometheus' ||
+    reason === 'no_cost_source' ||
     reason === 'query_error' ||
     reason === 'access_denied' ||
-    reason === 'not_found'
+    reason === 'not_found' ||
+    reason === 'source_unavailable' ||
+    reason === 'authentication_error' ||
+    reason === 'configuration_mismatch' ||
+    reason === 'deployment_configuration_error'
   )
     return reason
   if (queryError) return 'load_error'
@@ -289,11 +328,11 @@ function WorkloadCostDiscovering({
         <Loader2 className="h-8 w-8 animate-spin text-theme-text-tertiary/60" />
         <div>
           <p className="text-sm font-medium text-theme-text-primary">
-            Looking for Prometheus cost data…
+            Looking for cost data…
           </p>
           <p className="mt-1 text-xs text-theme-text-tertiary">
-            First discovery can take a few seconds while Radar checks cluster services and opens a
-            local port-forward.
+            Radar is checking OpenCost metrics in a PromQL-compatible backend and a local Kubecost
+            3 Aggregator. First discovery can take a few seconds.
           </p>
         </div>
         <button
@@ -308,19 +347,28 @@ function WorkloadCostDiscovering({
   )
 }
 
-function WorkloadCostUnavailable({ state }: { state: CostUnavailableReason | 'load_error' }) {
+function WorkloadCostUnavailable({
+  state,
+  settingsAvailable,
+}: {
+  state: CostUnavailableReason | 'load_error'
+  settingsAvailable: boolean
+}) {
   const message =
-    state === 'no_prometheus'
-      ? 'Prometheus not found. OpenCost workload cost requires Prometheus or VictoriaMetrics.'
+    costIntegrationUnavailableMessage(state, settingsAvailable) ??
+    (state === 'no_prometheus'
+      ? 'No compatible metrics backend was found. OpenCost workload cost requires OpenCost metrics in a PromQL-compatible backend.'
       : state === 'query_error'
-        ? 'Cost data is temporarily unavailable. Prometheus was found, but workload cost queries failed.'
+        ? 'Cost data is temporarily unavailable. A metrics backend was found, but workload cost queries failed.'
+        : state === 'history_unsupported'
+          ? 'Historical workload cost is not available for Kubecost yet.'
         : state === 'access_denied'
           ? 'You do not have access to view cost for this workload.'
           : state === 'not_found'
             ? 'This workload no longer exists.'
             : state === 'load_error'
               ? 'Could not load workload cost data. Check access to this workload and try again.'
-              : 'OpenCost workload metrics were not found for this workload.'
+              : 'No workload cost data was returned for this workload by the active cost source.')
 
   return (
     <div className="flex h-full min-h-[320px] items-center justify-center">

package/src/components/cost/source.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'vitest'
+import { costDataThroughLabel, costFreshnessLabel, costIntegrationUnavailableMessage, costRateLabels, costSourceLabel, isCostDiscoveryPending } from './source'
+
+describe('cost source presentation', () => {
+  it('distinguishes Prometheus windows from Kubecost ETL freshness', () => {
+    expect(costSourceLabel('prometheus')).toBe('OpenCost via Prometheus')
+    expect(costSourceLabel('kubecost')).toBe('Kubecost Aggregator')
+    expect(costFreshnessLabel('prometheus', '1h')).toBe('last 1h average')
+    expect(costFreshnessLabel('kubecost', '1h', '2026-08-26T13:58:00Z')).toContain('1-hour allocation average')
+    expect(costFreshnessLabel('kubecost', '1d', '2026-08-26T13:58:00Z')).toContain('1-day allocation average')
+    expect(costDataThroughLabel('2026-08-26T13:58:00Z')).toContain('2026')
+    expect(costDataThroughLabel('invalid')).toBe('')
+  })
+
+  it('labels fallback allocation windows without calling a daily average current', () => {
+    expect(costRateLabels('1h').hourly).toBe('Hourly (1-hour average)')
+    expect(costRateLabels('1d').rate).toBe('1-day average hourly rate')
+    expect(costRateLabels().allocationTitle).toBe('Current allocation and use')
+  })
+
+  it('keeps both absent-source reasons inside the discovery grace period', () => {
+    expect(isCostDiscoveryPending('no_prometheus')).toBe(true)
+    expect(isCostDiscoveryPending('no_cost_source')).toBe(true)
+    expect(isCostDiscoveryPending('source_unavailable')).toBe(false)
+  })
+
+  it('does not point embedded users at standalone Settings', () => {
+    expect(costIntegrationUnavailableMessage('no_cost_source', true)).toContain('Settings → Metrics')
+    expect(costIntegrationUnavailableMessage('no_cost_source', false)).toContain('host application')
+    expect(costIntegrationUnavailableMessage('source_unavailable', false)).not.toContain('Settings')
+    expect(costIntegrationUnavailableMessage('authentication_error', false)).not.toContain('Settings')
+  })
+})

package/src/components/cost/source.ts

@@ -0,0 +1,100 @@
+import type { CostDataSource, CostUnavailableReason } from '../../api/client'
+
+export function costSourceLabel(source?: CostDataSource): string {
+  return source === 'kubecost' ? 'Kubecost Aggregator' : 'OpenCost via Prometheus'
+}
+
+export function isCostDiscoveryPending(reason?: string): boolean {
+  return reason === 'no_prometheus' || reason === 'no_cost_source'
+}
+
+export function costConfigurationAction(reason?: CostUnavailableReason): {
+  section: 'prometheus' | 'cost'
+  label: string
+} {
+  return reason === 'no_prometheus'
+    ? { section: 'prometheus', label: 'Configure metrics' }
+    : { section: 'cost', label: 'Configure cost source' }
+}
+
+export function costRateLabels(window?: string): {
+  hourly: string
+  rate: string
+  allocationTitle: string
+  allocationPeriod: string
+} {
+  if (window === '1d') {
+    return {
+      hourly: 'Hourly (1-day average)',
+      rate: '1-day average hourly rate',
+      allocationTitle: '1-day average allocation and use',
+      allocationPeriod: 'Allocation and observed use: 1-day average',
+    }
+  }
+  if (window === '1h') {
+    return {
+      hourly: 'Hourly (1-hour average)',
+      rate: '1-hour average hourly rate',
+      allocationTitle: '1-hour average allocation and use',
+      allocationPeriod: 'Allocation and observed use: 1-hour average',
+    }
+  }
+  return {
+    hourly: 'Current hourly',
+    rate: 'current hourly rate',
+    allocationTitle: 'Current allocation and use',
+    allocationPeriod: 'Allocation and CPU use: 1h average · Memory use: current',
+  }
+}
+
+export function costFreshnessLabel(
+  source?: CostDataSource,
+  window?: string,
+  dataThrough?: string,
+): string {
+  if (source !== 'kubecost') return window ? `last ${window} average` : 'current allocation average'
+  const average = window === '1d'
+    ? '1-day allocation average'
+    : window === '1h'
+      ? '1-hour allocation average'
+      : 'current allocation average'
+  if (!dataThrough) return `latest Kubecost ${average}`
+  const timestamp = costDataThroughLabel(dataThrough)
+  if (!timestamp) return `latest Kubecost ${average}`
+  return `Kubecost ${average} · data through ${timestamp}`
+}
+
+export function costDataThroughLabel(dataThrough?: string): string {
+  if (!dataThrough) return ''
+  const timestamp = new Date(dataThrough)
+  if (Number.isNaN(timestamp.getTime())) return ''
+  return timestamp.toLocaleString([], { dateStyle: 'medium', timeStyle: 'short' })
+}
+
+export function costIntegrationUnavailableMessage(
+  reason?: CostUnavailableReason | 'load_error',
+  settingsAvailable = true,
+): string | undefined {
+  switch (reason) {
+    case 'no_cost_source':
+      return settingsAvailable
+        ? 'No compatible cost source was found. Connect OpenCost metrics in Settings → Metrics or configure Kubecost in Settings → Cost.'
+        : 'No compatible cost source is configured for this cluster. Configure OpenCost metrics or Kubecost in the host application or Radar deployment.'
+    case 'source_unavailable':
+      return settingsAvailable
+        ? 'Kubecost Aggregator is unavailable. Check the URL, network path, and cluster ID in Settings → Cost.'
+        : 'Kubecost Aggregator is unavailable. Update this cluster’s cost-source configuration in the host application or Radar deployment.'
+    case 'deployment_configuration_error':
+      return 'Cost collection is misconfigured by this Radar deployment. Update its environment variables or Helm cost values, then restart Radar.'
+    case 'authentication_error':
+      return settingsAvailable
+        ? 'Kubecost rejected the configured API key. Update it in Settings → Cost.'
+        : 'Kubecost rejected the configured API key. Update this cluster’s credential in the host application or Radar deployment.'
+    case 'configuration_mismatch':
+      return settingsAvailable
+        ? 'Saved Kubecost settings are not valid for this cluster. Update the cluster ID or local API key in Settings → Cost.'
+        : 'Kubecost settings are not valid for this cluster. Update the cluster ID or credential in the host application or Radar deployment.'
+    default:
+      return undefined
+  }
+}

package/src/components/diagnose/parts.test.tsx

@@ -41,9 +41,12 @@ describe("AgentControls execution profile explanation", () => {
     const html = renderAgent("cursor-agent", ["full-local"], "safeguarded");
     expect(html).toContain("must use this agent");
     expect(html).toContain("normal setup");
-    expect(html).toContain("always loads your global MCP servers");
-    expect(html).toContain("still enables the agent CLI");
-    expect(html).toContain("does not constrain external MCP servers");
+    expect(html).toContain("--force");
+    expect(html).toContain("auto-approves its built-in tools");
+    expect(html).toContain("including your global servers");
+    expect(html).toContain("does not reliably confine those tools");
+    expect(html).not.toContain("still enables the agent CLI");
+    expect(html).not.toContain("does not constrain external MCP servers");
     expect(html).not.toContain("always runs this agent with safeguards");
   });
 
@@ -104,7 +107,12 @@ describe("ConsentCard execution profile treatment", () => {
     expect(html).toContain("border-amber-500/40");
     expect(html).toContain("text-amber-500");
     expect(html).toContain("Radar cannot constrain");
-    expect(html).toContain("always loads your global MCP servers");
+    expect(html).toContain("--force");
+    expect(html).toContain("auto-approves its built-in tools");
+    expect(html).toContain("including your global servers");
+    expect(html).toContain("does not reliably confine those tools");
+    expect(html).not.toContain("still enables the agent CLI");
+    expect(html).not.toContain("does not constrain external MCP servers");
     expect(html).not.toContain("text-accent");
   });