# HyperTwist Phase 6R-U whisper.cpp live microphone capture shell preparation packet

Created on `2026-05-24`

## Status

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

## Purpose

This packet freezes the next widening order after the landed `Phase 6R-T`
`MagicTile` transform-aware macro remapping slice.

The open task was:

- define the next bounded source-backed widening packet for
  `ggml-org/whisper.cpp` as the retained `Phase 6R-U` live microphone capture
  shell seam

It is not:

- a full `whisper.cpp` row transplant
- a real device-permission workflow 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_T_MAGICTILE_TRANSFORM_AWARE_MACRO_REMAPPING_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
- `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:
  - VAD-gated streaming-shell defaults
  - rolling capture-window and keep-window posture
  - transcript-preview and manual-commit shell cues
  - health-surface capability exposure for the bounded shell
- ownership denied here is:
  - do not widen into real device-permission workflow ownership
  - 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-U` implementation packet should:

- define one bounded live microphone capture shell slice above the landed
  transcript-session boundary
- land a first-party microphone shell profile and session-state surface
- preserve donor-backed stream defaults as shell metadata rather than a broader
  runtime takeover
- 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\server\README.md`
- `C:\Workspaces\HyperTwist\mirrors\permissive\ggml-org\whisper.cpp\include\whisper.h`
- `C:\Workspaces\HyperTwist\mirrors\permissive\ggml-org\whisper.cpp\tests\test-vad.cpp`

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-U slice decision

The next widening slice is fixed as:

1. live microphone capture shell profile and session-state boundary

That narrowed slice covers:

- first-party speech shell contract types for:
  - shell panel layout
  - shell action binding
  - microphone shell profile
  - microphone shell state
- donor-backed shell defaults for:
  - `3000ms` step window
  - `10000ms` capture window
  - `200ms` keep window
  - `0.6` VAD threshold
  - `100Hz` high-pass threshold
  - no previous-text carryover by default
- first-party session-state composition for:
  - open-state shell activation
  - utterance preview/commit progression
  - transcript-preview, speech-gap, and last-utterance readout
- bounded mock and HTTP speech-health capability exposure for:
  - microphone capture shell
  - streaming preview
  - manual transcript commit
- focused automation coverage

## Deferred neighboring families

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

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

Why this slice is next:

- `whisper.cpp` exposes a narrower donor seam at VAD-gated streaming shell
  posture than at broader model/runtime ownership
- the already landed `Phase 6R-E` and `Phase 6R-F` packets provide the right
  local substrate for a bounded shell layer above transcript sessions and
  orchestration metadata
- widening directly into permission workflow, model checkout, or payload
  shipping would blur custody and legal boundaries more than clarify them at
  this point

## Acceptance criteria

- the packet records why the queue advanced from landed `Phase 6R-T` to
  `Phase 6R-U`
- the packet records that the first `6R-U` widening slice is live microphone
  capture shell profile/state only
- the packet states exact out-of-scope families for the first `6R-U` pass
- the packet preserves the upstream `MIT` attribution boundary explicitly
- the packet leaves permission workflow, payload shipping, and broad
  assistant-platform ownership deferred

## Validation checklist

1. confirm the landed `Phase 6R-T` packet is the consumed prior queue head
2. confirm the retained `whisper.cpp` seam narrows cleanly to shell profile and
   shell-state composition
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-U`
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-V` `ggml-org/whisper.cpp` device-permission and
  capture-route readiness shell preparation/control pass
