Reconcile yakupbilen research benchmark lane

This commit is contained in:
axiomlogicnexus 2026-05-27 22:06:18 +02:00
parent 0bb51d98f9
commit bb3cfd0464
10 changed files with 188 additions and 11 deletions

View file

@ -0,0 +1,159 @@
# 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 product-code reopening is required
- yes selective authority backfill is required because older row-source surfaces
still over-describe the repo as a vision/perception donor instead of the
narrower research benchmark it actually is
## 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\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, and small value-network research | `yakupbilen/drl-rubiks-cube` | adjacent live recognition and retained correctness owners remain stronger for product use | `R4` now, `R1` only if a future first-party ML research lane is intentionally opened | `F2` | permissive research benchmark authority kept explicit |
## Why no product-code 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.
### 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.
## Selective backfill 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.
This pass makes 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 only for learned search, `ADI`
generation, and offline experimentation
### Change class
- no repo-local extraction changed
- no product-code change occurred
- no license-status change occurred
- row-source and dependent authority wording were sharpened
## Propagation result
### Feature registry
Updated.
The retained learned-search research slice is now explicit instead of living
only in packet and tracker prose.
### 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 did not create or reopen any command/skill surface.
### Legal evidence
No license-status or custody change occurred.
The manifest and tracker were sharpened instead.
## 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
- if HyperTwist later opens a real first-party ML search or offline
experimentation lane, reopen only from the narrower learned-search/`ADI`
benchmark slice

View file

@ -741,8 +741,13 @@ Non-promotion decisions and rationale:
Integration call:
- retain as MIT research benchmark material for learned heuristic search, offline experimentation, and future solver-evaluation work
- revisit only if HyperTwist explicitly opens a first-party ML search or experimentation lane
- retain as MIT research benchmark material for `54`-sticker transition
encoding, `ADI` state generation, batched neural search experimentation, and
future solver-evaluation work
- do not reinterpret the repo as a live camera/perception or product-shell
donor
- revisit only if HyperTwist explicitly opens a first-party ML search or
experimentation lane
## Phase 0R closure result

View file

@ -369,7 +369,7 @@ These rows stay retained, but not as active implementation backlog.
- `AviKaufman/Rubix-cube-trainer` — primary all-rights-reserved guided-pedagogy benchmark
- `alinen/cube` — no-license planner and task-segmentation benchmark
- `ambisinister/blindsolve` — no-license BLD memo benchmark
- `yakupbilen/drl-rubiks-cube` — MIT learned-heuristic research benchmark
- `yakupbilen/drl-rubiks-cube` — MIT learned-heuristic, `ADI` state-generation, and offline solver-experimentation benchmark
Contract:

View file

@ -262,7 +262,7 @@ Most important scheduling result:
- `efrantar/rob-twophase` remains a secondary solver oracle for metric and performance comparison
- `ShellPuppy/RCube` remains a large-`N` algorithm and parity benchmark
- `AviKaufman/Rubix-cube-trainer`, `alinen/cube`, `ambisinister/blindsolve`, and `vwcwong/CubeSim` remain clean-room-later pedagogy, planner, memo, and history benchmarks
- `yakupbilen/drl-rubiks-cube` remains a permissive research benchmark for learned heuristic search and experimentation
- `yakupbilen/drl-rubiks-cube` remains a permissive research benchmark for learned heuristic search, `ADI` state generation, and offline solver experimentation
- `aMonteSl/CodeXR`, `MathewKJ2048/Rubiks-cube-simulator`, and `brianpeiris/RiftSketch` are now discarded from the active retained implementation set
Combined `Phase 0R` packet status:

View file

