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

Created on `2026-05-24`

## Status

- first-party HyperTwist packet
- source-backed `Phase 6R-Y` preparation/control slice

## Purpose

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

The granted slice is:

- first-party provider routing and workflow-policy metadata only

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 control pass stands on:

- `docs/ops/HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `docs/arch/HYPERTWIST_PHASE6R_X_FIRST_PARTY_PROVIDER_PROFILE_AND_BYOK_CUSTODY_IMPLEMENTATION_PACKET_2026-05-24.md`
- `docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md`

The preserved owners do not change here:

- first-party HyperTwist remains the top-level provider/session owner
- first-party HyperTwist remains the 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

## Granted family

The bounded `Phase 6R-Y` slice may land:

1. first-party provider-routing policy ids and definitions
2. first-party route-decision summaries for session config and service health
3. explicit fallback-health posture wording above provider-backed route failure
4. workflow-policy capability exposure in the bounded speech-health seam
5. focused automation for mock-route and provider-backed-route posture

The packet must stay out of:

- normalized usage/cost event ownership
- actual provider-gateway fan-out ownership
- real secret-storage workflow ownership
- payload download or redistribution ownership
- real device-permission workflow ownership

## Proposed implementation shape

Land the narrower first-party boundary through:

- retained recognition contract types for:
  - routing-policy definition
  - route-decision summary
  - expanded speech session config
  - expanded speech service health
- contract-library defaults for:
  - provider-backed route policy
  - local mock route policy
  - explicit route-decision defaults
- training-subsystem normalization for:
  - requested session-route posture
  - health-surface route posture
  - fallback-health route posture on provider failure
- direct speech-client health capability exposure for:
  - `providerRoutingPolicy`
  - `providerRouteSelection`
  - `workflowPolicyState`

## Validation target

Validate with:

- Unreal build for `UnrealHyperTwistEditor Win64 Development`
- focused automation:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.Y`
- regressions:
  - `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`

## Queue effect

If this packet lands cleanly, the next bounded move becomes:

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

Keep the narrow sequencing guards visible:

- keep actual payload shipping separate from routing/policy ownership
- keep real device-permission workflow and native capture-route ownership
  outside this packet
- keep normalized usage/cost events as the next separate first-party family
