scriptoriumadmin/hypertwist
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Deepen HyperTwist Phase 0R-C source evaluation

Browse source
This commit is contained in:
axiomlogicnexus 2026-05-12 23:41:46 +02:00
parent 03636fa9d9
commit b6d242b97b
4 changed files with 444 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md
View file

@ -414,34 +414,40 @@ After this reconciliation:
## Current packet status
`Packet 0R-A` and `Packet 0R-B` are now closed as evaluation packets.
`Packet 0R-A`, `Packet 0R-B`, and `Packet 0R-C` are now closed as evaluation packets.
See:
- `docs/HYPERTWIST_PHASE_0R_PACKET_0R_A_EVALUATION_2026-05-12.md`
- `docs/HYPERTWIST_PHASE_0R_PACKET_0R_B_EVALUATION_2026-05-12.md`
- `docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md`
Result:
- all seven `0R-A` repos remain retained
- all thirty-six `0R-B` repos remain retained
- all six `0R-C` repos remain retained
- `Packet 0R-B` is now a deep-source integration authority packet, not merely a permissive backlog summary
- `Packet 0R-C` is now the deep-source boundary-use authority for the mixed, attributed, asset-term, and commercial rows
- none of those packet rows are currently proven live in checked Unreal surfaces
- `Aarav2709/KubeTimr` is the earliest straight permissive subsystem implementation candidate after `Phase 2R`
- `Hypercubers/hypercubing.xyz` is the retained knowledge/curriculum/community donor
- `apache/echarts` is the retained analytics/reporting anchor
- the browser-side viewer, XR, motion, and support rows remain bounded sidecar/support lanes rather than runtime-foundation replacements
- `cubing/cubing.js` is retained only through MPL-aware dependency or adapter use
- `cutelyaware/magiccube4d` is retained as an attributed strategic donor beneath the `Hyperspeedcube` anchor
- `google/model-viewer/packages/shared-assets` is retained only as a fixture and QA pack
- `PostHog/posthog`, `screenpipe/screenpipe`, and `remotion-dev/remotion` remain bounded sidecar, allowlist, or reference lanes rather than broad donor shells
License-tracking boundary:
- `docs/REPO_LICENSE_TRACKING.md` is the canonical repo-row legal and attribution ledger
- `docs/v6_5_deep_manual_pack/HyperTwist/LICENSETRACKING.md` is policy-only and must not become a second repo-row legal ledger
- `Packet 0R-A` and `Packet 0R-B` are the source-value and exclusion-rationale authorities for their retained rows, not the license tracker
- `Packet 0R-A`, `Packet 0R-B`, and `Packet 0R-C` are the source-value and exclusion-rationale authorities for their retained rows, not the license tracker
## Practical next move
The next bounded move is:
1. keep `Phase 3R+` widening frozen
2. open `Packet 0R-C`
2. open `Packet 0R-D`
3. continue the remaining non-permissive `Phase 0R` backlog until the broader `Phase 0R` set is actually closed

368
docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md Normal file
View file

