diff --git a/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md b/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md index 5848e18..6eed76b 100644 --- a/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md +++ b/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md @@ -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 diff --git a/docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md b/docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md new file mode 100644 index 0000000..cf0fce8 --- /dev/null +++ b/docs/HYPERTWIST_PHASE_0R_PACKET_0R_C_EVALUATION_2026-05-12.md @@ -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 diff --git a/docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md b/docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md index ebcdfa1..6b5d774 100644 --- a/docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md +++ b/docs/HYPERTWIST_REPO_EVALUATION_RESET_AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md @@ -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: diff --git a/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md b/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md index 59ef86d..3c37a99 100644 --- a/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md +++ b/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md @@ -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