# HyperTwist Original 29 Live Repositories: Runtime Capability Proof Matrix

**Date:** 2026-07-23
**Status:** Current implementation and Release 19 package authority
**Scope:** The 29 implemented/live repositories inside the original 71-row
shallow-evaluation set

## Purpose

This matrix answers a narrower and more useful question than "is the repo
mentioned in documentation?":

> What retained capability from each of the original 29 live repositories has
> a current first-party owner, where can a player or operator reach it, what
> evidence validates it, and what package artifact is expected to carry it?

The executable source authority is
`UHyperTwistFirstRunLaunchLibrary::BuildIntegratedCapabilityCatalog()`. It
contains exactly 29 unique canonical repository rows and is rendered in the
native `About & Credits` surface. The catalog is contract-tested by
`HyperTwist.FirstRun.IntegratedCapabilityCatalogContract`.

This document does not turn all 29 rows into standalone games. It deliberately
separates:

- **Native playable**: puzzle-engine ownership used by a playable route.
- **Native player service**: learning, timing, recognition, replay, solver,
  narration, or session behavior inside a player route.
- **Browser support**: bounded support for the optional browser companion.
- **Operator support**: diagnostics, rollout, capture-history, or media-export
  planning used by advanced/operator surfaces.

This is also not the different historical Phase 1 queue of `29` selected
solver/browser/support candidates. That second set is now accounted for by
unique positions `1` through `29` in both
`Content/Browser/src/runtime/registry.ts` and
`Content/Browser/src/browser-spatial-runtime-fallback.js`.
`Content/Browser/scripts/verify-browser-shell.mjs` rejects count/identity
drift and also checks retained source/sidecar paths, direct bundled
dependencies, and locked transitive dependencies. Its valid realization
postures include dependency-only, source/native sidecar, QA/editor sidecar, and
reference-only; those postures are deliberate and are not mislabeled as
standalone gameplay.

## Count Contract

| Dimension | Required count | Current compiled catalog |
|---|---:|---:|
| Total original live rows | 29 | 29 |
| Permissive | 18 | 18 |
| Restrictive clean-room | 5 | 5 |
| Boundary-sensitive | 6 | 6 |
| Native playable | 5 | 5 |
| Native player service | 14 | 14 |
| Browser support | 7 | 7 |
| Operator support | 3 | 3 |

The native player puzzle catalog is a different count:

- 8 native playable entries: Classic Cube, 4D orders 2 through 6, Magic
  120-cell, and order-3 5D Cube.
- 1 browser preview entry: MagicTile Lab.
- The five native-playable integration rows do not map one-to-one to those
  eight menu entries. Hyperspeedcube owns the generalized order-3 through
  order-6 4D foundation, the order-2 clean-room row owns 2x2x2x2, the legacy
  4D row supplies attributed continuity beneath the current 4D family, and
  Magic120Cell plus MagicCube5D own their dedicated families.
- Classic Cube is first-party product behavior assembled above several player
  service rows; no donor row is falsely credited as owning the whole Classic
  runtime.

## Package Artifact Codes

- `N`: compiled into the first-party `UnrealHyperTwist` native module and
  therefore expected in `UnrealHyperTwist.exe`.
- `M`: consumed by a dedicated cooked map or materialized catalog asset.
- `B`: consumed by the bounded browser companion under `Content/Browser`.
- `O`: consumed by native advanced/operator diagnostics rather than presented
  as a standalone player mode.

The latest exact editor build is green. The final exact Release 19 desktop
package rerun for this combined lane is also green, including positive
verification of the staged browser files, all nine native route smokes,
archive integrity, and independent interactive proof from both the validation
archive and the exact Downloads executable.

## Permissive Rows