@ -374,7 +374,7 @@ Count: `13`
| `poliva/cubedex` | `no explicit license visible` | Locked Strategic Donor | `integrate` | `not_live_reference_or_discard_candidate` | `phase0r_reference_benchmark_or_discard_eval` | `Phase 1R` plus the `2026-05-27` smartcube practice/review/SRS hierarchy clarification are closed. Retain only as restrictive comparison context for smartcube-aware practice-shell behavior, review/SRS UX, recognition-versus-execution timing presentation, and local stats/history comparison; do not treat it as a live owner or a default clean-room next row. |
| `ShellPuppy/RCube` | `GPL-3.0` | Reserve Bench | `future candidate` | `not_live_reference_or_discard_candidate` | `phase0r_reference_benchmark_or_discard_eval` | `Packet 0R-E` closed. Retain as a large-`N` centers/edges/parity benchmark and later clean-room research input, not as an active product donor. |
| `vwcwong/CubeSim` | `GPL-3.0` | Reserve Bench | `future candidate` | `not_live_reference_or_discard_candidate` | `phase0r_reference_benchmark_or_discard_eval` | `Packet 0R-E` closed. Retain as a readable state/history and beginner-solver decomposition benchmark for later clean-room use. |
| `yakupbilen/drl-rubiks-cube` | `MIT` | Reserve Bench | `future candidate` | `not_live_reference_or_discard_candidate` | `phase0r_reference_benchmark_or_discard_eval` | `Packet 0R-E` closed. Retain as an MIT research benchmark for learned heuristic search, ADI training loops, and offline experimentation rather than near-term product implementation. |
| `yakupbilen/drl-rubiks-cube` | `MIT` | Reserve Bench | `future candidate` | `not_live_reference_or_discard_candidate` | `phase0r_reference_benchmark_or_discard_eval` | `Packet 0R-E` closed. Retain as an MIT research benchmark for `54`-sticker transition encoding, `ADI` state generation, batched neural `A*` search, and offline solver experimentation; do not treat it as a live camera/perception owner or a near-term product donor. |
## Implementation rule going forward

View file

@ -1768,11 +1768,23 @@ Source basis:
- `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`
- `C:\HyperTwist\docs\HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md`
- `C:\HyperTwist\docs\HYPERTWIST_LEARNED_HEURISTIC_SEARCH_AND_OFFLINE_SOLVER_RESEARCH_HIERARCHY_RECONCILIATION_2026-05-27.md`
Approved working posture:
- keep as a permissive research bench for learned heuristic search and offline experimentation
- do not let permissive status alone promote it above the committed training/perception/runtime core
- keep as a permissive research bench for `54`-sticker transition encoding,
`ADI` state generation, batched neural search experiments, and offline solver
experimentation
- do not treat it as a live camera, calibration, reconstruction, or browser
shell owner
- preserve `qbr` and `rubix-cube-solver` as the live recognition/reconstruction
owners
- preserve `brownan` and `efrantar` as the retained correctness/performance
solver-oracle owners
- do not let permissive status alone promote it into the committed
perception/training/runtime core
- reopen only if a first-party ML search or offline experimentation lane is
intentionally opened later
### `HactarCE/2x2x2x2-Scrambler`

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View file

