# HyperTwist Phase 6R-AK qbr locale-aware solve guidance routing implementation packet

Created on `2026-05-31`

## Status

- bounded permissive HyperTwist packet
- landed `Phase 6R-AK` implementation slice

## Purpose

This packet lands the justified narrow `qbr` locale-aware guidance-routing
overlay above the already landed webcam shell, correction shell, and bounded
solve-explanation stage ladder.

The landed slice is:

- source-backed supported-locale metadata for the ten upstream `qbr` locales
- locale-display routing aligned with the bounded `cycle-locale` shell action
- qbr-grounded starting-orientation reminder inside solve-guidance state
- bounded locale-routing mode ids above the current explanation shell

It is not:

- bundled-font redistribution
- standalone multilingual shell rendering
- generalized solver-backend ownership
- browser-host or asset-shipping widening

## Current authority basis

This implementation packet stands on:

- `docs/arch/HYPERTWIST_PHASE6R_AK_QBR_LOCALE_AWARE_SOLVE_GUIDANCE_ROUTING_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`
- `docs/ops/HYPERTWIST_IMPLEMENTATION_PHASE_1_KICKOFF.md`

## Landed scope

The current code now owns the bounded `6R-AK` locale-routing seam through:

- `FHyperTwistVisionLocaleOption`
- qbr-backed supported-locale arrays on the webcam-shell and
  solve-explanation profiles
- default locale ids and locale-display labels on the webcam shell state
- solve-guidance locale mode, active locale display label, and starting
  orientation reminder on the bounded solve-explanation state
- focused automation in:
  - `HyperTwistQbrPhase6RAKLocaleGuidanceContractTest.cpp`

## Why this is still intentionally bounded

This packet lands routing metadata and bounded shell/state posture only.

Still deferred:

- bundled `arial-unicode-ms.ttf` redistribution
- full standalone multilingual shell rendering
- glyph/rendering guarantees outside the local first-party UI stack
- broad `qbr` ownership of the explanation shell or browser host

## Validation

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

- `git diff --check`
- focused source review against the current recognition, correction, and
  solve-explanation substrate

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

- 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-AK` reopening.

`qbr` still remains a partially incorporated row, but the locale-aware
guidance-routing remainder is now live as a bounded overlay above the existing
first-party and `rubix-cube-solver` explanation stack.

The next clean move is to return to the retained repo-row queue rather than
widen this row into bundled-font shipping or a broad multilingual host shell.
