# HyperTwist Phase 6R-AW learned-search sequence policy and search budget preparation packet

Date: `2026-05-31`

## Goal

Reopen the landed `Phase 6R-AV` learned-search lane one narrow step further
through explicit first-party sequence-policy and search-budget contracts above
the same retained `yakupbilen/drl-rubiks-cube` benchmark slice.

## Why this slice is justified

After `Phase 6R-AV`, one bounded experimentation gap still remained in
first-party terms:

- explicit anti-cancellation sequence-generation policy
- explicit solved-state inclusion and weighting-policy posture
- explicit frontier budget, iteration/time cap, and checkpoint-clone posture

Those surfaces are real in the benchmark source:

- `cube.py` keeps inverse-pair cancellation cleanup
- `train_utils.py` keeps anti-cancellation sequence generation, solved-state
  inclusion posture, and weighting-policy selection
- `search.py` keeps weighted frontier ranking plus iteration/time budget modes
- `modelpaper.py` keeps compact clone/checkpoint posture

But HyperTwist did not yet expose those as narrow first-party contracts.

## Bounded implementation target

Land a bounded follow-on inside the existing learned-search library:

- first-party learned-search sequence-policy contract
- first-party learned-search search-budget boundary
- runtime-library accessors for both
- focused automation coverage

## Explicit non-goals

Do not widen this packet into:

- live replay or notation ownership
- general scramble-registry ownership
- correctness/performance oracle ownership
- live solve explanation ownership
- deployed model serving
- broad ML platform or training-job 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/HyperTwistLearnedSearchPhase6RAWSequenceBudgetContractTest.cpp`
- canon sync docs

## Validation target

Safe source-level validation only on this VPS:

- focused contract coverage for the new sequence-policy and search-budget slice
- targeted wiring sweep
- `git diff --check`
