# HyperTwist Phase 6R-F faster-whisper transcription orchestration preparation packet

Created on `2026-05-21`

## Status

- historical consumed preparation authority
- bounded post-`Phase 6R-E` control slice
- the first bounded implementation slice is now landed separately after this packet

## Purpose

This packet freezes the next widening order after the landed `Phase 6R-E` `ggml-org/whisper.cpp`
speech transcript-session slice.

The open task was:

- define the first bounded source-backed widening packet for `SYSTRAN/faster-whisper` as the
  retained Python transcription-service orchestration profile above the already landed first-party
  speech session boundary

It is not:

- a full `faster-whisper` row transplant
- a replacement for the first-party HyperTwist provider-neutral speech contract
- a live microphone capture or device-permission packet
- a model checkout, payload-shipping, or model-card approval packet
- a real-time streaming or diarization 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/ops/HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `docs/arch/HYPERTWIST_PHASE6R_E_WHISPER_CPP_SPEECH_TRANSCRIPT_IMPLEMENTATION_PACKET_2026-05-21.md`

The key accepted routing facts are:

- first-party HyperTwist already owns the top-level provider-neutral speech/session contract lane
- `ggml-org/whisper.cpp` already owns the landed offline/native transcript-session donor slice
- `SYSTRAN/faster-whisper` is the next retained donor for Python-side transcription-service
  orchestration
- the donor value there is strongest for:
  - batched decoding orchestration
  - VAD-aware clip orchestration
  - word-timestamp and transcript-metadata shaping
  - prompt-hint surfaces such as `prefix` and `hotwords`
  - language-detection and chunking controls
- ownership denied there is:
  - do not let the row absorb the top-level provider contract
  - do not let the row absorb BYOK/profile custody
  - do not widen into microphone capture or permission shell ownership
  - do not widen into downloadable model or payload review
  - do not widen into TTS or broad voice-output ownership
  - do not widen into a broad assistant platform

## Why this was the next packet

The earlier retained queue heads were already landed:

- `Phase 6R-A` `HactarCE/Hyperspeedcube`
- `Phase 6R-B` `kkoomen/qbr`
- `Phase 6R-C` `vivaansinghvi07/rubix-cube-solver`
- `Phase 6R-D` `roice3/MagicTile`
- `Phase 6R-E` `ggml-org/whisper.cpp`

That advanced the live queue to:

- `Phase 6R-F` `SYSTRAN/faster-whisper`

with the later adjacent retained rows ordered behind it:

- `rhasspy/piper`
- `coqui-ai/TTS`

## Required result

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

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

- preserve the first-party provider-neutral speech contract as owner
- define one bounded retained slice from `faster-whisper`
- keep the slice inside the accepted speech-input seam
- widen only the first Python orchestration family that can stand on its own without dragging in
  model shipping, provider-profile custody, or voice-output scope
- explicitly state which neighboring retained rows stay closed in that packet

## Source-backed retained basis

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

Inspected retained donor basis:

- `README.md`
- `setup.py`
- `faster_whisper/transcribe.py`
- `faster_whisper/vad.py`
- `tests/test_transcribe.py`

Inspected first-party receiving basis:

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

## Narrowed 6R-F slice decision

The first widening slice is fixed as:

1. Python transcription-service orchestration profile above the existing first-party speech session
   boundary

not as the broader speech-input or provider platform.

That narrowed slice covers:

- first-party transcription-orchestration request policy for:
  - batching
  - chunk length / clip segmentation
  - prompt-hint routing:
    - `prefix`
    - `hotwords`
  - language-detection thresholds and segment-count policy
  - condition-on-previous-text and word-timestamp request posture
- first-party transcript metadata shape for orchestration-aware results
- direct-donor speech-client seam updates for:
  - mock coverage
  - HTTP-sidecar request/response normalization
- active subsystem normalization of the bounded orchestration profile
- focused automation coverage

## A/R/F clarification by slice

Provider contract lane:

- first-party HyperTwist
- `A1 / R1 / F1`

Landed offline/native transcript-session slice:

- `ggml-org/whisper.cpp`
- `A1 / R1 / F2`

Chosen next Python orchestration slice:

- `SYSTRAN/faster-whisper`
- `A1 / R1 / F2`

These are different slices.

Do not let the donor that wins the orchestration slice inherit the provider-contract lane by
accident.

## Deferred neighboring families

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

- live microphone capture shell
- device-permission shell
- downloadable model checkout, packaging, or payload shipping
- worker-process management beyond the bounded request/response orchestration seam
- real-time streaming, diarization, or broad assistant-platform scope
- provider-profile, BYOK, or OpenAI-compatible endpoint custody
- TTS or voice-output ownership

## Why this slice is first

- `faster-whisper` is strongest where the retained donor adds orchestration controls above the
  already landed transcript-session contract:
  - batch size
  - clip/VAD control
  - prompt hints
  - word timestamps
  - language detection
- current first-party code already has a bounded speech session boundary, but it does not yet own a
  richer Python orchestration profile for that seam
- keeping model, payload, provider-profile, and voice decisions outside this packet preserves
  swapability, provider neutrality, and cleaner legal review

## Out of scope for the first 6R-F packet

- microphone capture
- downloadable model checkout or packaging
- provider-profile and BYOK custody
- generic provider dashboarding or usage accounting
- TTS / voice output
- `rhasspy/piper` or `coqui-ai/TTS`
- broad assistant or narration platform work

## Acceptance criteria

- the packet records why the live queue advanced from landed `6R-E` to `6R-F`
- the packet records that the first `6R-F` widening slice is the Python transcription-service
  orchestration profile only
- the packet states exact out-of-scope families for the first `6R-F` pass
- the packet keeps the speech-lane legal sequencing guard visible:
  - keep code-license judgments separate from model, voice, and payload-license review
- the packet keeps the provider-neutrality guard visible:
  - first-party HyperTwist remains the top-level provider-contract owner

## Validation checklist

1. confirm the landed `Phase 6R-E` packet is the consumed prior queue head
2. confirm the retained `faster-whisper` seam narrows cleanly to the orchestration profile
3. confirm the next implementation packet is framed as bounded source-backed widening rather than a
   Python speech-platform transplant

That is the packet.