@ -193,7 +193,7 @@
"onionhoney/roux-trainers","https://github.com/onionhoney/roux-trainers","HyperTwist","Donor Bench","Focused restrictive clean-room donor target","P2","7481","9236","52.0","117.0","132.0","medium","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving cube-state, scramble, scheduling, or timer internals while adapting pedagogy, analytics, and UI.","repurpose","architecture only","Capture the stage-specific training, analyzer, recognition, and drill-loop behaviors that justify keeping roux-trainers as a clean-room donor target.","Stage-specific training flows, solver-backed analyzer logic, recognition masking, favorites/batch-drill persistence, and 2D/3D visualization boundaries.","Inspect blockbuilding micro-trainers, stage-specific state machines, solver-backed analyzer logic, recognition masking, favorites/batch-drill persistence, and 2D/3D visualization boundaries.","Which Roux-specific training and analyzer behaviors are strategically worth reproducing in first-party code through a clean-room handoff?","Keep in restrictive custody and route value through clean-room extraction only. Use it as a method-specific training and analyzer donor, not as direct donor code.","Do not merge this repo into the HyperTwist core as source. Convert the valuable training-state-machine and analyzer behaviors into first-party subsystems behind a clean-room boundary.","Repurpose here means: translate stage-specific training and analyzer behaviors into first-party implementations through a clean-room process.","tao-yu/Alg-Trainer","base + donor swarm","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","poliva/cubedex","specialized training UX donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","Lykos/cube_trainer","sampling/analytics donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","HyperTwist only","Restrictive clean-room donor value is real, but it should flow through Model A to a first-party implementation rather than through direct source sharing.","Upgrade if source reveals clean modular architecture, reusable core abstractions, strong adapters/plugins, robust tests, and direct fit to a locked stack.","Demote if reusable value is mostly superficial, undocumented complexity overwhelms salvage value, or higher-ranked repos clearly dominate the same role.","Model A salvage map + clean-room boundary note + first-party subsystem extraction plan.","1) Which stage-specific subsystems are worth preserving
2) What must stay behind Model A / Model B separation
3) What first-party implementations should replace the GPL source","Primary: Phase G v4 board (canonical ranking and current bucket); Operational v3 board filtered to this repo; Merger matrix rows involving this repo; VS Code packet row for this repo, if present. Optional: Cluster narratives row for matching cluster; Bookmark occurrence rows for this repo. Do not attach v1/v2 or preliminary memo unless a judgment conflict, lineage ambiguity, or rationale gap needs arbitration.","Keep in canon as a focused restrictive clean-room donor for method-specific training and analyzer behavior.","GPLv3 method-specific trainer with real subsystem value that should be preserved through clean-room extraction rather than donor use.","Audit onionhoney/roux-trainers as a focused restrictive clean-room donor for HyperTwist. Preserve method-specific training-state-machine, analyzer, recognition-masking, and drill-loop behavior in a scrubbed Model A handoff only.","HT_training_clean_room_0006","HT_training_clean_room","onionhoney/roux-trainers","","","","","","","Original global P0-P3 source audit retained","GPL-3.0","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","2","3","117.0","mixed_or_boundary_sensitive_known","reverse_engineer_preferred","The repo is GPLv3 and should not be used as direct donor code in the HyperTwist core. Its value is in selective behavior and subsystem extraction through a clean-room Model A / Model B process.","Model A inspects the restrictive source; Model B implements only from a scrubbed first-party specification and must not access the repo directly.","Direct incorporation would require GPL-compatible distribution/compliance and is not the planned HyperTwist path.","Yes — preferred path for selectively reproducing stage-specific training and analyzer behavior in first-party code.","high","gpl-clean-room-donor","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Corrected on 2026-04-25 from stale donor posture to dossier-backed focused restrictive clean-room donor status.","implemented_live_clean_room_verified","landed_clean_room_preserve","Phase 1R closed. Preserve as the landed restrictive clean-room precedent; keep the Model A/Model B chain explicit and work only from first-party outputs or scrubbed specs."
"yakupbilen/drl-rubiks-cube","https://github.com/yakupbilen/drl-rubiks-cube","HyperTwist","Reserve Bench","Adjacency / future transfer","P2","7482","9237","53.0","117.0","132.0","medium","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving calibration/detection/state-reconstruction logic while replacing camera UX and integration surfaces.","future candidate","architecture only","Determine whether yakupbilen/drl-rubiks-cube should stay donor/merge-tier for HyperTwist, be promoted, or be demoted; identify concrete salvageable modules and best merge path.","puzzle model, learning flow, UX loops, data schema, replay/export, plugin/hooks","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for algorithm databases, spaced-repetition logic, scramble generation, timer/stat code, virtual cube components, smartcube adapters, and custom-trainer configuration support.","Inspect preprocessing/calibration; tracking stabilization; state reconstruction; replay/event model; camera abstraction; fallback heuristics; testing assets/videos; performance shortcuts.","Integrate as a cubing / algorithm training subsystem for HyperTwist. Preserve the strongest existing pieces — scramble generation, algorithm database, recognition/training loop, timing/statistics, virtual cube, smartcube hooks, spaced repetition — and expose them behind a portfolio-stable interface. Wire first into tao-yu/Alg-Trainer, then into poliva/cubedex for orchestration, visualization, or data exchange.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Repurpose here means: turn it into a trainer engine, solver/timer backend, recognition drill module, or method-specific practice mode for HyperTwist.","kkoomen/qbr","foundation + perception donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","vivaansinghvi07/rubix-cube-solver","perception + replay donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cubing/cubing.js","state/render backend","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","Upgrade if source reveals clean modular architecture, reusable core abstractions, strong adapters/plugins, robust tests, and direct fit to a locked stack.","Demote if reusable value is mostly superficial, undocumented complexity overwhelms salvage value, or higher-ranked repos clearly dominate the same role.","Capability inventory + salvage targets + promotion/demotion verdict","1) Confirmed visible capabilities
"yakupbilen/drl-rubiks-cube","https://github.com/yakupbilen/drl-rubiks-cube","HyperTwist","Reserve Bench","Adjacency / future transfer","P2","7482","9237","53.0","117.0","132.0","medium","Retain the valuable internal research engine, but keep it below live product ownership. For this repo class, preserve sticker-state transition encoding, ADI state generation, batched neural search, and offline experiment loops while excluding camera UX, PyQt shell behavior, and near-term product runtime assumptions.","future candidate","architecture only","Determine whether yakupbilen/drl-rubiks-cube should stay donor/merge-tier for HyperTwist, be promoted, or be demoted; identify concrete salvageable modules and best merge path.","puzzle model, learning flow, UX loops, data schema, replay/export, plugin/hooks","Inspect README/docs, cube-state model, move-transition tables, search loop, ADI generation, network architecture, training scripts, and experiment configuration. Look for reusable search research primitives rather than camera UX, PyQt shell flows, or live perception assumptions.","Inspect cube-state encoding; move-transition tables; ADI state generation; batched A* evaluation; value-network shape; offline training loop; and experiment boundaries. Explicitly exclude camera/perception shell claims from owner judgment.","Keep only as a research benchmark. Use it to shape first-party learned heuristic search, ADI state-generation, and offline solver experimentation if HyperTwist ever opens that lane; do not treat it as a live camera, calibration, recognition, or product-shell donor.","Keep behind the landed qbr and rubix-cube-solver recognition owners and behind the retained brownan/efrantar solver-oracle owners. Revisit only if HyperTwist intentionally opens a first-party ML search or offline experimentation lane.","Repurpose here means: mine cube-state transition encoding, ADI target-generation loops, batched heuristic-search experiments, and small value-network research rather than camera UX or product shell behavior.","brownan/Rubiks-Cube-Solver","correctness oracle","Use brownan above this row for compact correctness and heuristic-table ownership; keep yakupbilen only as adjacent learned-search research.","efrantar/rob-twophase","performance comparator","Use efrantar above this row for metric, pruning, and performance comparison; keep yakupbilen only as offline learned-search experimentation.","kkoomen/qbr","live recognition boundary check","Use qbr as the landed recognition/calibration owner and keep yakupbilen explicitly out of live perception-shell ownership.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","Upgrade if source reveals clean modular architecture, reusable core abstractions, strong adapters/plugins, robust tests, and direct fit to a locked stack.","Demote if reusable value is mostly superficial, undocumented complexity overwhelms salvage value, or higher-ranked repos clearly dominate the same role.","Capability inventory + salvage targets + promotion/demotion verdict","1) Confirmed visible capabilities
2) Hidden capabilities found only in source
3) Best salvageable modules/files/packages
4) Integration path into target project
@ -201,7 +201,7 @@
6) Best merge partners and exact coupling seam
7) Reasons to promote / retain / demote
8) Confidence change after source audit
9) Open questions / blockers","Primary: Phase G v4 board (canonical ranking and current bucket); Operational v3 board filtered to this repo; Merger matrix rows involving this repo; VS Code packet row for this repo, if present. Optional: Cluster narratives row for matching cluster; Bookmark occurrence rows for this repo. Do not attach v1/v2 or preliminary memo unless a judgment conflict, lineage ambiguity, or rationale gap needs arbitration.","yakupbilen/drl-rubiks-cube is placed in Reserve Bench for HyperTwist because it best serves the 'Search/training systems bench' role; recommended action is 'future candidate' with repurposing scope 'architecture only'. Confidence is medium because this remains a metadata-level judgment until source audit confirms hidden modules, plugin points, adapters, or architectural strengths.","Useful MIT search and training benchmark for learned-heuristic search, state generation, and experimentation loops, but explicitly below the committed perception and training core.","Audit yakupbilen/drl-rubiks-cube as a vision / perception / AR candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect preprocessing/calibration; tracking stabilization; state reconstruction; replay/event model; camera abstraction; fallback heuristics; testing assets/videos; performance shortcuts. Decide whether the best extraction path is moderate modification and whether it belongs as subsystem donor / vision donor. Test the three merger paths in order: 1) kkoomen/qbr [foundation + perception donor]; 2) vivaansinghvi07/rubix-cube-solver [perception + replay donor]; 3) cubing/cubing.js [state/render backend]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","HT_cube_vision_0008","HT_cube_vision","yakupbilen/drl-rubiks-cube","","","","","","","Original global P0-P3 source audit retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","2","3","117.0","permissive_or_noncopyleft_known","pattern_only_preferred","The repo is MIT and remains a research benchmark for learned heuristic search, ADI state generation, and offline experimentation rather than a near-term product donor.","Reference only: benchmark learned heuristic search and training experiments without near-term direct incorporation.","Typically preserve notices, attribution, and license text where required; no special copyleft-driven disclosure posture is normally needed.","Usually unnecessary unless you later decide the existing implementation is too constraining architecturally.","high","strategic-or-implemented-component","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Normalized legacy merge-bench wording to dossier-backed below-core benchmark posture on 2026-04-25.","not_live_reference_or_discard_candidate","phase0r_reference_benchmark_or_discard_eval","Packet 0R-E closed. Retain as an MIT research benchmark for learned heuristic search, ADI training loops, and offline experimentation rather than near-term product implementation."
9) Open questions / blockers","Primary: Phase G v4 board (canonical ranking and current bucket); Operational v3 board filtered to this repo; Merger matrix rows involving this repo; VS Code packet row for this repo, if present. Optional: Cluster narratives row for matching cluster; Bookmark occurrence rows for this repo. Do not attach v1/v2 or preliminary memo unless a judgment conflict, lineage ambiguity, or rationale gap needs arbitration.","yakupbilen/drl-rubiks-cube is placed in Reserve Bench for HyperTwist because it best serves the 'Search/training systems bench' role; recommended action is 'future candidate' with repurposing scope 'architecture only'. Confidence is medium because this remains a metadata-level judgment until source audit confirms hidden modules, plugin points, adapters, or architectural strengths.","Useful MIT search and training benchmark for learned-heuristic search, state generation, and experimentation loops, but explicitly below the committed perception and training core.","Audit yakupbilen/drl-rubiks-cube as a learned-search and offline experimentation benchmark for HyperTwist. Do not stop at README-level claims. Inspect cube-state encoding, move-transition tables, ADI generation, batched neural A* search, value-network shape, and experiment loops. Decide whether the repo remains a non-live research benchmark and identify only those primitives that would matter if a future first-party ML search lane is intentionally opened. Do not treat camera UX or PyQt shell behavior as owner evidence.","HT_cube_vision_0008","HT_cube_vision","yakupbilen/drl-rubiks-cube","","","","","","","Original global P0-P3 source audit retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","2","3","117.0","permissive_or_noncopyleft_known","pattern_only_preferred","The repo is MIT and remains a research benchmark for learned heuristic search, ADI state generation, and offline experimentation rather than a near-term product donor.","Reference only: benchmark learned heuristic search and training experiments without near-term direct incorporation.","Typically preserve notices, attribution, and license text where required; no special copyleft-driven disclosure posture is normally needed.","Usually unnecessary unless you later decide the existing implementation is too constraining architecturally.","high","strategic-or-implemented-component","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Normalized legacy merge-bench wording to dossier-backed below-core benchmark posture on 2026-04-25.","not_live_reference_or_discard_candidate","phase0r_reference_benchmark_or_discard_eval","Packet 0R-E closed. Retain as an MIT research benchmark for learned heuristic search, ADI training loops, and offline experimentation rather than near-term product implementation."
"Hypercubers/hypercubing.xyz","https://github.com/Hypercubers/hypercubing.xyz","HyperTwist","Locked Strategic Donor","Knowledge and curriculum donor","P1","7483","9238","1.0","92.0","101.0","medium","Treat this as a mineable codebase: keep selected internals (algorithms, renderers, adapters, parsers, schedulers) while replacing the surrounding product assumptions and architecture. For this repo class, that usually means preserving generalized puzzle/state/render logic while building a new application shell around it.","repurpose","moderate modification","Determine whether Hypercubers/hypercubing.xyz should stay donor/merge-tier for HyperTwist, be promoted, or be demoted; identify concrete salvageable modules and best merge path.","puzzle model, learning flow, UX loops, data schema, replay/export, plugin/hooks","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for higher-dimensional state/notation representations, projection math, renderer abstractions, puzzle serialization, controls, and replay/training hooks.","Inspect generalized puzzle/state model; notation parser; transform math; rendering abstraction; save/load format; puzzle generator; input mapping; performance optimizations.","Repurpose selected subsystems rather than the whole product. Mine the repo for nD state model, move notation, renderer, projection controls, solver/traversal logic, puzzle serialization, replay; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, tao-yu/Alg-Trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, tao-yu/Alg-Trainer.","Repurpose here means: turn it into a higher-dimensional renderer/simulator donor and shared interaction grammar for HyperTwist and long-horizon VectorShell.","HactarCE/Hyperspeedcube","foundation + donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","cubing/cubing.js","3D engine + notation/state donor","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","tao-yu/Alg-Trainer","training UX donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","Upgrade if source reveals clean modular architecture, reusable core abstractions, strong adapters/plugins, robust tests, and direct fit to a locked stack.","Demote if reusable value is mostly superficial, undocumented complexity overwhelms salvage value, or higher-ranked repos clearly dominate the same role.","Capability inventory + salvage targets + promotion/demotion verdict","1) Confirmed visible capabilities
2) Hidden capabilities found only in source
3) Best salvageable modules/files/packages

1 repo primary_url project phase_g_bucket stack_layer audit_tier tier_queue_order global_order wave_number portfolio_priority_score execution_priority_score_v3 current_confidence modification_scope_detail_v3 recommended_action_v2 repurposing_potential_v2 audit_goal inspect_emphasis source_code_audit_targets source_inspection_questions integration_realization_detail consolidation_detail repurpose_detail merger_partner_1 merger_type_1 merger_rationale_1 merger_partner_2 merger_type_2 merger_rationale_2 merger_partner_3 merger_type_3 merger_rationale_3 cross_project_transfer_targets cross_project_transfer_rationale reclassify_up_if reclassify_down_if deliverable_expected session_note_template recommended_context_packet phase_g_master_list_rationale phase_g_bucket_reason coding_model_instruction_v3 source_audit_packet_id cluster_tag _repo_norm v5_runtime_project v5_scriptorium_override_status v5_scriptorium_bucket v5_scriptorium_stack_layer v5_scriptorium_current_reality_status v5_scriptorium_supersedes_prior_assessment v5_source_of_truth v6_license_annotation v6_license_annotation_status v6_license_annotation_source v6_supplemental_intake_present v6_supplemental_source_groups v6_supplemental_source_sections v6_supplemental_source_files v6_reference_material_position v6_kali_agent_access_relevance v6_branch_seed_prompt_included v6_branch_seed_scope v6_intake_wave v6_notes v6_source_of_truth project_rank_num tier_rank_num priority_num copyleft_relevance_v6_1 copyleft_strategy_v6_1 copyleft_rationale_v6_1 preferred_boundary_model_v6_1 open_compliance_if_used_as_is_v6_1 reverse_engineer_if_proprietary_core_needed_v6_1 copyleft_strategy_confidence_v6_1 copyleft_manual_review_trigger_v6_1 as_is_incorporation_sensible_v6_1 v6_2_sre_layer v6_2_sre_stratum v6_2_sre_role v6_2_sre_family v6_2_related_kali_package v6_2_related_upstream_repo v6_2_kali_package_suffices_for_tool_execution v6_2_upstream_repo_preferred_for_deep_eval v6_2_index_page_followup_useful v6_2_index_page_followup_reason v6_2_sre_notes v6_2_dnspy_ilspy_relevance v6_3_source_of_truth v6_3_merge_note v6_3_live_state_2026_05_11 v6_3_reset_lane_2026_05_11 v6_3_reset_next_step_2026_05_11
193
194
195
196
197
198
199
201
202
203
204
205
206
207

