# HyperTwist Implementation Phase 1 Kickoff

Created on `2026-05-21`.

## Purpose

This file records the current implementation-facing HyperTwist runtime truth
after the retained-set reset, the restrictive clean-room waves, and the first
`Phase 6R` widening packets.

It exists so the repo has one short operational note that answers:

- what real product code exists now
- which live first-party seams are already real
- which newer doctrine surfaces govern future widening
- what the next concrete packet should be

## Verified repo-state note on `2026-05-21`

Current verified product-side reality is:

- first-party training/coaching/runtime surfaces are real and landed
- restrictive lanes `onionhoney/roux-trainers`, `cubing/alg.js`,
  `cubing/twisty.js`, `HactarCE/2x2x2x2-Scrambler`, and `kash/cubedesk` are
  already implemented through accepted bounded packets
- `cubing/cubing.js` is live through an accepted boundary-sensitive `MPL`-side
  adapter/dependency route, not through a restrictive clean-room route
- bounded permissive widening is already landed for:
  - `HactarCE/Hyperspeedcube`
  - `kkoomen/qbr`
  - `vivaansinghvi07/rubix-cube-solver`
  - `roice3/MagicTile`
  - `ggml-org/whisper.cpp`
  - `SYSTRAN/faster-whisper`
  - `rhasspy/piper`
  - `coqui-ai/TTS`
  - `roice3/Magic120Cell`
  - `roice3/MagicCube5D`
- the landed `coqui-ai/TTS` code-side slice is not a clean-room lane by
  current doctrine; model and payload review remains separate from the package
  code license
- the `2026-05-27` speech row-source live-state reconciliation note is the
  authority for backfilling the `v6.3` source-pack live-state and reset-lane
  fields for `ggml-org/whisper.cpp`, `SYSTRAN/faster-whisper`,
  `rhasspy/piper`, and `coqui-ai/TTS`
- the dedicated current doctrine note for `MPL`-side non-`GPL` usage is:
  - [HYPERTWIST_MPL_BOUNDARY_AND_NON_GPL_USAGE_DOCTRINE_2026-05-25.md](C:/HyperTwist/docs/ops/HYPERTWIST_MPL_BOUNDARY_AND_NON_GPL_USAGE_DOCTRINE_2026-05-25.md:1)
- the dedicated release-placement checklist for selling or externally
  distributing builds that include those `MPL` lanes is:
  - [HYPERTWIST_MPL_DISTRIBUTION_PLACEMENT_CHECKLIST_2026-05-25.md](C:/HyperTwist/docs/ops/HYPERTWIST_MPL_DISTRIBUTION_PLACEMENT_CHECKLIST_2026-05-25.md:1)
  - that checklist explicitly covers public commercial website, store,
    checkout, release, and download surfaces when they sell or deliver builds
    containing those `MPL` lanes
- the closed `0R-E` packet still retains these non-live benchmark, oracle, or
  clean-room-later rows:
  - `cs0x7f/cstimer`
  - `brownan/Rubiks-Cube-Solver`
  - `efrantar/rob-twophase`
  - `ShellPuppy/RCube`
  - `vwcwong/CubeSim`
  - `AviKaufman/Rubix-cube-trainer`
  - `alinen/cube`
  - `ambisinister/blindsolve`
  - `yakupbilen/drl-rubiks-cube`
- the closed `0R-E` packet discarded these active-set rows:
  - `aMonteSl/CodeXR`
  - `MathewKJ2048/Rubiks-cube-simulator`
  - `brianpeiris/RiftSketch`
- no other repo should be described as implemented without explicit packet and
  product-surface evidence

## Live first-party runtime anchors

Current first-party anchors already present in code include:

- `UHyperTwistTrainingSubsystem`
- `UHyperTwistTrainingRuntimeLibrary`
- `UHyperTwistTrainingPanelWidget`
- `AHyperTwistTrainingSessionActor`
- `UHyperTwistCoachDashboardWidget`
- `UHyperTwistTrainingCatalogLibrary`
- `UHyperTwistTrainingTilingLibrary`
- `UHyperTwistContractLibrary`
- `UHyperTwistHttpVisionClient`
- `UHyperTwistHttpSpeechClient`
- `UHyperTwistMockSpeechClient`
- `UHyperTwistHttpVoiceClient`
- `UHyperTwistMockVoiceClient`

These are real first-party seams, not speculative targets.

## What this scaffold is not

This is not yet:

- a full memory federation implementation
- a finished provider-neutral BYOK/profile system
- a broad live skill layer
- the fully widened speech-input / voice-output stack

