Skip to content

Themed insight detail view + discoverable insight IDs (REF-149) - #69

Merged
dantech2000 merged 1 commit into
mainfrom
ref-insight-detail-view
Jun 15, 2026
Merged

Themed insight detail view + discoverable insight IDs (REF-149)#69
dantech2000 merged 1 commit into
mainfrom
ref-insight-detail-view

Conversation

@dantech2000

Copy link
Copy Markdown
Owner

Two fixes from validating REF-137 against your real cluster.

1. The --id detail view now uses the design system (and shows the doc links)

It was a plain fmt.Printf dump that didn't match describe/status — and it silently dropped additionalInfo (the EKS doc links, often the most useful part: your AL2 insight had 5 of them). Now a themed insightDetailLines:

  • header + status token, then sections: OVERVIEW (category / targets / id / refreshed), DESCRIPTION and RECOMMENDATION (word-wrapped paragraphs, not one runaway line), AFFECTED RESOURCES, MORE INFORMATION (the additionalInfo links, sorted), and the DEPRECATED APIs caller breakdown when present.
  • -o plain keeps an uncolored label/value layout, now including the links.

2. Insight IDs are discoverable

You asked: how would the user know the ID to pass to --id? They couldn't — the table didn't show it. Now:

  • The upgrade-check insights table has a short ID column (8-char prefix) + a hint: drill into one: cluster upgrade-check -c <c> --id <id|name>.
  • --id accepts a full ID, a short ID prefix, or a case-insensitive name substring (ResolveInsightID). So you can just type --id "amazon linux" or --id bc8b2f86. Ambiguous queries list the candidates; exact ID always wins.

Consistency

Mirrors the existing themed views (sections, status tokens, KV) so it reads like the rest of the tool.

Tests

  • ResolveInsightID — exact / prefix / name / ambiguous / none (EKS mock)
  • insightDetailLines golden — recommendation + additionalInfo (sorted) + no-deprecations; plus a deprecations case with clientStats
  • wrapText — wrapping + whitespace collapse
  • Docs reference regenerated for the new --id help. go build/vet/test -race/golangci-lint/docs-drift all clean.

🤖 Generated with Claude Code

…t IDs (REF-149)

The --id detail view was a plain fmt.Printf dump and silently dropped
additionalInfo (the EKS doc links). Rewrote it through the design system
(insightDetailLines: header+status, OVERVIEW, wrapped DESCRIPTION/RECOMMENDATION,
AFFECTED RESOURCES, MORE INFORMATION links, DEPRECATED APIs caller breakdown);
-o plain keeps an uncolored layout and now includes additionalInfo too.

Insight IDs weren't discoverable — the table showed no ID, so users couldn't
know what to pass to --id. Added a short ID column (8-char prefix) + a drill-in
hint, and made --id resolve a full ID, a short prefix, or a case-insensitive
name substring (ResolveInsightID on the cluster service; ambiguous queries list
candidates).

Tests: ResolveInsightID (exact/prefix/name/ambiguous/none), insightDetailLines
golden + deprecations, wrapText. Docs reference regenerated for the new --id help.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dantech2000
dantech2000 merged commit e546903 into main Jun 15, 2026
6 checks passed
@dantech2000
dantech2000 deleted the ref-insight-detail-view branch June 15, 2026 19:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant