# HyperTwist Phase 4 dashboard live guidance deck preview and handoff recommendation inspect surface packet

- bounded Phase `4` dashboard-consumer slice
- date: `2026-05-09`

## Intent

Stay on the deliberate live `UHyperTwistCoachDashboardWidget` guidance-consumer lane and expose the remaining surfaced recommended/follow-up deck preview state and live coach handoff recommendation state directly to gameplay and Blueprint callers.

## Why this packet exists

The dashboard already derived:

- the displayed recommended guidance deck preview line
- the displayed follow-up guidance deck preview line
- the current coach handoff recommendation line and retained recommendation detail posture

But that live state still only surfaced through dashboard text blocks. Callers still had to scrape widget presentation or reopen deck-preview / handoff derivation to inspect what the dashboard was currently showing.

## What changed

- added `FHyperTwistTrainingCoachDashboardGuidanceDeckPreviewInspectSurface`
- added `FHyperTwistTrainingCoachDashboardHandoffRecommendationInspectSurface`
- added `GetDisplayedRecommendedGuidanceDeckPreviewInspectSurface()`
- added `GetDisplayedFollowUpGuidanceDeckPreviewInspectSurface()`
- added `GetDisplayedCoachHandoffRecommendationInspectSurface()`
- retained the exact displayed preview / recommendation lines inside the widget so the new inspect surfaces report the same live strings the dashboard is already presenting
- kept the packet bounded to `UHyperTwistCoachDashboardWidget` plus shared surface types, with no dashboard redesign and no backend continuity changes

## Files

- `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Public\HyperTwistTraining\HyperTwistTrainingTypes.h`
- `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Public\HyperTwistTraining\HyperTwistCoachDashboardWidget.h`
- `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Private\HyperTwistTraining\HyperTwistCoachDashboardWidget.cpp`
- `C:\HyperTwist\docs\HYPERTWIST_ROADMAP_OVERHAUL_EXPANSION_GUIDE.md`

## Outcome

Gameplay and Blueprint callers can now inspect:

- the displayed recommended guidance deck preview, including deck identity, selection posture, brief fallback, and preview-case summary
- the displayed follow-up guidance deck preview, including deck identity, selection posture, brief fallback, and preview-case summary
- the live coach handoff recommendation, including readiness posture, retained recommendation source posture, and current accepted-packet / method-drill / exact-branch reinforcement flags

without scraping dashboard text blocks or reopening deck-preview / handoff derivation.

## Validation

- full `Development Editor | Win64` MSBuild on `UnrealHyperTwist.sln`
  - passed with `0 Warning(s), 0 Error(s)`

## Next clean slice

Stay on the same live dashboard guidance-consumer lane and land the displayed coach handoff status, displayed transition status, and displayed continuation / queued / follow-up / recommended run action-label inspect surface group.