@ -0,0 +1,368 @@
# HyperTwist Phase 0R Packet 0R-C Deep Source Evaluation
Created on `2026-05-12`
## Status
`Packet 0R-C` is now `closed` as a `Phase 0R` evaluation packet.
This packet applies the same deep-source standard already established by `0R-A` and `0R-B`:
- read the upstream source directly
- salvage all meaningful value
- omit only when the surface is:
- an inferior duplicate
- superseded by a stronger retained donor
- off topic to HyperTwist's retained product scope
- host-shell glue with no durable architecture value
- record the rationale every time something is not promoted
For these six repos, this document is now the canonical `integration-facing` authority.
Before a future instance implements any `0R-C` repo, it must read:
1. this document for source-value extraction, boundary discipline, and exclusion rationale
2. [REPO_LICENSE_TRACKING.md](C:/HyperTwist/docs/REPO_LICENSE_TRACKING.md:1) for license, attribution, notice, asset-term, publication, subtree, and provenance obligations
3. [HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md](C:/HyperTwist/docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md:1) for sequencing
## Purpose
This packet redoes `Phase 0R-C` as a true deep source parsing packet for:
- `cubing/cubing.js`
- `cutelyaware/magiccube4d`
- `google/model-viewer/packages/shared-assets`
- `PostHog/posthog`
- `remotion-dev/remotion`
- `screenpipe/screenpipe`
It answers, repo by repo:
- what was actually read in source
- what value HyperTwist should salvage
- what is subordinate, duplicate, inferior, or off topic
- why that non-promotion decision was made
- which repo should own a domain when multiple boundary-sensitive rows overlap
- how the repo should enter `Phase 2R`, `Phase 4R`, or later implementation work
## Storage boundary
To stop future confusion, the storage boundary is explicit:
- `this packet doc`: source-value extraction, implementation posture, overlap resolution, exclusion rationale, and boundary-use recommendations
- [REPO_LICENSE_TRACKING.md](C:/HyperTwist/docs/REPO_LICENSE_TRACKING.md:1): repo-row license, attribution, copyright, notice, asset-term, publication, subtree, and provenance obligations
- [HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md](C:/HyperTwist/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md:1): row state and next-step board
- [HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md](C:/HyperTwist/docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md:1): packet sequencing and restart phases
- [HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md](C:/HyperTwist/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md:1): cross-location authority routing
License facts do not belong in this packet unless they change integration posture.
Deep source-value extraction does not belong in the license tracker.
## Inputs used
This rewrite used:
- current reset docs in `C:\HyperTwist\docs`
- current mirrors under:
- `C:\Workspaces\HyperTwist\mirrors\permissive\cubing\cubing.js`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cutelyaware\magiccube4d`
- `C:\Workspaces\HyperTwist\mirrors\permissive\google\model-viewer`
- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog`
- `C:\Workspaces\HyperTwist\mirrors\restrictive\remotion-dev\remotion`
- `C:\Workspaces\HyperTwist\mirrors\restrictive\screenpipe\screenpipe`
- checked live Unreal surfaces under:
- `C:\HyperTwist\UnrealHyperTwist\Source`
- `C:\HyperTwist\UnrealHyperTwist\Content\HyperTwistTraining\MaterializedCatalog`
## Mirror topology caveats
Some `0R-C` rows are package or mixed-license rows inside broader upstream trees.
That must stay visible:
- `google/model-viewer/packages/shared-assets` was inspected inside the `google/model-viewer` monorepo, not as a separate top-level repo
- `PostHog/posthog`, `screenpipe/screenpipe`, and `remotion-dev/remotion` are not plain permissive mirrors in practice even where parts of their trees are usable
- `cutelyaware/magiccube4d` has both a workspace mirror and a local zip archive, but the mirror is the canonical source surface for integration-facing reading
Future instances must not mistake package rows for missing source, and must not mistake mixed-license monorepos for carefree donor trees.
## Live-state result
Current live-evidence check result for all six `0R-C` repos:
- no exact live-surface match found in checked Unreal source or materialized catalog
That means:
- none of these six are currently proven live in checked Unreal surfaces
- all six remain retained candidates, not landed implementation lanes
## Packet-wide hierarchy
This packet does not treat all six repos as equal.
| Domain | Primary retained owner | Secondary retained owner | Non-promotion rule |
| --- | --- | --- | --- |
| Classic-cubing semantics, notation, puzzle geometry, and browser player/runtime support | `cubing/cubing.js` | none in `0R-C` | Do not let this row displace `HactarCE/Hyperspeedcube` as the hyper runtime foundation. Keep it as the classic-cubing semantic/runtime lane. |
| Legacy `4D` interaction grammar, history, macros, and generic puzzle-description semantics | `cutelyaware/magiccube4d` | none in `0R-C` | Do not let the Java Swing shell displace `Hyperspeedcube`; mine it for interaction grammar, history, macro, and generic hyper-puzzle semantics. |
| Sample-model and environment fixture pack | `google/model-viewer/packages/shared-assets` | none in `0R-C` | Treat it as a fixture and QA lane only, never as a blanket shippable asset source. |
| Telemetry, replay diagnostics, and feature-governance patterns | `PostHog/posthog` | none in `0R-C` | Keep it as a bounded control-plane donor; do not let it become a product shell, gameplay core, or vision donor. |
| Local capture, timeline, retention, vault, and deterministic agent-permission surfaces | `screenpipe/screenpipe` | `PostHog/posthog` | `screenpipe` owns local capture/history and pipe-permission architecture. `PostHog` stays subordinate there and instead owns feature-governance and replay-diagnostic patterns. |
| Programmatic media export and replay-explainer rendering | `remotion-dev/remotion` | none in `0R-C` | Keep it as a commercially sensitive presentation sidecar. Do not treat it as core runtime architecture. |
## Packet outcome summary
- retained: `6`
- discarded: `0`
- newly proven live: `0`
Most important scheduling consequences:
- the boundary-sensitive backlog is now closed at the deep-source standard
- `cubing/cubing.js` remains retained, but only through MPL-aware dependency or adapter seams
- `cutelyaware/magiccube4d` remains retained as an attributed strategic donor beneath the `Hyperspeedcube` anchor
- `google/model-viewer/packages/shared-assets` remains retained only as a local fixture and QA pack
- `PostHog/posthog`, `screenpipe/screenpipe`, and `remotion-dev/remotion` remain retained only as bounded sidecar, allowlist, or reference lanes rather than as broad donor shells
- the next clean packet is `0R-D`
## Repo evaluations
### `cubing/cubing.js`
Inspected source surfaces:
- [package.json](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/package.json:1)
- [README.md](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/README.md:1)
- [src/cubing/kpuzzle/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/kpuzzle/index.ts:1)
- [src/cubing/puzzle-geometry/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/puzzle-geometry/index.ts:1)
- [src/cubing/twisty/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/twisty/index.ts:1)
- [src/cubing/puzzles/implementations/melindas2x2x2x2/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/puzzles/implementations/melindas2x2x2x2/index.ts:1)
- [src/cubing/protocol/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/protocol/index.ts:1)
- [src/cubing/stream/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/stream/index.ts:1)
- [src/cubing/bluetooth/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/bluetooth/index.ts:1)
- [src/cubing/search/index.ts](C:/Workspaces/HyperTwist/mirrors/permissive/cubing/cubing.js/src/cubing/search/index.ts:1)
High-value salvage:
- `KPuzzle`, `KPattern`, and `KTransformation` are the strongest retained classic-cubing state and transform seam in the current set
- the puzzle-geometry layer exposes generalized puzzle-description parsing, named-puzzle resolution, notation mapping, and geometry-backed puzzle construction
- the `twisty` layer contributes a mature browser-side viewer/player taxonomy: player, viewer, editor, indexers, and view props
- the package already includes a `melindas2x2x2x2` loader, which is strategically important because it shows a real bridge between the classic-cubing library and HyperTwist-adjacent puzzle families
- the protocol and bluetooth layers contribute smartcube, smart-timer, smart-robot, and binary interchange thinking that HyperTwist can reuse in bounded companion surfaces
- the search layer contributes classic solve and random-state helpers that remain useful reference seams even when they are not the main hyper runtime owner
Subordinate or later value:
- the `stream` package explicitly self-identifies as older code likely to be overhauled, so it is not a stable foundation owner
- Twizzle sites, experiments, docs generation, and deployment tooling are useful reference surfaces but not the main donor value
- build scripts, vendor trees, and docs/demo shells are secondary compared with `kpuzzle`, puzzle geometry, `twisty`, and protocol seams
Non-promotion decisions and rationale:
- do not deep-fork it into a private proprietary core: `implementation detail better reauthored first-party` and `boundary cost` because source-file modifications create publication obligations on the `cubing.js` source itself
- do not let `cubing.js` replace `Hyperspeedcube` as the hyper runtime owner: `superseded by stronger retained donor` for higher-dimensional runtime architecture
- do not promote Twizzle docs/demo shell as a product-shell donor: `host-shell glue`
- do not promote the older `stream` package as a major architecture owner: `inferior duplicate` relative to cleaner modern seams elsewhere in the repo
Integration call:
- retain as the primary classic-cubing semantic/runtime donor in the retained set
- use it in `Phase 2R` to freeze `KPuzzle`, notation, puzzle-geometry, viewer/player, and smart-device contracts for non-hyper cubing lanes
- schedule implementation in `Phase 4R` through MPL-side dependency, adapter, or companion-library consumption rather than a deep private fork
### `cutelyaware/magiccube4d`
Inspected source surfaces:
- [README.md](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/README.md:1)
- [LICENSE.md](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/LICENSE.md:1)
- [src/com/superliminal/magiccube4d/History.java](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/src/com/superliminal/magiccube4d/History.java:1)
- [src/com/superliminal/magiccube4d/Macro.java](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/src/com/superliminal/magiccube4d/Macro.java:1)
- [src/com/superliminal/magiccube4d/PolytopePuzzleDescription.java](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/src/com/superliminal/magiccube4d/PolytopePuzzleDescription.java:1)
- [src/com/superliminal/magiccube4d/RotationHandler.java](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/src/com/superliminal/magiccube4d/RotationHandler.java:1)
- [src/com/superliminal/magiccube4d/MC4DView.java](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/src/com/superliminal/magiccube4d/MC4DView.java:1)
- [src/com/donhatchsw/util/MyMath.java](C:/Workspaces/HyperTwist/mirrors/permissive/cutelyaware/magiccube4d/src/com/donhatchsw/util/MyMath.java:1)
High-value salvage:
- `History` is a strong retained donor for move logs with marks, macro boundaries, undo/redo traversal, and save/restore semantics
- `Macro` is major value, not a footnote: relative macro application against reference grips, transform remapping, and reversal logic are exactly the kind of higher-dimensional training behavior HyperTwist needs
- `PolytopePuzzleDescription` contains the strongest retained legacy evidence for generic polytope slicing, grip/sticker/face relationships, and generalized puzzle-description plumbing
- `RotationHandler` contributes concrete `4D` rotation-state, snap-to-center semantics, spin continuation, and drag grammar
- `MC4DView` contributes animation-queue behavior, sticker picking/highlighting, slice-mask handling, and viewer/controller composition
- the repo as a whole preserves a mature legacy hypercubing interaction grammar that still matters even if the Java shell itself is not the final foundation
Subordinate or later value:
- applet, launcher, Swing shell, preference plumbing, and audio/resource packaging are mostly host-shell value, not primary donor value
- utility math helpers are useful only selectively; they do not own a modern first-party math stack by default
- long in-file TODO and issue logs are useful historical context, but not architectural goals to inherit wholesale
Non-promotion decisions and rationale:
- do not transplant the Swing/applet product shell: `host-shell glue / legacy packaging`
- do not let this repo replace `Hyperspeedcube` as the main runtime owner: `superseded by stronger retained donor`
- do not promote `MyMath.java` wholesale into first-party utility code without provenance discipline: `implementation detail better reauthored first-party`
- do not treat every generic-puzzle comment or TODO as a current product requirement: `off topic` to the actually proven retained value
Integration call:
- retain as an attributed strategic donor beneath the `Hyperspeedcube` runtime anchor
- use it in `Phase 2R` to freeze history, macro, generic puzzle-description, and `4D` interaction contracts
- schedule bounded extraction in `Phase 6R`, not as an early standalone shell and not as a replacement for the `Hyperspeedcube`-owned runtime spine
### `google/model-viewer/packages/shared-assets`
Inspected source surfaces:
- [README.md](C:/Workspaces/HyperTwist/mirrors/permissive/google/model-viewer/packages/shared-assets/README.md:1)
- [ATTRIBUTIONS.md](C:/Workspaces/HyperTwist/mirrors/permissive/google/model-viewer/packages/shared-assets/ATTRIBUTIONS.md:1)
- [scripts/fetch-khronos-gltf-samples.sh](C:/Workspaces/HyperTwist/mirrors/permissive/google/model-viewer/packages/shared-assets/scripts/fetch-khronos-gltf-samples.sh:1)
High-value salvage:
- the package is a useful local fixture library for viewer tests, environment-lighting checks, sample-model coverage, and docs/demo payloads
- `ATTRIBUTIONS.md` is strong retained value in its own right because it documents asset provenance explicitly rather than pretending the package container license resolves everything
- the fetch script is useful as a pattern for reproducible sample-fixture refresh against upstream glTF sample sources
- this package can materially shorten HyperTwist QA and browser-viewer smoke-test setup if handled as fixtures instead of donor product assets
Subordinate or later value:
- the assets are support material, not code architecture
- the package is subordinate to the broader `google/model-viewer` lane and to any first-party asset program HyperTwist later adopts
- fixture organization is useful; broad asset adoption is not
Non-promotion decisions and rationale:
- do not treat it as a normal code donor: `off topic`
- do not treat it as a blanket shippable asset bundle: `boundary cost exceeds naive use`
- do not assume Apache at the package container overrides per-asset conditions such as `CC-BY-NC`, `CC-BY-NC-SA`, or Smithsonian usage terms: `implementation detail belongs in per-asset review`
Integration call:
- retain only as a local fixture, docs, and visual-QA pack beneath the `google/model-viewer` lane
- do not give it `Phase 2R` product-core contract ownership
- schedule any real use only in `Phase 4R` as a per-asset allowlist for local fixtures, demos, or specifically reviewed shippable assets
### `PostHog/posthog`
Inspected source surfaces:
- [README.md](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/README.md:1)
- [LICENSE](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/LICENSE:1)
- [products/replay/manifest.tsx](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/replay/manifest.tsx:1)
- [products/replay/skills/diagnosing-missing-recordings/SKILL.md](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/replay/skills/diagnosing-missing-recordings/SKILL.md:1)
- [products/feature_flags/mcp/tools.yaml](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/feature_flags/mcp/tools.yaml:1)
- [posthog/models/feature_flag/feature_flag.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/posthog/models/feature_flag/feature_flag.py:1)
- [posthog/models/feature_flag/user_blast_radius.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/posthog/models/feature_flag/user_blast_radius.py:1)
High-value salvage:
- the replay manifest contributes a concrete deep-link and product-manifest grammar for replay home, filtered lists, single-session offsets, file playback, kiosk mode, playlists, and settings routes
- the replay diagnostic skill is strong retained value because it encodes a structured reason-about-missing-recordings workflow, not just UI
- the feature-flag MCP tool definitions contribute a practical capability map for CRUD, dependency inspection, evaluation reasons, status, activity log, scheduled changes, and blast-radius analysis
- `feature_flag.py` is a strong donor for flag data modeling: conditions, variants, bucketing identifiers, evaluation runtime, dashboard attachment, usage metadata, and filesystem sync thinking
- `user_blast_radius.py` contributes concrete query and property-normalization discipline for rollout-impact estimation before a change is shipped
- the repo as a whole contributes product/service boundary thinking for telemetry, replay diagnostics, and feature governance, which is the actual value lane for HyperTwist
Subordinate or later value:
- the all-in-one analytics shell, data warehouse, surveys, LLM analytics, and broader SaaS product surface are not the retained center of gravity for HyperTwist
- self-hosting/deployment shell and large cloud product areas are secondary to the telemetry, replay, and governance seams above
Non-promotion decisions and rationale:
- do not treat it as a vision, perception, or cube-state donor: `off topic`
- do not inherit the broader analytics platform shell: `host-shell glue / off mission`
- do not consume `ee/` or treat the repo as a carefree whole-tree MIT donor: `boundary cost exceeds naive use`
- do not overfit HyperTwist to PostHog's full product taxonomy when the retained value is much narrower: `superseded by first-party scope discipline`
Integration call:
- retain as a mixed-license control-plane donor for telemetry, replay diagnostics, and feature-governance patterns
- use it in `Phase 2R` to freeze event-schema, replay-diagnostic, audit-log, rollout, dependency, and blast-radius contracts
- if later implementation proceeds, schedule it in `Phase 4R` only as a clearly MIT-path bounded sidecar or selective first-party reimplementation lane, with `ee/` still excluded and mixed-license source kept out of generic implementation work
### `remotion-dev/remotion`
Inspected source surfaces:
- [README.md](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/README.md:1)
- [LICENSE.md](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/LICENSE.md:1)
- [packages/player/package.json](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/player/package.json:1)
- [packages/renderer/package.json](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/renderer/package.json:1)
- [packages/studio/package.json](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/studio/package.json:1)
- [packages/media-parser/package.json](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/media-parser/package.json:1)
- [packages/player/src/Player.tsx](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/player/src/Player.tsx:1)
- [packages/renderer/src/client.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/renderer/src/client.ts:1)
- [packages/media-parser/src/index.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/remotion-dev/remotion/packages/media-parser/src/index.ts:1)
High-value salvage:
- the player package contributes an embeddable timeline-aware playback surface with explicit frame, duration, dimension, control, poster, and validation contracts
- the renderer package contributes a reusable browser-safe export option grammar around codecs, CRF, pixel formats, hardware acceleration, Chrome mode, and output validation
- the media-parser package contributes a pure-JavaScript parsing surface for ISO/WebM/M3U and worker/node/web entry points that is useful for bounded media inspection
- the studio package shows a real editor/preview/render API split, even if HyperTwist should not inherit the whole authoring shell
- the repo's strongest HyperTwist value is generated coaching media, replay explainers, export workflows, and embeddable playback contracts
Subordinate or later value:
- templates, docs, create-video shell, and showcase ecosystem are not core donor value for HyperTwist
- full Remotion Studio authoring shell is secondary to the bounded export and playback seams
- broader React-video identity is valuable context, but not a reason to let it shape runtime architecture
Non-promotion decisions and rationale:
- do not treat the monorepo as a plain permissive donor just because some subpackages expose narrower package-level license strings: `boundary cost exceeds naive use`
- do not promote it into gameplay core, recognition, or main runtime ownership: `off topic`
- do not inherit the whole authoring or template shell: `host-shell glue`
Integration call:
- retain as a commercially sensitive media-export and replay-explainer sidecar/reference lane
- use it in `Phase 2R` only to freeze playback, export, and explainer contract language
- before any `Phase 4R` implementation, make an explicit license decision for the exact package set being shipped; without that decision, keep it as reference or reimplement the narrower first-party behaviors instead of lifting repo code
### `screenpipe/screenpipe`
Inspected source surfaces:
- [README.md](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/README.md:1)
- [Cargo.toml](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/Cargo.toml:1)
- [LICENSE.md](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/LICENSE.md:1)
- [ee/LICENSE](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/ee/LICENSE:1)
- [crates/screenpipe-engine/src/lib.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-engine/src/lib.rs:1)
- [crates/screenpipe-engine/src/event_driven_capture.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-engine/src/event_driven_capture.rs:1)
- [crates/screenpipe-engine/src/pipe_permissions_middleware.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-engine/src/pipe_permissions_middleware.rs:1)
- [crates/screenpipe-db/src/lib.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-db/src/lib.rs:1)
- [crates/screenpipe-db/src/write_queue.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-db/src/write_queue.rs:1)
- [crates/screenpipe-vault/src/lib.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-vault/src/lib.rs:1)
- [crates/screenpipe-vault/src/manager.rs](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/crates/screenpipe-vault/src/manager.rs:1)
- [apps/screenpipe-app-tauri/components/rewind/timeline/timeline.tsx](C:/Workspaces/HyperTwist/mirrors/restrictive/screenpipe/screenpipe/apps/screenpipe-app-tauri/components/rewind/timeline/timeline.tsx:1)
High-value salvage:
- the engine crate layout is already shaped like a support-plane platform: capture, recording config, power, retention, permissions, pipes, routes, server, video, and vision manager seams
- `event_driven_capture.rs` is strong retained value for event-triggered capture, debounce rules, typing-pause and idle logic, visual-change detection, and paired screenshot-plus-accessibility capture discipline
- `pipe_permissions_middleware.rs` contributes deterministic endpoint gating, token-scoped permissions, and backpressure thinking for agent-triggered automation
- the DB layer contributes write coalescing, batch transactions, pause/resume during sleep, and sync-table serialization discipline
- the vault layer contributes a concrete lock/unlock, migration, and encryption-state lifecycle instead of vague at-rest-encryption claims
- the timeline UI contributes multi-app, multi-domain, multi-speaker, and replay-control ideas that are actually useful for HyperTwist support-plane history tooling
Subordinate or later value:
- the full AI-memory product shell, app-branding layer, and large local-assistant product frame are not the retained HyperTwist center of gravity
- cloud search, broad AI agent ecosystem, and adjacent assistant features are secondary to capture/history/permissions/vault seams
- many UI surfaces are useful patterns but not product-shell owners
Non-promotion decisions and rationale:
- do not treat it as gameplay core, cube-state owner, or product shell: `off topic`
- do not consume `ee/` or flatten the repo into a blanket permissive donor: `boundary cost exceeds naive use`
- do not inherit its full AI memory product framing when the retained value is the support-plane architecture beneath it: `host-shell glue`
Integration call:
- retain as the primary local capture/history/replay, permissions, and vault donor in the support-plane lane
- use it in `Phase 2R` to freeze capture-trigger, retention, permission, vault, and timeline-sidecar contracts
- if later implementation proceeds, schedule it in `Phase 4R` only as a permissive-core allowlist or selective first-party reimplementation lane with `ee/` still excluded

