From 0c1bf3a419a3b96e1696d160ba96653812622b07 Mon Sep 17 00:00:00 2001 From: axiomlogicnexus Date: Wed, 27 May 2026 16:45:58 +0200 Subject: [PATCH] Backfill cubing.js reference provenance --- .../HT_REPO_INCORPORATION_AUDIT_2026-05-11.md | 7 +- ...CORPORATION_PROVENANCE_BOARD_2026-05-27.md | 147 ++++++++++++++++++ .../HyperTwist/FEATURE_REGISTRY.md | 1 + 3 files changed, 152 insertions(+), 3 deletions(-) create mode 100644 docs/HYPERTWIST_CUBING_JS_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md diff --git a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md index 8200825..98360c2 100644 --- a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md +++ b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md @@ -389,14 +389,15 @@ capture-history reference side, the `remotion-dev/remotion` media-export reference side, the `PostHog/posthog` control-plane reference side, and the `google/model-viewer/packages/shared-assets` fixture/provenance reference side are now explicit, and the `cutelyaware/magiccube4d` legacy `4D` reference side -is now explicit too. +is now explicit too, and the `cubing/cubing.js` classic-cubing semantic and +compliance reference side is now explicit too. The next clean bounded move is a source-backed pass on the remaining repo-backed reference-incorporation families whose hierarchy or canon follow-through is still only implicit in `hypertwist-reference-incorporation-targets.json`, starting with -`cubing/cubing.js` if you want the adjacent boundary-sensitive classic-cubing -semantic and compliance reference side closed to the same standard. +`met4citizen/TalkingHead` if you want the adjacent permissive companion and +narration reference side closed to the same standard. For the readable all-rows follow-up board that pairs this audit with the reset schedule, use: diff --git a/docs/HYPERTWIST_CUBING_JS_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md b/docs/HYPERTWIST_CUBING_JS_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md new file mode 100644 index 0000000..b8a569c --- /dev/null +++ b/docs/HYPERTWIST_CUBING_JS_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md @@ -0,0 +1,147 @@ +# HyperTwist cubing.js Reference Incorporation Provenance Board - 2026-05-27 + +## Status + +This document is the source-backed provenance and hierarchy note for the live +repo-backed reference-incorporation side currently materialized from +`cubing/cubing.js`. + +It closes the source-specific reference side that remained implicit after the +landed `Phase 4R-A` packet and the broader live-lane and `MPL`-boundary +audits. + +It answers one narrow question: + +- do the live `cubing/cubing.js` reference targets reopen already landed + first-party classic-cubing semantic/runtime and `MPL`-boundary + implementation, or do they instead need a reference-side provenance-board and + canon backfill + +Result: + +- no product-code reopening is required +- yes reference-side provenance-board and feature-canon backfill is required + +## Source basis + +- `C:\HyperTwist\docs\HT_REPO_INCORPORATION_AUDIT_2026-05-11.md` +- `C:\HyperTwist\docs\HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md` +- `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` +- `C:\HyperTwist\docs\REPO_LICENSE_TRACKING.md` +- `C:\HyperTwist\docs\ops\HYPERTWIST_MPL_BOUNDARY_AND_NON_GPL_USAGE_DOCTRINE_2026-05-25.md` +- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md` +- `C:\HyperTwist\UnrealHyperTwist\Content\HyperTwistTraining\MaterializedCatalog\hypertwist-reference-incorporation-targets.json` +- `C:\HyperTwist\UnrealHyperTwist\Content\HyperTwistTraining\MaterializedCatalog\raw-extracts\cubing-cubing-js-reference-pages.jsonl` + +## Counts confirmed from current first-party materialization + +Current live `cubing/cubing.js` reference-incorporation targets: + +- `7` total rewritten reference targets +- all `7` are under `Classic Cubing Semantics and Runtime` +- all `7` stay inside the already-landed `Phase 4R-A` bounded lane + +Exact surfaces: + +1. `reference/cubing-cubing-js-semantic-reference-page-stack` + - `SurfaceType`: `classic-cubing-semantic-reference` + - `IncorporationChannel`: `semantic-contract` + - `TargetAssetFamily`: `semantic-contract-note` +2. `reference/cubing-cubing-js-geometry-reference-page-stack` + - `SurfaceType`: `classic-cubing-geometry-reference` + - `IncorporationChannel`: `geometry-contract` + - `TargetAssetFamily`: `geometry-contract-note` +3. `reference/cubing-cubing-js-viewer-reference-page-stack` + - `SurfaceType`: `classic-cubing-viewer-reference` + - `IncorporationChannel`: `viewer-adapter-contract` + - `TargetAssetFamily`: `viewer-adapter-note` +4. `reference/cubing-cubing-js-device-reference-page-boundary` + - `SurfaceType`: `classic-cubing-device-reference` + - `IncorporationChannel`: `device-adapter-boundary` + - `TargetAssetFamily`: `device-boundary-note` +5. `reference/cubing-cubing-js-search-reference-page-stack` + - `SurfaceType`: `classic-cubing-search-reference` + - `IncorporationChannel`: `search-contract` + - `TargetAssetFamily`: `search-contract-note` +6. `reference/cubing-cubing-js-bridge-reference-page-melinda` + - `SurfaceType`: `classic-cubing-bridge-reference` + - `IncorporationChannel`: `melinda-bridge-boundary` + - `TargetAssetFamily`: `bridge-note` +7. `reference/cubing-cubing-js-compliance-reference-page-boundary` + - `SurfaceType`: `classic-cubing-compliance-reference` + - `IncorporationChannel`: `mpl-compliance-boundary` + - `TargetAssetFamily`: `compliance-boundary-note` + +Important adjacent fact: + +- all seven targets preserve the explicit practical `MPL` path, notice + retention, and future source-file publication duty boundary already enforced + by the landed lane + +## Slice-local verdict + +| Slice | Primary authority | Secondary value kept | Result | +|---|---|---|---| +| First-party classic-cubing semantic/runtime and `MPL`-boundary implementation | first-party current code plus landed `Phase 4R-A` packet | retained `cubing/cubing.js` reference targets stay subordinate provenance-grounding surfaces | unchanged live implementation owner | +| Rewritten semantics, geometry, viewer, device, search, and Melinda-bridge grounding | `cubing/cubing.js` retained boundary-sensitive lane | factual classic-cubing state, geometry, viewer, protocol, search, and bridge semantics are preserved while prose remains first-party | unchanged retained reference-grounding surface beneath first-party contracts | +| `MPL` compliance and notice-boundary grounding | `cubing/cubing.js` retained boundary-sensitive lane | the practical `MPL` path, notice retention, and future modified-file publication duty stay explicit in first-party compliance notes | unchanged bounded compliance-grounding surface | + +## Why no product-code reopening is required + +The live surfaces here are already rewritten first-party targets, not copied +donor docs, donor Twizzle shell UI, or a silent upstream private fork. + +The checked targets explicitly require: + +- preserving factual semantic, geometry, viewer, device, search, bridge, and + `MPL`-boundary semantics +- rewriting donor wording, donor docs/demo framing, and any broader donor + product-shell assumptions + +That means the retained surfaces are provenance and factual grounding, not +donor shell ownership. + +So this pass does not reopen: + +- the closed `Phase 4R-A` first-party classic-cubing lane +- the separate `cubing/twisty.js` clean-room replay shell lane +- the separate `cubing/alg.js` parser/AST lane +- any silent flattening of the `MPL` boundary into an untracked fork posture + +## Current exact grounded role + +`cubing/cubing.js` currently grounds seven live rewritten first-party +contract/reference targets for `Classic Cubing Semantics and Runtime`: + +- semantic state, transformation, notation, and binary or Twizzle interop +- named-puzzle and geometry construction +- viewer, player, and editor adapter behavior +- smart-device and protocol adapter boundary +- search, scramble, and solve-helper contract +- bounded Melinda `2x2x2x2` bridge semantics +- practical `MPL` adapter and notice boundary + +These targets preserve bounded classic-cubing semantics while keeping all +surfaced prose and shell framing first-party. + +## Backfill result + +### Earlier incorporation audit reopened + +- `C:\HyperTwist\docs\HT_REPO_INCORPORATION_AUDIT_2026-05-11.md` + +### Feature canon reopened + +- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md` + +## Final call + +The live `cubing/cubing.js` reference-incorporation side is now explicit: + +- `7` rewritten first-party contract/reference targets +- all `7` remain inside the landed `Phase 4R-A` classic-cubing lane +- the practical `MPL` path, notice retention, and modified-file publication + duty boundary stay explicit + +This closes the `cubing/cubing.js` reference side without reopening product +code. diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md index 547fa0f..0d52b6f 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md @@ -150,6 +150,7 @@ repo. |---|---|---|---| | Native puzzle-state runtime | Implemented now | first-party runtime + landed donor packets | Core product identity. | | Classic-cubing semantic/runtime adapter | Implemented now | landed `cubing/cubing.js` packet | Live adapter family. | +| Classic-cubing semantic, bridge, and `MPL`-boundary reference grounding | Implemented now | `cubing/cubing.js` retained boundary-sensitive lane + first-party current code | Current live `Classic Cubing Semantics and Runtime` reference side includes seven rewritten first-party contract/reference targets grounded in `cubing/cubing.js`: semantics, geometry, viewer adapter, device boundary, search contract, Melinda bridge, and explicit `MPL` compliance-boundary notes. This does not displace the landed `Phase 4R-A` first-party owner lane, the separate `cubing/twisty.js` replay shell lane, the separate `cubing/alg.js` parser/AST lane, or the explicit practical `MPL` path and notice-retention boundary. | | Seeded competition scramble workflow and lightweight scramble-operator shell adjuncts | Deep-source grounded retained | `cubing/cubing.js` retained lane + `cubing/mark3` / `cubing/scramble.cubing.net` successor evaluation | Source-backed successor surfaces sharpen competition-spec workflow and operator-shell expectations above the retained scramble and visualization seams, but they do not displace `cubing/cubing.js` or `cubing/twisty.js`; `scramble-display` remains comparison-only. | | Replay shell and timeline | Implemented now | landed `cubing/twisty.js` bounded packets | First-party `HyperTwistSimulation` now owns the bounded replay-player shell, cursor/timeline transport, adapter/bootstrap, and local visualization or fallback presentation contract grounded in `cubing/twisty.js`; classic-cubing semantics remain with `cubing/cubing.js`, parser and AST ownership remain with `cubing/alg.js`, and broader browser support ownership stays with the landed browser lanes. | | Media-export, embedded-playback, and replay-explainer reference grounding | Implemented now | `remotion-dev/remotion` retained boundary-sensitive lane + first-party current code | Current live `Media Export and Replay Explainers` reference side includes five rewritten first-party contract/reference targets grounded in `remotion-dev/remotion`: embedded playback, render orchestration, media parser, explainer-studio preview/output registration, and explicit commercial-license/package-split compliance-boundary notes. This does not displace the landed `Phase 4R-F` first-party owner lane, the broader browser/spatial/media adjunct family, or the explicit package-split commercial boundary. |