Expose runtime generated-mode selector request delta and launch preview

UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp

@@ -1401,6 +1401,82 @@ UHyperTwistTrainingRuntimeLibrary::GetActiveTrainingCoachGeneratedModeSelectorOp
 	return FHyperTwistTrainingCoachGeneratedModeSelectorOptionRequestAlignmentSurface();
 }
 
+FHyperTwistTrainingCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface
+UHyperTwistTrainingRuntimeLibrary::GetActiveTrainingCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface(
+	UObject* WorldContextObject,
+	const FString& SelectorId
+)
+{
+	if (UHyperTwistTrainingSubsystem* TrainingSubsystem = GetTrainingSubsystem(WorldContextObject))
+	{
+		const FHyperTwistTrainingRunState RunState = TrainingSubsystem->GetActiveRunState();
+		const FHyperTwistTrainingCoachGeneratedModeSelectorOptionMenuSurface OptionMenuSurface =
+			GetActiveTrainingCoachGeneratedModeSelectorOptionMenuSurface(
+				WorldContextObject,
+				SelectorId
+			);
+		const FHyperTwistTrainingCoachGeneratedModeSelectorOptionDispatchSurface
+			OptionDispatchSurface =
+				GetActiveTrainingCoachGeneratedModeSelectorOptionDispatchSurface(
+					WorldContextObject,
+					SelectorId
+				);
+		const FHyperTwistTrainingCoachGeneratedModeSelectorOptionRequestAlignmentSurface
+			OptionRequestAlignmentSurface =
+				GetActiveTrainingCoachGeneratedModeSelectorOptionRequestAlignmentSurface(
+					WorldContextObject,
+					SelectorId
+				);
+		return UHyperTwistTrainingCoachLibrary::DeriveCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface(
+			RunState,
+			SelectorId,
+			OptionMenuSurface,
+			OptionDispatchSurface,
+			OptionRequestAlignmentSurface
+		);
+	}
+
+	return FHyperTwistTrainingCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface();
+}
+
+FHyperTwistTrainingCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface
+UHyperTwistTrainingRuntimeLibrary::GetActiveTrainingCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface(
+	UObject* WorldContextObject,
+	const FString& SelectorId
+)
+{
+	if (UHyperTwistTrainingSubsystem* TrainingSubsystem = GetTrainingSubsystem(WorldContextObject))
+	{
+		const FHyperTwistTrainingRunState RunState = TrainingSubsystem->GetActiveRunState();
+		const FHyperTwistTrainingCoachGeneratedModeSelectorOptionMenuSurface OptionMenuSurface =
+			GetActiveTrainingCoachGeneratedModeSelectorOptionMenuSurface(
+				WorldContextObject,
+				SelectorId
+			);
+		const FHyperTwistTrainingCoachGeneratedModeSelectorOptionDispatchSurface
+			OptionDispatchSurface =
+				GetActiveTrainingCoachGeneratedModeSelectorOptionDispatchSurface(
+					WorldContextObject,
+					SelectorId
+				);
+		const FHyperTwistTrainingCoachGeneratedModeSelectorOptionRequestAlignmentSurface
+			OptionRequestAlignmentSurface =
+				GetActiveTrainingCoachGeneratedModeSelectorOptionRequestAlignmentSurface(
+					WorldContextObject,
+					SelectorId
+				);
+		return UHyperTwistTrainingCoachLibrary::DeriveCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface(
+			RunState,
+			SelectorId,
+			OptionMenuSurface,
+			OptionDispatchSurface,
+			OptionRequestAlignmentSurface
+		);
+	}
+
+	return FHyperTwistTrainingCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface();
+}
+
 TArray<FHyperTwistTrainingMethodSegment> UHyperTwistTrainingRuntimeLibrary::GetActiveTrainingLearnerMethodSegments(UObject* WorldContextObject)
 {
 	if (UHyperTwistTrainingSubsystem* TrainingSubsystem = GetTrainingSubsystem(WorldContextObject))

UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h

@@ -356,6 +356,20 @@ public:
 		const FString& SelectorId
 	);
 
+	UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|Coach", meta = (WorldContext = "WorldContextObject"))
+	static FHyperTwistTrainingCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface
+	GetActiveTrainingCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface(
+		UObject* WorldContextObject,
+		const FString& SelectorId
+	);
+
+	UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|Coach", meta = (WorldContext = "WorldContextObject"))
+	static FHyperTwistTrainingCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface
+	GetActiveTrainingCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface(
+		UObject* WorldContextObject,
+		const FString& SelectorId
+	);
+
 	UFUNCTION(BlueprintPure, Category = "HyperTwist|Training", meta = (WorldContext = "WorldContextObject"))
 	static TArray<FHyperTwistTrainingMethodSegment> GetActiveTrainingLearnerMethodSegments(UObject* WorldContextObject);
 

docs/HYPERTWIST_ROADMAP_OVERHAUL_EXPANSION_GUIDE.md

@@ -68,8 +68,8 @@ Current correction call from the source-exposed audit and current execution refr
   - the imported generated-mode gap is closed; request/config/selection plumbing and the bounded clean-room executor are already landed in first-party code
   - the latest landed bounded `Phase 4` packet closes the retained-idle comparison/outcome actionability gap at the end of the recognition-assisted coach-to-review continuity lane, and the final retained-surface confirmation pass now leaves that closure lane functionally complete
   - the retained idle widget surface now keeps retained comparison and decision history inspectable without continuing to advertise live launch or guidance-outcome actions once the coach-to-review loop has already collapsed to truthful closed-loop idle
