# HyperTwist — Unwired Repo Inventory & Wiring Schedule

**Date:** 2026-06-10  
**Source authority:** `HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md`, `HYPERTWIST_PHASE_0R_PACKET_0R_B_EVALUATION_2026-05-12.md`, `HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md`  
**Status:** Reconstructed from canonical docs; counts verified against board totals.

---

## Executive Count

| Bucket | Count |
|--------|-------|
| Implemented/live (all licenses, original 71-row set) | 29 |
| **Selected, not live — permissive wiring queue** | **29** |
| Reference / benchmark / discard (0R-E) | 13 |
| Speech rows outside 71-row set (attribution-only) | 4 |
| **Total non-live** | **46** |

The **29 in the wiring queue** are the implementation targets. The 13 reference/discard rows and the 4 speech rows are accounted for but not scheduled for direct wiring unless a later decision changes their posture.

---

## The 29 — Permissive Wiring Queue (0R-B minus live promotions)

These repos were evaluated in `Packet 0R-B` (36 repos). Seven later graduated to live status via Phase 3R and 6R packets. The remaining 29 are retained but **not yet wired** into the Unreal build.

### Wave A — Solver & Recognition Adjuncts (2 repos)

| # | Repo | License | Lang | What It Does | Wiring Approach | Target Phase |
|---|------|---------|------|--------------|-----------------|--------------|
| 1 | `cahidenes/rubiks-cube-solver` | MIT | Python | Classic cube solver with visualizer | IPC process or Python embedding; expose `Solve(FString State)` → moves | 4A (Solver HUD) |
| 2 | `tentone/rubix-solver` | MIT | JS | Browser-based cube solver | Embedded browser runtime (CEF) or adapter layer; not direct C++ link | 4A (Solver HUD) |

### Wave B — Spatial / Browser / XR Stack (13 repos)

| # | Repo | License | Lang | What It Does | Wiring Approach | Target Phase |
|---|------|---------|------|--------------|-----------------|--------------|
| 3 | `NuiLab/code-vr` | MIT | JS | Code editor in VR (WebXR) | Embedded browser or WebXR bridge; evaluate vs. native UE VR | 8 (Browser renderer) |
| 4 | `pissang/claygl` | BSD | JS | Lightweight WebGL engine | Embedded browser runtime; alternative to Three.js if needed | 8 (Browser renderer) |
| 5 | `pissang/clay-viewer` | BSD | JS | glTF model viewer on ClayGL | Embedded browser runtime; asset QA preview | 8 (Browser renderer) |
| 6 | `pmndrs/postprocessing` | Zlib | JS | Post-processing effects for Three.js | Embedded browser runtime; visual polish for browser view | 8 (Browser renderer) |
| 7 | `pmndrs/react-postprocessing` | MIT | JS | React wrapper for postprocessing | Embedded browser runtime; only if R3F bridge is used | 8 (Browser renderer) |
| 8 | `pmndrs/drei` | MIT | JS | Useful helpers for R3F | Embedded browser runtime; helper components | 8 (Browser renderer) |
| 9 | `pmndrs/uikit` | MIT | JS | UI components for R3F | Embedded browser runtime; HUD in browser view | 8 (Browser renderer) |
| 10 | `pmndrs/three-stdlib` | MIT | JS | Three.js standard library extensions | Embedded browser runtime; dependency of other pmndrs pkgs | 8 (Browser renderer) |
| 11 | `pmndrs/maath` | MIT | JS | Math utilities for animation | Embedded browser runtime; animation easing | 8 (Browser renderer) |
| 12 | `pmndrs/zustand` | MIT | JS | State management | Embedded browser runtime; state sync if browser view is standalone | 8 (Browser renderer) |
| 13 | `pmndrs/leva` | MIT | JS | GUI controls for R3F | Embedded browser runtime; debug/inspector panel | 8 (Browser renderer) |
| 14 | `pmndrs/use-gesture` | MIT | JS | Gesture hooks for React | Embedded browser runtime; touch/drag in browser view | 8 (Browser renderer) |
| 15 | `pmndrs/react-spring` | MIT | JS | Spring physics animation | Embedded browser runtime; smooth transitions | 8 (Browser renderer) |

### Wave C — Google Model-Viewer Sub-Packages (4 repos)

| # | Repo | License | Lang | What It Does | Wiring Approach | Target Phase |
|---|------|---------|------|--------------|-----------------|--------------|
| 16 | `google/model-viewer/packages/model-viewer-effects` | Apache-2.0 | JS | Particle/effects system for model-viewer | Embedded browser runtime; decorative effects | 8 (Browser renderer) |
| 17 | `google/model-viewer/packages/modelviewer.dev` | Apache-2.0 | JS | Documentation site | Not for runtime; reference docs only | — |
| 18 | `google/model-viewer/packages/render-fidelity-tools` | Apache-2.0 | JS | Rendering comparison tools | Not for runtime; QA/benchmark pipeline | 10B (Validation) |
| 19 | `google/model-viewer/packages/space-opera` | Apache-2.0 | JS | Model-viewer editor UI | Embedded browser runtime; editor interface | 8 (Browser renderer) |

### Wave D — Analytics & Visualization (2 repos)

| # | Repo | License | Lang | What It Does | Wiring Approach | Target Phase |
|---|------|---------|------|--------------|-----------------|--------------|
| 20 | `ecomfe/zrender` | BSD | JS | 2D rendering engine (ECharts dependency) | Embedded browser runtime; subordinate to apache/echarts | 9 (Social/Export) |
| 21 | `ecomfe/echarts-gl` | BSD | JS | WebGL extension for ECharts | Embedded browser runtime; 3D charts/progress viz | 9 (Social/Export) |

