diff --git a/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md b/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md index 3dbaa3e..2ac6307 100644 --- a/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md +++ b/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md @@ -118,7 +118,7 @@ For future work on the already-live lanes, read in this order: | `met4citizen/TalkingHead` | `MIT` | landed embodied companion, narration, lip-sync, gesture, subtitle, and avatar-embed lane | the main landed permissive embodied coach and companion preserve lane | generic speech-engine ownership, sample-asset shipping assumptions, donor example-shell ownership, or vendor lock-in | | `tao-yu/Alg-Trainer` | `MIT` | broad algorithm-training shell and case-corpus foundation | the main landed permissive algorithm-trainer foundation | persisted coaching backend or smartcube-first review shell | | `Lykos/cube_trainer` | `MIT` | persisted coaching, weighted sampling, and BLD-domain lane | the main landed permissive training-session and coaching lane | broad front-end training-shell ownership | -| `poliva/cubedex` | no explicit license visible in checked mirror; restrictive-custody correction on `2026-05-27` | existing first-party smartcube-aware practice, SRS, and review outputs remain preserved | preserve the current first-party lane only; future donor widening is blocked unless a real license basis is restored or a clean-room route is established | the sole case-corpus foundation, full backend owner, or ordinary permissive donor lane | +| `poliva/cubedex` | no explicit license visible in checked mirror; restrictive-custody correction on `2026-05-27` | existing first-party smartcube-aware practice, SRS, and review outputs remain preserved | preserve the current first-party lane only and keep this repo as restrictive comparison context; future donor widening is blocked unless a real license basis is restored or a narrower clean-room route is later justified | the sole case-corpus foundation, full backend owner, ordinary permissive donor lane, or default next clean-room queue row | | `newyork-anthonyng/rubiks-cross-trainer` | `MIT` | narrow CFOP cross drill lane | a focused cross difficulty ladder and scramble corpus | a general training platform | | `abunickabhi/5style-Trainer` | `MIT` with checked local notice naming `Tao Yu` | narrow advanced `5-style` / BLD drill lane | a focused advanced drill surface beneath the broader trainer owners | a general training foundation | | `onionhoney/roux-trainers` | `GPL-3.0`, already landed through clean-room | landed restrictive Roux method-stage lane | the earliest restrictive clean-room preserve precedent captured in this audit snapshot; later bounded restrictive clean-room lanes are tracked separately in later per-lane authority notes | permission for direct restrictive mirror reuse or a shortcut around future clean-room governance | @@ -1076,6 +1076,10 @@ Current status: - preserve the existing first-party outputs already landed in HyperTwist - do not treat the checked donor mirror as a landed permissive lane anymore +- use + [HYPERTWIST_SMARTCUBE_PRACTICE_REVIEW_AND_SRS_HIERARCHY_RECONCILIATION_2026-05-27.md](C:/HyperTwist/docs/HYPERTWIST_SMARTCUBE_PRACTICE_REVIEW_AND_SRS_HIERARCHY_RECONCILIATION_2026-05-27.md:1) + for the current owner split across first-party training, timer, smart-device, + and permissive trainer-foundation surfaces Licensing posture: @@ -1121,13 +1125,20 @@ Excluded or non-promotion boundary: Rationale: -- this lane is strongest as the landed smartcube review and repetition shell -- its practical value is high even though its checked local mirror currently carries a license-surface gap that must remain recorded +- the restrictive source still shows a useful smartcube-aware drill and + review/SRS UX comparison surface +- the current first-party training stack, timer substrate, integrated + smart-device workflow family, and landed permissive trainer foundations + already own the practical live implementation family +- the checked local mirror still carries a license-surface gap that must remain + recorded Future widening rule: -- widen only through ordinary first-party enhancement work -- preserve the current canonical `MIT` classification unless new source-backed evidence overturns it +- do not treat this row as a default clean-room implementation candidate +- widen only through ordinary first-party enhancement work, restored + source-backed license evidence, or a later clean-room route after a narrower + first-party gap is actually proven - do not lose the mirror-surface gap note during future legal packaging or mirror refresh work ### `newyork-anthonyng/rubiks-cross-trainer` diff --git a/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md b/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md index 623a1d4..1c07054 100644 --- a/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md +++ b/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md @@ -177,6 +177,12 @@ Contract: treated as a landed permissive preserve row. Preserve the existing first-party outputs, but route any future donor-backed work from restrictive custody only and do not treat the mirror as a normal `MIT` donor surface. +- `2026-05-27` hierarchy clarification: `poliva/cubedex` is also no longer a + default future clean-room queue row. Treat it only as restrictive comparison + context for a narrower smartcube-aware practice-shell, review/SRS UX, + recognition-versus-execution timing presentation, and local stats/history + slice beneath the current first-party training, `KubeTimr`, `CubeDesk`, + `tao-yu/Alg-Trainer`, and `Lykos/cube_trainer` owners. ### Landed boundary-sensitive preserve diff --git a/docs/HYPERTWIST_SMARTCUBE_PRACTICE_REVIEW_AND_SRS_HIERARCHY_RECONCILIATION_2026-05-27.md b/docs/HYPERTWIST_SMARTCUBE_PRACTICE_REVIEW_AND_SRS_HIERARCHY_RECONCILIATION_2026-05-27.md new file mode 100644 index 0000000..8ded019 --- /dev/null +++ b/docs/HYPERTWIST_SMARTCUBE_PRACTICE_REVIEW_AND_SRS_HIERARCHY_RECONCILIATION_2026-05-27.md @@ -0,0 +1,197 @@ +# HyperTwist Smartcube Practice, Review, And SRS Hierarchy Reconciliation - 2026-05-27 + +## Status + +This document is the source-backed reconciliation note for the current +smartcube-aware practice, review, spaced-repetition, and split-timing family +across: + +- `poliva/cubedex` +- the first-party training, review-plan, coaching, and stats/history surfaces +- the landed `Aarav2709/KubeTimr` timer substrate +- the landed `kash/cubedesk` trainer-session and integrated smart-device + workflow family +- the landed permissive trainer foundations under `tao-yu/Alg-Trainer` and + `Lykos/cube_trainer` + +It answers one narrow question: + +- does the current `poliva/cubedex` source require reopening already landed + HyperTwist training, review, timer, or smart-device packets before any future + smartcube-practice widening is considered + +Result: + +- no product-code reopening is required +- yes selective authority backfill is required +- `poliva/cubedex` should no longer be treated as a default future clean-room + candidate row + +## Source basis + +- `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` +- `C:\HyperTwist\docs\HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_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\mirrors\restrictive\poliva\cubedex\README.md` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\poliva\cubedex\src\hooks\useTrainingState.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\poliva\cubedex\src\lib\srs.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\poliva\cubedex\src\hooks\useSmartcubeConnection.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\poliva\cubedex\src\views\PracticeView.tsx` +- current first-party training code and content surfaces under: + - `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Public\HyperTwistTraining` + - `C:\HyperTwist\UnrealHyperTwist\Source\UnrealHyperTwist\Private\HyperTwistTraining` + - `C:\HyperTwist\UnrealHyperTwist\Content\HyperTwistTraining\MaterializedCatalog` + +## Slice-local verdict + +| Slice | Primary authority | Secondary value kept | Route | Width | Result | +|---|---|---|---|---|---| +| Landed first-party training sessions, review-plan state, spaced review flow, recognition-versus-execution timing policy, stats/history, and smartcube-capability surfaces | first-party training and coaching surfaces | `poliva/cubedex` as comparison context only | existing landed first-party and permissive routes | `F2` | unchanged live implementation owner | +| Landed local timer substrate and integrated smart-device workflow composition | `Aarav2709/KubeTimr` plus bounded `kash/cubedesk` lanes | `poliva/cubedex` as comparison context only | existing landed permissive and clean-room routes | `F2` | unchanged live implementation owner | +| Broad trainer-foundation and persisted coaching lane | `tao-yu/Alg-Trainer` plus `Lykos/cube_trainer` | `poliva/cubedex` as comparison context only | existing landed permissive routes | `F2` | unchanged live implementation owner | +| Smartcube-aware practice-shell comparison, offline-first drill UX composition, review/SRS workflow presentation, recognition-versus-execution timing presentation, and local stats/history comparison | `poliva/cubedex` | current first-party owners remain stronger for live implementation | preserve-only now; later `R4` only if a narrower first-party gap is actually proven | `F2` | retained restrictive comparison row only | + +## Why no product-code reopening is required + +### `poliva/cubedex` + +`cubedex` still has real comparison value, but its strongest value is now +narrower than the already landed first-party family. + +The restrictive source is still useful for: + +- smartcube-aware practice-shell expectations +- offline-first drill UX composition +- review and spaced-repetition workflow presentation +- recognition-versus-execution timing presentation +- local stats and training-history presentation + +That is useful comparison context. It is not proof that HyperTwist still lacks +an owner for the underlying training, review, timer, or smart-device family. + +### Current first-party training and review surfaces + +HyperTwist already owns the practical live family in current first-party code: + +- review-plan state, review-history, and review-plan repository/runtime APIs +- explicit recognition and execution split-phase timing definitions +- smartcube capability flags and smartcube-capability preview surfaces +- active review-plan resume, stored-plan access, and review-plan-backed launch + behavior +- first-party review policy, follow-up, and stats/history surfaces + +Those first-party surfaces are already broader than a future `cubedex` +promotion would need to be. + +### `KubeTimr`, `CubeDesk`, `Alg-Trainer`, and `cube_trainer` + +Adjacent retained or landed owners are also already explicit: + +- `KubeTimr` keeps the landed local timer substrate +- `kash/cubedesk` keeps the landed trainer-session and integrated smart-device + workflow composition family +- `tao-yu/Alg-Trainer` remains the landed permissive algorithm-training + foundation +- `Lykos/cube_trainer` remains the landed permissive persisted coaching and + weighted-sampling lane + +That means `cubedex` no longer reads like the next natural implementation queue +row. It reads like restrictive comparison context beneath already stronger live +owners. + +## Selective backfill result + +### Earlier preserve note reopened + +- `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` + +### Earlier retained-set contract reopened + +- `C:\HyperTwist\docs\HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md` + +### Reason + +The earlier custody correction fixed the legal posture, but it did not finish +the authority split. + +Later comparison against current first-party training/review/timer and +smart-device surfaces sharpens the exact remaining role: + +- `poliva/cubedex` is not a landed permissive lane anymore +- `poliva/cubedex` is not the current live owner of the smartcube-aware + practice/review/SRS family anymore +- `poliva/cubedex` is not the default next clean-room queue row either +- `poliva/cubedex` remains useful only as restrictive comparison context for a + narrower practice-shell and review UX slice + +### Change class + +- repo-local extraction did not change +- cross-lane authority wording was sharpened +- no cleanup interpretation changed +- no product-code change occurred + +### What remained valid + +- the restrictive-custody correction remained valid +- the existing first-party preserved outputs remained valid +- the current first-party training, review-plan, timer, and smart-device + owners remained valid + +### What changed + +The dependent canon now makes the exact non-live role explicit: + +- keep `poliva/cubedex` only as restrictive comparison context for the narrow + smartcube-practice, review/SRS UX, split-timing presentation, and local + history/stats presentation slice +- keep live implementation ownership with current first-party training/review + surfaces and the already landed adjacent owner lanes +- do not keep `poliva/cubedex` in the default future clean-room queue unless a + narrower first-party gap is actually proven later + +## Propagation result + +### Feature registry + +Updated. + +The registry now explicitly records the retained restrictive comparison slice +instead of leaving `cubedex` implied only by the live-lane audit and legal +tracker. + +### Cross-lane doctrine + +No doctrine wording change was needed. + +This pass applies the current hierarchy; it does not change the hierarchy +rules. + +### 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 custody change occurred. + +The repo-row tracker, preserve note, retained-set contract, feature registry, +and manifest role were sharpened instead. + +## Operational answer + +Before any future smartcube-practice or review-adjacent implementation 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 treat `poliva/cubedex` as the next default clean-room packet row +- only reopen this row if a narrower first-party gap above the current + training/review/timer/smart-device owner set is actually proven, or if + restored upstream license evidence materially changes the route diff --git a/docs/REPO_LICENSE_TRACKING.md b/docs/REPO_LICENSE_TRACKING.md index 421cad1..c2b1ebd 100644 --- a/docs/REPO_LICENSE_TRACKING.md +++ b/docs/REPO_LICENSE_TRACKING.md @@ -343,9 +343,10 @@ Those restrictive lanes should now be treated as: - the five historically restrictive implementation lanes remain properly clean-roomed and already landed/live - `poliva/cubedex` is a restrictive-custody correction: preserve the existing - first-party outputs already landed in HyperTwist, but do not widen from the - donor mirror without restored source-backed license evidence or a fresh - clean-room route + first-party outputs already landed in HyperTwist, treat the row as + restrictive comparison context only, and do not widen from the donor mirror + without restored source-backed license evidence or a later narrower + clean-room justification Interpretation rule: @@ -603,6 +604,7 @@ Source basis: - `C:\Workspaces\HyperTwist\mirrors\restrictive\poliva\cubedex\package.json` - `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` +- `C:\HyperTwist\docs\HYPERTWIST_SMARTCUBE_PRACTICE_REVIEW_AND_SRS_HIERARCHY_RECONCILIATION_2026-05-27.md` - current HyperTwist canonical row state and retained-set docs Practical obligations: @@ -618,9 +620,14 @@ Practical obligations: Approved working posture: - preserve the existing first-party outputs already landed in HyperTwist +- keep the current first-party training, review-plan, timer, and smart-device + owners as the practical live family for this slice +- treat this row as restrictive comparison context only, not as a default + clean-room implementation queue row - block donor-backed widening from this mirror by default - allow future widening only through independently owned first-party work, - restored upstream license evidence, or a fresh clean-room route + restored upstream license evidence, or a later clean-room route after a + narrower first-party gap is actually proven ### `newyork-anthonyng/rubiks-cross-trainer` 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 9458393..c911143 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md @@ -185,6 +185,7 @@ repo. | 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. | | Blindfold memo attempt and validation benchmark | Deep-source grounded retained | `ambisinister/blindsolve` retained clean-room benchmark lane | Retained as `A1 + R4 + F2` only for a narrow blindfold memo attempt-phase loop, conceal/reveal validation, letter-pair token entry, parity-aware memo expectation, and lightweight repeat cadence. This does not displace the first-party timing-policy templates, coaching-memory/follow-up surfaces, replay-verification blindfold event taxonomy, or the broader memory doctrine. | +| Smartcube-aware practice-shell and review/SRS UX comparison | Deep-source grounded retained | `poliva/cubedex` restrictive reference row | Retained as `A1 + R4 + F2` only for smartcube-aware practice-shell comparison, offline-first drill UX composition, review/SRS workflow presentation, recognition-versus-execution timing presentation, and local stats/history comparison. This does not displace the current first-party training-session, review-plan, coaching, `KubeTimr` timer substrate, `CubeDesk` smart-device workflow composition, or the landed permissive trainer-foundation lanes. | | 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. |