| Repository | Retained product capability | First-party runtime owner | Reachable route | Evidence | Artifact | Current truth |
|---|---|---|---|---|---|---|
| `Aarav2709/KubeTimr` | Inspection, live solve timer, splits, rolling statistics, personal bests, local persistence, timer-scoped replay | `UHyperTwistTrainingSubsystem.LiveTimer` | `classic-cube-training` | Integrated-capability catalog; Classic Cube integration and CubeDesk Bound 1 timer tests | `N` | Live native player service; not a separate timer application |
| `abunickabhi/5style-Trainer` | Advanced 5-style edge-cycle and blindfold micro-drills with reveal, self-grade, timing, and review priority | `UHyperTwistTrainingCatalogLibrary`, case `5style-4mover` | Main menu `Learn` | Learning Studio deck contract; integrated-capability catalog | `N` | Live learning service |
| `apache/echarts` | Solve trends and progress visualization contracts for the bounded browser companion | `UHyperTwistTrainingAnalyticsLibrary` | Protected/public browser-access lane | Browser automation plus integrated-capability catalog | `B` | Live browser-support contract; staged-package proof is green in Release 19 |
| `google/model-viewer` | Bounded glTF preview and browser asset-quality surface | `UHyperTwistTrainingViewerLibrary` | Browser-access lane | Browser shell verification; integrated-capability catalog | `B` | Live browser-support contract; not an Unreal renderer replacement |
| `HactarCE/Hyperspeedcube` | Generalized exact order-3 through order-6 4D state, legal turns, projection, notation, replay verification, statistics, and puzzle definitions | `UHyperTwistVirtual3333ProjectionLibrary` plus generated order-specific GameModes | `magic-cube-4d-3x3x3x3` through `magic-cube-4d-6x6x6x6` | `HyperTwist.Permissive.Hyperspeedcube.*`; `HyperTwist.VirtualNxNxNxN.*`; route/map contracts | `N`, `M` | Live native puzzle family; orders 3, 4, 5, and 6 are separate playable routes |
| `Hypercubers/hypercubing.xyz` | Higher-dimensional curriculum, notation, taxonomy, progression, software references, and community context | `UHyperTwistTrainingKnowledgeLibrary` | Main menu `Learn` and knowledge surfaces | Knowledge/reference contracts; integrated-capability catalog | `N` | Live learning/reference service |
| `kkoomen/qbr` | Classic-cube face observation, calibration, webcam-shell guidance, locale presentation, and bounded font readiness | `UHyperTwistTrainingSubsystem.RecognitionSession` | Settings and recognition workflow | `HyperTwist.Permissive.Qbr.*`; integrated-capability catalog | `N` | Live native recognition service; camera hardware still requires user permission and a real device |
| `Lykos/cube_trainer` | Persisted, weighted, and recency-aware coaching plus method exploration and blindfold-oriented training continuity | `UHyperTwistTrainingRepositoryLibrary` | Main menu `Learn` | Learning Studio and repository-library tests; integrated-capability catalog | `N` | Live learning service |
| `met4citizen/TalkingHead` | Voice, subtitle, provider-boundary, and avatar-embed contracts beneath the fixed coach | `UHyperTwistTrainingCompanionLibrary`, `UHyperTwistSpeechLibrary`, fixed coach | Settings `Speech & Coach`; F3 in native puzzles | Speech tests; PlayerExperience native assistant test; integrated-capability catalog | `N` | Live native player service; no TalkingHead source is used as the Unreal UI owner |
| `mrdoob/three.js` | Browser-side spatial runtime substrate | `UHyperTwistTrainingSpatialLibrary.Three` plus bounded browser runtime | Browser-access lane | Browser shell verification; integrated-capability catalog | `B` | Live browser support; native Unreal remains authoritative |
| `pmndrs/react-three-fiber` | Declarative browser scene composition over the bounded spatial runtime | `UHyperTwistTrainingSpatialLibrary.ReactThreeFiber` | Browser-access lane | Browser shell verification; integrated-capability catalog | `B` | Live browser support |
| `pmndrs/xr` | Optional browser XR contract, kept separate from native Unreal OpenXR | `UHyperTwistTrainingSpatialLibrary.Xr` | Browser-access lane | Browser contract tests; integrated-capability catalog | `B` | Live browser support; no claim of headset validation |
| `roice3/Magic120Cell` | Exact 7,560-facelet permutation state, 7,440 legal base moves, inverse/forward turns, focus, projection, persistence, and dedicated scene | `UHyperTwistMagic120CellRuntimeLibrary` | `magic-120-cell-training` | `HyperTwist.Permissive.Magic120Cell.*`; Phase 6C activation; dedicated-map tests | `N`, `M` | Live native puzzle family. Visual scene shows representative 120 cell centers; it does not yet draw all 7,560 stickers |
| `roice3/MagicCube5D` | Exact order-3 5D state with 243 cubies, 810 facelets, legal turns, projection layers, focus, and persistence | `UHyperTwistMagicCube5DRuntimeLibrary` | `magic-cube-5d-training` | `HyperTwist.Permissive.MagicCube5D.*`; Phase 6C activation; dedicated-map tests | `N`, `M` | Live native puzzle family |
| `roice3/MagicTile` | Non-Euclidean topology, macro remapping, state bridge, timer continuity, browser preview, and native behavior proof seam | `UHyperTwistTrainingTilingLibrary`, `UHyperTwistBrowserWidget` | Browser-access lane / MagicTile Lab preview | `HyperTwist.Permissive.MagicTile.*`; `HyperTwist.FirstParty.MagicTile.Phase7*`; integrated-capability catalog | `B` | Live browser preview and proof seam. Native spherical/hyperbolic renderer remains deliberately gated |
| `tao-yu/Alg-Trainer` | Algorithm-set, prompt, scramble, reveal, self-grade, and training-catalog foundation | `UHyperTwistTrainingCatalogLibrary`, case `oll-t` | Main menu `Learn` | Learning Studio deck contract; integrated-capability catalog | `N` | Live learning service |
| `newyork-anthonyng/rubiks-cross-trainer` | Four-move cross-planning ladder with hidden answer, timing, self-grade, and review | `UHyperTwistTrainingCatalogLibrary`, case `cross-4move` | Main menu `Learn` | Learning Studio deck contract; integrated-capability catalog | `N` | Live learning service |
| `vivaansinghvi07/rubix-cube-solver` | Committed-face reconstruction, correction flow, solve explanation, and bounded browser/webcam support | `UHyperTwistTrainingSubsystem.SolveExplanation` | `classic-cube-training` | `HyperTwist.Permissive.RubixCubeSolver.*`; Classic integration; integrated-capability catalog | `N` | Live native player service |

