# HyperTwist Phase 6R-AP faster-whisper batch-window and prompt/retrieval tuning implementation packet

Created on `2026-05-31`

## Status

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

## Purpose

This packet lands the next justified owned widening above the already landed
`Phase 6R-F` `SYSTRAN/faster-whisper` orchestration profile.

The landed slice is:

- batch-collection window metadata for the Python transcription service lane
- prompt-routing mode metadata above the existing prefix and hotword posture
- retrieval-hint lane metadata above the existing command-hint seam
- bounded transcript-result backfill for those tuning surfaces
- bounded service-health capability exposure for that tuning family

It is not:

- top-level provider/session ownership
- BYOK/profile custody
- microphone capture or device-permission ownership
- downloadable model or payload shipping
- worker-process takeover
- TTS or broad voice-output ownership
- broad assistant-platform scope

## Current authority basis

This implementation packet stands on:

- `docs/arch/HYPERTWIST_PHASE6R_AP_FASTER_WHISPER_BATCH_WINDOW_AND_PROMPT_RETRIEVAL_TUNING_PREPARATION_PACKET_2026-05-31.md`
- `docs/REPO_LICENSE_TRACKING.md`
- `docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md`
- `docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md`

## Landed scope

The current code now owns the bounded tuning seam through:

- extended `FHyperTwistSpeechTranscriptionOrchestrationProfile` metadata for:
  - batch-collection window
  - prompt-routing mode
  - retrieval-context lane
  - retrieved-hint limit and augmentation posture
- extended `FHyperTwistSpeechTranscriptResult` metadata for:
  - applied batch-window tuning
  - applied prompt-routing mode
  - applied retrieval-context lane
  - applied retrieved-hint count and hint list
- mock and HTTP speech-client propagation/backfill for those tuning fields
- active training-subsystem normalization/backfill for the bounded tuning
  metadata
- service-health capability exposure for:
  - `batchWindowTuning`
  - `promptRoutingProfiles`
  - `retrievalHintAugmentation`
- focused automation in:
  - `HyperTwistFasterWhisperPhase6RAPServiceLaneTuningContractTest.cpp`

## Why this is still intentionally bounded

This packet extends orchestration tuning metadata only.

Still deferred:

- worker-process or queue-ownership takeover
- downloadable model or payload shipping
- provider-profile and BYOK custody
- voice-output ownership
- broad assistant-platform scope

## Validation

Current validation for this VPS-side turn is source-level only:

- `git diff --check`
- focused source review against the speech orchestration, transcript-result,
  and service-health substrate

The authoritative Unreal build/test lane for future packet verification is now:

- Windows reverse-SSH validation when the task benefits from Unreal validation
  and the VPS lacks `UnrealEditor`

Important limitation:

- if the Windows checkout does not yet contain the same source files as the VPS
  working tree, do not claim that the Windows Unreal pass covered this packet

## Queue effect

This packet consumes the justified `Phase 6R-AP` reopening.

`SYSTRAN/faster-whisper` remains only partially incorporated, but the next
narrow orchestration tuning seam is now live without reopening provider,
payload, or voice-output families.
