# HyperTwist Phase 6R-T MagicTile transform-aware macro remapping implementation packet

Created on `2026-05-24`

## Status

- first-party HyperTwist packet
- bounded permissive `Phase 6R-T` implementation slice

## Purpose

This packet lands the current retained `roice3/MagicTile`
transform-aware-macro seam:

- first-party transform-aware macro remapping contract, macro persistence
  boundary, and runtime lookup accessors above the already landed `Phase 6R-D`
  tiling topology contract

It is not:

- a full `MagicTile` row transplant
- a `Hyperspeedcube` runtime-base replacement
- a broad non-Euclidean interaction shell
- a WinForms/OpenTK host-shell packet
- a generic notation or replay packet
- the speech-input / voice sidecar packet

## Current authority basis

This implementation packet stands on:

- `docs/REPO_LICENSE_TRACKING.md`
- `docs/ops/HYPERTWIST_CROSS_LANE_AUTHORITY_HIERARCHY_AND_RECONCILIATION_2026-05-20.md`
- `docs/arch/HYPERTWIST_PHASE6R_T_MAGICTILE_TRANSFORM_AWARE_MACRO_REMAPPING_PREPARATION_PACKET_2026-05-24.md`

The retained owner remains:

- `roice3/MagicTile`

The granted family remains bounded to:

- transform-aware macro remapping
- reverse/setup-move/commutator playback support tags
- macro XML persistence boundary and puzzle-compatibility checks
- direct-donor attribution inside the already landed tiling reference bundle

The top-level product-shell and hyper-runtime owners do not change here:

- first-party HyperTwist remains the broader training and product-shell owner
- the retained `Hyperspeedcube` runtime anchor remains the generic
  higher-dimensional runtime owner

## Landed scope

The current code now owns a bounded first-party macro-remapping slice through:

- new first-party tiling contract types for:
  - macro remapping contract
  - macro persistence boundary
- expanded bundled `MagicTile` reference-bundle construction in:
  - `UHyperTwistTrainingTilingLibrary`
- package-reference additions for:
  - `Macro.cs`
  - `TwistHandler.cs`
  - `SetupMoves.cs`
- remapping-contract coverage for:
  - reference Mobius transform
  - clicked-cell canonical orientation
  - view-reflection parity
  - transformed twist lookup by nearest transformed center
  - reverse XOR view-reflection handling
  - puzzle-specific macro ownership
- persistence-boundary coverage for:
  - `MagicTileMacros` XML root
  - macro display-name, transform, and view-reflection persistence
  - saved-version compatibility
  - active-puzzle compatibility checks
  - puzzle-specific macro-file caveats
- runtime-library accessors for:
  - bundled macro remapping contract lookup
  - bundled macro persistence-boundary lookup
- focused automation coverage in:
  - `HyperTwistMagicTilePhase6RTMacroRemappingContractTest.cpp`

## Why this is still intentionally bounded

This packet lands the next narrow donor-backed `MagicTile` seam, but it does
not widen into neighboring retained families or broad host ownership.

Still deferred:

- broad non-Euclidean interaction shell
- WinForms/OpenTK host shell
- generic runtime-base replacement above `Hyperspeedcube`
- generic notation or replay ownership
- the speech-input / voice sidecar queue

## Validation

Build validation:

- `C:\Program Files\Epic Games\UE_5.7\Engine\Build\BatchFiles\Build.bat UnrealHyperTwistEditor Win64 Development -Project='C:\HyperTwist\UnrealHyperTwist\UnrealHyperTwist.uproject' -WaitMutex -NoHotReloadFromIDE -NoUba`

Focused automation validation:

- `C:\Program Files\Epic Games\UE_5.7\Engine\Binaries\Win64\UnrealEditor-Cmd.exe C:\HyperTwist\UnrealHyperTwist\UnrealHyperTwist.uproject -unattended -nop4 -nosplash -NullRHI -log -stdout -FullStdOutLogOutput -AbsLog=C:\HyperTwist\UnrealHyperTwist\Saved\Logs\Phase6R-T-MagicTile-Verify.log -ReportExportPath=C:\HyperTwist\UnrealHyperTwist\Saved\AutomationReports\Phase6R-T-MagicTile-Verify -ExecCmds="Automation RunTests HyperTwist.Permissive.MagicTile.Phase6R.T; Quit" -TestExit="Automation Test Queue Empty"`

Regression automation validation:

- `HyperTwist.Permissive.MagicTile.Phase6R.D`
- `HyperTwist.Permissive.MagicCube5D.Phase6R.J`
- `HyperTwist.Permissive.Magic120Cell.Phase6R.I`
- `HyperTwist.CleanRoom.CubeDesk`

Expected covered tests:

- `MacroRemappingContract`
- `MacroPersistenceBoundary`
- `PackageChecklist`
- existing `Phase 6R-D`, `MagicCube5D`, `Magic120Cell`, and `CubeDesk`
  regression suites

## Queue effect

This packet consumes the current bounded `Phase 6R-T` implementation slice.

`roice3/MagicTile` remains partially incorporated:

- landed now:
  - tiling topology and geometry-family contract
  - loader/runtime-anchor boundary
  - direct-donor attribution boundary
  - transform-aware macro remapping contract
  - macro persistence boundary
  - reverse/setup-move/commutator playback support tags
- still deferred:
  - broad non-Euclidean interaction shell
  - WinForms/OpenTK host shell
  - generic runtime-base replacement

The next clean move is:

- a source-backed `Phase 6R-U` `ggml-org/whisper.cpp` live microphone capture
  shell preparation/control pass

Keep the future sequencing guards visible:

- `roice3/MagicTile`
  - keep broad non-Euclidean interaction or WinForms/OpenTK host ownership
    closed by default unless a narrower first-party gap is proven above the
    landed macro-remapping seam
- `ggml-org/whisper.cpp`
  - keep code-license judgments separate from downloadable model or payload
    license review in any future live microphone packet
- first-party HyperTwist
  - keep the top-level provider/session contract first-party rather than
    letting `whisper.cpp` or `faster-whisper` absorb that lane through a
    narrower donor win
