# HyperTwist Phase 6R-AG first-party native capture-route ownership and workflow preparation/control preparation packet

Created on `2026-05-26`

## Status

- first-party HyperTwist packet
- source-backed `Phase 6R-AG` 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,
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 native capture-route ownership and workflow preparation/control
  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_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/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 native capture-route workflow
  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-AG` slice may land:

1. first-party native capture-route workflow profile ids and definitions
2. derived native capture-route workflow entry, issue, and state record shapes
3. session-config and companion-session-state expansion for those shapes
4. bounded capability exposure for:
   - `nativeCaptureRouteWorkflow`
   - `captureRoutePreparationControl`
   - `captureRouteOwnershipAssessment`
   - `reopenSpeechSession`
5. focused automation for:
   - cleared ownership posture
   - permission-workflow dependency posture
   - preparation-required posture
   - route/session reopen 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 workflow profile
  - native capture-route workflow entry
  - native capture-route workflow issue
  - native capture-route workflow state
  - expanded speech session config
  - expanded companion speech session state
- contract-library defaults for:
  - native capture-route workflow profile ids and definitions
  - action bindings and panel ids
  - service-health capability exposure
- training-subsystem composition for:
  - session-open-required posture
  - permission-workflow dependency posture
  - preparation-required posture
  - capture-route retry posture
  - explicit separation between bounded workflow control and unrestricted
    low-level audio-device takeover
  - explicit separation between bounded workflow control and actual OS
    permission-grant execution
- direct speech-client health capability exposure for:
  - `nativeCaptureRouteWorkflow`
  - `captureRoutePreparationControl`
  - `captureRouteOwnershipAssessment`
  - `reopenSpeechSession`

## Validation target

Validate with:

- Unreal build for `UnrealHyperTwistEditor Win64 Development`
- focused automation:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AG`
- regressions:
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AF`
  - `HyperTwist.Permissive.WhisperCpp.Phase6R.AE`
  - `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 native capture-route ownership gap before widening into:

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