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

Created on `2026-05-21`

## Status

- first-party HyperTwist packet
- bounded permissive `Phase 6R-F` implementation slice

## Purpose

This packet lands the first narrower bounded slice from the retained `SYSTRAN/faster-whisper`
speech-input row.

The landed slice is:

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

It is not:

- a full `faster-whisper` row transplant
- a top-level provider-contract packet
- a microphone capture or device-permission packet
- a downloadable model or payload-shipping packet
- a BYOK/profile custody packet
- a `rhasspy/piper` or `coqui-ai/TTS` voice-output packet
- a broad assistant-platform packet

## Current authority basis

This implementation packet stands on:

- `docs/HYPERTWIST_PHASE_0R_PACKET_0R_A_EVALUATION_2026-05-12.md`
- `docs/HYPERTWIST_PHASE_2R_PACKET_2R_A_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md`
- `docs/REPO_LICENSE_TRACKING.md`
- `docs/ops/HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `docs/arch/HYPERTWIST_PHASE6R_F_FASTER_WHISPER_TRANSCRIPTION_ORCHESTRATION_PREPARATION_PACKET_2026-05-21.md`

The retained owner remains:

- `SYSTRAN/faster-whisper`

The top-level provider/session contract owner does not change here:

- first-party HyperTwist remains the provider-neutral `A1 / R1 / F1` owner for the speech
  provider-contract lane
- this packet keeps `SYSTRAN/faster-whisper` bounded to the narrower `A1 / R1 / F2`
  transcription-service orchestration donor slice only

The granted family remains bounded to:

- orchestration-profile request policy for:
  - batching
  - clip / chunk shaping
  - prompt hints:
    - `prefix`
    - `hotwords`
  - language detection
  - word timestamps
  - condition-on-previous-text posture
- orchestration-aware transcript metadata
- speech-service capability exposure for the bounded Python service lane

This packet lands only the first narrower family in that granted set.

## Landed scope

The current code now owns a retained Python transcription-service orchestration contract through:

- retained recognition contract types for:
  - `FHyperTwistSpeechTranscriptionOrchestrationProfile`
  - orchestration-aware `FHyperTwistSpeechSessionConfig`
  - orchestration-aware `FHyperTwistSpeechTranscriptResult`
  - orchestration-aware `FHyperTwistSpeechServiceHealth`
- sample session-config, transcript-result, and service-health outputs in:
  - `UHyperTwistContractLibrary`
- direct-donor speech client seam updates with:
  - `UHyperTwistMockSpeechClient`
  - `UHyperTwistHttpSpeechClient`
- active companion orchestration-profile normalization and transcript-result backfill in:
  - `UHyperTwistTrainingSubsystem`
- focused automation coverage in:
  - `HyperTwistFasterWhisperPhase6RFOrchestrationContractTest.cpp`

## Why this is still intentionally bounded

This packet lands the first donor-backed Python orchestration seam, but it does not widen into the
neighboring retained families.

Still deferred:

- live microphone capture shell
- device-permission shell
- downloadable model or payload shipping
- provider-profile and BYOK custody
- TTS or voice-output ownership
- broad assistant-platform scope

## Validation

Build validation:

- `Build.bat UnrealHyperTwistEditor Win64 Development -Project='C:\HyperTwist\UnrealHyperTwist\UnrealHyperTwist.uproject' -WaitMutex -NoHotReloadFromIDE`

Focused automation validation:

- `Automation RunTests HyperTwist.Permissive.FasterWhisper.Phase6R.F`

Regression automation validation:

- `Automation RunTests HyperTwist.Permissive.WhisperCpp.Phase6R.E`
- `Automation RunTests HyperTwist.Permissive.MagicTile.Phase6R.D`
- `Automation RunTests HyperTwist.Permissive.RubixCubeSolver.Phase6R.C`
- `Automation RunTests HyperTwist.Permissive.Qbr.Phase6R.B`
- `Automation RunTests HyperTwist.Permissive.Hyperspeedcube.Phase6R.A`
- `Automation RunTests HyperTwist.CleanRoom.CubeDesk`

Expected covered tests:

- `ServiceHealth`
- `SessionConfig`
- `TranscriptMetadata`
- `CloseSession`
- `TranscriptResult`
- `TopologyContract`
- `LoaderBoundary`
- `PackageChecklist`
- `CommitBuildsReconstructionSession`
- `RevisionLedger`
- `FinalizeBuildsClassicNet`
- `CalibrationSessionConfig`
- `PreviewObservation`
- `CommitObservation`
- `CatalogLookup`
- `SampleDefinition`
- `TrainingRunDefinition`
- existing `CubeDesk` clean-room regression suite

## Queue effect

This packet consumes the current `Phase 6R-F` implementation slice.

`SYSTRAN/faster-whisper` remains only partially incorporated:

- landed now:
  - Python transcription-service orchestration profile
  - orchestration-aware transcript metadata
  - mock and HTTP-sidecar normalization for the bounded Python service lane
  - service-health capability exposure for:
    - batched transcription
    - word timestamps
    - language detection
    - prompt hints
- still deferred:
  - live microphone capture shell
  - provider-profile and BYOK custody
  - downloadable model or payload shipping
  - TTS or voice-output ownership
  - broad assistant-platform scope

The next clean move is not another immediate `faster-whisper` widening by default.

The next queue head should be:

- source-backed `Phase 6R-G` `rhasspy/piper` preparation/control pass

Keep the future sequencing guards visible:

- speech-input / voice sidecar set
  - keep code-license judgments separate from model, voice, and payload-license review
- `SYSTRAN/faster-whisper`
  - keep it complementary to `ggml-org/whisper.cpp` and bounded to Python transcription-service
    orchestration rather than provider-contract ownership
- `rhasspy/piper` and `coqui-ai/TTS`
  - keep future downloadable voice-asset review separate from the code-license judgment