57
docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md
View file

@ -105,6 +105,44 @@ Mandatory read rule before implementing any `0R-B` repo:
2. read `docs/REPO_LICENSE_TRACKING.md`
3. then apply the phase schedule in this document
## 2026-05-12 Packet 0R-C status
The third `Phase 0R` packet is now also closed as an evaluation packet:
- `Packet 0R-C` result doc:
- `docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md`
That result doc is now the `integration-facing deep-source authority` for all six `0R-C` repos.
Packet result:
- evaluated rows: `6`
- retained: `6`
- discarded: `0`
- newly proven live: `0`
Most important scheduling result:
- the boundary-sensitive candidate backlog is now closed as a `Phase 0R` evaluation class
- `cubing/cubing.js` is ratified as the primary classic-cubing semantic/runtime donor, but only through MPL-aware dependency or adapter seams
- `cutelyaware/magiccube4d` is ratified as the primary legacy `4D` interaction, history, and macro donor beneath the `Hyperspeedcube` anchor
- `google/model-viewer/packages/shared-assets` is retained only as a local fixture and QA pack
- `PostHog/posthog` is retained only as a telemetry, replay-diagnostic, and feature-governance control-plane donor
- `screenpipe/screenpipe` is retained only as a local capture/history/replay, deterministic permissions, and vault sidecar donor
- `remotion-dev/remotion` is retained only as a commercially sensitive media-export and replay-explainer sidecar/reference lane
Combined `Phase 0R` packet status so far:
- packet-evaluated non-live rows: `49` of `65`
- remaining non-live rows still awaiting `Phase 0R` closure: `16`
- next packet: `0R-D`
Mandatory read rule before implementing any `0R-C` repo:
1. read `docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md`
2. read `docs/REPO_LICENSE_TRACKING.md`
3. then apply the phase schedule in this document
Use it when a future model, operator, or reviewer needs one unambiguous answer to all of the following:
- what is already implemented right now
@ -217,7 +255,7 @@ In practical terms:
Goal:
- repo-by-repo deep source evaluation for the not-yet-live rows retained after the live-state reset
- after `0R-A` and `0R-B`, `22` rows still remain to be closed
- after `0R-A`, `0R-B`, and `0R-C`, `16` rows still remain to be closed
Required method from this point forward:
@ -435,10 +473,6 @@ Current packet result:
- `@react-spring/rafz`
- `@react-spring/animated`
- none of those rows are newly proven live in checked Unreal surfaces
- next clean packet is `0R-C`
- `pmndrs/leva`
- `met4citizen/TalkingHead`
- `NuiLab/code-vr`
Expected outcome:
@ -464,6 +498,19 @@ Expected outcome:
- explicit notice / publication / subtree restrictions where needed
- discard where the boundary cost exceeds strategic value
Current packet result:
- `Packet 0R-C` is now closed for:
- `cubing/cubing.js`
- `cutelyaware/magiccube4d`
- `google/model-viewer/packages/shared-assets`
- `PostHog/posthog`
- `remotion-dev/remotion`
- `screenpipe/screenpipe`
- none of those rows are newly proven live in checked Unreal surfaces
- the actual result was `retained with sharply bounded use`, not `broad donor promotion`
- next clean packet is `0R-D`
### Wave `4` — restrictive clean-room candidates still pending
These are the restrictive rows still retained for possible implementation after proper deep evaluation and refreshed Model A / Model B handling:

