# HyperTwist Phase 6R-V whisper.cpp device-permission and capture-route readiness shell preparation packet

Created on `2026-05-24`

## Status

- historical same-day preparation authority
- bounded post-`Phase 6R-U` control slice
- the first bounded implementation slice now lands separately under:
  - `docs/arch/HYPERTWIST_PHASE6R_V_WHISPER_CPP_DEVICE_PERMISSION_AND_CAPTURE_ROUTE_READINESS_SHELL_IMPLEMENTATION_PACKET_2026-05-24.md`

## Purpose

This packet freezes the next widening order after the landed `Phase 6R-U`
`whisper.cpp` live microphone capture shell slice.

The open task was:

- define the next bounded source-backed widening packet for
  `ggml-org/whisper.cpp` as the retained `Phase 6R-V`
  device-permission and capture-route readiness shell seam

It is not:

- a full `whisper.cpp` row transplant
- a real device-permission workflow packet
- a native audio-device route ownership packet
- a downloadable model or payload-shipping packet
- a `SYSTRAN/faster-whisper` provider/service rewrite packet
- a `rhasspy/piper` or `coqui-ai/TTS` voice-output packet
- a broad assistant-platform packet

## Current authority basis

This preparation packet stands on already-closed authority:

- `docs/REPO_LICENSE_TRACKING.md`
- `docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md`
- `docs/arch/HYPERTWIST_PHASE6R_U_WHISPER_CPP_LIVE_MICROPHONE_CAPTURE_SHELL_IMPLEMENTATION_PACKET_2026-05-24.md`

The key accepted routing facts are:

- `ggml-org/whisper.cpp` remains the retained offline STT donor after the
  already landed `Phase 6R-E` transcript-session slice and the landed
  `Phase 6R-U` microphone shell slice
- `SYSTRAN/faster-whisper` remains the complementary landed Python
  orchestration donor above the existing first-party speech session boundary
- first-party HyperTwist already owns the top-level provider/session contract,
  companion listening lifecycle, and speech-session substrate
- the retained donor value strongest for the next narrow widening is:
  - explicit microphone-permission shell wording
  - capture-route readiness / retry posture
  - capture-device / route-selection failure surfacing
  - bounded request / retry capability exposure
- ownership denied here is:
  - do not widen into real device-permission workflow ownership
  - do not widen into native audio-device route ownership beyond bounded shell
    posture
  - do not widen into downloadable model or payload shipping
  - do not let `whisper.cpp` inherit the top-level provider/session lane
  - do not widen into voice-output or broad assistant-platform ownership

## Required result

The source-backed control pass for this packet is now complete.

The first actual `6R-V` implementation packet should:

- define one bounded permission/readiness shell posture slice above the landed
  microphone shell seam
- land first-party profile/state fields for explicit permission and route
  readiness semantics
- land explicit issue objects, status/detail wording, and request/retry action
  routing
- add bounded health-surface capability exposure and focused automation
- explicitly state which neighboring retained families stay closed

## Source-backed retained basis

The queue-head decision is now source-backed rather than README-only.

Inspected retained donor basis:

- `C:\visual_studio_solutions\multi_project\GPT 5.4 HyperTwist parse\49-ggml-org-whisper-cpp-upstream-dossier.md`
- `C:\Workspaces\HyperTwist\mirrors\permissive\ggml-org\whisper.cpp\examples\stream\stream.cpp`
- `C:\Workspaces\HyperTwist\mirrors\permissive\ggml-org\whisper.cpp\examples\command\command.cpp`
- `C:\Workspaces\HyperTwist\mirrors\permissive\ggml-org\whisper.cpp\examples\wchess\wchess.cmd\wchess.cmd.cpp`
- `C:\Workspaces\HyperTwist\mirrors\permissive\ggml-org\whisper.cpp\examples\wchess\wchess.wasm\index-tmpl.html`

Inspected first-party receiving basis:

- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistRecognition/HyperTwistRecognitionTypes.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistRecognition/HyperTwistSpeechClient.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingTypes.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingSubsystem.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistBootstrap/HyperTwistContractLibrary.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingSubsystem.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistRecognition/HyperTwistMockSpeechClient.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistRecognition/HyperTwistHttpSpeechClient.cpp`

## Narrowed 6R-V slice decision

The next widening slice is fixed as:

1. device-permission and capture-route readiness shell posture

That narrowed slice covers:

- first-party speech shell contract expansion for:
  - permission contract ids
  - capture-route contract ids
  - request/retry action ids
  - permission/readiness state ids
  - route fallback issue objects
- lifecycle sync for:
  - open-session posture
  - submit-session posture
  - close-session posture
  - service-health refresh posture
- bounded mock and HTTP speech-health capability exposure for:
  - `devicePermissionShell`
  - `captureRouteReadinessShell`
  - `captureRouteRetry`
- focused automation coverage

## Deferred neighboring families

The first `6R-V` implementation packet must keep these capability families
closed:

- real device-permission workflow ownership
- native audio-device route ownership beyond bounded shell posture
- downloadable model or payload shipping
- provider-profile or BYOK custody
- voice-output ownership
- broad assistant-platform scope

## Acceptance criteria

- the packet records why the queue advanced from landed `Phase 6R-U` to
  `Phase 6R-V`
- the packet records that the first `6R-V` widening slice is shell posture only
- the packet states exact out-of-scope families for the first `6R-V` pass
- the packet preserves the upstream `MIT` attribution boundary explicitly
- the packet leaves real workflow ownership and payload shipping deferred

## Validation checklist

1. confirm the landed `Phase 6R-U` packet is the consumed prior queue head
2. confirm the retained `whisper.cpp` seam narrows cleanly to shell posture
   rather than native runtime ownership
3. confirm the next implementation packet is framed as bounded source-backed
   widening rather than a broad speech-platform transplant

That is the packet.

## Queue effect

This preparation packet is now consumed by the landed bounded `Phase 6R-V`
implementation slice.

Once that slice lands, the next clean move should stay narrow inside the
retained `whisper.cpp` row at:

- a source-backed `Phase 6R-W` `ggml-org/whisper.cpp` downloadable model and
  payload custody preparation/control pass