### Wave E — glTF Standards & Samples (2 repos)

| # | Repo | License | Lang | What It Does | Wiring Approach | Target Phase |
|---|------|---------|------|--------------|-----------------|--------------|
| 22 | `KhronosGroup/glTF-Sample-Viewer` | Apache-2.0 | JS | Reference glTF viewer | Embedded browser runtime; standard compliance check | 8 (Browser renderer) |
| 23 | `KhronosGroup/glTF-Sample-Renderer` | Apache-2.0 | C++ | Reference glTF renderer | **Direct C++ link** via `ThirdParty/`; evaluate for asset import pipeline | 2A (Geometry) |

### Wave F — React-Spring Sub-Packages (6 repos)

| # | Repo | License | Lang | What It Does | Wiring Approach | Target Phase |
|---|------|---------|------|--------------|-----------------|--------------|
| 24 | `@react-spring/core` | MIT | JS | Core spring physics | Embedded browser runtime; dependency | 8 (Browser renderer) |
| 25 | `@react-spring/shared` | MIT | JS | Shared utilities | Embedded browser runtime; dependency | 8 (Browser renderer) |
| 26 | `@react-spring/types` | MIT | TS | Type definitions | Dev dependency only; not shipped | — |
| 27 | `@react-spring/parallax` | MIT | JS | Parallax scrolling | Embedded browser runtime; scroll UX if needed | 8 (Browser renderer) |
| 28 | `@react-spring/rafz` | MIT | JS | RAF scheduling | Embedded browser runtime; dependency | 8 (Browser renderer) |
| 29 | `@react-spring/animated` | MIT | JS | Animated component primitives | Embedded browser runtime; dependency | 8 (Browser renderer) |

---

## Wiring Rules by Runtime Posture

### Direct C++ Link (Only for C/C++ repos)
- `efrantar/rob-twophase`
- `KhronosGroup/glTF-Sample-Renderer`
- `rhasspy/piper`
- `freestyle-voice/freestyle` (if embedding; otherwise IPC)

### Embedded Browser Runtime (For JS/TS repos)
- Requires `WebBrowser` plugin in `.uproject`
- Requires Node.js build pipeline or prebuilt bundles in `Content/Browser/`
- State bridge via `FJsonObject` ↔ JavaScript `postMessage`
- All Wave B, C, D, E (JS), F repos use this path

### IPC / Sidecar Process (For Python or restrictive repos)
- `cahidenes/rubiks-cube-solver` (Python)
- `brownan/Rubiks-Cube-Solver` (GPL, Python)
- `freestyle-voice/freestyle` (if not embedded)

### Reference-Only (No runtime wiring)
- `google/model-viewer/packages/modelviewer.dev` — docs site
- `@react-spring/types` — TypeScript dev dependency
- `pmndrs/react-postprocessing` — only if R3F is primary path; may be redundant

---

## Speech Rows (Outside 71-Row Set)

| Repo | License | Status | New Wiring Plan |
|------|---------|--------|-----------------|
| `ggml-org/whisper.cpp` | MIT | **Replaced** | No longer primary STT; retain as benchmark/reference |
| `rhasspy/piper` | MIT | **Queued** | Phase 1C — compile as static lib, link directly |
| `SYSTRAN/faster-whisper` | MIT | **Queued** | Retain as alternative STT benchmark; no active wiring |
| `coqui-ai/TTS` | MPL-2.0 | **Queued** | Retain as TTS benchmark; piper is primary |

**STT primary:** `freestyle-voice/freestyle` (MIT, cloud-API client)  
**TTS primary:** `rhasspy/piper` (MIT, local C++ engine)

---

## Reference / Benchmark / Discard (13 repos — 0R-E)

Not scheduled for wiring. Listed for completeness:

| Repo | Posture |
|------|---------|
| `yakupbilen/drl-rubiks-cube` | Research benchmark only |
| `brownan/Rubiks-Cube-Solver` | GPL oracle; IPC if ever used |
| `efrantar/rob-twophase` | **Promoted to Phase 1A** — direct implementation |
| `ShellPuppy/RCube` | Benchmark only |
| `vwcwong/CubeSim` | Benchmark only |
| `alinen/cube` | Benchmark only |
| `ambisinister/blindsolve` | Benchmark only |
| `AviKaufman/Rubix-cube-trainer` | Benchmark only |
| `poliva/cubedex` | Restrictive comparison context |
| And 4 others | Discard or deferred |

---

## Phase 1 Regenerated — All Wired Repos

| Sub-Phase | Repo | Wiring Path | Build Type |
|-----------|------|-------------|------------|
| 1A | `efrantar/rob-twophase` | Static library, direct link | C++ |
| 1B | `freestyle-voice/freestyle` | Sidecar HTTP or embedded | Rust/TS |
| 1C | `rhasspy/piper` | Static library, direct link | C++ |
| 1D | `brownan/Rubiks-Cube-Solver` | IPC process (GPL) | Python |
| 1E | `KhronosGroup/glTF-Sample-Renderer` | Static library or header-only | C++ |
| 1F | `cahidenes/rubiks-cube-solver` | IPC process | Python |
| 1G | `tentone/rubix-solver` | Embedded browser | JS |

---

## Next Step

**Phase 0:** Create `.external/`, `ThirdParty/`, `.gitmodules`, and `Build.cs` rules so that Phase 1 repos can actually compile and link.
