Add HyperTwist repo incorporation audit

2026-05-11 22:30:26 +02:00 · 2026-05-11 22:30:26 +02:00 · a97513081f
commit a97513081f
parent c6e6e84245
1 changed files with 276 additions and 0 deletions
--- a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md
+++ b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md
@ -0,0 +1,276 @@
+# HyperTwist Repo Incorporation Audit
+
+Date: 2026-05-11
+
+## Scope
+
+- Current repo set audited: the 71 `HyperTwist` rows in `docs/repo_portfolio_unified_source_audit_v6_3.csv`.
+- Live project surface checked:
+  - `UnrealHyperTwist/Source/UnrealHyperTwist/`
+  - `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/`
+- Excluded from the live-incorporation check:
+  - `mirrors/`
+  - `zippedreposource/`
+  - `docs/refs/`
+  - generated `Intermediate/`
+- Conservative rule used here:
+  - `live materialized`: the live Unreal project contains exact repo attribution and/or materialized bundle content traced to that repo.
+  - `queued but not live`: current docs say `integrate` or `repurpose`, but no exact live project evidence was found in the checked Unreal surfaces.
+  - `future candidate`: current docs say `future candidate`, and no exact live project evidence was found.
+- Important limitation:
+  - this is a conservative current-state incorporation audit, not a proof of zero semantic reuse.
+  - absence from this report's live-evidence bucket does not prove that no human ever looked at a donor repo while writing first-party code.
+  - it does prove that this pass did not find exact repo-tagged incorporation evidence inside the checked live Unreal project surfaces.
+
+## Evidence anchors
+
+- Live training source attributions in code:
+  - `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingCatalogLibrary.cpp`
+    - `tao-yu/Alg-Trainer`
+    - `newyork-anthonyng/rubiks-cross-trainer`
+    - `abunickabhi/5style-Trainer`
+  - `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistBootstrap/HyperTwistContractLibrary.cpp`
+    - `onionhoney/roux-trainers`
+- Live materialized donor manifests:
+  - `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-deck-import-specs.json`
+  - `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-runtime-content-bundles.json`
+  - `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/repo-backed-exercises.jsonl`
+  - `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/restrictive-static-exercises.jsonl`
+  - `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/restrictive-generative-exercise-surfaces.jsonl`
+- Negative exact-name probe:
+  - no matches were found in the checked live Unreal surfaces for:
+    - `cstimer`
+    - `cubedesk`
+    - `alg.js`
+    - `twisty.js`
+    - `cubing.js`
+    - `Hyperspeedcube`
+    - `qbr`
+    - `MagicCube4D`
+    - `MagicTile`
+    - `MagicCube5D`
+    - `TalkingHead`
+    - `KubeTimr`
+
+## Permissive bucket
+
+This section covers `MIT`, `Apache-2.0`, `BSD-3-Clause`, BSD-style permissive, and `Zlib`.
+
+### Live materialized
+
+These are not just planned in docs. They are materially present in `UnrealHyperTwist` training manifests and raw extract bundles.
+
+| Repo | License | Current docs posture | Deck import specs | Raw extract records | Notes |
+| --- | --- | --- | ---: | ---: | --- |
+| `abunickabhi/5style-Trainer` | MIT | repurpose | 1 | 7 | Direct donor training deck |
+| `tao-yu/Alg-Trainer` | MIT | integrate | 37 | 766 | Large live algorithm-case surface |
+| `Lykos/cube_trainer` | MIT | integrate | 26 | 5725 | Large live repo-backed extract surface |
+| `poliva/cubedex` | MIT | integrate | 199 | 1575 | Broadest live direct-donor deck manifest surface in this pass |
+| `newyork-anthonyng/rubiks-cross-trainer` | MIT | repurpose | 8 | 8000 | Large live repo-backed cross-training surface |
+
+### Partly implemented
+
+No exact `source_attribution_only` rows were found in the audited 71-repo set.
+
+Under this pass, the permissive HyperTwist rows are split cleanly into either:
+
+- `live materialized`, or
+- `queued but not live`, or
+- `future candidate`
+
+### Queued but not live
+
+These rows are donor-approved or integration-shaped in the current docs, but this pass did not find exact live Unreal project evidence for them.
+
+#### MIT
+
+- `@react-spring/animated`
+- `@react-spring/core`
+- `@react-spring/parallax`
+- `@react-spring/rafz`
+- `@react-spring/shared`
+- `@react-spring/types`
+- `Aarav2709/KubeTimr`
+- `cahidenes/rubiks-cube-solver`
+- `HactarCE/Hyperspeedcube`
+- `Hypercubers/hypercubing.xyz`
+- `kkoomen/qbr`
+- `met4citizen/TalkingHead`
+- `mrdoob/three.js`
+- `NuiLab/code-vr`
+- `pmndrs/drei`
+- `pmndrs/leva`
+- `pmndrs/maath`
+- `pmndrs/react-postprocessing`
+- `pmndrs/react-spring`
+- `pmndrs/react-three-fiber`
+- `pmndrs/three-stdlib`
+- `pmndrs/uikit`
+- `pmndrs/use-gesture`
+- `pmndrs/xr`
+- `pmndrs/zustand`
+- `PostHog/posthog`
+- `roice3/Magic120Cell`
+- `roice3/MagicCube5D`
+- `roice3/MagicTile`
+- `screenpipe/screenpipe`
+- `tentone/rubix-solver`
+- `vivaansinghvi07/rubix-cube-solver`
+
+#### Apache-2.0
+
+- `apache/echarts`
+- `google/model-viewer`
+- `google/model-viewer/packages/model-viewer-effects`
+- `google/model-viewer/packages/modelviewer.dev`
+- `google/model-viewer/packages/render-fidelity-tools`
+- `google/model-viewer/packages/shared-assets`
+- `google/model-viewer/packages/space-opera`
+- `KhronosGroup/glTF-Sample-Renderer`
+- `KhronosGroup/glTF-Sample-Viewer`
+
+#### BSD
+
+- `ecomfe/echarts-gl`
+- `ecomfe/zrender`
+- `pissang/clay-viewer`
+- `pissang/claygl`
+
+#### Zlib
+
+- `pmndrs/postprocessing`
+
+### Future candidate
+
+These permissive rows are still marked `future candidate` in current docs and showed no live Unreal evidence in this pass.
+
+- `brianpeiris/RiftSketch`
+- `yakupbilen/drl-rubiks-cube`
+
+## Restricted, custom, or unclear bucket
+
+This section covers `GPL-3.0`, `All Rights Reserved`, `no explicit license`, `MPL`, mixed restrictive postures, and custom terms.
+
+### Live materialized
+
+Only one restrictive lane in the current 71-row HyperTwist set showed live materialized Unreal evidence.
+
+| Repo | License | Current docs posture | Deck import specs | Raw extract records | Notes |
+| --- | --- | --- | ---: | ---: | --- |
+| `onionhoney/roux-trainers` | GPL-3.0 | repurpose / reverse engineer preferred | 17 | 270 | Live restrictive-static and restrictive-generative materialization is present in the Unreal training catalog |
+
+Critical detail:
+
+- `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/restrictive-static-exercises.jsonl` contains exact algorithm-case surfaces with origin paths back to `mirrors/restrictive/onionhoney/roux-trainers/src/lib/Algs.tsx`.
+- `UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/restrictive-generative-exercise-surfaces.jsonl` contains generator/mode surfaces with origin paths back to `mirrors/restrictive/onionhoney/roux-trainers/README.md` and `src/Config.tsx`.
+- `UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistBootstrap/HyperTwistContractLibrary.cpp` also carries a clean-room attribution stub for the same repo.
+
+That means this restrictive lane is not merely planned. It is live in the current project content surface and should be treated as the first quarantine/remediation target.
+
+### Partly implemented
+
+No exact `source_attribution_only` rows were found in the audited 71-repo set.
+
+Under this pass, the restricted/custom/unclear rows are split cleanly into either:
+
+- `live materialized`, or
+- `queued but not live`, or
+- `future candidate`
+
+### Queued but not live
+
+These rows are active or donor-shaped in docs, but this pass did not find exact live Unreal evidence for them.
+
+#### GPL / restrictive repurpose lanes
+
+- `cubing/alg.js`
+- `cubing/twisty.js`
+- `HactarCE/2x2x2x2-Scrambler`
+- `kash/cubedesk`
+
+#### MPL or mixed copyleft lane
+
+- `cubing/cubing.js`
+
+#### Custom / special-term lanes
+
+- `cutelyaware/magiccube4d`
+- `remotion-dev/remotion`
+
+### Future candidate
+
+These rows remain future or reserve lanes in current docs and showed no live Unreal evidence in this pass.
+
+#### GPL-3.0
+
+- `aMonteSl/CodeXR`
+- `brownan/Rubiks-Cube-Solver`
+- `cs0x7f/cstimer`
+- `efrantar/rob-twophase`
+- `MathewKJ2048/Rubiks-cube-simulator`
+- `ShellPuppy/RCube`
+- `vwcwong/CubeSim`
+
+#### No explicit license
+
+- `alinen/cube`
+- `ambisinister/blindsolve`
+
+#### All Rights Reserved
+
+- `AviKaufman/Rubix-cube-trainer`
+
+## Additional live donor surfaces outside the current 71-row HyperTwist set
+
+These are not part of the current 71-repo shallow-eval set, but they are live in the Unreal training materialization layer and should not be ignored in provenance work.
+
+| Source | Current surface | Count signal | Notes |
+| --- | --- | ---: | --- |
+| `SpeedCubeDB` | retained web content | 185 runtime bundles / 185 direct donor deck specs | Live retained-web-content incorporation surface |
+| `CubingApp` | retained web content | 25 direct donor deck specs | Live retained-web-content incorporation surface |
+
+## Current saveability view
+
+### Clearly salvageable without a new clean-room pass
+
+These currently live lanes are under permissive direct-donor posture and can be preserved with ordinary notice and attribution handling:
+
+- `abunickabhi/5style-Trainer`
+- `tao-yu/Alg-Trainer`
+- `Lykos/cube_trainer`
+- `poliva/cubedex`
+- `newyork-anthonyng/rubiks-cross-trainer`
+
+Also important:
+
+- the many permissive rows listed as `queued but not live` do not currently show live Unreal incorporation evidence in this pass.
+- those should not be mass-reverted because there is nothing live here, in this pass, to revert from the checked Unreal surfaces.
+
+### Needs quarantine or replacement first
+
+- `onionhoney/roux-trainers`
+  - live restrictive static and generative extract surfaces are present now
+  - this is the highest-value first remediation target
+
+### Not currently evidenced as live in this Unreal pass
+
+The following sensitive or high-risk lanes showed no exact live Unreal evidence here:
+
+- `cs0x7f/cstimer`
+- `cubing/alg.js`
+- `cubing/twisty.js`
+- `cubing/cubing.js`
+- `kash/cubedesk`
+- `HactarCE/Hyperspeedcube`
+- `kkoomen/qbr`
+- `Aarav2709/KubeTimr`
+- `met4citizen/TalkingHead`
+- `roice3/Magic120Cell`
+- `roice3/MagicCube5D`
+- `roice3/MagicTile`
+
+That does not make them legally cleared or deeply audited. It only means this pass did not find exact live incorporation evidence for them inside the checked Unreal project surfaces.
+
+## Recommended next implementation slice
+
+The next clean bounded move is to quarantine the live `onionhoney/roux-trainers` lane first: isolate the affected materialized bundle files, list every runtime surface that consumes them, and replace those bundles with a true first-party or properly governed clean-room output. After that, do a second pass focused only on the additional live non-71 surfaces (`SpeedCubeDB` and `CubingApp`) so the active training catalog has a complete provenance board before any further widening work resumes.