## Restrictive Clean-Room Rows

No restrictive donor source is linked or imported into the proprietary/native
player surface. These rows refer to accepted first-party clean-room outputs.

| Repository | Retained product capability | First-party runtime owner | Reachable route | Evidence | Artifact | Current truth |
|---|---|---|---|---|---|---|
| `onionhoney/roux-trainers` | First-party Roux stages, blockbuilding, CMLL study, reveal, self-grade, and review flow | `UHyperTwistTrainingCatalogLibrary`, case `roux-trainers-algorithm-case-deck-cmll-default` | Main menu `Learn` | Learning Studio deck contract; clean-room authority; integrated-capability catalog | `N` | Live clean-room learning service |
| `cubing/alg.js` | First-party algorithm parser, AST, traversal, validation, keyboard mapping, serialization, and sharing semantics | `UHyperTwistAlgorithmLibrary` | Classic play and learning surfaces | Algorithm automation suite; clean-room authority; integrated-capability catalog | `N` | Live clean-room player service |
| `cubing/twisty.js` | First-party replay shell, scrubber, cursor timeline, adapter boundary, and local visual fallback | `UHyperTwistViewerLibrary` | `classic-cube-training` replay surface | `HyperTwist.CleanRoom.TwistyJs.*`; integrated-capability catalog | `N` | Live clean-room replay service |
| `HactarCE/2x2x2x2-Scrambler` | First-party order-2 4D legality, move algebra, exact turns, scramble packets, random-state generation, and teaching projection | `UHyperTwistCoreLibrary.Melinda` and Melinda projection runtime | `magic-cube-4d-2x2x2x2` | Melinda Bound 1-4, Phase 6A, dedicated-map, and PlayerExperience tests | `N`, `M` | Live clean-room native puzzle route |
| `kash/cubedesk` | First-party training/timer coupling, session analytics, smart-device lifecycle, publication gates, and local challenges | `UHyperTwistTrainingSubsystem.CubeDeskBounds` | `classic-cube-training` and advanced surfaces | CubeDesk Bound 1 through Bound 5; integrated-capability catalog | `N` | Live clean-room player service |

