diff --git a/docs/HYPERTWIST_GUIDED_CLASSIC_CUBE_TASK_PLANNER_AND_FOCUS_PLAYBACK_HIERARCHY_RECONCILIATION_2026-05-27.md b/docs/HYPERTWIST_GUIDED_CLASSIC_CUBE_TASK_PLANNER_AND_FOCUS_PLAYBACK_HIERARCHY_RECONCILIATION_2026-05-27.md new file mode 100644 index 0000000..26b28e9 --- /dev/null +++ b/docs/HYPERTWIST_GUIDED_CLASSIC_CUBE_TASK_PLANNER_AND_FOCUS_PLAYBACK_HIERARCHY_RECONCILIATION_2026-05-27.md @@ -0,0 +1,208 @@ +# HyperTwist Guided Classic-Cube Task-Planner And Focus-Playback Hierarchy Reconciliation - 2026-05-27 + +## Status + +This document is the source-backed reconciliation note for the current guided +classic-cube task-planner and focus-playback family across: + +- `alinen/cube` +- the first-party training, drill, coaching, and replay surfaces +- the landed bounded classic-cube `Phase 6R-Q`, `Phase 6R-R`, and `Phase 6R-S` + seams + +It answers one narrow question: + +- does the current `alinen/cube` source require reopening already landed + HyperTwist training/replay or classic-cube explanation packets before any + future guided-task packet is considered + +Result: + +- no product-code reopening is required +- yes selective authority backfill is required so the retained planner slice + stays narrow and does not blur into the current first-party + training/drill/coaching, replay, or bounded classic-cube explanation + families + +## 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\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md` +- `C:\Workspaces\HyperTwist\repos.manifest.json` +- `C:\Workspaces\HyperTwist\clean-room-specs\alinen-cube.model-a.md` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\alinen\cube\README.md` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\alinen\cube\Assets\Scripts\CubePlanner.cs` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\alinen\cube\Assets\Scripts\CubeTaskSolver.cs` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\alinen\cube\Assets\Scripts\CubeStateManager.cs` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\alinen\cube\Assets\Scripts\CubeController.cs` +- current first-party runtime and packet authority under: + - `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist` + - `C:\HyperTwist\docs\ops\HYPERTWIST_IMPLEMENTATION_PHASE_1_KICKOFF.md` + +## Slice-local verdict + +| Slice | Primary authority | Secondary value kept | Route | Width | Result | +| --- | --- | --- | --- | --- | --- | +| Landed first-party training sessions, method-drill definitions, run state, follow-up queues, and coaching cockpit surfaces | first-party training and coaching surfaces | none required from `alinen/cube` | existing landed permissive route | `F2` | unchanged live implementation owner | +| Landed first-party replay and staged explanation shells | first-party replay surfaces plus landed bounded classic-cube `Phase 6R-Q`, `Phase 6R-R`, and `Phase 6R-S` seams | none required from `alinen/cube` | existing landed permissive route | `F2` | unchanged live implementation owner | +| Guided task graph, bounded task-local planner, focus-target cueing, and queued move demonstration for beginner classic-cube help | `alinen/cube` | current first-party training/coaching, replay, and bounded classic-cube explanation families remain adjacent non-overlapping owners | `R4` now, `R3` only if an explicit clean-room packet is opened later | `F2` | restrictive planner benchmark authority kept explicit | + +## Why no product-code reopening is required + +### `alinen/cube` + +`alinen` still has retained value, but it is narrow: + +- named solve-task progression rather than a single monolithic solve path +- bounded per-task search and scoring against current constraints +- explicit focus-target cueing for the current task +- queued move demonstration over a visible cube surface +- separable cube-state, planner, and playback modules + +That retained value is explicit in the current source: + +- `CubePlanner.cs` builds an ordered `_tasks` list with row/task labels and + per-task solver delegates +- `CubePlanner.cs` advances one task at a time and only requests bounded help + against the current task +- `CubePlanner.cs` uses `FocusCubie(...)` and task-specific color-enable logic + to spotlight the current teaching target +- `CubeTaskSolver.cs` scores candidate paths against the current cubie and + solved constraints rather than only asking for a total-cube finish +- `CubeController.cs` owns a queued command-playback seam separate from the + planner +- `CubeStateManager.cs` keeps the cube-state turn/grouping layer separate from + both the planner and the playback shell + +Those strengths make `alinen/cube` the strongest current guided task-planner +benchmark. They do not make it the owner of HyperTwist's live training, +coaching, replay, or bounded classic-cube explanation families. + +### Current first-party training/coaching and replay surfaces + +HyperTwist already owns the current live training, coaching, and adjacent +replay family in first-party code: + +- method-drill sample decks and definitions already exist +- method-drill run, batch, diagnostic, and follow-up template surfaces already + exist +- coaching queue and follow-up entry surfaces already exist +- replay and staged explanation surfaces already exist through first-party + replay and bounded classic-cube explanation lanes + +Those surfaces are broader and already live. `alinen/cube` does not reopen +them. + +### Landed classic-cube `Phase 6R-Q/R/S` + +The landed classic-cube explanation and correction seams are already first-party +and bounded: + +- the stage ladder already exposes ordered solve stages +- solve guidance already gates on reconstruction and correction completion +- correction and resolution already reopen or unlock the stage ladder in a + bounded way +- playback-stage ownership is intentionally deferred inside that bounded family + +`alinen/cube`'s task-planner benchmark does not reopen those shell/state +families. It only remains a later clean-room comparison surface if HyperTwist +ever wants a more explicit guided task graph above the current drill, replay, +and solve-guidance seams. + +## Selective backfill result + +### Earlier packet reopened + +- `C:\HyperTwist\docs\HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md` + +### Earlier standing note reopened + +- `C:\Workspaces\HyperTwist\clean-room-specs\alinen-cube.model-a.md` + +### Reason + +Later comparison against the now-landed HyperTwist training/drill/coaching, +replay, and classic-cube explanation surfaces sharpened the exact retained +`alinen` slice: + +- `alinen/cube` is not a generic training-session owner +- `alinen/cube` is not a generic coaching backend owner +- `alinen/cube` is not the live owner of canonical replay or staged + explanation playback +- `alinen/cube` is not the live owner of the current bounded solve-guidance + ladder +- `alinen/cube` remains the task-planner benchmark only for the narrower + lesson-task graph, bounded task-local planner, focus-target cueing, and + queued move-demonstration slice + +### Change class + +- repo-local extraction did not change +- cross-lane authority wording was sharpened for the exact retained slice +- no cleanup interpretation changed +- no product-code change occurred + +### What remained valid + +- the original `0R-E` decision to keep `alinen/cube` no-license and non-live + remained valid +- the current first-party training/coaching surfaces remained valid +- the current first-party replay surfaces remained valid +- the current first-party classic-cube `Phase 6R-Q/R/S` seams remained valid +- the existing scrubbed `Model A` handoff remained valid as a seed + +### What changed + +The dependent canon now makes the exact non-live role explicit: + +- keep `alinen/cube` only as the strongest clean-room planner benchmark for + the narrower guided task-graph and focus-playback slice +- keep training/drill/coaching ownership with the current first-party surfaces +- keep replay ownership with the current first-party replay family +- keep bounded classic-cube explanation and correction ownership with the + landed `Phase 6R-Q/R/S` seams + +## Propagation result + +### Feature registry + +Updated. + +The registry now explicitly records the retained guided task-planner and +focus-playback slice instead of leaving that slice implicit in the older `0R-E` +packet alone. + +### Cross-lane doctrine + +No doctrine wording change was needed. + +This pass applied the existing `A/R/F` hierarchy; it did not change the +hierarchy rules themselves. + +### Skillization + +No doctrine or `SKILLS.md` change was needed. + +This pass did not create or reopen any command or skill surface. + +### Legal evidence + +No license-status or mirror-custody change occurred. + +The repo-row tracker, feature registry, manifest, and scrubbed handoff were +sharpened instead. + +## Operational answer + +Before any future guided task or planner packet is opened, the correct move was +this evaluation and selective backfill pass first. + +After this pass: + +- do not reopen the live product code +- do not reinterpret `alinen/cube` as proof that training/coaching, replay, + or bounded solve-guidance ownership is still pending +- if HyperTwist later opens a true guided task-planner lane, start from the + retained planner benchmark slice only and keep it clean-room routed rather + than donor-routed diff --git a/docs/HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md b/docs/HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md index e3fc782..5d496b6 100644 --- a/docs/HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md +++ b/docs/HYPERTWIST_PHASE_0R_PACKET_0R_E_EVALUATION_2026-05-13.md @@ -595,6 +595,19 @@ Integration call: - retain as a clean-room planner and step-segmentation benchmark - if future teaching work needs planner-style explicit tasks, start from scrubbed task contracts rather than source reuse +2026-05-27 hierarchy overlay: + +- `alinen/cube` remains `A1 + R4 + F2` only for the retained lesson-task + graph, bounded task-local planner, focus-cue targeting, and queued + move-demonstration slice +- do not reinterpret the current first-party training-session, method-drill, + coaching queue/follow-up, canonical replay, or bounded classic-cube + `Phase 6R-Q`, `Phase 6R-R`, and `Phase 6R-S` shell/state families through + this row +- use + `C:\HyperTwist\docs\HYPERTWIST_GUIDED_CLASSIC_CUBE_TASK_PLANNER_AND_FOCUS_PLAYBACK_HIERARCHY_RECONCILIATION_2026-05-27.md` + as the current comparative authority before later clean-room work + ### `ambisinister/blindsolve` Inspected source surfaces: diff --git a/docs/REPO_LICENSE_TRACKING.md b/docs/REPO_LICENSE_TRACKING.md index bd4c61b..61d370a 100644 --- a/docs/REPO_LICENSE_TRACKING.md +++ b/docs/REPO_LICENSE_TRACKING.md @@ -1591,9 +1591,16 @@ Source basis: Approved working posture: -- keep as a planner/task-segmentation clean-room benchmark +- keep as an `A1 + R4 + F2` clean-room benchmark only for the retained + lesson-task graph, bounded task-local planner, focus-target cueing, and + queued move-demonstration slice +- do not reinterpret the current first-party training-session, method-drill, + coaching queue/follow-up, canonical replay, or bounded classic-cube + `Phase 6R-Q`, `Phase 6R-R`, and `Phase 6R-S` shell/state families through + this row - do not route direct donor work from this row -- preserve the existing model-a file only as bounded seed material beneath the packet authority +- preserve the existing model-a file only as bounded seed material beneath the + packet authority ### `ambisinister/blindsolve` diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md index 6f74394..ff0ba8a 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md @@ -182,6 +182,7 @@ repo. | Training sessions, method drills, and coaching dashboard | Implemented now | first-party training/coaching surfaces | Current live cockpit anchor. | | Follow-up templates, session queues, and coach summaries | Implemented now | first-party current code | Real first-party orchestration surface. | | Guided beginner lesson-state and stepwise pedagogy benchmark | Deep-source grounded retained | `AviKaufman/Rubix-cube-trainer` retained clean-room benchmark lane | Retained as `A1 + R4 + F2` only for named beginner milestones, oversatisfied-step explanation, bounded step help, and manual-turn/tutorial coherence on a live cube surface. This does not displace the first-party training-session, method-drill, coaching queue/follow-up, or bounded classic-cube `Phase 6R-Q/R/S` explanation and correction seams. | +| Guided task-planner and focus-playback benchmark | Deep-source grounded retained | `alinen/cube` retained clean-room benchmark lane | Retained as `A1 + R4 + F2` only for a separable lesson-task graph, bounded task-local planner, focus-target cueing, and queued move demonstration on a visible cube surface. This does not displace the first-party training-session, method-drill, coaching queue/follow-up, canonical replay, or bounded classic-cube `Phase 6R-Q/R/S` explanation and correction seams. | | Embodied companion/narration adjunct | Implemented now | landed `TalkingHead` packet | Live bounded avatar/narration family. | | Broader long-horizon coach memory and cognitive state | Deep-source grounded retained | first-party target + memory doctrine | Doctrine-governed future widening; not yet a mature memory system. |