Those remain governed future capability families.

## Governing doctrine stack for next widening

Use these as the current governing docs:

- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md`
- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\ROADMAP.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_CROSS_LANE_AUTHORITY_HIERARCHY_AND_RECONCILIATION_2026-05-20.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_PACKET_CLEANUP_AND_REBUILDABLE_ARTIFACT_HYGIENE_2026-05-20.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_CANONICAL_COMPACT_CLOSEOUT_FORMAT_2026-05-19.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_OPTIONAL_ASSISTIVE_FEATURE_DEACTIVATION_AND_REMOVABILITY_DOCTRINE_2026-05-21.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_MEMORY_LANE_AUTHORITY_AND_PHASE_IMPLEMENTATION_DOCTRINE_2026-05-21.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_CONTINUITY_LATTICE_AND_CONTEXT_ASSEMBLY_PROFILE_DOCTRINE_2026-05-23.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`
- `C:\HyperTwist\docs\ops\HYPERTWIST_SKILLIZATION_AND_COMMAND_SURFACE_DOCTRINE_2026-05-21.md`

## Immediate next step

The next bounded move is now:

1. the bounded permissive `Phase 6R-K` `HactarCE/Hyperspeedcube` notation and replay-log
   serialization implementation packet is now landed in current code
2. the bounded permissive `Phase 6R-L` `HactarCE/Hyperspeedcube` replay verification
   implementation packet is now landed in current code
3. the bounded permissive `Phase 6R-M` `HactarCE/Hyperspeedcube` stats-shape and solve-record
   implementation packet is now landed in current code
4. the bounded permissive `Phase 6R-N` `HactarCE/Hyperspeedcube` puzzle-definition DSL
   implementation packet is now landed in current code
5. the bounded permissive `Phase 6R-O` `kkoomen/qbr` webcam UI shell packet is now landed in
   current code
6. the bounded permissive `Phase 6R-P` `vivaansinghvi07/rubix-cube-solver` browser/webcam shell
   packet is now landed in current code
7. the bounded permissive `Phase 6R-Q` `vivaansinghvi07/rubix-cube-solver` solve
   explanation/recommendation packet is now landed in current code
8. the continuity-profile sync now names `Continuity Lattice` as the substrate only, keeps
   `Memory Lanes` canonical, and treats `Max-Retention Mode` and `Economic-Retention Mode` as
   preset-backed overrideable context-assembly profiles rather than a second memory system
9. the generic source-backed `Phase 6R-R` shared classic-cube recognition multi-face
   correction/explanation control pass is now consumed
10. the bounded permissive `Phase 6R-R` shared classic-cube recognition multi-face
    correction/explanation shell packet is now landed in current code
11. the generic source-backed `Phase 6R-S` shared classic-cube correction-resolution closure
    control pass is now consumed
12. the bounded permissive `Phase 6R-S` shared classic-cube correction-resolution closure packet
    is now landed in current code
13. the generic source-backed `Phase 6R-T` `roice3/MagicTile` transform-aware macro remapping
    control pass is now consumed
14. the bounded permissive `Phase 6R-T` `roice3/MagicTile` transform-aware macro remapping
    packet is now landed in current code
15. the generic source-backed `Phase 6R-U` `ggml-org/whisper.cpp` live microphone capture shell
    control pass is now consumed
16. the bounded permissive `Phase 6R-U` `ggml-org/whisper.cpp` live microphone capture shell
    packet is now landed in current code
17. the generic source-backed `Phase 6R-V` `ggml-org/whisper.cpp` device-permission and
    capture-route readiness shell control pass is now consumed
18. the bounded permissive `Phase 6R-V` `ggml-org/whisper.cpp` device-permission and
    capture-route readiness shell packet is now landed in current code
19. the generic source-backed `Phase 6R-W` `ggml-org/whisper.cpp` downloadable model and
    payload custody control pass is now consumed
20. the bounded permissive `Phase 6R-W` `ggml-org/whisper.cpp` downloadable model and
    payload custody packet is now landed in current code
21. the generic source-backed `Phase 6R-X` first-party provider-profile and BYOK custody
    control pass is now consumed
22. the bounded first-party `Phase 6R-X` provider-profile and BYOK custody packet is now
    landed in current code
23. the generic source-backed `Phase 6R-Y` first-party provider routing and policy control
    pass is now consumed
24. the bounded first-party `Phase 6R-Y` provider routing and policy packet is now landed in
    current code
25. the generic source-backed `Phase 6R-Z` first-party normalized usage/cost event-model
    control pass is now consumed