## Boundary-Sensitive Rows

These rows retain explicit attribution, mixed-asset, enterprise-boundary, or
future-widening constraints. "Live" never removes those constraints.

| Repository | Retained product capability | First-party runtime owner | Reachable route | Evidence | Artifact | Current truth |
|---|---|---|---|---|---|---|
| `cubing/cubing.js` | Bounded classic-cubing semantic, geometry, search, viewer-adapter, and device boundary | `UHyperTwistTrainingClassicCubingLibrary` | `classic-cube-training` | Classic-cubing support contracts; integrated-capability catalog | `N` | Live first-party adapter; donor license choice remains explicit |
| `cutelyaware/magiccube4d` | Attributed history, macro, puzzle-description, interaction, and view-continuity contracts beneath modern exact 4D | `UHyperTwistTrainingLegacy4DLibrary` | 4D order-3 through order-6 routes | Legacy 4D reference contracts plus exact 4D runtime tests; integrated-capability catalog | `N`, `M` | Live attributed continuity support; not the current runtime owner by itself |
| `google/model-viewer/packages/shared-assets` | Allowlisted mixed-provenance browser fixture/environment pack for bounded QA | `UHyperTwistTrainingSharedAssetLibrary` | Browser QA/operator path | Shared-asset allowlist contracts; integrated-capability catalog | `B` | Live browser QA support only; per-asset terms remain controlling |
| `PostHog/posthog` | Local feature governance, rollout, scheduling, replay diagnostics, and compliance boundary | `UHyperTwistTrainingControlPlaneLibrary` | Main menu `Advanced` | Control-plane and publication tests; integrated-capability catalog | `O`, `N` | Live operator contract; telemetry is not silently enabled |
| `screenpipe/screenpipe` | Consent-bound local event capture, permission, vault lifecycle, persistence, and timeline-review contracts | `UHyperTwistTrainingCaptureHistoryLibrary` | Main menu `Advanced` | Capture-history contracts; integrated-capability catalog | `O`, `N` | Live operator contract; background capture is off by default |
| `remotion-dev/remotion` | Retained first-party replay plan, playback, render orchestration, explainer, parser, and compliance outputs | `UHyperTwistTrainingMediaExportLibrary` | Main menu `Advanced` | Media export fixture/plan tests; integrated-capability catalog | `O`, `N` | Landed outputs retained. Any fresh donor-backed widening is restrictive; fresh shipping work prefers Unreal-native export |

## FamiliarOS Pattern Cross-Reference

The 2026-07-23 player-experience continuation reviewed FamiliarOS's control
center and floating-chat architecture as a product-pattern reference. HyperTwist
keeps independent Unreal-native ownership and does not import or depend on the
FamiliarOS Electron renderer.

The retained pattern parity is:

- Separate AI, speech-to-text, and text-to-speech provider configuration.
- Local-first defaults with cloud providers disabled until explicit consent.
- Loopback HTTP support, remote HTTPS enforcement, and rejection of unsafe
  provider URLs.