-  - the latest landed bounded `Phase 4` packet stays on that same deliberate `UHyperTwistTrainingRuntimeLibrary` world-context consumer lane and adds active generated-mode selector option execution-impact and selector option request-alignment surfaces over the already-landed launch/execution context, selector option-menu, and selector option dispatch surfaces plus active run state, so gameplay/Blueprint callers can explain direct-start versus stored-request versus refresh-required versus blocked execute posture and preview stored-request alignment without reading raw launch-config, request-match, or unresolved-selector derivation details directly
-  - the current next bounded packet should stay on that same runtime-library consumer lane only if a real world-context gameplay or Blueprint caller still needs one more thin derived coach/generated-mode display contract or displayed-action convenience helper over already-cached state; inside that lane the next aligned pair is the runtime-library generated-mode selector option stored-request delta and hypothetical launch-request payload / refresh-preview surfaces, otherwise choose the next roadmap lane deliberately instead of extending runtime-consumer widening by drift
+  - the latest landed bounded `Phase 4` packet stays on that same deliberate `UHyperTwistTrainingRuntimeLibrary` world-context consumer lane and adds active generated-mode selector option stored-request delta and launch-request preview surfaces over the already-landed selector option-menu, selector option dispatch, and selector option request-alignment surfaces plus active run state, so gameplay/Blueprint callers can explain current-vs-hypothetical-vs-stored selector deltas and preview the resulting generated-mode launch-request payload and refresh posture without reading raw selector-choice arrays or rebuilt launch-config details directly
+  - the current next bounded packet should stay on that same runtime-library consumer lane only if a real world-context gameplay or Blueprint caller still needs one more thin derived coach/generated-mode display contract or displayed-action convenience helper over already-cached state; inside that lane the next aligned pair is the runtime-library generated-mode selector option launch-request metadata preview and launch-request envelope preview surfaces, otherwise choose the next roadmap lane deliberately instead of extending runtime-consumer widening by drift
   - the current execution-discipline rule that broad refactor / monolith-splitting work should not interrupt the active bounded roadmap packet unless structure is actually blocking it
 
 ## Current execution-reality references

docs/arch/HYPERTWIST_PHASE4_RUNTIME_LIBRARY_GENERATED_MODE_SELECTOR_OPTION_STORED_REQUEST_DELTA_LAUNCH_REQUEST_PREVIEW_SURFACE_PACKET_2026-05-09.md

@@ -0,0 +1,52 @@
+# HyperTwist Phase 4 runtime-library generated-mode selector option stored-request delta and launch-request preview surface packet
+
+- bounded Phase `4` runtime-consumer slice
+- date: `2026-05-09`
+
+## Intent
+
+Stay on the deliberate `UHyperTwistTrainingRuntimeLibrary` world-context consumer lane and expose the next truthful generated-mode selector request-delta preview contracts above the already-landed selector option request-alignment surface.
+
+## Why this packet exists
+
+The prior runtime-library packet let world-context callers explain direct-start versus stored-request versus refresh-required versus blocked execute posture and preview stored-request alignment.
+
+But callers still had to inspect raw selector-choice arrays and rebuilt launch-config details if they needed to explain:
+
+- how the hypothetical selector state differs from the current selector state
+- how the hypothetical selector state differs from the stored request
+- how the current selector state differs from the stored request
+- what the resulting generated-mode launch-request payload and refresh posture would be
+
+That kept the runtime-library world-context seam behind the already-landed panel-widget and session-actor selector option stored-request delta and launch-request preview display-contract lane.
+
+## What changed
+
+- added `GetActiveTrainingCoachGeneratedModeSelectorOptionStoredRequestDeltaSurface()`
+- added `GetActiveTrainingCoachGeneratedModeSelectorOptionLaunchRequestPreviewSurface()`
+- derived the stored-request delta surface from the active run state, selected `SelectorId`, and the already-landed runtime-library selector option-menu, selector option dispatch, and selector option request-alignment surfaces
+- derived the launch-request preview surface from that same active run state and `SelectorId` over the runtime-library selector option-menu, selector option dispatch, and selector option request-alignment surfaces
+- kept the runtime-library lane purely compositional over already-cached coach/generated-mode state without reopening backend derivation
+
+## Files
+
+- `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Public\HyperTwistTraining\HyperTwistTrainingRuntimeLibrary.h`
+- `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Private\HyperTwistTraining\HyperTwistTrainingRuntimeLibrary.cpp`
+- `C:\HyperTwist\docs\HYPERTWIST_ROADMAP_OVERHAUL_EXPANSION_GUIDE.md`
+
+## Outcome
+
+World-context gameplay and Blueprint callers can now ask the runtime library for:
+
+- the truthful current-vs-hypothetical-vs-stored selector delta posture
+- the truthful resulting generated-mode launch-request payload preview
+
+without reading raw selector-choice arrays or rebuilt launch-config details directly.
+
+## Validation
+
+- full `Development Editor | Win64` MSBuild on `UnrealHyperTwist.sln`
+
+## Next clean slice
+
+Stay on this runtime-library consumer lane only if a real world-context caller still needs one more thin derived coach/generated-mode display contract or displayed-action convenience helper over already-cached state. The next aligned pair inside that lane would be the runtime-library generated-mode selector option launch-request metadata preview and launch-request envelope preview surfaces, because those are the next truthful launch-request provenance and envelope contracts above the newly-landed launch-request preview surface.