# HyperTwist Phase 6R-AH first-party operator-facing native capture-route workflow shell preparation packet

Created on `2026-05-26`

## Status

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

## Purpose

This packet scopes the next bounded first-party slice above the landed speech
session, microphone-shell, permission/readiness shell, permission-workflow,
native capture-route workflow/control, payload-custody, provider-custody,
provider-routing, normalized usage/cost event, operator-facing usage/cost
dashboard, provider usage/cost history/export, provider receipt-review,
provider billing-settlement, and provider settlement-exception seams.

The granted slice is:

- first-party operator-facing native capture-route workflow shell only

It is not:

- an unrestricted low-level audio-device takeover packet
- an actual OS permission-grant execution packet
- an actual payment execution packet
- a provider-portal ownership packet
- an actual payload-shipping 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_AG_FIRST_PARTY_NATIVE_CAPTURE_ROUTE_OWNERSHIP_AND_WORKFLOW_PREPARATION_CONTROL_IMPLEMENTATION_PACKET_2026-05-26.md`
- `docs/arch/HYPERTWIST_PHASE6R_AF_FIRST_PARTY_REAL_DEVICE_PERMISSION_WORKFLOW_IMPLEMENTATION_PACKET_2026-05-25.md`
- `docs/arch/HYPERTWIST_PHASE6R_V_WHISPER_CPP_DEVICE_PERMISSION_AND_CAPTURE_ROUTE_READINESS_SHELL_IMPLEMENTATION_PACKET_2026-05-24.md`
- `docs/arch/HYPERTWIST_PHASE6R_AA_FIRST_PARTY_OPERATOR_FACING_PROVIDER_USAGE_COST_DASHBOARD_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 bounded operator-facing native
  capture-route shell owner for this slice
- `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-AH` slice may land:

1. first-party native capture-route shell profile ids and definitions
2. derived operator-facing native capture-route shell-state record shapes
3. session-config and companion-session-state expansion for those shapes
4. bounded capability exposure for:
   - `nativeCaptureRouteWorkflowShell`
   - `captureRouteOwnershipSummaryCard`
   - `captureRoutePreparationCard`
   - `captureRouteSessionReopenCard`
5. focused automation for:
   - shell-session config/default posture
   - cleared shell posture
   - permission-dependency shell posture
   - preparation-required shell posture

The packet must stay out of:

- unrestricted low-level audio-device takeover
- actual OS permission-grant execution ownership
- actual payment execution
- provider-portal ownership
- actual payload download or redistribution ownership

## Proposed implementation shape

Land the narrower first-party boundary through:

- retained recognition contract types for:
  - native capture-route shell profile
  - native capture-route shell state
  - expanded speech session config
  - expanded companion speech session state
- contract-library defaults for:
  - native capture-route shell profile ids and definitions
  - shell panel ids and action bindings
  - service-health capability exposure
- training-subsystem composition for:
  - ownership-summary shell posture
  - permission-dependency banner posture
  - preparation card posture
  - session-reopen card posture
  - explicit separation between bounded shell posture and unrestricted
    low-level audio-device takeover
  - explicit separation between bounded shell posture and actual OS
    permission-grant execution
- direct speech-client health capability exposure for:
  - `nativeCaptureRouteWorkflowShell`
  - `captureRouteOwnershipSummaryCard`
  - `captureRoutePreparationCard`
  - `captureRouteSessionReopenCard`

## Validation target

Validate with:

- Unreal build for `UnrealHyperTwistEditor Win64 Development`
- focused automation:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AH`
- regressions:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AG`
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AF`
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.V`

## Queue effect

If this packet lands cleanly, the speech-adjacent queue should still stay
narrow.

If another first-party speech packet is later justified, it must prove a
narrower remaining operator-facing native capture-route consumption gap before
widening into:

- actual OS permission-grant execution
- actual payment execution
- provider-portal ownership
- actual payload shipping
- broad voice-output ownership
- broad assistant-platform scope
