hypertwist/docs/ops/HYPERTWIST_IMPLEMENTATION_PHASE_1_KICKOFF.md
2026-05-26 23:31:20 +02:00

13 KiB

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 dedicated current doctrine note for MPL-side non-GPL usage is:
  • the dedicated release-placement checklist for selling or externally distributing builds that include those MPL lanes is:
  • 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