- Separate provider credentials protected for the current Windows account.
- Provider, endpoint, model, language, voice, speed, timeout, context, and
  dictation-destination controls.
- Readiness labels and configuration checks rather than a single ambiguous
  "connected" toggle.
- Microphone enumeration, selection, refresh, and non-retaining open test.
- A fixed native in-game conversation panel with quick prompts, offline guide,
  optional generated responses, global dictation, bounded session history, and
  clear close/back controls.
- Asynchronous fixed-coach reply narration through the selected TTS bridge,
  with explicit consent/credential checks, validated PCM16 WAV playback,
  managed voice volume, cancellation on dictation/panel close/route teardown,
  and text-first fallback when narration is unavailable.

Intentional differences are equally important:

- HyperTwist chat history is session-only and is not silently persisted.
- Temporary dictation audio is deleted after transcription.
- HyperTwist does not expose FamiliarOS MCP or desktop-agent tooling inside the
  game.
- HyperTwist's assistant is a fixed Unreal widget owned by the common native
  puzzle controller, not a floating operating-system window.
- AI, STT, and TTS remain optional. Every puzzle and the built-in guide must
  remain usable without an API key.

Exact validation for this continuation:

- UE 5.7 editor build after the standalone global-speech repair:
  `Result: Succeeded`, 2026-07-23, `7` actions, `60.93` seconds.
- `HyperTwist.PlayerExperience`: 5 succeeded, 0 failed, 0 warnings.
- Report:
  `C:\HyperTwist_worktrees\phase10validate\UnrealHyperTwist\Saved\Automation\Release19-PlayerExperience\index.json`.
- `GlobalAssistantSpeechSession` proves the fixed coach can open a standalone
  global dictation session without an active Classic training run.
- A real provider-reachability and audible-output smoke test still requires a
  configured local or cloud voice service and is therefore not fabricated by
  unattended automation.
- Phase 1 historical queue verification: passed.
- Browser production bundle: passed, `1,872` modules transformed.
- Release 19 Shipping package: passed, including all `9` native routes, staged
  browser assets, exact solver table, archive reopen/hash validation, and
  independent archive plus Downloads semantic visual gates.

## Closed Package Gates And Remaining External Gates

The original 29 are now all represented by:

1. A unique compiled capability row.
2. A legal-lane classification.
3. A first-party runtime owner.
4. A player, browser, or operator route.
5. A common executable catalog contract plus focused domain evidence where
   applicable.
6. Native About/Credits presentation that does not confuse attribution with
   runtime ownership.

The combined package gates are closed:

- The exact post-lane Windows desktop build/cook/package sequence passed.
- All four required `Content/Browser` runtime files were verified in the
  package and reopened ZIP.
- Every native map route passed in the packaged executable, including 4D orders
  2 through 6, Magic120Cell, and MagicCube5D.
- The validation-archive executable and the exact Downloads executable both
  produced fresh semantic `launch-menu-renderable` frames.

The following external or deliberately bounded gates remain real:

- Keep the Magic120Cell visual claim bounded: exact state is full; current
  scene geometry is a representative 120-center projection.
- Keep MagicTile native renderer widening closed until its Phase 7D go/no-go
  criteria are genuinely satisfied.
- Keep XR readiness bounded until a real headset and controller observation
  completes the existing hardware gate.
- Perform an audible STT/TTS/AI provider smoke pass only when a real configured
  service is available; structural automation does not substitute for it.

## Authority Relationships

This document supplements, and does not erase:

- `docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md`
- `docs/ops/HYPERTWIST_UNWIRED_REPO_INVENTORY_AND_WIRING_SCHEDULE_2026-06-10.md`
- `docs/repo_portfolio_unified_source_audit_v6_3.csv`
- `docs/REPO_LICENSE_TRACKING.md`
- `docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md`

If prose drifts from current code, the compiled 29-row catalog, its automation
contract, current source/license evidence, and current package report outrank a
stale summary.
