[P3] kubectl grove compare command - Plan vs actual comparison

[athreesh]

Summary

Implement kubectl grove compare command to compare AIConfigurator predictions to actual runtime performance.

Goal

Show whether deployed workload meets planned performance targets.

Usage

kubectl grove compare <podcliqueset-name> [-n namespace]

Expected Output

Plan vs Actual Comparison: my-inference

┌─────────────────────┬──────────────┬──────────────┬────────────┐
│ Metric              │ Planned      │ Actual       │ Status     │
├─────────────────────┼──────────────┼──────────────┼────────────┤
│ Throughput          │ 804 tok/s/gpu│ 756 tok/s/gpu│ ⚠ -6%      │
│ TTFT (p99)          │ ≤300ms       │ 342ms        │ ❌ EXCEED  │
│ PlacementScore      │ 1.0          │ 0.72         │ ⚠ -28%     │
└─────────────────────┴──────────────┴──────────────┴────────────┘

Diagnosis:
  PlacementScore 0.72 → prefill pods split across 2 racks

Recommendations:
  1. Reschedule prefill pods to consolidate on rack-1

Prerequisites

• P1: kubectl grove plan (for stored plan)
• P3: kubectl grove metrics (for actual metrics)

Priority

P3 - Metrics Integration

[athreesh]

Implementation Complete

The kubectl grove compare command has been implemented with the following features:

Features

• Configuration Comparison:

  • Replica counts per role
  • GPU counts per role
  • Tensor parallel size

• Topology Analysis:

  • Planned vs actual pack constraint
  • PlacementScore analysis
  • Rack distribution detection

• Auto-generated Insights:

  • Diagnosis of issues (suboptimal placement, mismatches)
  • Actionable recommendations

Example Output

Plan vs Actual: my-inference

Configuration:
┌─────────────────┬──────────────┬──────────────┬────────────┐
│ Setting         │ Planned      │ Actual       │ Status     │
├─────────────────┼──────────────┼──────────────┼────────────┤
│ Prefill Replicas│ 4            │ 4            │ ✓ Match    │
│ Decode GPUs     │ 4            │ 4            │ ✓ Match    │
│ PlacementScore  │ 1.0          │ 0.72         │ ⚠ -28%     │
└─────────────────┴──────────────┴──────────────┴────────────┘

Diagnosis:
  ⚠ PlacementScore 0.72 indicates suboptimal placement

Files

• cmd/kubectl-grove/internal/commands/compare.go (~817 lines)
• cmd/kubectl-grove/internal/commands/compare_test.go (~886 lines)

PR: #338

[athreesh]

Implemented in PR #338