25
docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md
View file

@ -10,16 +10,17 @@ This board is the readable row-by-row companion to the v6.3 CSVs. It is derived
- Currently verified live in checked `UnrealHyperTwist` surfaces: `6` repos
- Live permissive lanes: `5`
- Live restrictive clean-room lanes: `1`
- Remaining rows requiring `Phase 0R` deep repo evaluation: `22`
- Remaining rows requiring `Phase 0R` deep repo evaluation: `16`
## 2026-05-12 packet overlay
The baseline live-state counts above still do not change, but the permissive `Phase 0R` evaluation backlog is now closed.
The baseline live-state counts above still do not change, but the permissive and boundary-sensitive `Phase 0R` evaluation backlogs are now closed.
Read together with:
- [HYPERTWIST_PHASE_0R_PACKET_0R_A_EVALUATION_2026-05-12.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_0R_PACKET_0R_A_EVALUATION_2026-05-12.md:1)
- [HYPERTWIST_PHASE_0R_PACKET_0R_B_EVALUATION_2026-05-12.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_0R_PACKET_0R_B_EVALUATION_2026-05-12.md:1)
- [HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md:1)
That overlay closes evaluation for:
@ -36,16 +37,18 @@ Important authority correction:
- `Packet 0R-A` is now the deep-source value-extraction and exclusion-rationale authority for its seven repos
- `Packet 0R-B` is now the deep-source value-extraction and exclusion-rationale authority for its thirty-six repos
- `Packet 0R-C` is now the deep-source value-extraction and exclusion-rationale authority for its six boundary-sensitive repos
- future implementation of those seven repos should start from `Packet 0R-A`, not from this board alone
- future implementation of those thirty-six repos should start from `Packet 0R-B`, not from this board alone
- future implementation of those six boundary-sensitive repos should start from `Packet 0R-C`, not from this board alone
- this board remains the readable row-state companion, not the place for full source-value extraction
Packet overlay result:
- all `43` non-live permissive rows have now been packet-evaluated
- none of those `43` rows are newly proven live in checked Unreal surfaces
- the remaining `Phase 0R` backlog is now `22` rows:
- `6` boundary-sensitive
- all `6` boundary-sensitive rows have now been packet-evaluated
- none of those `49` packet-evaluated rows are newly proven live in checked Unreal surfaces
- the remaining `Phase 0R` backlog is now `16` rows:
- `4` restrictive clean-room candidates
- `12` reference, benchmark, reserve, or discard candidates
@ -149,12 +152,12 @@ Count: `6`
| Repo | License | Prior bucket | Prior action | Current live state | Reset lane | Next step |
| --- | --- | --- | --- | --- | --- | --- |
| `cubing/cubing.js` | `MPL-2.0 OR GPL-3.0-or-later` | Locked Strategic Donor | `integrate` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | Deep source evaluate now; if retained, prefer MPL-side dependency or adapter consumption and avoid deep private forks unless publication obligations are acceptable. |
| `cutelyaware/magiccube4d` | `Custom broad-use license with attribution requested` | Locked Strategic Donor | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | Deep source evaluate now; if retained, use as an attributed direct donor with preserved notices and provenance rather than as a clean-room lane. |
| `google/model-viewer/packages/shared-assets` | `Apache-2.0 container; mixed per-asset terms` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | Deep source evaluate asset terms now; keep as mixed-provenance reference or very narrow asset source only when per-asset terms are explicit. |
| `PostHog/posthog` | `MIT outside ee/; enterprise-restricted in ee/` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | Deep source evaluate now; if retained, keep ee/ excluded and prefer bounded donor or sidecar seams rather than broad shell inheritance. |
| `remotion-dev/remotion` | `Custom two-tier commercial license` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | Deep source evaluate commercial terms now; likely keep as reference or bounded sidecar unless a deliberate paid usage path is accepted. |
| `screenpipe/screenpipe` | `MIT OR Apache-2.0 core; enterprise-restricted ee/` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | Deep source evaluate now; if retained, keep enterprise-restricted slices excluded and prefer bounded donor or sidecar seams. |
| `cubing/cubing.js` | `MPL-2.0 OR GPL-3.0-or-later` | Locked Strategic Donor | `integrate` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | `Packet 0R-C` closed. Retain as the classic-cubing semantic/runtime donor through MPL-side dependency or adapter consumption; avoid deep private forks unless publication obligations are acceptable. |
| `cutelyaware/magiccube4d` | `Custom broad-use license with attribution requested` | Locked Strategic Donor | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | `Packet 0R-C` closed. Retain as an attributed direct donor for history, macros, generic puzzle description, and legacy `4D` interaction beneath the `Hyperspeedcube` anchor. |
| `google/model-viewer/packages/shared-assets` | `Apache-2.0 container; mixed per-asset terms` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | `Packet 0R-C` closed. Retain only as a local fixture and QA pack with per-asset allowlisting before any shipping use. |
| `PostHog/posthog` | `MIT outside ee/; enterprise-restricted in ee/` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | `Packet 0R-C` closed. Retain only as a bounded telemetry, replay-diagnostic, and feature-governance donor; keep `ee/` excluded and use MIT-path allowlists or selective first-party reimplementation. |
| `remotion-dev/remotion` | `Custom two-tier commercial license` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | `Packet 0R-C` closed. Retain only as a commercially sensitive media-export and explainer sidecar/reference lane after an explicit package-level license decision. |
| `screenpipe/screenpipe` | `MIT OR Apache-2.0 core; enterprise-restricted ee/` | Donor Bench | `repurpose` | `selected_not_live_boundary_sensitive` | `phase0r_boundary_sensitive_eval_then_adapter_or_sidecar` | `Packet 0R-C` closed. Retain only as a bounded capture/history/replay, deterministic permissions, and vault donor with `ee/` excluded and permissive-core use kept narrowly allowlisted. |
## Restrictive Clean-Room Candidates Pending Phase 0R