# HyperTwist Phase 4 dashboard live guidance comparison, outcome, and decision-weighting inspect surface packet

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

## Intent

Pivot deliberately off the now-complete retained-history inspect lane and expose the live dashboard guidance comparison, guidance-outcome, and decision-weighting state directly to gameplay and Blueprint callers.

## Why this packet exists

The dashboard already derived:

- the active recap-vs-preview comparison target
- the current repeat / broaden / redirect guidance-outcome posture
- the current authored decision-weighting bias over that same lane and scope

But that live state still only surfaced through dashboard text blocks and the live action button state. Callers still had to scrape widget presentation or reopen comparison/outcome weighting derivation to inspect what the dashboard was currently showing.

## What changed

- added `FHyperTwistTrainingCoachDashboardGuidanceComparisonInspectSurface`
- added `FHyperTwistTrainingCoachDashboardGuidanceOutcomeInspectSurface`
- added `FHyperTwistTrainingCoachDashboardGuidanceDecisionWeightingInspectSurface`
- added `GetDisplayedGuidanceComparisonInspectSurface()`
- added `GetDisplayedGuidanceOutcomeInspectSurface()`
- added `GetDisplayedGuidanceDecisionWeightingInspectSurface()`
- 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 currently displayed recap-vs-preview comparison target with lane, scope, preview-vs-actual deck/mode/selection posture, selected-case alignment, and closed-loop idle comparison posture
- the currently displayed guidance-outcome verdict with the live action button label, applyability posture, and closure-history / deferred-overflow adjustments
- the currently displayed decision-weighting summary with authored lane/scope bias, aligned launched-plan trust posture, and closed-loop idle weighting posture

without scraping dashboard text blocks or reopening comparison/outcome/weighting 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 active guidance preview selection, preview-case detail, rationale, and guidance-preference inspect surface group.
