@skyhook-io/k8s-ui 1.10.0 → 1.10.2

package/src/components/resources/renderers/KarpenterNodePoolRenderer.tsx

@@ -1,6 +1,8 @@
 import { Server, Settings, Shield, Cpu, Tag, BarChart3 } from 'lucide-react'
 import { Section, PropertyList, Property, ConditionsSection, AlertBanner, ResourceLink, useOperationalIssuesShown } from '../../ui/drawer-components'
 import { kindToPlural } from '../../../utils/navigation'
+import { formatCPUString, formatMemoryString } from '../../../utils/format'
+import { Badge } from '../../ui/Badge'
 import {
   getNodePoolStatus,
   getNodePoolNodeClassRef,
@@ -9,22 +11,14 @@ import {
   getNodePoolWeight,
 } from '../resource-utils-karpenter'
 
-function formatCpuCores(value: unknown): string {
-  const quantity = String(value)
-  if (quantity.endsWith('m')) {
-    const millis = parseInt(quantity, 10)
-    if (!isNaN(millis)) return String(millis / 1000)
-  }
-  return quantity
-}
-
-
 interface KarpenterNodePoolRendererProps {
   data: any
   onNavigate?: (ref: { kind: string; namespace: string; name: string; group?: string }) => void
+  /** Host-wired: opens this pool in the Capacity view (only hosts that ship it pass this). */
+  onOpenCapacity?: () => void
 }
 
-export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoolRendererProps) {
+export function KarpenterNodePoolRenderer({ data, onNavigate, onOpenCapacity }: KarpenterNodePoolRendererProps) {
   const status = data.status || {}
   const spec = data.spec || {}
   const conditions = status.conditions || []
@@ -38,6 +32,7 @@ export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoo
   const disruption = spec.disruption || {}
   const templateLabels = spec.template?.metadata?.labels || {}
   const templateExpireAfter = spec.template?.spec?.expireAfter
+  const terminationGracePeriod = spec.template?.spec?.terminationGracePeriod
   const nodeClassRef = spec.template?.spec?.nodeClassRef
   const templateTaints = spec.template?.spec?.taints || []
   const templateStartupTaints = spec.template?.spec?.startupTaints || []
@@ -45,6 +40,18 @@ export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoo
 
   return (
     <>
+      {onOpenCapacity && (
+        <div className="mb-3">
+          <button
+            type="button"
+            onClick={onOpenCapacity}
+            className="text-xs font-medium text-accent-text hover:underline"
+          >
+            Open in Capacity — ledger, workloads, demand →
+          </button>
+        </div>
+      )}
+
       {/* Problem alert */}
       {isNotReady && !operationalIssuesShown && (
         <AlertBanner
@@ -91,20 +98,23 @@ export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoo
         </PropertyList>
       </Section>
 
-      {/* Resource Usage — from status.resources vs spec.limits */}
+      {/* Karpenter reports provisioned resources here, not workload utilization. */}
       {(statusResources.cpu || statusResources.memory) && (
-        <Section title="Resource Usage" icon={BarChart3} defaultExpanded>
+        <Section title="Provisioned Capacity" icon={BarChart3} defaultExpanded>
+          <p className="mb-2 text-xs text-theme-text-tertiary">
+            Resources provisioned by this NodePool versus its configured ceiling. This is not live workload usage.
+          </p>
           <PropertyList>
             {statusResources.cpu && (
               <Property
                 label="CPU"
-                value={`${formatCpuCores(statusResources.cpu)}${spec.limits?.cpu ? ` / ${formatCpuCores(spec.limits.cpu)}` : ''}`}
+                value={`${formatCPUString(String(statusResources.cpu))} provisioned${spec.limits?.cpu ? ` / ${formatCPUString(String(spec.limits.cpu))} limit` : ''}`}
               />
             )}
             {statusResources.memory && (
               <Property
                 label="Memory"
-                value={`${statusResources.memory}${spec.limits?.memory ? ` / ${spec.limits.memory}` : ''}`}
+                value={`${formatMemoryString(String(statusResources.memory))} provisioned${spec.limits?.memory ? ` / ${formatMemoryString(String(spec.limits.memory))} limit` : ''}`}
               />
             )}
           </PropertyList>
@@ -121,6 +131,9 @@ export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoo
           {(disruption.expireAfter || templateExpireAfter) && (
             <Property label="Expire After" value={disruption.expireAfter || templateExpireAfter} />
           )}
+          {terminationGracePeriod && (
+            <Property label="Termination Grace Period" value={terminationGracePeriod} />
+          )}
         </PropertyList>
         {disruption.budgets && disruption.budgets.length > 0 && (
           <div className="mt-2 space-y-1">
@@ -130,6 +143,11 @@ export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoo
                 {budget.nodes && <span>Nodes: {budget.nodes}</span>}
                 {budget.schedule && <span className="ml-2">Schedule: {budget.schedule}</span>}
                 {budget.duration && <span className="ml-2">Duration: {budget.duration}</span>}
+                {budget.reasons?.length > 0 && (
+                  <div className="mt-1 flex flex-wrap gap-1">
+                    {budget.reasons.map((reason: string) => <Badge key={reason} tone="structural" size="sm">{reason}</Badge>)}
+                  </div>
+                )}
               </div>
             ))}
           </div>
@@ -193,6 +211,7 @@ export function KarpenterNodePoolRenderer({ data, onNavigate }: KarpenterNodePoo
                 <div className="flex items-center gap-2 text-sm">
                   <span className="text-theme-text-primary font-medium">{req.key}</span>
                   <span className="text-theme-text-tertiary">{req.operator}</span>
+                  {req.minValues !== undefined && <Badge tone="note" size="sm">min {req.minValues}</Badge>}
                 </div>
                 {req.values && req.values.length > 0 && (
                   <div className="mt-1 flex flex-wrap gap-1">

package/src/components/resources/renderers/PodRenderer.test.tsx

@@ -1,8 +1,10 @@
 import { describe, expect, it } from 'vitest'
 import { renderToString } from 'react-dom/server'
 import { PodRenderer } from './PodRenderer'
+import { ContainerEnvironmentSection } from './ContainerEnvironmentSection'
 import { resolvedEnvFromKey } from '../../../utils/env-from'
 import type { ResolvedEnvFrom } from '../../../types'
+import type { PodEnvironmentResponse } from '../../../types'
 
 const pod = {
   metadata: { name: 'api', namespace: 'default' },
@@ -52,6 +54,231 @@ describe('PodRenderer envFrom expansion', () => {
   })
 })
 
+describe('PodRenderer resolved environment', () => {
+  it('explains Secret coverage without placing Secret values in the initial markup', () => {
+    const environment: PodEnvironmentResponse = {
+      containers: [{
+        name: 'api',
+        role: 'container',
+        rows: [
+          { name: 'PUBLIC_URL', value: 'https://example.com', state: 'resolved', source: { kind: 'ConfigMap', name: 'shared', key: 'PUBLIC_URL' } },
+          { name: 'API_TOKEN', state: 'masked', sensitive: true, source: { kind: 'Secret', name: 'shared', key: 'API_TOKEN' } },
+        ],
+      }],
+      coverage: { observedSince: '2026-08-02T00:00:00Z' },
+    }
+
+    const html = renderToString(
+      <PodRenderer
+        data={pod}
+        onCopy={() => undefined}
+        copied={null}
+        environment={environment}
+        onRevealEnvironment={async () => ({ value: 'sentinel-secret-value', encoding: 'utf8' })}
+      />,
+    )
+
+    expect(html).toContain('2 variables')
+    expect(html).toContain('1 from Secrets')
+    expect(html).toContain('Secret values stay hidden until you reveal them.')
+    expect(html).not.toContain('Value if restarted now')
+    expect(html).toContain('Only variables declared on the Pod are shown.')
+    expect(html).not.toContain('Changes observed')
+    expect(html).toContain('Secret<!-- -->/<!-- -->shared')
+    expect(html).toContain('flex-wrap items-center gap-x-1.5 gap-y-0.5')
+    expect(html).toContain('@container/env')
+    expect(html).toContain('table-fixed')
+    expect(html).toContain('w-[46%]')
+    expect(html).toContain('table-divide-subtle')
+    expect(html).not.toContain('overflow-x-auto')
+    expect(html).not.toContain('space-y-2.5 px-3 py-3 text-xs')
+    expect(html).not.toContain('title=')
+    expect(html).not.toContain('sentinel-secret-value')
+  })
+
+  it('only allocates a status column when a row needs attention', () => {
+    const environment: PodEnvironmentResponse = {
+      containers: [{
+        name: 'api',
+        role: 'container',
+        rows: [{ name: 'PUBLIC_URL', value: 'https://example.com', state: 'resolved', source: { kind: 'Direct' } }],
+      }],
+      coverage: {},
+    }
+    const render = (value: PodEnvironmentResponse) => renderToString(
+      <ContainerEnvironmentSection
+        environment={value}
+        namespace="default"
+        onCopy={() => undefined}
+        copied={null}
+      />,
+    )
+
+    const normal = render(environment)
+    expect(normal).toContain('w-[46%]')
+    expect(normal).not.toContain('>Status</span>')
+    expect(normal).toContain('lucide-equal')
+    expect(normal).not.toContain('lucide-pencil')
+
+    const optional = render({
+      ...environment,
+      containers: [{
+        ...environment.containers[0],
+        rows: [{ name: 'FEATURE', state: 'missing', optional: true, source: { kind: 'ConfigMap', name: 'settings', key: 'feature' }, message: 'Optional key feature is absent.' }],
+      }],
+    })
+    expect(optional).toContain('Not set')
+    expect(optional).toContain('w-[46%]')
+    expect(optional).not.toContain('>Status</span>')
+    expect(optional).toContain('!cursor-help')
+    expect(optional).not.toContain('<button class="badge-sm')
+
+    const navigable = renderToString(
+      <ContainerEnvironmentSection
+        environment={{
+          ...environment,
+          containers: [{
+            ...environment.containers[0],
+            rows: [{ name: 'PUBLIC_URL', value: 'https://example.com', state: 'resolved', source: { kind: 'ConfigMap', name: 'settings', key: 'url' } }],
+          }],
+        }}
+        namespace="default"
+        onNavigate={() => undefined}
+        onCopy={() => undefined}
+        copied={null}
+      />,
+    )
+    expect(navigable).toContain('cursor-pointer')
+    expect(navigable).toContain('<button class="badge-sm')
+
+    const runtime = render({
+      ...environment,
+      containers: [{
+        ...environment.containers[0],
+        rows: [{ name: 'RUNTIME_VALUE', value: '$(SERVICE_HOST)', state: 'unavailable', runtimeDependent: true, source: { kind: 'Direct' } }],
+      }],
+    })
+    expect(runtime).toContain('Set at startup')
+    expect(runtime).toContain('w-[46%]')
+    expect(runtime).not.toContain('>Status</span>')
+
+    const restartBlocked = render({
+      ...environment,
+      containers: [{
+        ...environment.containers[0],
+        rows: [{
+          name: 'REQUIRED',
+          state: 'missing',
+          missingImpact: 'restartBlocked',
+          source: { kind: 'ConfigMap', name: 'settings', key: 'required' },
+          message: 'The running container cannot restart while this is missing.',
+          evidence: { kind: 'removed', changedAt: '2026-08-02T00:00:00Z', message: 'Removed after the container started.' },
+        }],
+      }],
+    })
+    expect(restartBlocked).toContain('Restart blocked')
+    expect(restartBlocked).not.toContain('>Removed after start</span>')
+    expect(restartBlocked).toContain('>Status</span>')
+
+    const startupBlocked = render({
+      ...environment,
+      containers: [{
+        ...environment.containers[0],
+        rows: [{ name: 'REQUIRED', state: 'missing', missingImpact: 'startupBlocked', source: { kind: 'Secret', name: 'credentials', key: 'required' } }],
+      }],
+    })
+    expect(startupBlocked).toContain('Prevents start')
+    expect(startupBlocked).toContain('>Status</span>')
+
+    const limitedHistory = render({
+      ...environment,
+      coverage: { degraded: true, degradedReason: 'Change history is limited to this Radar session.', saturated: true },
+    })
+    expect(limitedHistory).toContain('Change history is limited to this Radar session.')
+    expect(limitedHistory).toContain('Some recent changes may not be shown.')
+
+    const changed = render({
+      ...environment,
+      containers: [{
+        ...environment.containers[0],
+        rows: [{
+          ...environment.containers[0].rows[0],
+          evidence: { kind: 'modified', changedAt: '2026-08-02T00:00:00Z', message: 'Changed after the container started.' },
+        }],
+      }],
+    })
+    expect(changed).toContain('w-[42%]')
+    expect(changed).toContain('>Status</span>')
+  })
+
+  it('selects the first regular container instead of an init container', () => {
+    const html = renderToString(
+      <ContainerEnvironmentSection
+        environment={{
+          containers: [
+            { name: 'migrate', role: 'init', rows: [{ name: 'INIT_ONLY', value: 'yes', state: 'resolved', source: { kind: 'Direct' } }] },
+            { name: 'api', role: 'container', rows: [{ name: 'API_ONLY', value: 'yes', state: 'resolved', source: { kind: 'Direct' } }] },
+          ],
+          coverage: {},
+        }}
+        namespace="default"
+        onCopy={() => undefined}
+        copied={null}
+      />,
+    )
+
+    expect(html).toContain('API_ONLY')
+    expect(html).not.toContain('INIT_ONLY')
+    expect(html).toContain('aria-selected="false"')
+    expect(html).toContain('aria-selected="true"')
+  })
+
+  it('offers copy for concrete values and confirms success', () => {
+    const environment: PodEnvironmentResponse = {
+      containers: [{
+        name: 'api',
+        role: 'container',
+        rows: [{ name: 'PUBLIC_URL', value: 'https://example.com', state: 'resolved', source: { kind: 'Direct' } }],
+      }],
+      coverage: {},
+    }
+    const render = (copied: string | null) => renderToString(
+      <ContainerEnvironmentSection
+        environment={environment}
+        namespace="default"
+        onCopy={() => undefined}
+        copied={copied}
+      />,
+    )
+
+    const ready = render(null)
+    expect(ready).toContain('group-hover/value:opacity-100')
+    expect(ready).toContain('aria-label="Copy value"')
+    expect(ready).toContain('lucide-copy')
+
+    const confirmed = render('api\u0000PUBLIC_URL')
+    expect(confirmed).toContain('aria-label="Value copied"')
+    expect(confirmed).toContain('lucide-check')
+    expect(confirmed).toContain('text-green-400')
+  })
+
+  it('keeps the declaration view when resolved sources contain no usable variables', () => {
+    const html = renderToString(
+      <PodRenderer
+        data={pod}
+        onCopy={() => undefined}
+        copied={null}
+        environment={{ containers: [{ name: 'api', role: 'container', rows: [] }], coverage: {} }}
+      />,
+    )
+
+    expect(html).toContain('Environment Variables')
+    expect(html).toContain('ConfigMap')
+    expect(html).toContain('Secret')
+    expect(html).toContain('(all keys)')
+  })
+})
+
 describe('PodRenderer issues banner', () => {
   it('renders pod status messages for evicted pods', () => {
     const html = renderToString(

package/src/components/resources/renderers/PodRenderer.tsx

@@ -12,10 +12,17 @@ import {
 import { resolvedEnvFromKey } from '../../../utils/env-from'
 import { detectBlastRadius, rulePermissivenessScore } from '../../../utils/rbac-blast-radius'
 import { RBACErrorSection, isRBACUnavailable } from './RBACErrorSection'
-import type { ResolvedEnvFrom, RBACSubjectResponse, RBACPolicyRule } from '../../../types'
+import type {
+  PodEnvironmentResponse,
+  PodEnvironmentRevealResponse,
+  ResolvedEnvFrom,
+  RBACSubjectResponse,
+  RBACPolicyRule,
+} from '../../../types'
 import { Tooltip } from '../../ui/Tooltip'
 import { MetricsChart } from '../../ui/MetricsChart'
 import { MetricsUnavailableNotice } from './MetricsUnavailableNotice'
+import { ContainerEnvironmentSection } from './ContainerEnvironmentSection'
 
 function parseValidDate(dateStr: string): Date | null {
   const d = new Date(dateStr)
@@ -63,6 +70,10 @@ interface PodRendererProps {
   onNavigate?: (ref: { kind: string; namespace: string; name: string }) => void
   /** When provided, container-level Logs buttons call this instead of onOpenLogsPanel */
   onOpenLogs?: (podName: string, containerName: string) => void
+  /** Host-wired for pending pods on Karpenter clusters: opens the Capacity
+   *  Demand view, which groups pending pods by scheduling signature and
+   *  evaluates every NodePool against them. */
+  onEvaluateCapacity?: () => void
   // Platform capabilities
   canExec?: boolean
   canViewLogs?: boolean
@@ -85,6 +96,10 @@ interface PodRendererProps {
    * When provided, expands ConfigMap/Secret keys inline instead of showing "(all keys)".
    */
   resolvedEnvFrom?: ResolvedEnvFrom
+  environment?: PodEnvironmentResponse
+  environmentLoading?: boolean
+  environmentError?: Error | null
+  onRevealEnvironment?: (container: string, variable: string) => Promise<PodEnvironmentRevealResponse>
   /**
    * RBAC reverse-lookup for the Pod's ServiceAccount. Undefined means the host
    * didn't wire the fetch (Permissions section is omitted). Null means the
@@ -251,6 +266,7 @@ export function PodRenderer({
   copied,
   onNavigate,
   onOpenLogs: onOpenLogsOverride,
+  onEvaluateCapacity,
   canExec,
   canViewLogs,
   canPortForward,
@@ -264,6 +280,10 @@ export function PodRenderer({
   renderImageBrowser,
   renderPodBrowser,
   resolvedEnvFrom,
+  environment,
+  environmentLoading,
+  environmentError,
+  onRevealEnvironment,
   rbacData,
   rbacLoading,
   rbacError,
@@ -272,6 +292,12 @@ export function PodRenderer({
   const containers = data.spec?.containers || []
   const initContainers = data.spec?.initContainers || []
   const initContainerStatuses = data.status?.initContainerStatuses || []
+  const hasEnvironmentDeclarations = [...initContainers, ...containers].some(
+    (container: any) => container.env?.length > 0 || container.envFrom?.length > 0,
+  )
+  const hasResolvedEnvironmentRows = environment?.containers.some(
+    container => container.rows.length > 0 || container.truncated,
+  ) ?? false
 
   const namespace = data.metadata?.namespace
   const podName = data.metadata?.name
@@ -366,6 +392,18 @@ export function PodRenderer({
         </AlertBanner>
       )}
 
+      {onEvaluateCapacity && (
+        <div className="mb-3">
+          <button
+            type="button"
+            onClick={onEvaluateCapacity}
+            className="text-xs font-medium text-accent-text hover:underline"
+          >
+            Evaluate against Karpenter NodePools →
+          </button>
+        </div>
+      )}
+
       {/* Status section */}
       <Section title="Status" icon={Server}>
         <PropertyList>
@@ -715,7 +753,30 @@ export function PodRenderer({
       </Section>
 
       {/* Environment Variables */}
-      {[...initContainers, ...containers].some((c: any) => c.env?.length > 0 || c.envFrom?.length > 0) && (
+      {environment && hasResolvedEnvironmentRows && (
+        <ContainerEnvironmentSection
+          environment={environment}
+          namespace={namespace}
+          onNavigate={onNavigate}
+          onReveal={onRevealEnvironment}
+          onCopy={onCopy}
+          copied={copied}
+        />
+      )}
+      {hasEnvironmentDeclarations && environmentLoading && !environment && (
+        <Section title="Environment Variables" icon={List} defaultExpanded={false}>
+          <div className="text-xs text-theme-text-tertiary">Loading variable sources…</div>
+        </Section>
+      )}
+      {hasEnvironmentDeclarations && environmentError && !environment && (
+        <Section title="Environment Variables" icon={List} defaultExpanded={false}>
+          <div className="space-y-2 text-xs">
+            <p className="text-theme-text-secondary">Variable sources could not be loaded.</p>
+            <p className="text-theme-text-tertiary">{environmentError.message}</p>
+          </div>
+        </Section>
+      )}
+      {(!environment || !hasResolvedEnvironmentRows) && !environmentLoading && !environmentError && hasEnvironmentDeclarations && (
         <EnvVarsSection
           initContainers={initContainers}
           containers={containers}

package/src/components/resources/renderers/index.ts

@@ -80,6 +80,7 @@ export * from './OrderRenderer'
 export * from './PersistentVolumeRenderer'
 export * from './PodDisruptionBudgetRenderer'
 export * from './PodRenderer'
+export * from './ContainerEnvironmentSection'
 export * from './PodMonitorRenderer'
 export * from './PriorityClassRenderer'
 export * from './prometheus-cells'

package/src/components/shared/ResourceRendererDispatch.tsx

@@ -256,6 +256,10 @@ export interface RendererOverrides {
   NodeRenderer?: React.ComponentType<{
     data: any; relationships?: Relationships
   }>
+  KarpenterNodePoolRenderer?: React.ComponentType<{
+    data: any
+    onNavigate?: (ref: ResourceRef) => void
+  }>
   ServiceRenderer?: React.ComponentType<{
     data: any; onCopy: CopyHandler; copied: string | null
     onNavigate?: (ref: ResourceRef) => void
@@ -487,6 +491,7 @@ export function ResourceRendererDispatch({
   const isKnownKind = KNOWN_KINDS.has(kind) || isCrossplaneMR || isCrossplaneClaim || isCrossplaneXR
 
   const PodComp = rendererOverrides?.PodRenderer ?? PodRenderer
+  const KarpenterNodePoolComp = rendererOverrides?.KarpenterNodePoolRenderer ?? KarpenterNodePoolRenderer
   const WorkloadComp = rendererOverrides?.WorkloadRenderer ?? WorkloadRenderer
   const NodeComp = rendererOverrides?.NodeRenderer ?? NodeRenderer
   const ServiceComp = rendererOverrides?.ServiceRenderer ?? ServiceRenderer
@@ -570,7 +575,7 @@ export function ResourceRendererDispatch({
         {kind === 'helmreleases' && <FluxHelmReleaseRenderer data={data} onNavigate={onNavigate} />}
         {kind === 'alerts' && <AlertRenderer data={data} />}
         {kind === 'applications' && <ArgoApplicationRenderer data={data} />}
-        {kind === 'nodepools' && <KarpenterNodePoolRenderer data={data} onNavigate={onNavigate} />}
+        {kind === 'nodepools' && <KarpenterNodePoolComp data={data} onNavigate={onNavigate} />}
         {kind === 'nodeclaims' && <KarpenterNodeClaimRenderer data={data} onNavigate={onNavigate} />}
         {kind === 'ec2nodeclasses' && <KarpenterEC2NodeClassRenderer data={data} />}
         {kind === 'scaledobjects' && <KedaScaledObjectRenderer data={data} onNavigate={onNavigate} />}

package/src/components/ui/drawer-components.tsx

@@ -81,9 +81,10 @@ interface SectionProps {
   icon?: React.ComponentType<{ className?: string }>
   children: React.ReactNode
   defaultExpanded?: boolean
+  contentClassName?: string
 }
 
-export function Section({ title, icon: Icon, children, defaultExpanded = true }: SectionProps) {
+export function Section({ title, icon: Icon, children, defaultExpanded = true, contentClassName }: SectionProps) {
   const [expanded, setExpanded] = useState(defaultExpanded)
 
   return (
@@ -101,7 +102,7 @@ export function Section({ title, icon: Icon, children, defaultExpanded = true }:
         style={{ gridTemplateRows: expanded ? '1fr' : '0fr' }}
       >
         <div className="overflow-hidden">
-          <div className="pl-6">{children}</div>
+          <div className={contentClassName ?? 'pl-6'}>{children}</div>
         </div>
       </div>
     </div>

package/src/components/ui/index.ts

@@ -1,4 +1,6 @@
-export { Tooltip } from './Tooltip'
+export { Tooltip, WithTooltip } from './Tooltip'
+export { Badge } from './Badge'
+export type { BadgeSeverity, BadgeSize, BadgeTone } from './Badge'
 export { FreshnessControl } from './FreshnessControl'
 export type { FreshnessMode, FreshnessConnection } from './FreshnessControl'
 export { PaneLoader } from './PaneLoader'

package/src/components/workload/WorkloadView.tsx

@@ -156,6 +156,9 @@ interface WorkloadViewProps {
   workloadPods?: WorkloadPodInfo[]
   workloadPodsLoading?: boolean
   workloadPodsError?: Error | null
+  /** Wired by the host only while this workload has pods awaiting scheduling
+   *  and Karpenter is available — absent otherwise, so no dead affordance. */
+  onEvaluateCapacity?: () => void
   /** Full objects for service/route refs related to this workload. Optional;
    *  overview falls back to relationship refs when hosts do not fetch them. */
   servingResources?: ServingResourceDetail[]
@@ -349,6 +352,7 @@ export function WorkloadView({
   workloadPods,
   workloadPodsLoading = false,
   workloadPodsError = null,
+  onEvaluateCapacity,
   servingResources,
   renderServicePortAction,
   renderServicePortPanel,
@@ -1027,6 +1031,7 @@ export function WorkloadView({
               extraContent={renderOverviewExtra && renderOverviewExtra({ kind, namespace, name })}
               introContent={overviewIntro}
               leadContent={hasOperationalIssues && renderOverviewLead ? renderOverviewLead({ kind, namespace, name }) : undefined}
+              onEvaluateCapacity={onEvaluateCapacity}
             />
         )}
         {effectiveTab === 'topology' && (
@@ -1471,6 +1476,7 @@ function InfoTab({
   extraContent,
   introContent,
   leadContent,
+  onEvaluateCapacity,
 }: {
   resource: any
   selectedResource: SelectedResource
@@ -1481,6 +1487,7 @@ function InfoTab({
   workloadPods?: WorkloadPodInfo[]
   workloadPodsLoading?: boolean
   workloadPodsError?: Error | null
+  onEvaluateCapacity?: () => void
   servingResources?: ServingResourceDetail[]
   renderServicePortAction?: (props: ServicePortRenderProps) => ReactNode
   renderServicePortPanel?: (props: ServicePortRenderProps) => ReactNode
@@ -1591,6 +1598,7 @@ function InfoTab({
       extraContent={extraContent}
       introContent={introContent}
       leadContent={leadContent}
+      onEvaluateCapacity={onEvaluateCapacity}
     />
   )
 }
@@ -1646,6 +1654,7 @@ function WorkloadOverviewTab({
   extraContent,
   introContent,
   leadContent,
+  onEvaluateCapacity,
 }: {
   resource: any
   selectedResource: SelectedResource
@@ -1655,6 +1664,7 @@ function WorkloadOverviewTab({
   workloadPods?: WorkloadPodInfo[]
   workloadPodsLoading?: boolean
   workloadPodsError?: Error | null
+  onEvaluateCapacity?: () => void
   servingResources?: ServingResourceDetail[]
   renderServicePortAction?: (props: ServicePortRenderProps) => ReactNode
   renderServicePortPanel?: (props: ServicePortRenderProps) => ReactNode
@@ -1707,6 +1717,18 @@ function WorkloadOverviewTab({
             servingSummary={showServingPath ? buildServingStripSummary(servingRelationshipGroups, servingResources) : undefined}
           />
 
+          {onEvaluateCapacity && (
+            <div>
+              <button
+                type="button"
+                onClick={onEvaluateCapacity}
+                className="text-xs font-medium text-accent-text hover:underline"
+              >
+                Evaluate pending pods against Karpenter NodePools →
+              </button>
+            </div>
+          )}
+
           <div className="grid items-start gap-4 xl:grid-cols-[minmax(0,1fr)_360px] 2xl:grid-cols-[minmax(0,1fr)_400px]">
             <div className="space-y-4">
               <div className="grid items-start gap-4 2xl:grid-cols-[minmax(0,1fr)_minmax(320px,420px)]">