# HyperTwist Learned Heuristic Search And Offline Solver Research Hierarchy Reconciliation - 2026-05-27

## Status

This document is the source-backed reconciliation note for the retained
`yakupbilen/drl-rubiks-cube` row against the current HyperTwist stack.

It answers one narrow question:

- does the current `yakupbilen/drl-rubiks-cube` source justify reopening any
  live HyperTwist perception, reconstruction, solver, or training owner lane

Result:

- no live perception or reconstruction reopening is required
- yes selective authority backfill was required because older row-source
  surfaces still over-described the repo as a vision/perception donor instead
  of the narrower research benchmark it actually is
- yes a later bounded first-party experimentation reopening is now justified
  and landed through `Phase 6R-AV`
- yes one additional bounded refinement above that same slice is now landed
  through `Phase 6R-AW`
- yes one further bounded refinement above that same slice is now landed
  through `Phase 6R-AX`
- yes one further bounded refinement above that same slice is now landed
  through `Phase 6R-AY`
- yes one further bounded refinement above that same slice is now landed
  through `Phase 6R-AZ`

## Source basis

- `C:\HyperTwist\docs\HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md`
- `C:\HyperTwist\docs\REPO_LICENSE_TRACKING.md`
- `C:\HyperTwist\docs\HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md`
- `C:\HyperTwist\docs\HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md`
- `C:\HyperTwist\docs\HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md`
- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md`
- `C:\Workspaces\HyperTwist\repos.manifest.json`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\README.md`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\cube\cube.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\search\search.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\search\node.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\search\search_utils.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\train\train_utils.py`
- `C:\Workspaces\HyperTwist\mirrors\permissive\yakupbilen\drl-rubiks-cube\networks\modelpaper.py`
- current first-party owner surfaces under:
  - `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist`
  - `C:\HyperTwist\docs\ROADMAP.md`
  - `C:\HyperTwist\docs\ops\HYPERTWIST_IMPLEMENTATION_PHASE_1_KICKOFF.md`

## Slice-local verdict

| Slice | Primary authority | Secondary value kept | Route | Width | Result |
| --- | --- | --- | --- | --- | --- |
| Live classic-cube calibration, ordered face observation, webcam shell, committed-face reconstruction, and bounded browser recognition shells | first-party landed `qbr` / `rubix-cube-solver` packets | none required from `yakupbilen` | existing landed permissive route | `F2` | unchanged live implementation owner |
| Live bounded classic-cube explanation, recommendation, correction, and resolution seams | first-party landed `Phase 6R-Q`, `Phase 6R-R`, and `Phase 6R-S` seams | none required from `yakupbilen` | existing landed permissive route | `F2` | unchanged live implementation owner |
| Compact correctness and heuristic-search oracle | `brownan/Rubiks-Cube-Solver` plus `efrantar/rob-twophase` as comparator | `yakupbilen` remains adjacent research value only | existing retained non-live route | `F2` | unchanged retained oracle order |
| Learned heuristic search, ADI state generation, batched neural search experimentation, compact node identity, vectorized state expansion, and small value-network research | first-party landed `Phase 6R-AV` through `Phase 6R-AX` learned-search lane grounded in `yakupbilen/drl-rubiks-cube` | adjacent live recognition and retained correctness owners remain stronger for product use | `R1` through landed first-party packet | `F2` | narrow experimentation reopening landed without changing live owner hierarchy |

## Why no live owner reopening is required

### `yakupbilen/drl-rubiks-cube`

`yakupbilen` still has retained value, but it is narrow and research-oriented:

- concise `54`-sticker state encoding with direct move-transition tables
- anti-cancellation move-sequence generation
- `ADI` state-generation and weighted target-preparation loops
- batched neural-evaluated `A*` search experiments
- small value-network research architecture

Those strengths are explicit in the current source:

- `cube.py` is centered on direct sticker-state transitions, scramble
  generation, inverse-solution recovery, and sequence cleanup
- `train_utils.py` is centered on `ADI` training-state generation and target
  construction rather than product shell behavior
- `search.py` is centered on batched node expansion and network-guided search
- `modelpaper.py` is a compact offline value model, not a deployable product
  runtime

That does not make the repo a meaningful live camera/perception owner.

It does, however, justify one narrow first-party reopening:

- a bounded experiment profile above the compact state, `ADI`, search, and
  model benchmark packages
- a bounded attribution and exclusion layer that keeps the donor row
  benchmark-grounded

### Current live recognition and correction owners

HyperTwist already owns the live physical-cube lane elsewhere:

- `qbr` owns the landed calibration, ordered face observation, and webcam-shell
  surface
- `rubix-cube-solver` owns the landed committed-face reconstruction and bounded
  browser recognition shell
- current first-party correction and resolution shells are already live above
  those seams

`yakupbilen` does not reopen any of those owners because its strongest value is
offline research logic, not camera/calibration/runtime shell ownership.

### Current retained solver-oracle owners

HyperTwist also already has stronger retained solver-oracle anchors:

- `brownan` remains the compact correctness and heuristic-table oracle
- `efrantar` remains the metric, pruning, robot-execution, and performance
  comparator

`yakupbilen` stays distinct as a learned-search and `ADI` experimentation
benchmark, not as the primary correctness or compact solver oracle.

## Backfill and bounded reopening result

### Earlier packet reopened

- `C:\HyperTwist\docs\HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md`

### Reason

The original `0R-E` call was directionally correct but later row-source layers
still blurred the repo into a perception/camera donor story.

The original reconciliation made the exact retained slice explicit:

- `yakupbilen` is not a live recognition or camera-shell owner
- `yakupbilen` is not a current product donor despite permissive licensing
- `yakupbilen` remains the retained benchmark for learned search, `ADI`
  generation, and offline experimentation
- later reopening may only happen through a first-party lane above that
  benchmark slice

The current landed state now adds:

- `Phase 6R-AV` as the bounded first-party learned-search and `ADI`
  experimentation lane
- `Phase 6R-AW` as the bounded first-party sequence-policy and
  search-budget refinement above that same lane
- `Phase 6R-AX` as the bounded first-party node-identity and state-expansion
  refinement above that same lane
- `Phase 6R-AY` as the bounded first-party frontier-scoring and
  solution-unwind refinement above that same lane
- `Phase 6R-AZ` as the bounded first-party value-network shape and
  generator-sync refinement above that same lane
- explicit continued ownership separation from `qbr`, `rubix-cube-solver`,
  `brownan`, and `efrantar`

### Change class

- repo-local first-party experimentation extraction now exists
- bounded product-code change occurred through landed `Phase 6R-AV`
- additional bounded product-code change occurred through landed `Phase 6R-AW`
- additional bounded product-code change occurred through landed `Phase 6R-AX`
- additional bounded product-code change occurred through landed `Phase 6R-AY`
- additional bounded product-code change occurred through landed `Phase 6R-AZ`
- no license-status change occurred
- row-source and dependent authority wording were sharpened

## Propagation result

### Feature registry

Updated.

The retained learned-search research slice remains explicit, and the landed
first-party experimentation lane is now recorded beside it.

### Cross-lane doctrine

No doctrine wording change was needed.

This pass applied the existing `A/R/F` hierarchy; it did not change it.

### Skillization

No doctrine or `SKILLS.md` change was needed.

This pass still did not create or reopen any command/skill surface.

### Legal evidence

No license-status or custody change occurred.

The manifest and tracker were sharpened, and the bounded first-party reopening
is now recorded.

## Operational answer

After this pass:

- do not reopen live perception, reconstruction, or correction code
- do not reinterpret `yakupbilen` as a camera/perception donor
- do not promote it above `brownan` or `efrantar` for correctness/performance
  oracle ownership
- keep `Phase 6R-AV` and `Phase 6R-AW` bounded to first-party
  experiment-profile, `ADI`, search-benchmark, attribution, sequence-policy,
  and search-budget ownership only
- keep `Phase 6R-AX` bounded to first-party node-identity and state-expansion
  ownership only
- keep `Phase 6R-AY` bounded to first-party frontier-scoring and
  solution-unwind ownership only
- keep `Phase 6R-AZ` bounded to first-party value-network shape and
  generator-sync ownership only
- if HyperTwist later widens beyond `Phase 6R-AZ`, reopen only from the same
  narrower learned-search/`ADI` benchmark slice and preserve the current live
  and oracle owner hierarchy