View file

@ -190,6 +190,7 @@ repo.
| Recognition-comparison adjunct boundary | Deep-source grounded retained | `cahidenes/rubiks-cube-solver` + `tentone/rubix-solver` retained adjunct lane | Narrow face-placement, cube-string cross-check, quad sorting, square-mask color sampling, center-color face labeling, and native face/state comparison value remain retained only behind the landed `qbr`, `rubix-cube-solver`, and first-party correction-stack owners. No default widening packet is open. |
| Multi-face correction/explanation shell | Implemented now | first-party recognition/training surfaces | Current bounded correction profile, contradiction-aware correction state, accepted-resolution ledger, and correction-explanation / solve-unlock shell are live above the landed `Phase 6R-O`, `Phase 6R-P`, `Phase 6R-Q`, `Phase 6R-R`, and `Phase 6R-S` seams. Bundled-asset, generalized solver-backend, and broad playback/runtime widening remain deferred. |
| Compact classic-cube solver correctness and heuristic-search oracle | Deep-source grounded retained | `brownan/Rubiks-Cube-Solver` retained lane + `efrantar/rob-twophase` comparator | Broad solver-backend ownership remains non-live. `brownan` remains the primary compact correctness and heuristic-table oracle, while `efrantar` remains the retained metric, pruning, robot-execution, and performance comparator. |
| Learned heuristic search and `ADI` state-generation research benchmark | Deep-source grounded retained | `yakupbilen/drl-rubiks-cube` retained research lane | Retained only for `54`-sticker transition encoding, anti-cancellation move-sequence generation, `ADI` state generation, batched neural `A*` search experiments, and small value-network research. This does not displace `qbr` or `rubix-cube-solver` for live perception/reconstruction ownership, and it does not displace `brownan` or `efrantar` for correctness/performance oracle ownership. |
### 3. Training, coaching, and progression cockpit