# HyperTwist Phase 6R-AV learned heuristic search and ADI experimentation preparation packet

Date: `2026-05-31`

## Goal

Intentionally reopen the retained `yakupbilen/drl-rubiks-cube` row through the
only slice the canon allows: a narrow first-party ML search and offline
experimentation lane that stays beneath the already landed live recognition,
reconstruction, and solver-oracle owners.

## Why this slice is justified

The learned-search reconciliation explicitly kept one later reopening path:

- a bounded first-party ML search / offline experimentation lane grounded in
  `54`-sticker transition encoding, `ADI` state generation, batched neural
  search experiments, and small value-network research

That gap is now still real in first-party terms because HyperTwist already
owns:

- live recognition, reconstruction, correction, and explanation through landed
  `qbr`, `rubix-cube-solver`, and first-party correction packets
- correctness/performance oracle posture through retained `brownan` and
  `efrantar`

But HyperTwist did not yet own a bounded first-party contract layer for:

- benchmark-grounded `54`-sticker experiment profiles
- bounded `ADI` generation and target-preparation posture
- bounded offline neural search benchmark posture
- explicit attribution and exclusion boundaries that prevent donor promotion

## Bounded implementation target

Land a bundled first-party experimentation library above the retained benchmark
packages:

- package references for the compact state, `ADI`, search, and model benchmark
  surfaces
- a first-party learned-search experiment profile contract
- a first-party `ADI` generation boundary
- a first-party offline search benchmark boundary
- a first-party attribution boundary
- runtime-library accessors and focused automation coverage

## Explicit non-goals

Do not widen this packet into:

- live camera or browser recognition ownership
- committed-face reconstruction ownership
- correctness/performance oracle ownership
- generalized solver-backend ownership
- deployed product-side ML serving
- broad model-training platform ownership

## Files expected to move

- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingLearnedSearchLibrary.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingLearnedSearchLibrary.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp`
- `UnrealHyperTwist/Source/UnrealHyperTwist/Tests/HyperTwistLearnedSearchPhase6RAVExperimentationContractTest.cpp`
- canon sync docs

## Validation target

Safe source-level validation only on this VPS:

- focused contract coverage for the new learned-search experimentation slice
- targeted wiring sweep
- `git diff --check`

Windows Unreal/editor automation remains a separate follow-on and still depends
on the Windows checkout matching the current VPS worktree.
