# V2 Xbox GDK SDK Stub

Phase 72 task 72.21.1.6 is implemented by the
[Xbox GDK SDK stub contract](../../ue/Content/V2/Online/XboxGdkSdkStub_V2_Contract.json)
and the `V2OnlineServices` public Xbox API surface. The public bridge is
`V2XboxGdkSdkStubBridge`. This is an NDA-safe interface stub, not a native GDK
implementation. The boundary guarantee is that proprietary headers and symbols
stay in `Restricted/NotForLicensees/Online/PlatformSDK/XboxGDK`.

## Feature Coverage

| Feature           | Public interface                    | Abstract bridge commands                                                                     |
| ----------------- | ----------------------------------- | -------------------------------------------------------------------------------------------- |
| Achievements      | `V2XboxGdkAchievementInterface`     | `Achievements.QueryProgress`, `Achievements.Unlock`, `Achievements.SyncGamerscore`           |
| Xbox Live friends | `V2XboxGdkXboxLiveFriendsInterface` | `XboxLiveFriends.Query`, `XboxLiveFriends.ResolvePresence`, `XboxLiveFriends.Invite`         |
| Quick Resume      | `V2XboxGdkQuickResumeInterface`     | `QuickResume.SaveState`, `QuickResume.RestoreState`, `QuickResume.ValidateSuspendResume`     |
| Smart Delivery    | `V2XboxGdkSmartDeliveryInterface`   | `SmartDelivery.QueryEntitlement`, `SmartDelivery.ResolvePackage`, `SmartDelivery.FailClosed` |
| Game Pass         | `V2XboxGdkGamePassInterface`        | `GamePass.QueryEntitlement`, `GamePass.RefreshBenefits`, `GamePass.FailClosed`               |

## Guard Rails

The public module only defines stable request, config, and operation-plan
shapes. Restricted adapters are named as opaque targets so gameplay code can
plan work without including NDA GDK headers.

Plans are only ready when the restricted module is loaded, the build is
certification-scoped, an Xbox Live user is signed in, and the platform SDK
abstraction route is active. Quick Resume requires serialized session state.
Smart Delivery and Game Pass checks fail closed unless entitlement verification
succeeds.

## Verification

Run the focused gate with:

```bash
python3 V2/ue/Tools/check-v2-xbox-gdk-sdk-stub.py
```

The checker validates the contract, C++ source declarations, automation spec,
CI/Horde wiring, this document, Phase 72 TODO evidence, and the NDA-safe public
boundary.