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

Created on `2026-05-31`

## Status

- bounded permissive HyperTwist packet
- source-backed `Phase 6R-AK` preparation/control slice

## Purpose

This packet scopes the next justified narrow `kkoomen/qbr` reopening after the
already landed calibration, webcam-shell, correction, and solve-explanation
seams.

The granted slice is:

- source-backed supported-locale metadata from `qbr`
- locale-display routing aligned with the landed `cycle-locale` shell action
- a bounded locale-aware solve-guidance overlay above the already landed
  `rubix-cube-solver` explanation stack
- the `qbr` starting-orientation reminder carried into the first-party
  solve-guidance state

It is not:

- bundled-font redistribution
- standalone multilingual shell rendering
- generalized solver-backend ownership
- browser-host ownership
- broad `qbr` promotion over the landed first-party and
  `rubix-cube-solver` explanation/correction owners

## Current authority basis

This control pass stands on:

- `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`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\README.md`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\constants.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\helpers.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\en.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\de.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\hu.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\fr.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\es.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\nl.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\zh.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\zh-tw.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\ar.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\kkoomen\qbr\src\translations\fa.json`

The preserved owners do not change:

- `qbr` remains the narrower recognition-substrate donor
- the landed first-party correction shell remains the correction owner
- the landed `rubix-cube-solver` stage ladder remains the bounded
  solve-explanation owner

## Granted family

The bounded `Phase 6R-AK` slice may land:

1. supported-locale option structs and default locale ids inside the current
   vision shell and solve-explanation contracts
2. qbr-source-backed locale labels for the ten upstream locale codes
3. a bounded locale-aware solve-guidance routing mode id
4. the qbr starting-orientation reminder carried into the solve-guidance state
5. focused automation for:
   - session-config locale metadata
   - partial shell/state locale routing
   - completed solve-guidance locale routing

The packet must stay out of:

- direct font-asset copying or shipping
- locale-specific rendered glyph claims beyond the contract metadata
- standalone multilingual move-by-move explanation rendering
- generalized solve-engine or browser-host widening

## Proposed implementation shape

Land the narrower boundary through:

- new locale option metadata in:
  - `HyperTwistRecognitionTypes.h`
- default locale arrays in:
  - `UHyperTwistTrainingSubsystem`
  - `UHyperTwistContractLibrary`
- shell-state and solve-guidance-state routing updates in:
  - `BuildClassicCubeWebcamShellState(...)`
  - `BuildClassicCubeSolveExplanationState(...)`
- focused automation in:
  - `HyperTwistQbrPhase6RAKLocaleGuidanceContractTest.cpp`

## Validation target

Use the documented validation split:

- safe VPS-side source checks first
- when Unreal validation is sensible and the instance is on the VPS without
  `UnrealEditor`, use the Windows reverse-SSH lane documented in the sensitive
  runbook
- if the Windows checkout lags the VPS source state, say that explicitly and
  do not claim packet coverage for missing Windows-side files

## Queue effect

If this packet lands cleanly, `qbr` remains partially incorporated but the
locale-aware guidance-routing remainder is no longer only a deferred note.

After that, keep bundled-font redistribution and standalone multilingual shell
rendering deferred, and return to the retained repo-row queue rather than
widening `qbr` back into a broad host shell.
