# 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.
**2026-06-11 repair update:** this inventory now preserves the original queue history while also reflecting the repaired current posture for the browser-runtime and speech rows that were previously left stale after newer Phase 1 implementation work.
**2026-07-23 exact-roster update:** this remains a historical queue ledger, but
every row now has a unique executable/browser-registry position from `1`
through `29`. The clean-checkout verifier checks both registries, retained
source/sidecar evidence, direct runtime dependencies, and locked dependency
modules. Runtime-loaded, transitive dependency, native/source sidecar,
QA/editor sidecar, and reference-only are intentionally different completion
postures; only the first category should be called default browser runtime.
This queue is not the same set as the original `29` implemented/live
repositories documented in
`HYPERTWIST_ORIGINAL_29_LIVE_REPOSITORY_RUNTIME_CAPABILITY_PROOF_MATRIX_2026-07-23.md`.

---

## 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 original implementation targets from the reconstructed board snapshot. The 13 reference/discard rows and the 4 speech rows are accounted for separately. Some of the original queue items have now landed through the repaired Phase 1 browser-runtime work; their current posture is called out below rather than erased from the historical count view.

---

## 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. This section preserves the original retained queue, but the current repaired posture now includes live/browser-backed closure for the `1E`, `1G`, `1H`, `1I`, and `1J` browser-runtime families through the authoritative `Content/Browser` shell plus the embedded `UHyperTwistBrowserWidget` bridge.

### 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++/JS mix | Reference glTF renderer | Browser/runtime reference viewer posture through the first-party `Content/Browser` shell; do not over-claim a direct Unreal static-link lane for this packet | 1E (Browser runtime) |

### 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 true native-link repos)
- `efrantar/rob-twophase`
- `freestyle-voice/freestyle` (if embedding; otherwise IPC)

### First-Party External Engine / Sidecar Seam
- `rhasspy/piper` — first-party synthesis boundary with retained donor source and local/offline voice-model posture, without overstating direct Unreal static-link closure in the current packet
- `freestyle-voice/freestyle` — sidecar/session boundary is still the primary accepted posture unless a later packet explicitly reopens plugin-hosting work

### Embedded Browser Runtime (For JS/TS repos)
- Requires `WebBrowser` plugin in `.uproject`
- Requires Node.js build pipeline or prebuilt bundles in `Content/Browser/`
- Current first-party landing uses `UHyperTwistBrowserWidget` + `UHyperTwistBrowserBridgeObject`
- State bridge via embedded Unreal bridge object with JavaScript `postMessage` fallback
- 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 | **Live in first-party external-engine posture** | Phase 1C now lands `UHyperTwistSpeechLibrary::Synthesize(...)` plus bounded local/offline narration seams without pretending the donor is already a direct Unreal static-link lane |
| `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, retained local/offline engine with first-party synthesis boundary)

---

## 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` | First-party synthesis boundary over retained local/offline donor posture | C++/sidecar |
| 1D | `brownan/Rubiks-Cube-Solver` | IPC process (GPL) | Python |
| 1E | `KhronosGroup/glTF-Sample-Renderer` | Embedded browser runtime reference viewer | JS/browser |
| 1F | `cahidenes/rubiks-cube-solver` | IPC process | Python |
| 1G | `tentone/rubix-solver` | Browser fallback shell + native-sidecar bridge | Native/browser |

Current repaired note:
- `1E`, `1G`, `1H`, `1I`, and `1J` now close through the authoritative `Content/Browser/index.html` shell, bundled-runtime upgrade path, committed clean-checkout fallback runtime, and embedded `UHyperTwistBrowserWidget` / bridge-object lane.
- The browser queue is no longer blocked on retaining `dist/index.html`; build artifacts can be cleaned after validation because the authoritative shell remains runnable without them.

### Phase 1 wiring answer — 2026-06-11

- Yes: the intended Phase 1 wiring set is complete on the accepted posture.
- `1A` through `1J` are live across direct-link, IPC, retained-sidecar, and authoritative-browser-shell routes.
- Do not miscount intentionally subordinate or non-default rows as missing runtime wiring:
  - `google/model-viewer/packages/modelviewer.dev` remains docs-only.
  - `@react-spring/types` remains dev-types only.
  - `KhronosGroup/glTF-Sample-Viewer`, `google/model-viewer/packages/space-opera`, and `google/model-viewer/packages/render-fidelity-tools` are retained support or sidecar lanes beneath the landed browser-viewer owner rather than missing standalone gameplay lanes.

---

## Next Step

**Current next step after repair (`2026-07-23`):** the intended Phase 1 wiring
question remains closed and is now backed by two deliberately separate exact
count contracts: the original `29` implemented/live repository capabilities in
the native compiled catalog, and this historical `29`-position selected support
queue in both browser registries. Release 19 package validation rebuilt the
browser shell, transformed `1,872` modules, verified all four required staged
browser files in the package and reopened ZIP, and passed all nine native route
smokes, including exact dedicated 4D orders `2` through `6`. No Phase 1 repo
wiring repair remains. The next safe work is release engineering
(installer/uninstaller, signing, clean-machine prerequisites, entitlement, and
update channel), not reopening already-completed Phase 6A/6B implementation.
