# HyperTwist Phase 6R-AC first-party provider receipt review and posted-charge inspection preparation packet

Created on `2026-05-25`

## Status

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

## Purpose

This packet scopes the next bounded first-party slice above the landed speech
session, microphone-shell, payload-custody, provider-custody,
provider-routing, normalized usage/cost event, operator-facing
usage/cost dashboard, and provider usage/cost history/export seams.

The granted slice is:

- first-party provider receipt review and posted-charge inspection shell only

It is not:

- an actual billing settlement packet
- an invoice reconciliation packet
- an actual payment execution packet
- a provider-portal ownership packet
- an actual payload-shipping packet
- a real device-permission workflow packet
- a native audio-device route ownership 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_AB_FIRST_PARTY_PROVIDER_USAGE_COST_HISTORY_EXPORT_SHELL_IMPLEMENTATION_PACKET_2026-05-25.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
- first-party HyperTwist remains the receipt-review shell 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-AC` slice may land:

1. first-party receipt-review shell profile ids and definitions
2. derived receipt-review entry, issue, and shell-state record shapes
3. session-config and companion-session-state expansion for those shapes
4. bounded capability exposure for:
   - `providerReceiptReviewShell`
   - `providerPostedChargeInspection`
   - `providerChargeVarianceReview`
5. focused automation for estimate-only review posture and provider-backed
   fallback inspection posture

The packet must stay out of:

- actual billing settlement
- invoice reconciliation ownership
- actual payment execution
- provider-portal ownership
- actual payload download or redistribution ownership
- real device-permission workflow ownership
- native audio-device route ownership

## Proposed implementation shape

Land the narrower first-party boundary through:

- retained recognition contract types for:
  - provider receipt-review shell profile
  - provider receipt-review entry
  - provider receipt-review issue
  - provider receipt-review shell state
  - expanded speech session config
  - expanded companion speech session state
- contract-library defaults for:
  - receipt-review shell profile ids and definitions
  - receipt-review action bindings and panel ids
  - service-health capability exposure
- training-subsystem composition for:
  - bounded review posture derived from retained history/export snapshots
  - posted-charge inspection readiness posture
  - charge-variance review posture
  - route-degraded and charge-pending issue posture
- direct speech-client health capability exposure for:
  - `providerReceiptReviewShell`
  - `providerPostedChargeInspection`
  - `providerChargeVarianceReview`

## Validation target

Validate with:

- Unreal build for `UnrealHyperTwistEditor Win64 Development`
- focused automation:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AC`
- regressions:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AB`
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AA`
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.Z`
  - `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-AD` first-party provider billing settlement and
  invoice reconciliation preparation/control pass

Keep the narrow sequencing guards visible:

- keep actual billing settlement and invoice reconciliation separate from
  receipt-review shell ownership
- keep actual payment execution or provider-portal ownership separate from
  receipt-review shell ownership
- keep actual payload shipping separate from usage/cost governance
- keep real device-permission workflow and native capture-route ownership
  outside this packet
