# HyperTwist Phase 6R-Y first-party provider routing and policy implementation packet

Created on `2026-05-24`

## Status

- first-party HyperTwist packet
- bounded `Phase 6R-Y` implementation slice

## Purpose

This packet lands the next bounded first-party slice above the landed speech
session, microphone-shell, payload-custody, and provider-custody seams.

The landed slice is:

- first-party provider routing and workflow-policy metadata

It is not:

- a normalized usage/cost event-model packet
- an actual payload-shipping packet
- a real device-permission workflow packet
- a native audio-device route ownership packet
- a provider-specific overlay packet
- a voice-output packet
- a broad assistant-platform packet

## Current authority basis

This implementation packet stands on:

- `docs/ops/HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `docs/arch/HYPERTWIST_PHASE6R_Y_FIRST_PARTY_PROVIDER_ROUTING_AND_POLICY_PREPARATION_PACKET_2026-05-24.md`
- `docs/arch/HYPERTWIST_PHASE6R_X_FIRST_PARTY_PROVIDER_PROFILE_AND_BYOK_CUSTODY_IMPLEMENTATION_PACKET_2026-05-24.md`

The preserved owners do not change:

- first-party HyperTwist remains the top-level provider/session owner
- first-party HyperTwist remains the provider routing/policy owner
- `ggml-org/whisper.cpp` remains bounded to offline STT donor seams
- `SYSTRAN/faster-whisper` remains bounded to complementary Python
  orchestration/service-lane seams

## Landed scope

The current code now owns a bounded provider-routing / workflow-policy seam
through:

- retained recognition contract types for:
  - `FHyperTwistSpeechProviderRoutingPolicy`
  - `FHyperTwistSpeechProviderRouteDecision`
  - expanded `FHyperTwistSpeechSessionConfig`
  - expanded `FHyperTwistSpeechServiceHealth`
- contract-library defaults for:
  - provider-backed route policy
  - mock verification route policy
  - sample route-decision posture
- active companion session-config and service-health normalization in:
  - `UHyperTwistTrainingSubsystem`
- direct speech-client health capability exposure in:
  - `UHyperTwistHttpSpeechClient`
  - `UHyperTwistMockSpeechClient`
- focused automation coverage in:
  - `HyperTwistWhisperCppPhase6RYProviderRoutingPolicyContractTest.cpp`

## Why this is still intentionally bounded

This packet lands the routing/policy metadata family only.

Still deferred:

- normalized usage/cost events
- actual downloadable payload shipping
- real device-permission workflow
- native audio-device route ownership beyond bounded shell posture
- broad voice-output ownership
- broad assistant-platform scope

## Validation

Build validation:

- `C:\Program Files\Epic Games\UE_5.7\Engine\Build\BatchFiles\Build.bat UnrealHyperTwistEditor Win64 Development -Project='C:\HyperTwist\UnrealHyperTwist\UnrealHyperTwist.uproject' -WaitMutex -NoHotReloadFromIDE -NoUba`

Focused automation validation:

- `Automation RunTests HyperTwist.Permissive.WhisperCpp.Phase6R.Y`

Regression automation validation:

- `HyperTwist.Permissive.WhisperCpp.Phase6R.X`
- `HyperTwist.Permissive.WhisperCpp.Phase6R.W`
- `HyperTwist.Permissive.WhisperCpp.Phase6R.V`
- `HyperTwist.Permissive.WhisperCpp.Phase6R.U`
- `HyperTwist.Permissive.WhisperCpp.Phase6R.E`
- `HyperTwist.Permissive.FasterWhisper.Phase6R.F`
- `HyperTwist.Permissive.Piper.Phase6R.G`
- `HyperTwist.Permissive.Coqui.Phase6R.H`
- `HyperTwist.CleanRoom.CubeDesk`

Expected covered tests:

- `ProviderRoutingPolicySessionConfig`
- `ProviderRoutingPolicyServiceHealth`
- `ProviderBackedRoutingFallback`

## Queue effect

This packet consumes the current `Phase 6R-Y` implementation slice.

`ggml-org/whisper.cpp` remains only partially incorporated:

- landed now:
  - speech transcript session boundary
  - live microphone shell boundary
  - device-permission and capture-route readiness shell posture
  - downloadable model and payload custody boundary
  - first-party provider-profile and BYOK custody boundary
  - first-party provider routing and workflow-policy boundary for:
    - routing-policy ids and definitions
    - route-decision summaries
    - fallback-health posture
    - capability exposure for:
      - `providerRoutingPolicy`
      - `providerRouteSelection`
      - `workflowPolicyState`
- still deferred:
  - normalized usage/cost event model
  - actual downloadable payload shipping
  - real device-permission workflow
  - native audio-device route ownership beyond bounded shell posture
  - broad assistant-platform scope

The next clean move is:

- a source-backed `Phase 6R-Z` first-party normalized usage/cost event-model
  preparation/control pass

Keep the future sequencing guards visible:

- first-party HyperTwist
  - keep the top-level provider/session contract and provider routing/policy
    lane first-party
  - keep normalized usage/cost events separate from the landed provider-routing
    seam
- `ggml-org/whisper.cpp`
  - keep code-license judgments separate from actual model or payload shipping
    review in any follow-on packet
- `SYSTRAN/faster-whisper`
  - keep the row complementary to the landed provider-routing seam and bounded
    to Python orchestration/service-lane ownership rather than usage/cost
    governance ownership
