@skyhook-io/k8s-ui 1.8.6 → 1.8.8

package/src/components/issues/IssuesView.tsx

@@ -2,6 +2,7 @@ import { useEffect, useMemo, useState, type ComponentType, type ReactNode } from
 import { ChevronRight, CircleCheck, Clock, ExternalLink } from 'lucide-react';
 import { ClusterName, EmptyState } from '../ui';
 import { formatCompactAge, formatRelativeAgeTime } from '../../utils/format';
+import { diagnosticRoleLabel, diagnosticFactLabel, confidenceTitle, incidentParentLabel } from './diagnostic';
 import {
   ISSUE_SEVERITY_BADGE_CLASS,
   ISSUE_SEVERITY_LABEL,
@@ -208,6 +209,17 @@ export function IssueRow({
                 <span className="shrink-0 tabular-nums">{affected}</span>
               </>
             ) : null}
+            {issue.incident_parent ? (
+              <>
+                <span aria-hidden>·</span>
+                {/* Non-interactive signal (the header is the toggle — a nested
+                    button would be invalid); the clickable link lives in the body. */}
+                <span className="min-w-0 truncate text-theme-text-tertiary" title={confidenceTitle(issue.incident_parent.confidence ?? '')}>
+                  ↳ {incidentParentLabel(issue.incident_parent.fact_type, issue.incident_parent.confidence)}{' '}
+                  <span className="font-medium text-theme-text-secondary">{issue.incident_parent.ref.kind} / {issue.incident_parent.ref.name}</span>
+                </span>
+              </>
+            ) : null}
             {renderMeta?.(slotCtx)}
           </div>
         </div>
@@ -248,6 +260,21 @@ export function IssueRow({
             <div className="border-t border-theme-border bg-theme-base/40 px-4 py-4 pl-11">
               <div className="flex flex-col gap-4">
                 <Diagnosis issue={issue} />
+                {issue.incident_parent ? (
+                  <section className="flex flex-col gap-1">
+                    <h4 className="text-[11px] font-semibold uppercase tracking-wide text-theme-text-tertiary">
+                      {incidentParentLabel(issue.incident_parent.fact_type, issue.incident_parent.confidence)}
+                      {issue.incident_parent.confidence ? (
+                        <span className="ml-2 badge-sm text-[10px] font-normal text-theme-text-tertiary" title={confidenceTitle(issue.incident_parent.confidence)}>
+                          {issue.incident_parent.confidence} confidence
+                        </span>
+                      ) : null}
+                    </h4>
+                    <ul className="flex flex-col gap-px">
+                      <ResourceLine refForLink={memberRef(issue, issue.incident_parent.ref)} resourceHref={resourceHref} onResourceClick={onResourceClick} ResourceLinkIcon={ResourceLinkIcon} />
+                    </ul>
+                  </section>
+                ) : null}
                 <DiagnosticContext issue={issue} resourceHref={resourceHref} onResourceClick={onResourceClick} ResourceLinkIcon={ResourceLinkIcon} />
                 <div className="border-t border-theme-border/70 pt-3">
                   <AffectedResources issue={issue} resourceHref={resourceHref} onResourceClick={onResourceClick} ResourceLinkIcon={ResourceLinkIcon} />
@@ -273,7 +300,11 @@ function Diagnosis({ issue }: { issue: Issue }) {
   const { headline, detail } = issueMessageParts(issue);
   // When the issue carries a parsed plain-English cause, lead with it. The raw
   // detector message is kept below as de-emphasized detail.
-  const rawMessage = issue.cause ? issue.message ?? '' : [headline, detail].filter(Boolean).join(' ');
+  const visibleMessage = [headline, detail].filter(Boolean).join(' ');
+  const rawMessage = issue.raw_message ?? (issue.cause ? issue.message ?? '' : '');
+  const shouldShowRawMessage = issue.cause
+    ? Boolean(rawMessage)
+    : Boolean(issue.raw_message && issue.raw_message !== visibleMessage);
   return (
     <section className="flex flex-col gap-1">
       <h4 className="text-[11px] font-semibold uppercase tracking-wide text-theme-text-tertiary">What's wrong</h4>
@@ -308,9 +339,9 @@ function Diagnosis({ issue }: { issue: Issue }) {
           {issue.operation_retry_count ? ` · retried ${issue.operation_retry_count}×` : ''}
         </p>
       ) : null}
-      {/* Raw detector message, de-emphasized — shown below the parsed cause so
-          the precise error (URLs, resource names) is available without leading. */}
-      {issue.cause && rawMessage ? (
+      {/* Raw detector message, de-emphasized so precise controller/kubelet text
+          remains available without leading the diagnosis. */}
+      {shouldShowRawMessage ? (
         <p className="break-words font-mono text-[11px] leading-relaxed text-theme-text-tertiary">{rawMessage}</p>
       ) : null}
       {crash ? <p className="text-xs text-theme-text-tertiary tabular-nums">{crash}</p> : null}
@@ -366,6 +397,14 @@ function DiagnosticContext({
           <li key={`${fact.type}-${idx}`} className="flex flex-col gap-1.5 rounded-md border border-theme-border/70 px-2.5 py-2">
             <div className="flex min-w-0 items-baseline gap-2">
               <span className="shrink-0 text-xs font-medium text-theme-text-secondary">{diagnosticFactLabel(fact.type)}</span>
+              {fact.confidence ? (
+                <span
+                  className="shrink-0 badge-sm text-[10px] text-theme-text-tertiary"
+                  title={confidenceTitle(fact.confidence)}
+                >
+                  {fact.confidence} confidence
+                </span>
+              ) : null}
               {fact.message ? <span className="min-w-0 break-words text-xs leading-relaxed text-theme-text-tertiary">{fact.message}</span> : null}
             </div>
             {fact.related_issues?.length ? (
@@ -375,6 +414,7 @@ function DiagnosticContext({
                     key={`${related.ref.group ?? ''}/${related.ref.kind}/${related.ref.namespace ?? ''}/${related.ref.name}#${relIdx}`}
                     label="Related"
                     refForLink={memberRef(issue, related.ref)}
+                    count={related.count}
                     resourceHref={resourceHref}
                     onResourceClick={onResourceClick}
                     ResourceLinkIcon={ResourceLinkIcon}
@@ -402,42 +442,6 @@ function DiagnosticContext({
   );
 }
 
-function diagnosticRoleLabel(role: string): string {
-  switch (role) {
-    case 'candidate':
-      return 'Candidate signal';
-    case 'affected':
-      return 'Affected signal';
-    case 'rollup':
-      return 'Rollup';
-    default:
-      return 'Context';
-  }
-}
-
-function diagnosticFactLabel(type: string): string {
-  switch (type) {
-    case 'explicit_reference':
-      return 'Explicit reference';
-    case 'owner_rollup':
-      return 'Owner rollup';
-    case 'selected_backend_issue':
-      return 'Selected backend';
-    case 'service_config_mismatch':
-      return 'Service config';
-    case 'service_env_reference':
-      return 'Service env';
-    case 'probe_target_mismatch':
-      return 'Probe target';
-    case 'blocked_init_container':
-      return 'Init container';
-    case 'restart_cause':
-      return 'Restart cause';
-    default:
-      return type.replace(/_/g, ' ');
-  }
-}
-
 // Native-tooltip detail for the collapsed-row age chip: absolute first-seen + last-seen
 // freshness, the two facts the compact "2h" hides.
 function ageTitle(issue: Issue): string {
@@ -505,12 +509,14 @@ function AffectedResources({
 function ResourceLine({
   label,
   refForLink,
+  count,
   resourceHref,
   onResourceClick,
   ResourceLinkIcon,
 }: {
   label?: string;
   refForLink: IssueResourceRef;
+  count?: number;
   resourceHref?: (ref: IssueResourceRef) => string;
   onResourceClick?: (ref: IssueResourceRef) => void;
   ResourceLinkIcon: ComponentType<{ className?: string }>;
@@ -525,6 +531,9 @@ function ResourceLine({
         {r.namespace ? `${r.namespace} / ` : ''}
         {r.name}
       </span>
+      {count && count > 1 ? (
+        <span className="shrink-0 text-[10px] text-theme-text-tertiary tabular-nums" title={`${count} affected resources grouped under this issue`}>{count} affected</span>
+      ) : null}
       {linkable && <ResourceLinkIcon className="h-3 w-3 shrink-0 text-theme-text-tertiary opacity-0 transition-opacity group-hover/r:opacity-100" />}
     </>
   );

package/src/components/issues/ResourceIssuesSection.tsx

@@ -0,0 +1,145 @@
+import { AlertTriangle, ExternalLink } from 'lucide-react'
+import { Section } from '../ui/drawer-components'
+import { Badge } from '../ui/Badge'
+import type { Issue, IssueResourceRef } from './types'
+import { categoryLabel } from './severity'
+import { diagnosticRoleLabel, diagnosticFactLabel, confidenceTitle } from './diagnostic'
+
+/**
+ * ResourceIssuesSection — the compact "Operational Issues" block for the resource
+ * detail. Renders the live, diagnosed Issues that touch one resource (its own +,
+ * for a workload, its owned pods' issues, server-rolled-up via RelatedIssues).
+ * The diagnosis sibling of IssuesView's queue row — same Cause/Action vocabulary,
+ * stripped of the queue chrome (accordion, scope copy, fan-out expansion).
+ *
+ * Header mirrors the queue: the plain `categoryLabel` is the operator-facing
+ * headline and the raw `reason` rides alongside as a muted signal (so the K8s
+ * jargon is available but not the lead). Body is intentionally just the plain
+ * `cause` (which names the offending object) + the `Next step` — the diagnosis
+ * and the fix. The raw `message`/evidence stays in the queue + MCP where the
+ * locator detail is wanted; inline it mostly restated the cause or the category,
+ * so it's omitted to keep the card scannable. (`message` is the body fallback
+ * only for categories that don't yet emit a `cause`.)
+ */
+export function ResourceIssuesSection({
+  issues,
+  onResourceClick,
+}: {
+  issues: Issue[] | undefined
+  /** When provided, related resources in a causal link become clickable. */
+  onResourceClick?: (ref: IssueResourceRef) => void
+}) {
+  if (!issues || issues.length === 0) return null
+  return (
+    <Section title={`Operational Issues (${issues.length})`} icon={AlertTriangle} defaultExpanded>
+      <div className="space-y-3">
+        {issues.map((issue) => {
+          return (
+            <div key={issue.id} className="card-inner">
+              <div className="mb-1 flex min-w-0 items-baseline gap-2">
+                <Badge severity={issue.severity === 'critical' ? 'error' : 'warning'} size="sm">
+                  {issue.severity}
+                </Badge>
+                <span className="shrink-0 text-sm font-medium text-theme-text-primary">{categoryLabel(issue.category)}</span>
+                {issue.reason ? (
+                  <span className="min-w-0 flex-1 truncate text-xs text-theme-text-tertiary">{issue.reason}</span>
+                ) : null}
+                {issue.count ? (
+                  <span className="shrink-0 text-xs text-theme-text-tertiary tabular-nums">· {issue.count} affected</span>
+                ) : null}
+              </div>
+              {issue.cause ? (
+                <p className="text-sm leading-relaxed text-theme-text-secondary">{issue.cause}</p>
+              ) : issue.message ? (
+                <p className="text-sm leading-relaxed text-theme-text-secondary">{issue.message}</p>
+              ) : null}
+              {issue.action ? (
+                <p className="mt-1 text-sm leading-relaxed text-theme-text-secondary">
+                  <span className="font-medium text-theme-text-primary">Next step: </span>
+                  {issue.action}
+                </p>
+              ) : null}
+              {issue.remediation_kind === 'create-namespace' && issue.remediation_target ? (
+                <p className="mt-1 text-xs text-theme-text-tertiary">
+                  Suggested fix: create namespace{' '}
+                  <code className="rounded bg-theme-elevated px-1 font-mono">{issue.remediation_target}</code> — apply it from the GitOps detail page.
+                </p>
+              ) : null}
+              <CausalContext issue={issue} onResourceClick={onResourceClick} />
+            </div>
+          )
+        })}
+      </div>
+    </Section>
+  )
+}
+
+/**
+ * CausalContext — the compact, drawer-density rendering of an issue's
+ * cross-subject causal links (DiagnosticContext). Shows only the linking facts
+ * (those carrying a confidence tier or related issues) — the queue's IssuesView
+ * renders the fuller context with clickable resource navigation; here the related
+ * resources are shown as plain identifiers to keep the resource panel scannable.
+ */
+function CausalContext({ issue, onResourceClick }: { issue: Issue; onResourceClick?: (ref: IssueResourceRef) => void }) {
+  const ctx = issue.diagnostic_context
+  const links = ctx?.facts?.filter((f) => f.confidence || (f.related_issues && f.related_issues.length > 0)) ?? []
+  if (!ctx || links.length === 0) return null
+  return (
+    <div className="mt-2 border-t border-theme-border/60 pt-2">
+      <div className="mb-1 flex items-center gap-2">
+        <span className="text-[10px] font-semibold uppercase tracking-wide text-theme-text-tertiary">Context</span>
+        {ctx.role ? <span className="badge-sm text-[10px] text-theme-text-secondary">{diagnosticRoleLabel(ctx.role)}</span> : null}
+      </div>
+      <ul className="space-y-1.5">
+        {links.map((fact, idx) => (
+          <li key={`${fact.type}-${idx}`} className="text-xs">
+            <div className="flex flex-wrap items-baseline gap-x-2 gap-y-0.5">
+              <span className="font-medium text-theme-text-secondary">{diagnosticFactLabel(fact.type)}</span>
+              {fact.confidence ? (
+                <span className="badge-sm text-[10px] text-theme-text-tertiary" title={confidenceTitle(fact.confidence)}>
+                  {fact.confidence} confidence
+                </span>
+              ) : null}
+              {fact.message ? <span className="text-theme-text-tertiary">{fact.message}</span> : null}
+            </div>
+            {fact.related_issues && fact.related_issues.length > 0 ? (
+              <ul className="mt-0.5 space-y-0.5 pl-3">
+                {fact.related_issues.map((rel, ri) => {
+                  const label = (
+                    <>
+                      <span className="text-[10px] uppercase tracking-wide text-theme-text-tertiary">{rel.ref.kind}</span>{' '}
+                      <span className="font-mono">
+                        {rel.ref.namespace ? `${rel.ref.namespace} / ` : ''}
+                        {rel.ref.name}
+                      </span>
+                      {rel.count && rel.count > 1 ? (
+                        <span className="ml-1 tabular-nums" title={`${rel.count} affected resources grouped under this issue`}>· {rel.count} affected</span>
+                      ) : null}
+                    </>
+                  )
+                  return (
+                    <li key={ri} className="text-theme-text-tertiary">
+                      {onResourceClick ? (
+                        <button
+                          type="button"
+                          onClick={() => onResourceClick(rel.ref)}
+                          className="group inline-flex items-center gap-1 text-left hover:text-theme-text-secondary"
+                        >
+                          {label}
+                          <ExternalLink className="h-3 w-3 opacity-0 group-hover:opacity-100" />
+                        </button>
+                      ) : (
+                        label
+                      )}
+                    </li>
+                  )
+                })}
+              </ul>
+            ) : null}
+          </li>
+        ))}
+      </ul>
+    </div>
+  )
+}

package/src/components/issues/diagnostic.ts

@@ -0,0 +1,86 @@
+// Shared labels for rendering an issue's DiagnosticContext (the causal-link
+// surface). Used by both the cluster Issues queue (IssuesView) and the
+// per-resource Operational Issues block (ResourceIssuesSection) so the two
+// can't drift on wording.
+
+// Operator-facing — describes the issue's place in the causal picture in plain
+// language, not Radar's internal role taxonomy.
+export function diagnosticRoleLabel(role: string): string {
+  switch (role) {
+    case 'candidate':
+      return 'Possible cause';
+    case 'affected':
+      return 'Affected';
+    case 'rollup':
+      return 'Grouped';
+    default:
+      return 'Context';
+  }
+}
+
+// Operator-facing fact labels — plain language over the implementation-shaped
+// internal type names.
+export function diagnosticFactLabel(type: string): string {
+  switch (type) {
+    case 'explicit_reference':
+      return 'Missing reference';
+    case 'owner_rollup':
+      return 'Grouped from pods';
+    case 'selected_backend_issue':
+      return 'Backend pods';
+    case 'service_config_mismatch':
+      return 'Service config';
+    case 'service_env_reference':
+      return 'Referenced service';
+    case 'probe_target_mismatch':
+      return 'Probe target';
+    case 'blocked_init_container':
+      return 'Init container';
+    case 'restart_cause':
+      return 'Restart evidence';
+    case 'node_blast_radius':
+      return 'Affected workloads';
+    case 'pvc_blast_radius':
+      return 'Blocked pods';
+    case 'apiservice_hpa':
+      return 'Stalled autoscalers';
+    case 'secret_not_ready':
+      return 'Dependent pods';
+    default:
+      return type.replace(/_/g, ' ');
+  }
+}
+
+// Operator-facing lead-in for the symptom→root pointer chip. Honest per fact
+// type: a declared PVC/Secret edge is a cause; a co-located node is only
+// "related" (node pressure can be a shared victim, not the root), so it must not
+// claim "caused by".
+export function incidentParentLabel(factType?: string, confidence?: string): string {
+  switch (factType) {
+    case 'pvc_blast_radius':
+    case 'secret_not_ready':
+      return 'Caused by';
+    case 'apiservice_hpa':
+      return 'Likely cause';
+    case 'node_blast_radius':
+      return 'Related';
+    default:
+      return confidence === 'high' ? 'Caused by' : 'Possible cause';
+  }
+}
+
+// Plain-language gloss for the confidence chip's tooltip — the operator should
+// know a medium link is "these are co-located, the node may be the cause", not a
+// proven fact.
+export function confidenceTitle(confidence: string): string {
+  switch (confidence) {
+    case 'high':
+      return 'High confidence: a declared structural link (selector, owner, or claim reference).';
+    case 'medium':
+      return 'Medium confidence: these resources are related, but causation is inferred — verify before acting.';
+    case 'low':
+      return 'Low confidence: a heuristic match.';
+    default:
+      return '';
+  }
+}

package/src/components/issues/index.ts

@@ -4,6 +4,7 @@
 // names are safe to surface.
 export { IssueRow, IssuesView } from './IssuesView';
 export type { IssueRowProps, IssueRowSlotContext, IssuesViewProps } from './IssuesView';
+export { ResourceIssuesSection } from './ResourceIssuesSection';
 export {
   ISSUE_SEVERITIES,
   ISSUE_SEVERITY_RANK,
@@ -11,7 +12,7 @@ export {
   subjectRef,
   memberRef,
 } from './types';
-export type { Issue, IssueSeverity, IssueAffected, IssueResourceRef, IssueDiagnosticContext, IssueDiagnosticFact, IssueDiagnosticIssueRef, IssueDiagnosticRole, IssueChangeContext, IssueRecentChange, IssueRecentChangeField } from './types';
+export type { Issue, IssueSeverity, IssueAffected, IssueResourceRef, IssueDiagnosticContext, IssueDiagnosticFact, IssueDiagnosticConfidence, IssueDiagnosticIssueRef, IssueDiagnosticRole, IssueIncidentParent, IssueChangeContext, IssueRecentChange, IssueRecentChangeField } from './types';
 export {
   ISSUE_SEVERITY_LABEL,
   ISSUE_SEVERITY_BADGE_CLASS,

package/src/components/issues/issues.test.ts

@@ -1,6 +1,9 @@
 import { describe, it, expect } from 'vitest'
+import { createElement } from 'react'
+import { renderToString } from 'react-dom/server'
 import { compareIssues, subjectRef, memberRef, normalizeImagePullMessage, issueMessageParts, type Issue } from './types'
 import { categoryLabel, groupLabel, groupBadgeClass } from './severity'
+import { IssueRow } from './IssuesView'
 
 const base: Issue = {
   id: 'id-0',
@@ -105,3 +108,21 @@ describe('image-pull message normalization', () => {
     expect(parts.detail).toBe('')
   })
 })
+
+describe('IssueRow diagnosis raw messages', () => {
+  it('shows raw_message when cleaned issue copy has no parsed cause', () => {
+    const issue = mk({
+      category: 'gitops_operation_failed',
+      category_group: 'configuration',
+      severity: 'critical',
+      reason: 'OperationFailed',
+      message: 'app path does not exist',
+      raw_message: 'rpc error: code = Unknown desc = app path does not exist',
+    })
+
+    const html = renderToString(createElement(IssueRow, { issue, open: true, onToggle: () => undefined, as: 'div' }))
+
+    expect(html).toContain('app path does not exist')
+    expect(html).toContain('rpc error: code = Unknown desc = app path does not exist')
+  })
+})

package/src/components/issues/severity.ts

@@ -57,7 +57,7 @@ export function groupBadgeClass(group: string): string {
 // new category needs no frontend deploy to APPEAR); the UI humanizes for
 // display, falling back to title-cased snake_case for anything unmapped.
 const CATEGORY_LABEL: Record<string, string> = {
-  unschedulable: 'Unschedulable',
+  unschedulable: "Can't be scheduled",
   quota_exceeded: 'Quota exceeded',
   admission_webhook_blocking: 'Admission blocked',
   image_pull_failed: 'Image pull failed',
@@ -65,12 +65,12 @@ const CATEGORY_LABEL: Record<string, string> = {
   init_container_failed: 'Init container failed',
   crashloop: 'Crash loop',
   oom_killed: 'OOM killed',
-  liveness_probe_failed: 'Liveness probe failing',
-  readiness_failed: 'Readiness failing',
+  liveness_probe_failed: 'Health check failing',
+  readiness_failed: 'Not ready for traffic',
   workload_degraded: 'Workload degraded',
   high_restart: 'High restart count',
   missing_config_ref: 'Missing reference',
-  pdb_blocks_evictions: 'PDB blocks evictions',
+  pdb_blocks_evictions: 'Evictions blocked',
   secret_sync_failed: 'Secret sync failed',
   service_no_endpoints: 'No endpoints',
   ingress_backend_missing: 'Ingress backend missing',
@@ -88,22 +88,23 @@ const CATEGORY_LABEL: Record<string, string> = {
   job_failed: 'Job failed',
   cronjob_failed: 'CronJob failed',
   rollout_stalled: 'Rollout stalled',
-  hpa_limited_or_failed: 'HPA limited',
-  rbac_forbidden: 'RBAC forbidden',
+  hpa_limited_or_failed: 'Autoscaling limited',
+  rbac_forbidden: 'Permission denied',
   certificate_not_ready: 'Certificate not ready',
-  pod_security_violation: 'Pod Security violation',
+  pod_security_violation: 'Pod Security blocked',
   node_not_ready: 'Node not ready',
   node_provisioning_failed: 'Node provisioning failed',
-  apiservice_unavailable: 'APIService unavailable',
+  apiservice_unavailable: 'API extension unavailable',
   crossplane_reconcile_failed: 'Crossplane reconcile failed',
   termination_stuck: 'Stuck terminating',
-  operator_condition_failed: 'Controller condition',
+  operator_condition_failed: 'Controller reports a problem',
   gitops_sync_failed: 'GitOps sync failed',
   gitops_render_failed: 'GitOps render failed',
   gitops_spec_invalid: 'GitOps spec invalid',
   gitops_operation_failed: 'GitOps operation failed',
   gitops_out_of_sync: 'GitOps out of sync',
   gitops_health_degraded: 'GitOps health degraded',
+  helm_release_failed: 'Helm release failed',
   webhook_backend_down: 'Webhook backend down',
   control_plane_not_ready: 'Control plane not ready',
   machine_not_ready: 'Machine not ready',

package/src/components/issues/types.ts

@@ -71,11 +71,31 @@ export interface IssueDiagnosticIssueRef {
   reason?: string;
   category?: string;
   severity?: IssueSeverity;
+  /** How many affected resources fold into this linked issue from the root's
+   *  perspective (e.g. 5 of a PVC's mounting pods under one Deployment issue).
+   *  Absent when the link covers a single resource. */
+  count?: number;
+}
+
+export type IssueDiagnosticConfidence = 'high' | 'medium' | 'low';
+
+/** Reverse pointer from a symptom issue to the root issue that explains it
+ *  (the inverse of diagnostic_context's root→symptom facts). Set only when a
+ *  single root is unambiguous. `ref` is the parent subject for display + deep
+ *  navigation (thread the issue's cluster_id onto it via memberRef). */
+export interface IssueIncidentParent {
+  id: string;
+  ref: IssueResourceRef;
+  category?: string;
+  confidence?: IssueDiagnosticConfidence;
+  fact_type?: string;
 }
 
 export interface IssueDiagnosticFact {
   type: string;
   message?: string;
+  /** How certain a cross-subject causal link is. Absent for non-causal facts. */
+  confidence?: IssueDiagnosticConfidence;
   refs?: IssueResourceRef[];
   related_issues?: IssueDiagnosticIssueRef[];
 }
@@ -99,6 +119,7 @@ export interface IssueRecentChangeField {
 }
 
 export interface IssueRecentChange {
+  source?: string;
   kind: string;
   namespace?: string;
   name: string;
@@ -153,6 +174,7 @@ export interface Issue {
 
   reason: string;
   message?: string;
+  raw_message?: string;
   /** Parsed domain diagnosis: plain-English cause, suggested next step, and
    *  an optional structured one-click fix.
    *  Server-emitted (omitempty); empty for issues without a parser. */
@@ -177,6 +199,7 @@ export interface Issue {
   members?: IssueResourceRef[];
   members_truncated?: boolean;
   diagnostic_context?: IssueDiagnosticContext;
+  incident_parent?: IssueIncidentParent;
   change_context?: IssueChangeContext;
 
   // Pod crash context carried from the representative member.