26. the bounded first-party `Phase 6R-Z` normalized usage/cost event-model packet is now
    landed in current code
27. the generic source-backed `Phase 6R-AA` first-party operator-facing provider usage/cost
    dashboard shell control pass is now consumed
28. the bounded first-party `Phase 6R-AA` operator-facing provider usage/cost dashboard shell
    packet is now landed in current code
29. the generic source-backed `Phase 6R-AB` first-party provider usage/cost history/export
    shell control pass is now consumed
30. the bounded first-party `Phase 6R-AB` provider usage/cost history/export shell packet is
    now landed in current code
31. the generic source-backed `Phase 6R-AC` first-party provider receipt review and
    posted-charge inspection control pass is now consumed
32. the bounded first-party `Phase 6R-AC` provider receipt review and posted-charge inspection
    packet is now landed in current code
33. the generic source-backed `Phase 6R-AD` first-party provider billing settlement and
    invoice reconciliation control pass is now consumed
34. the bounded first-party `Phase 6R-AD` provider billing settlement and invoice
    reconciliation packet is now landed in current code
35. the generic source-backed `Phase 6R-AE` first-party provider settlement exception and
    external-portal handoff control pass is now consumed
36. the bounded first-party `Phase 6R-AE` provider settlement exception and external-portal
    handoff packet is now landed in current code
37. the generic source-backed `Phase 6R-AF` first-party real device-permission workflow
    control pass is now consumed
38. the bounded first-party `Phase 6R-AF` real device-permission workflow packet is now
    landed in current code
39. the generic source-backed `Phase 6R-AG` first-party native capture-route ownership and
    workflow preparation/control pass is now consumed
40. the bounded first-party `Phase 6R-AG` native capture-route ownership and workflow
    preparation/control packet is now landed in current code
41. the generic source-backed `Phase 6R-AH` first-party operator-facing native capture-route
    workflow shell pass is now consumed
42. the bounded first-party `Phase 6R-AH` operator-facing native capture-route workflow shell
    packet is now landed in current code
43. the generic source-backed `Phase 6R-AI` first-party provider-neutral custom-endpoint runtime
    routing pass is now consumed
44. the bounded first-party `Phase 6R-AI` provider-neutral custom-endpoint runtime routing
    packet is now landed in current code
45. keep the speech-lane guard visible:
    - keep code-license judgments separate from model, voice, and payload-license review
46. keep the provider-neutral speech-lane guard visible:
    - first-party HyperTwist owns the top-level provider/session contract
    - `whisper.cpp` and `faster-whisper` may win narrower donor slices without inheriting that
      lane, the provider routing/policy lane, or the usage/cost governance lane
47. keep the `MagicTile` guard visible:
    - keep broad non-Euclidean interaction or WinForms/OpenTK host-shell ownership closed by
      default unless a narrower first-party gap is proven above the landed macro-remapping seam

## Memory-specific sequencing rule

When HyperTwist later returns to memory implementation:

- do not open one broad "memory packet"
- follow the lane map and packet order in
  `C:\HyperTwist\docs\ops\HYPERTWIST_MEMORY_LANE_AUTHORITY_AND_PHASE_IMPLEMENTATION_DOCTRINE_2026-05-21.md`

## Context-assembly sequencing rule

When HyperTwist chooses a context-assembly posture:

- do not replace the lane doctrine with one monolithic continuity concept
- use `Continuity Lattice` as the substrate name only
- keep `Memory Lanes` as the governing internal taxonomy
- treat `Max-Retention Mode` and `Economic-Retention Mode` as preset-backed,
  overrideable context-assembly profiles over the same substrate
- escalate from `Economic-Retention Mode` to `Max-Retention Mode` before
  uncertainty becomes dangerous

## Provider-specific sequencing rule

Do not implement provider-specific overlays, usage surfaces, or model-profile
flows directly on top of a donor-specific schema.

First establish the first-party provider-neutral and BYOK-capable contract in:

- `C:\HyperTwist\docs\ops\HYPERTWIST_PROVIDER_NEUTRALITY_AND_BYOK_DOCTRINE_2026-05-21.md`

## Skillization sequencing rule

Do not jump directly from retained donor packets to a large live skill layer.

First follow:

- `C:\HyperTwist\docs\ops\HYPERTWIST_SKILLIZATION_AND_COMMAND_SURFACE_DOCTRINE_2026-05-21.md`

Specifically:

- `S1-A` registry and manifest contract
- `S1-B` settings/menu/off-state control
- `S2-A` permissive analyzer wrappers
- `S2-B` clean-room command-contract specs
