# HyperTwist Phase 6R-Z first-party normalized usage/cost event-model preparation packet

Created on `2026-05-25`

## Status

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

## Purpose

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

The granted slice is:

- first-party normalized usage/cost event-model metadata only

It is not:

- an operator-facing provider dashboard packet
- an actual billing or charge-settlement 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_Y_FIRST_PARTY_PROVIDER_ROUTING_AND_POLICY_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 usage/cost governance 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-Z` slice may land:

1. first-party usage/cost accounting profile ids and definitions
2. normalized usage-event and cost-event record shapes
3. quota/rate-limit state record shapes
4. session-config and service-health expansion for those shapes
5. bounded capability exposure for:
   - `normalizedUsageEvents`
   - `normalizedCostEvents`
   - `quotaRateLimitState`
6. focused automation for mock-route and provider-backed fallback posture

The packet must stay out of:

- actual billing export or provider invoice reconciliation
- actual payload download or redistribution ownership
- real device-permission workflow ownership
- native audio-device route ownership
- provider-specific dashboard skinning

## Proposed implementation shape

Land the narrower first-party boundary through:

- retained recognition contract types for:
  - usage/cost accounting profile
  - normalized usage event
  - normalized cost event
  - quota/rate-limit state
  - expanded speech session config
  - expanded speech service health
- contract-library defaults for:
  - accounting profile
  - session-config event templates
  - service-health usage/cost summaries
  - quota/rate-limit posture
- training-subsystem normalization for:
  - requested session usage/cost posture
  - health-surface usage/cost posture
  - provider-backed fallback posture on route failure
- direct speech-client health capability exposure for:
  - `normalizedUsageEvents`
  - `normalizedCostEvents`
  - `quotaRateLimitState`

## Validation target

Validate with:

- Unreal build for `UnrealHyperTwistEditor Win64 Development`
- focused automation:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.Z`
- regressions:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.Y`
  - `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-AA` first-party operator-facing provider
  usage/cost dashboard shell preparation/control pass

Keep the narrow sequencing guards visible:

- keep actual billing and settlement separate from normalized event ownership
- keep actual payload shipping separate from usage/cost governance
- keep real device-permission workflow and native capture-route ownership
  outside this packet
