From edda3d7aeb6ef46624b33a549794cbf5e170e4fa Mon Sep 17 00:00:00 2001 From: axiomlogicnexus Date: Wed, 13 May 2026 22:22:16 +0200 Subject: [PATCH] Close HyperTwist Phase 4R packet 4R-D --- ...twist-catalog-materialization-summary.json | 4 +- ...twist-reference-incorporation-targets.json | 4724 +++++++++-------- ...osthog-control-plane-reference-pages.jsonl | 6 + .../HyperTwistTrainingControlPlaneLibrary.cpp | 562 ++ .../HyperTwistTrainingRuntimeLibrary.cpp | 84 + .../HyperTwistTrainingControlPlaneLibrary.h | 360 ++ .../HyperTwistTrainingRuntimeLibrary.h | 43 + .../HT_REPO_INCORPORATION_AUDIT_2026-05-11.md | 9 +- ...NICAL_RESTART_RECONCILIATION_2026-05-12.md | 24 +- ...OURCE_AND_PRESERVATION_AUDIT_2026-05-13.md | 90 +- ...NED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md | 30 +- ...CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md | 205 + ..._AND_IMPLEMENTATION_SCHEDULE_2026-05-11.md | 28 +- .../HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md | 32 +- docs/REPO_LICENSE_TRACKING.md | 38 +- ..._unified_copyleft_strategy_matrix_v6_3.csv | 2 +- ...epo_portfolio_unified_operational_v6_3.csv | 2 +- docs/repo_portfolio_unified_phase_g_v6_3.csv | 2 +- ...po_portfolio_unified_source_audit_v6_3.csv | 2 +- .../HyperTwist/AGENTS.md | 10 +- .../HyperTwist/DEVELOPMENT.md | 19 +- .../HyperTwist/LICENSETRACKING.md | 18 +- .../HyperTwist/ROADMAP.md | 11 +- 23 files changed, 3967 insertions(+), 2338 deletions(-) create mode 100644 UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl create mode 100644 UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.cpp create mode 100644 UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h create mode 100644 docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md diff --git a/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-catalog-materialization-summary.json b/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-catalog-materialization-summary.json index 0c96b70..a8c0324 100644 --- a/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-catalog-materialization-summary.json +++ b/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-catalog-materialization-summary.json @@ -7,7 +7,7 @@ "track_manifests": 14, "deck_import_specs": 498, "runtime_content_bundles": 498, - "reference_targets": 54, - "overlap_pruned_exclusions": 54 + "reference_targets": 60, + "overlap_pruned_exclusions": 60 } } diff --git a/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-reference-incorporation-targets.json b/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-reference-incorporation-targets.json index aaf002c..891eba1 100644 --- a/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-reference-incorporation-targets.json +++ b/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-reference-incorporation-targets.json @@ -1,2237 +1,2491 @@ { - "generated_at": "2026-05-13T22:00:00Z", - "reference_targets": [ - { - "ReferenceTargetId": "reference/speedcubedb-course-reference-page-speedcubedb-root", - "SurfaceType": "course-reference", - "TrackTitle": "Advanced 3x3 Systems", - "ItemTitle": "Speedcubedb Root", - "IncorporationChannel": "course-reference-supplement", - "TargetAssetFamily": "reference-page", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "SpeedCubeDB", - "SourceLicense": "retained-web-content", - "SourceTrackId": "advanced-3x3-systems", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten curriculum brief for Speedcubedb Root, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "speedcubedb", - "source_scope": "httrack-retained", - "structure_template": "course-reference-page", - "family": "speedcubedb-root", - "subset": null - }, - "MaterializationNotes": [ - "Rewritten curriculum brief for Speedcubedb Root, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/speedcubedb-tool-reference-page-speedcubedb-root", - "SurfaceType": "tool-reference", - "TrackTitle": "Advanced 3x3 Systems", - "ItemTitle": "Speedcubedb Root", - "IncorporationChannel": "feature-reference", - "TargetAssetFamily": "tool-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "SpeedCubeDB", - "SourceLicense": "retained-web-content", - "SourceTrackId": "advanced-3x3-systems", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Feature-semantics reference for Speedcubedb Root, rewritten as first-party product guidance instead of donor utility-page copy." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "speedcubedb", - "source_scope": "httrack-retained", - "structure_template": "tool-reference-page", - "family": "speedcubedb-root", - "subset": null - }, - "MaterializationNotes": [ - "Feature-semantics reference for Speedcubedb Root, rewritten as first-party product guidance instead of donor utility-page copy.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-com-course-reference-page-magic-cube-4d-solution", - "SurfaceType": "course-reference", - "TrackTitle": "Hypercubing Software Manuals", - "ItemTitle": "Magic Cube 4D Solution Notes", - "IncorporationChannel": "course-reference-supplement", - "TargetAssetFamily": "reference-page", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "superliminal.com", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-software-manuals", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten curriculum brief for Magic Cube 4D Solution Notes, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal.com", - "source_scope": "httrack-retained", - "structure_template": "course-reference-page", - "family": "Magic Cube 4D", - "subset": "solution" - }, - "MaterializationNotes": [ - "Rewritten curriculum brief for Magic Cube 4D Solution Notes, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-cube-4d", - "SurfaceType": "software-manual", - "TrackTitle": "Hypercubing Software Manuals", - "ItemTitle": "Magic Cube 4D Manual", - "IncorporationChannel": "software-manual-surface", - "TargetAssetFamily": "manual-page", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "superliminal.com", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-software-manuals", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten operational guide target for Magic Cube 4D Manual, preserving behavior and workflow semantics without reusing donor manual prose." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal.com", - "source_scope": "httrack-retained", - "structure_template": "software-manual-reference-page", - "family": "Magic Cube 4D", - "subset": null - }, - "MaterializationNotes": [ - "Rewritten operational guide target for Magic Cube 4D Manual, preserving behavior and workflow semantics without reusing donor manual prose.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-cube-7d", - "SurfaceType": "software-manual", - "TrackTitle": "Hypercubing Software Manuals", - "ItemTitle": "Magic Cube 7D Manual", - "IncorporationChannel": "software-manual-surface", - "TargetAssetFamily": "manual-page", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "superliminal.com", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-software-manuals", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten operational guide target for Magic Cube 7D Manual, preserving behavior and workflow semantics without reusing donor manual prose." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal.com", - "source_scope": "httrack-retained", - "structure_template": "software-manual-reference-page", - "family": "Magic Cube 7D", - "subset": null - }, - "MaterializationNotes": [ - "Rewritten operational guide target for Magic Cube 7D Manual, preserving behavior and workflow semantics without reusing donor manual prose.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-hyperbolic-tile", - "SurfaceType": "software-manual", - "TrackTitle": "Hypercubing Software Manuals", - "ItemTitle": "Magic Hyperbolic Tile Manual", - "IncorporationChannel": "software-manual-surface", - "TargetAssetFamily": "manual-page", - "PuzzleFamily": "Tiling", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "superliminal.com", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-software-manuals", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten operational guide target for Magic Hyperbolic Tile Manual, preserving behavior and workflow semantics without reusing donor manual prose." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal.com", - "source_scope": "httrack-retained", - "structure_template": "software-manual-reference-page", - "family": "Magic Hyperbolic Tile", - "subset": null - }, - "MaterializationNotes": [ - "Rewritten operational guide target for Magic Hyperbolic Tile Manual, preserving behavior and workflow semantics without reusing donor manual prose.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-puzzle-ultimate", - "SurfaceType": "software-manual", - "TrackTitle": "Hypercubing Software Manuals", - "ItemTitle": "Magic Puzzle Ultimate Manual", - "IncorporationChannel": "software-manual-surface", - "TargetAssetFamily": "manual-page", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "superliminal.com", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-software-manuals", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten operational guide target for Magic Puzzle Ultimate Manual, preserving behavior and workflow semantics without reusing donor manual prose." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal.com", - "source_scope": "httrack-retained", - "structure_template": "software-manual-reference-page", - "family": "Magic Puzzle Ultimate", - "subset": null - }, - "MaterializationNotes": [ - "Rewritten operational guide target for Magic Puzzle Ultimate Manual, preserving behavior and workflow semantics without reusing donor manual prose.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-simplex-5d", - "SurfaceType": "software-manual", - "TrackTitle": "Hypercubing Software Manuals", - "ItemTitle": "Magic Simplex 5D Manual", - "IncorporationChannel": "software-manual-surface", - "TargetAssetFamily": "manual-page", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "superliminal.com", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-software-manuals", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Rewritten operational guide target for Magic Simplex 5D Manual, preserving behavior and workflow semantics without reusing donor manual prose." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal.com", - "source_scope": "httrack-retained", - "structure_template": "software-manual-reference-page", - "family": "Magic Simplex 5D", - "subset": null - }, - "MaterializationNotes": [ - "Rewritten operational guide target for Magic Simplex 5D Manual, preserving behavior and workflow semantics without reusing donor manual prose.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/superliminal-wiki-historical-reference-page-hypercubing-reference", - "SurfaceType": "historical-reference", - "TrackTitle": "Hypercubing Reference", - "ItemTitle": "Hypercubing Historical Reference", - "IncorporationChannel": "historical-reference-supplement", - "TargetAssetFamily": "history-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "hypercubing-standard", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "Superliminal Wiki", - "SourceLicense": "retained-web-content", - "SourceTrackId": "hypercubing-reference", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "Historical and conceptual reference lane for hypercubing context, rewritten into concise HyperTwist-native background guidance." - }, - "PreserveFactualElements": [ - "topic scope", - "page role", - "factual software or method semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional/reference prose" - ], - "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", - "MatchFilter": { - "source": "superliminal-wiki", - "source_scope": "httrack-retained", - "structure_template": "historical-reference-page", - "family": "hypercubing-reference", - "subset": null - }, - "MaterializationNotes": [ - "Historical and conceptual reference lane for hypercubing context, rewritten into concise HyperTwist-native background guidance.", - "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." - ] - }, - { - "ReferenceTargetId": "reference/hypercubing-xyz-course-reference-page-progression", - "SurfaceType": "course-reference", - "TrackTitle": "Hypercubing Progression", - "ItemTitle": "Hypercubing Progression Ladder", - "IncorporationChannel": "course-reference-supplement", - "TargetAssetFamily": "reference-page", - "PuzzleFamily": "Hypercube", - "NotationProfile": "hypercubing-standard", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "Hypercubers/hypercubing.xyz", - "SourceLicense": "MIT", - "SourceTrackId": "progression", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist progression contract target preserving stage order, prerequisites, and widening boundaries from the donor progression guide." - }, - "PreserveFactualElements": [ - "stage ordering", - "prerequisite relationships", - "family branching semantics" - ], - "RewriteRequiredElements": [ - "page title", - "all instructional prose", - "all donor-specific presentation language" - ], - "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", - "MatchFilter": { - "source": "hypercubing.xyz", - "source_scope": "repo-backed", - "structure_template": "progression-reference-page", - "family": "hypercubing-progression", - "subset": null - }, - "MaterializationNotes": [ - "Preserve the donor's progression ordering and branch logic while rewriting the actual instructional surface in first-party HyperTwist language.", - "This target feeds the Phase 3R-B knowledge and curriculum lane rather than the runtime simulation lane." - ] - }, - { - "ReferenceTargetId": "reference/hypercubing-xyz-notation-reference-page-cell-turning-hypercubes", - "SurfaceType": "notation-reference", - "TrackTitle": "Hypercubing Notation", - "ItemTitle": "Cell-Turning Hypercube Notation", - "IncorporationChannel": "notation-reference-supplement", - "TargetAssetFamily": "glossary-page", - "PuzzleFamily": "Hypercube", - "NotationProfile": "hypercubing-standard", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "Hypercubers/hypercubing.xyz", - "SourceLicense": "MIT", - "SourceTrackId": "notation", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist notation reference target preserving factual cell, twist, plane-rotation, and metric semantics from the donor notation guide." - }, - "PreserveFactualElements": [ - "cell naming semantics", - "twist and rotation rules", - "metric distinctions" - ], - "RewriteRequiredElements": [ - "page title", - "all explanatory prose", - "all donor-specific examples beyond factual notation payloads" - ], - "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", - "MatchFilter": { - "source": "hypercubing.xyz", - "source_scope": "repo-backed", - "structure_template": "notation-reference-page", - "family": "cell-turning-hypercubes", - "subset": null - }, - "MaterializationNotes": [ - "Preserve factual notation grammar and cross-links while rewriting reference prose into HyperTwist-native documentation.", - "This target is paired with the compiled Phase 3R-B notation glossary contract." - ] - }, - { - "ReferenceTargetId": "reference/hypercubing-xyz-tool-reference-page-software-matrix", - "SurfaceType": "tool-reference", - "TrackTitle": "Hypercubing Software", - "ItemTitle": "Hypercubing Software Matrix", - "IncorporationChannel": "feature-reference", - "TargetAssetFamily": "tool-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "hypercubing-standard", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "Hypercubers/hypercubing.xyz", - "SourceLicense": "MIT", - "SourceTrackId": "software", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist software-comparison target preserving factual platform and capability semantics from the donor feature matrix." - }, - "PreserveFactualElements": [ - "platform coverage", - "capability taxonomy", - "program-role distinctions" - ], - "RewriteRequiredElements": [ - "page title", - "all donor prose", - "all donor presentation formatting" - ], - "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", - "MatchFilter": { - "source": "hypercubing.xyz", - "source_scope": "repo-backed", - "structure_template": "tool-reference-page", - "family": "software-matrix", - "subset": null - }, - "MaterializationNotes": [ - "Preserve factual feature, platform, and recommendation semantics while rewriting the reference surface in first-party HyperTwist terms.", - "This target supports bounded software-comparison and community-guidance surfaces, not runtime ownership." - ] - }, - { - "ReferenceTargetId": "reference/hypercubing-xyz-community-reference-page-leaderboards", - "SurfaceType": "community-reference", - "TrackTitle": "Hypercubing Leaderboards", - "ItemTitle": "Hypercubing Leaderboard Conventions", - "IncorporationChannel": "community-reference-supplement", - "TargetAssetFamily": "leaderboard-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "hypercubing-standard", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "Hypercubers/hypercubing.xyz", - "SourceLicense": "MIT", - "SourceTrackId": "leaderboards", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist leaderboard/report contract target preserving event identity, time formatting, relative-date, and solver-profile semantics from the donor community site." - }, - "PreserveFactualElements": [ - "event naming and ids", - "format semantics", - "display-rule conventions" - ], - "RewriteRequiredElements": [ - "page title", - "all donor prose", - "all donor HTML or presentation output" - ], - "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", - "MatchFilter": { - "source": "hypercubing.xyz", - "source_scope": "repo-backed", - "structure_template": "community-reference-page", - "family": "leaderboards", - "subset": null - }, - "MaterializationNotes": [ - "Preserve factual leaderboard contracts while rewriting community-reference copy into HyperTwist-native language.", - "This target pairs with the compiled Phase 3R-B leaderboard policy and event schema." - ] - }, - { - "ReferenceTargetId": "reference/apache-echarts-analytics-reference-page-session-outcome-and-progress", - "SurfaceType": "analytics-reference", - "TrackTitle": "Training Analytics", - "ItemTitle": "Session Outcome and Progress Reporting", - "IncorporationChannel": "analytics-report-contract", - "TargetAssetFamily": "dashboard-report", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "apache/echarts", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "analytics/session-outcome-balance", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist analytics contract target preserving bounded option, data-store, and outcome-reporting semantics from the retained echarts lane." - }, - "PreserveFactualElements": [ - "option and state layering", - "dataset separation", - "series-oriented outcome reporting" - ], - "RewriteRequiredElements": [ - "all donor source text", - "all donor component names", - "all donor shell assumptions" - ], - "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", - "MatchFilter": { - "source": "apache/echarts", - "source_scope": "repo-backed", - "structure_template": "analytics-report-reference-page", - "family": "session-outcome-and-progress", - "subset": null - }, - "MaterializationNotes": [ - "Preserve the donor's option and dataset separation while rewriting the report contract in first-party HyperTwist analytics language.", - "This target pairs with the compiled Phase 3R-C analytics report bundle and runtime data-view helpers." - ] - }, - { - "ReferenceTargetId": "reference/apache-echarts-report-export-reference-page-data-view-and-export", - "SurfaceType": "report-export-reference", - "TrackTitle": "Training Analytics", - "ItemTitle": "Analytics Data View and Export", - "IncorporationChannel": "report-export-contract", - "TargetAssetFamily": "export-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "apache/echarts", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "analytics/export", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist analytics export target preserving bounded tabular data-view, image export, and SSR-ready reporting expectations from the retained echarts lane." - }, - "PreserveFactualElements": [ - "tabular data-view contract", - "image export behavior", - "SSR-ready report shell expectations" - ], - "RewriteRequiredElements": [ - "all donor UI wording", - "all donor shell framing", - "all donor implementation-specific presentation" - ], - "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", - "MatchFilter": { - "source": "apache/echarts", - "source_scope": "repo-backed", - "structure_template": "report-export-reference-page", - "family": "report-data-view-and-export", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded export and data-view semantics while rewriting the surfaced report shell and copy in first-party HyperTwist terms.", - "This target feeds the Phase 3R-C TSV data-view and accessible export layer, not a generic BI shell." - ] - }, - { - "ReferenceTargetId": "reference/apache-echarts-analytics-interaction-reference-page-timing-trend-history", - "SurfaceType": "analytics-interaction-reference", - "TrackTitle": "Training Analytics", - "ItemTitle": "Timing Trend History and Overview", - "IncorporationChannel": "analytics-interaction-contract", - "TargetAssetFamily": "interaction-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "apache/echarts", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "analytics/timing-trend-rolling-windows", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist timing-trend interaction target preserving bounded zoom-history, thumbnail overview, and rolling-window inspection semantics from the retained echarts lane." - }, - "PreserveFactualElements": [ - "history-aware zoom interactions", - "thumbnail overview behavior", - "windowed timing-trend inspection" - ], - "RewriteRequiredElements": [ - "all donor component wording", - "all donor UI text", - "all donor chart-shell presentation" - ], - "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", - "MatchFilter": { - "source": "apache/echarts", - "source_scope": "repo-backed", - "structure_template": "analytics-interaction-reference-page", - "family": "timing-trend-history", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded history and overview semantics while rewriting the actual interaction copy and report framing in first-party HyperTwist language.", - "This target pairs with the Phase 3R-C rolling-window timing report bundle." - ] - }, - { - "ReferenceTargetId": "reference/apache-echarts-analytics-explainer-reference-page-optional-3d-sidecar", - "SurfaceType": "analytics-explainer-reference", - "TrackTitle": "Training Analytics", - "ItemTitle": "Optional 3D Analytics Sidecar", - "IncorporationChannel": "analytics-sidecar-boundary", - "TargetAssetFamily": "explainer-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "apache/echarts", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "analytics/live-split-ladder", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist sidecar-boundary target preserving how optional richer explainers stay subordinate to the apache/echarts lane while bounded concepts from echarts-gl and zrender remain support-only." - }, - "PreserveFactualElements": [ - "optional 3D analytics sidecar boundary", - "camera and zoom helper behavior", - "subordinate 2D and GL renderer layering" - ], - "RewriteRequiredElements": [ - "all donor implementation text", - "all donor framework naming", - "all donor chart-shell presentation" - ], - "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", - "MatchFilter": { - "source": "apache/echarts", - "source_scope": "repo-backed", - "structure_template": "analytics-explainer-reference-page", - "family": "optional-3d-analytics-explainer", - "subset": null - }, - "MaterializationNotes": [ - "Preserve the subordinate-sidecar boundary while rewriting the actual explainer framing in first-party HyperTwist language.", - "This target keeps `ecomfe/echarts-gl` and `ecomfe/zrender` explicit as support-only beneath the landed `apache/echarts` lane." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-browser-viewer-reference-page-embed-contract", - "SurfaceType": "browser-viewer-reference", - "TrackTitle": "Browser Viewer and Asset QA", - "ItemTitle": "Browser Viewer Embed Contract", - "IncorporationChannel": "viewer-embed-contract", - "TargetAssetFamily": "support-widget", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "viewer/browser-viewer-embed", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser viewer target preserving bounded embed, camera, annotation, and readiness semantics from the retained model-viewer lane." - }, - "PreserveFactualElements": [ - "embeddable viewer lifecycle", - "camera and framing state", - "annotation and load-progress semantics" - ], - "RewriteRequiredElements": [ - "all donor docs and demo copy", - "all donor shell assumptions", - "all donor site framing" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer", - "source_scope": "repo-backed", - "structure_template": "browser-viewer-reference-page", - "family": "browser-viewer-embed", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded viewer, camera, and annotation semantics while rewriting the actual support-plane viewer shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-D browser viewer embed contract and runtime access layer." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-browser-editor-reference-page-compact-editor", - "SurfaceType": "browser-editor-reference", - "TrackTitle": "Browser Viewer and Asset QA", - "ItemTitle": "Compact Browser Editor and Inspection", - "IncorporationChannel": "viewer-editor-contract", - "TargetAssetFamily": "editor-panel", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/space-opera", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "viewer/compact-editor", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist compact editor target preserving bounded inspection, camera, hotspot, and preview-state semantics from the retained space-opera lane." - }, - "PreserveFactualElements": [ - "compact inspection state", - "camera settings behavior", - "hotspot authoring boundaries" - ], - "RewriteRequiredElements": [ - "all donor UI wording", - "all donor shell framing", - "all donor site-navigation assumptions" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer", - "source_scope": "repo-backed", - "structure_template": "browser-editor-reference-page", - "family": "compact-editor-and-inspection", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded compact editor and inspection semantics while rewriting the actual shell and copy in first-party HyperTwist language.", - "This target pairs with the compiled Phase 3R-D editor contract beneath the landed browser viewer lane." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-browser-export-reference-page-snippet-and-export", - "SurfaceType": "browser-export-reference", - "TrackTitle": "Browser Viewer and Asset QA", - "ItemTitle": "Snippet and Export Surface", - "IncorporationChannel": "viewer-export-contract", - "TargetAssetFamily": "export-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/modelviewer.dev", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "viewer/snippet-and-export", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist export target preserving bounded snippet, preview, and portable embed semantics from the retained modelviewer.dev and space-opera sidecars." - }, - "PreserveFactualElements": [ - "portable snippet generation", - "preview and export posture", - "single-source embed expectations" - ], - "RewriteRequiredElements": [ - "all donor docs copy", - "all donor example-shell framing", - "all donor tutorial wording" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer", - "source_scope": "repo-backed", - "structure_template": "browser-export-reference-page", - "family": "snippet-and-export", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded snippet and export semantics while rewriting the actual support-plane export shell in first-party HyperTwist language.", - "This target keeps docs/demo infrastructure subordinate while still surfacing snippet and portable-embed value." - ] - }, - { - "ReferenceTargetId": "reference/khronos-gltf-browser-qa-reference-page-validation-and-statistics", - "SurfaceType": "asset-qa-reference", - "TrackTitle": "Browser Viewer and Asset QA", - "ItemTitle": "Asset Validation and Statistics", - "IncorporationChannel": "asset-qa-contract", - "TargetAssetFamily": "qa-checklist", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "KhronosGroup/glTF-Sample-Viewer", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "qa/asset-validation-and-statistics", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist QA target preserving bounded validator, statistics, camera export, and failure-reporting semantics from the retained Khronos viewer lane." - }, - "PreserveFactualElements": [ - "validator and statistics boundary", - "standards-aware preview state", - "camera export and capture posture" - ], - "RewriteRequiredElements": [ - "all donor shell framing", - "all donor UI wording", - "all donor product assumptions" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", - "MatchFilter": { - "source": "KhronosGroup/glTF-Sample-Viewer", - "source_scope": "repo-backed", - "structure_template": "asset-qa-reference-page", - "family": "asset-validation-and-statistics", - "subset": null - }, - "MaterializationNotes": [ - "Preserve standards-aware validation and statistics semantics while rewriting the surfaced QA shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-D QA checks and keeps the Khronos lane subordinate to the landed viewer owner." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-renderer-comparison-reference-page-fidelity", - "SurfaceType": "renderer-comparison-reference", - "TrackTitle": "Browser Viewer and Asset QA", - "ItemTitle": "Renderer Comparison and Fidelity", - "IncorporationChannel": "renderer-comparison-contract", - "TargetAssetFamily": "regression-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/render-fidelity-tools", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "qa/renderer-comparison-and-fidelity", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist renderer-comparison target preserving bounded golden-result, delta, and threshold semantics from the retained render-fidelity-tools lane." - }, - "PreserveFactualElements": [ - "golden-result comparison", - "delta and threshold reporting", - "renderer parity discipline" - ], - "RewriteRequiredElements": [ - "all donor workflow text", - "all donor shell framing", - "all donor docs/demo wording" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer", - "source_scope": "repo-backed", - "structure_template": "renderer-comparison-reference-page", - "family": "renderer-comparison-and-fidelity", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded renderer-regression semantics while rewriting the surfaced comparison shell in first-party HyperTwist language.", - "This target keeps render-fidelity-tools subordinate to the landed viewer lane and the Khronos reference renderer." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-docs-boundary-reference-page-demo-separation", - "SurfaceType": "docs-boundary-reference", - "TrackTitle": "Browser Viewer and Asset QA", - "ItemTitle": "Docs and Demo Separation Boundary", - "IncorporationChannel": "docs-demo-boundary", - "TargetAssetFamily": "docs-boundary-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/modelviewer.dev", - "SourceLicense": "Apache-2.0", - "SourceTrackId": "viewer/docs-demo-separation", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist boundary target preserving snippet-to-demo infrastructure insights while keeping docs and demo shells explicitly outside the shippable viewer lane." - }, - "PreserveFactualElements": [ - "snippet-to-demo stamping", - "interactive docs support patterns", - "demo-only shell boundaries" - ], - "RewriteRequiredElements": [ - "all donor docs copy", - "all donor navigation framing", - "all donor example-site assumptions" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer", - "source_scope": "repo-backed", - "structure_template": "docs-boundary-reference-page", - "family": "docs-demo-separation", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded docs/demo separation semantics while rewriting the actual support copy and shell in first-party HyperTwist language.", - "This target keeps modelviewer.dev explicitly subordinate to the landed browser viewer lane." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-shared-assets-reference-page-allowlist", - "SurfaceType": "viewer-shared-asset-reference", - "TrackTitle": "Browser Viewer Shared Asset Fixtures", - "ItemTitle": "Shared-Asset Fixture Allowlist", - "IncorporationChannel": "fixture-allowlist", - "TargetAssetFamily": "qa-fixture-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/shared-assets", - "SourceLicense": "Apache-2.0 container; mixed per-asset terms", - "SourceTrackId": "shared-assets/allowlist-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist fixture-allowlist target preserving explicit ship-eligible, review-required, and local-only splits from the retained shared-assets lane." - }, - "PreserveFactualElements": [ - "explicit fixture allowlisting", - "ship-eligible versus review-required splits", - "fixture-family role beneath the browser viewer lane" - ], - "RewriteRequiredElements": [ - "all donor README wording", - "all donor docs and demo framing", - "all donor bundle-as-product assumptions" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer/packages/shared-assets", - "source_scope": "repo-backed", - "structure_template": "viewer-shared-asset-reference-page", - "family": "viewer-shared-assets", - "subset": "allowlist" - }, - "MaterializationNotes": [ - "Preserve explicit allowlist semantics while rewriting the surfaced fixture ledger in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-C shared-assets allowlist contract and prevents blanket mixed-asset shipping assumptions." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-shared-assets-lighting-reference-page-cc0-matrix", - "SurfaceType": "viewer-shared-asset-lighting-reference", - "TrackTitle": "Browser Viewer Shared Asset Fixtures", - "ItemTitle": "CC0 Environment Fixture Matrix", - "IncorporationChannel": "environment-fixture-matrix", - "TargetAssetFamily": "environment-fixture-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/shared-assets", - "SourceLicense": "Apache-2.0 container; mixed per-asset terms", - "SourceTrackId": "shared-assets/cc0-environment-matrix", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist environment-fixture target preserving the CC0 lighting families retained from shared-assets for browser viewer parity and regression workflows." - }, - "PreserveFactualElements": [ - "CC0 environment-lighting families", - "HDRI selection for lighting parity", - "outdoor versus indoor fixture coverage" - ], - "RewriteRequiredElements": [ - "all donor docs and demo wording", - "all donor fixture-browser assumptions", - "all donor product-shell framing" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer/packages/shared-assets", - "source_scope": "repo-backed", - "structure_template": "viewer-shared-asset-lighting-reference-page", - "family": "viewer-shared-assets-lighting", - "subset": "cc0-environments" - }, - "MaterializationNotes": [ - "Preserve the CC0 environment-fixture matrix while rewriting the surfaced QA shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-C shared-assets fixture bundle and keeps environment-fixture approval explicit." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-shared-assets-provenance-reference-page-review-boundary", - "SurfaceType": "viewer-shared-asset-provenance-reference", - "TrackTitle": "Browser Viewer Shared Asset Fixtures", - "ItemTitle": "Review-Required and Restricted Fixture Boundary", - "IncorporationChannel": "shipping-boundary", - "TargetAssetFamily": "compliance-boundary-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/shared-assets", - "SourceLicense": "Apache-2.0 container; mixed per-asset terms", - "SourceTrackId": "shared-assets/provenance-boundary", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist provenance target preserving review-required, notice-bound, and excluded fixture duties from the retained shared-assets lane." - }, - "PreserveFactualElements": [ - "CC-BY notice-bound fixtures", - "Smithsonian review-only terms", - "CC-BY-NC-SA local-only exclusion" - ], - "RewriteRequiredElements": [ - "all donor legal-shell wording beyond the preserved factual duties", - "all donor docs/demo framing", - "all donor blanket shipping assumptions" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer/packages/shared-assets", - "source_scope": "repo-backed", - "structure_template": "viewer-shared-asset-provenance-reference-page", - "family": "viewer-shared-assets-boundary", - "subset": "review-and-restricted" - }, - "MaterializationNotes": [ - "Preserve the per-asset provenance and review split while rewriting the surfaced compliance shell as first-party HyperTwist guidance.", - "This target pairs with the compiled Phase 4R-C provenance boundary and keeps review-only and excluded fixtures explicit." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-shared-assets-refresh-reference-page-pattern", - "SurfaceType": "viewer-shared-asset-refresh-reference", - "TrackTitle": "Browser Viewer Shared Asset Fixtures", - "ItemTitle": "Fixture Refresh and Attribution Recheck Pattern", - "IncorporationChannel": "fixture-refresh-pattern", - "TargetAssetFamily": "refresh-pattern-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/shared-assets", - "SourceLicense": "Apache-2.0 container; mixed per-asset terms", - "SourceTrackId": "shared-assets/refresh-pattern", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist refresh-pattern target preserving the shared-assets fixture sync and attribution recheck workflow without automatic allowlist widening." - }, - "PreserveFactualElements": [ - "reproducible fixture refresh pattern", - "attribution recheck discipline", - "sample-sync workflow" - ], - "RewriteRequiredElements": [ - "all donor shell wording", - "all donor automation assumptions beyond the preserved refresh steps", - "all donor docs/demo framing" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer/packages/shared-assets", - "source_scope": "repo-backed", - "structure_template": "viewer-shared-asset-refresh-reference-page", - "family": "viewer-shared-assets-refresh", - "subset": "refresh-pattern" - }, - "MaterializationNotes": [ - "Preserve the fixture refresh pattern while rewriting the surfaced sync checklist in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-C refresh pattern and keeps attribution rechecks mandatory." - ] - }, - { - "ReferenceTargetId": "reference/google-model-viewer-shared-assets-geometry-reference-page-smoke-tests", - "SurfaceType": "viewer-shared-asset-geometry-reference", - "TrackTitle": "Browser Viewer Shared Asset Fixtures", - "ItemTitle": "Contributed Geometry Smoke-Test Boundary", - "IncorporationChannel": "geometry-smoke-test-boundary", - "TargetAssetFamily": "geometry-fixture-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "google/model-viewer/packages/shared-assets", - "SourceLicense": "Apache-2.0 container; mixed per-asset terms", - "SourceTrackId": "shared-assets/contributed-geometry", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist geometry-fixture target preserving contributed smoke-test assets as bounded parsing and framing fixtures while keeping per-asset review duties explicit." - }, - "PreserveFactualElements": [ - "small geometry smoke-test families", - "parser and framing fixtures", - "contributor-noted provenance boundary" - ], - "RewriteRequiredElements": [ - "all donor product-shell framing", - "all donor sample-browser wording", - "all donor blanket shipping assumptions" - ], - "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", - "MatchFilter": { - "source": "google/model-viewer/packages/shared-assets", - "source_scope": "repo-backed", - "structure_template": "viewer-shared-asset-geometry-reference-page", - "family": "viewer-shared-assets-geometry", - "subset": "contributed-geometry" - }, - "MaterializationNotes": [ - "Preserve parsing and framing smoke-test value while rewriting the surfaced fixture boundary in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-C geometry review boundary and keeps contributor-noted assets out of the blanket shipping lane." - ] - }, - { - "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-reference-page-narration", - "SurfaceType": "companion-reference", - "TrackTitle": "Embodied Companion and Narrated Coaching", - "ItemTitle": "Embodied Companion Narration", - "IncorporationChannel": "narration-contract", - "TargetAssetFamily": "companion-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "met4citizen/TalkingHead", - "SourceLicense": "MIT", - "SourceTrackId": "companion/narration-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist narration target preserving queued coach speech, subtitle timing, viseme alignment, and gesture-aware companion presentation from the retained TalkingHead lane." - }, - "PreserveFactualElements": [ - "queued speech lifecycle", - "subtitle timing", - "viseme alignment", - "gesture and mood cues" - ], - "RewriteRequiredElements": [ - "all donor example-shell framing", - "all donor vendor-specific copy", - "all donor avatar-demo wording" - ], - "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", - "MatchFilter": { - "source": "met4citizen/TalkingHead", - "source_scope": "repo-backed", - "structure_template": "embodied-companion-reference-page", - "family": "embodied-companion-narration", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded coach narration semantics while rewriting the actual companion shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-E narration contract and runtime access layer." - ] - }, - { - "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-subtitle-reference-page-sync", - "SurfaceType": "companion-subtitle-reference", - "TrackTitle": "Embodied Companion and Narrated Coaching", - "ItemTitle": "Subtitle and Viseme Synchronization", - "IncorporationChannel": "subtitle-sync-contract", - "TargetAssetFamily": "subtitle-checklist", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "met4citizen/TalkingHead", - "SourceLicense": "MIT", - "SourceTrackId": "companion/subtitle-and-viseme-sync", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist subtitle target preserving bounded caption timing, marker sync, and viseme-envelope behavior from the retained TalkingHead lane." - }, - "PreserveFactualElements": [ - "word-level subtitle cues", - "marker sync", - "blendshape viseme envelopes" - ], - "RewriteRequiredElements": [ - "all donor UI wording", - "all donor demo captions", - "all donor tutorial framing" - ], - "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", - "MatchFilter": { - "source": "met4citizen/TalkingHead", - "source_scope": "repo-backed", - "structure_template": "companion-subtitle-reference-page", - "family": "subtitle-and-viseme-sync", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded subtitle and viseme timing semantics while rewriting the surfaced cue shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 3R-E subtitle and viseme reference bundle." - ] - }, - { - "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-avatar-reference-page-embed", - "SurfaceType": "companion-avatar-reference", - "TrackTitle": "Embodied Companion and Narrated Coaching", - "ItemTitle": "Avatar-Only Embed Contract", - "IncorporationChannel": "avatar-embed-contract", - "TargetAssetFamily": "embed-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "met4citizen/TalkingHead", - "SourceLicense": "MIT", - "SourceTrackId": "companion/avatar-only-embed", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist embed target preserving bounded external-scene avatar composition, retargeting, and camera-safe companion presence from the retained TalkingHead lane." - }, - "PreserveFactualElements": [ - "external scene embedding", - "camera-safe avatar composition", - "retargeted motion and pose" - ], - "RewriteRequiredElements": [ - "all donor asset assumptions", - "all donor demo shell framing", - "all donor avatar picker UX" - ], - "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", - "MatchFilter": { - "source": "met4citizen/TalkingHead", - "source_scope": "repo-backed", - "structure_template": "companion-avatar-reference-page", - "family": "avatar-only-embedding", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded avatar-only embedding semantics while rewriting the actual companion scene shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-E avatar embed contract." - ] - }, - { - "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-gesture-reference-page-presets", - "SurfaceType": "companion-gesture-reference", - "TrackTitle": "Embodied Companion and Narrated Coaching", - "ItemTitle": "Gesture, Mood, and Pose Surface", - "IncorporationChannel": "gesture-mood-contract", - "TargetAssetFamily": "gesture-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "met4citizen/TalkingHead", - "SourceLicense": "MIT", - "SourceTrackId": "companion/gesture-mood-and-pose", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist gesture target preserving bounded coach acknowledgement, focus-callout, celebration, and mood-switching semantics from the retained TalkingHead lane." - }, - "PreserveFactualElements": [ - "gesture presets", - "mood switching", - "coach-facing pose cues" - ], - "RewriteRequiredElements": [ - "all donor animation-demo framing", - "all donor shell wording", - "all donor example choreography copy" - ], - "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", - "MatchFilter": { - "source": "met4citizen/TalkingHead", - "source_scope": "repo-backed", - "structure_template": "companion-gesture-reference-page", - "family": "gesture-mood-and-pose", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded gesture, mood, and pose semantics while rewriting the actual coach-presence shell in first-party HyperTwist language.", - "This target keeps expressive presentation inside the embodied companion lane rather than spreading it into unrelated owners." - ] - }, - { - "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-listening-reference-page-lifecycle", - "SurfaceType": "companion-listening-reference", - "TrackTitle": "Embodied Companion and Narrated Coaching", - "ItemTitle": "Streaming and Listening Lifecycle", - "IncorporationChannel": "listening-lifecycle-contract", - "TargetAssetFamily": "listening-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "met4citizen/TalkingHead", - "SourceLicense": "MIT", - "SourceTrackId": "companion/streaming-and-listening-lifecycle", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist listening target preserving bounded streaming playback, queue underrun handling, and microphone threshold-gating semantics from the retained TalkingHead lane." - }, - "PreserveFactualElements": [ - "audio stream buffering", - "queue underrun handling", - "listening thresholds", - "microphone handoff" - ], - "RewriteRequiredElements": [ - "all donor vendor tutorial text", - "all donor example shell framing", - "all donor microphone-demo wording" - ], - "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", - "MatchFilter": { - "source": "met4citizen/TalkingHead", - "source_scope": "repo-backed", - "structure_template": "companion-listening-reference-page", - "family": "streaming-and-listening-lifecycle", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded streaming and listening semantics while rewriting the surfaced audio and microphone shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-E queue lifecycle and listening contract surfaces." - ] - }, - { - "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-boundary-reference-page-adapter", - "SurfaceType": "companion-boundary-reference", - "TrackTitle": "Embodied Companion and Narrated Coaching", - "ItemTitle": "TTS and Asset Adapter Boundary", - "IncorporationChannel": "vendor-adapter-boundary", - "TargetAssetFamily": "boundary-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "met4citizen/TalkingHead", - "SourceLicense": "MIT", - "SourceTrackId": "companion/tts-and-asset-adapter-boundary", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist boundary target preserving configurable TTS, JWT, avatar, and streaming seams while keeping donor examples and sample assets explicitly outside the shipped companion lane." - }, - "PreserveFactualElements": [ - "replaceable voice-service fields", - "asset-seam boundaries", - "demo-only shell separation" - ], - "RewriteRequiredElements": [ - "all donor vendor branding", - "all donor example copy", - "all donor sample-asset assumptions" - ], - "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", - "MatchFilter": { - "source": "met4citizen/TalkingHead", - "source_scope": "repo-backed", - "structure_template": "companion-boundary-reference-page", - "family": "tts-and-asset-adapter-boundary", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded TTS and asset-adapter semantics while rewriting the surfaced configuration shell in first-party HyperTwist language.", - "This target keeps sample avatars, vendor wiring, and donor examples subordinate to the landed companion owner." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-scene-reference-page-stack", - "SurfaceType": "browser-spatial-scene-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "Browser Spatial Scene and Renderer Contract", - "IncorporationChannel": "browser-spatial-scene-contract", - "TargetAssetFamily": "scene-contract-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "mrdoob/three.js", - "SourceLicense": "MIT", - "SourceTrackId": "spatial/scene-substrate", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser spatial scene target preserving bounded three.js and react-three-fiber renderer, camera, frameloop, and WebXR-manager semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "scene and renderer lifecycle", - "camera and raycaster binding", - "frameloop invalidation", - "WebXR manager integration" - ], - "RewriteRequiredElements": [ - "all donor editor shell framing", - "all donor docs or demo wording", - "all donor example chrome" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "mrdoob/three.js", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-scene-reference-page", - "family": "browser-spatial-scene-substrate", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded browser scene and renderer semantics while rewriting the surfaced integration contract in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-F browser spatial scene contract and runtime access layer." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-react-reference-page-renderer", - "SurfaceType": "browser-spatial-react-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "React Scene Renderer and Event Bridge", - "IncorporationChannel": "browser-spatial-react-contract", - "TargetAssetFamily": "renderer-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "pmndrs/react-three-fiber", - "SourceLicense": "MIT", - "SourceTrackId": "spatial/react-renderer", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser spatial renderer target preserving bounded React canvas-root, event-manager, and camera-store bridge semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "canvas root configuration", - "event-manager bridge", - "pointer and raycaster routing", - "camera or store lifecycle" - ], - "RewriteRequiredElements": [ - "all donor docs or demo wording", - "all donor example framing", - "all donor package-marketing copy" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "pmndrs/react-three-fiber", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-react-reference-page", - "family": "browser-spatial-react-renderer", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded React renderer semantics while rewriting the surfaced browser spatial shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 3R-F browser spatial scene contract." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-xr-reference-page-session", - "SurfaceType": "browser-spatial-xr-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "Browser XR Session and Immersive Interaction Contract", - "IncorporationChannel": "browser-spatial-xr-contract", - "TargetAssetFamily": "xr-contract-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "pmndrs/xr", - "SourceLicense": "MIT", - "SourceTrackId": "spatial/xr-session-store", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser XR target preserving bounded session-store, controller or hand input, pointer-routing, and immersive interaction semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "XR store lifecycle", - "controller, hand, and gaze inputs", - "session visibility and origin management", - "pointer routing and immersive interaction" - ], - "RewriteRequiredElements": [ - "all donor showroom framing", - "all donor docs wording", - "all donor sample-app chrome" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "pmndrs/xr", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-xr-reference-page", - "family": "browser-spatial-xr-session", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded browser XR semantics while rewriting the immersive-support shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 3R-F XR session contract and runtime access layer." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-ui-reference-page-panels", - "SurfaceType": "browser-spatial-ui-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "Browser Spatial UI and World-Anchored Controls", - "IncorporationChannel": "browser-spatial-ui-contract", - "TargetAssetFamily": "spatial-ui-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "pmndrs/uikit", - "SourceLicense": "MIT", - "SourceTrackId": "spatial/world-anchored-ui", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser spatial UI target preserving bounded instanced-panel, text-input, and world-anchored control semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "instanced panels", - "world-anchored control families", - "text and input surfaces", - "themeable spatial UI kits" - ], - "RewriteRequiredElements": [ - "all donor dashboard framing", - "all donor example wording", - "all donor theme-kit copy" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "pmndrs/uikit", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-ui-reference-page", - "family": "browser-spatial-ui", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded spatial UI semantics while rewriting the surfaced world-anchored control shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-F spatial UI contract." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-effect-reference-page-boundary", - "SurfaceType": "browser-spatial-effect-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "Browser Post-Processing and Effect Boundary", - "IncorporationChannel": "browser-spatial-effect-boundary", - "TargetAssetFamily": "effect-boundary-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "pmndrs/postprocessing", - "SourceLicense": "Zlib", - "SourceTrackId": "spatial/effect-composer", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser effect target preserving bounded effect-composer, pass-orchestration, and render-priority semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "effect composer lifecycle", - "pass ordering and grouping", - "depth and normal pass orchestration", - "render-priority driven effect routing" - ], - "RewriteRequiredElements": [ - "all donor effect-gallery wording", - "all donor docs framing", - "all donor demo-shell assumptions" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "pmndrs/postprocessing", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-effect-reference-page", - "family": "browser-spatial-effects", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded post-processing semantics while rewriting the surfaced effect policy in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 3R-F effect boundary." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-helper-reference-page-stack", - "SurfaceType": "browser-spatial-helper-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "Browser Spatial Helper and Utility Stack", - "IncorporationChannel": "browser-spatial-helper-stack", - "TargetAssetFamily": "helper-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "pmndrs/drei", - "SourceLicense": "MIT", - "SourceTrackId": "spatial/helper-primitives", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist helper target preserving bounded view, HTML overlay, controller-helper, and motion-friendly math semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "scissored view embedding", - "HTML overlay bridging", - "XR controller model helpers", - "damping and easing helpers" - ], - "RewriteRequiredElements": [ - "all donor helper-demo wording", - "all donor example framing", - "all donor sample-shell assumptions" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "pmndrs/drei", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-helper-reference-page", - "family": "browser-spatial-helpers", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded helper and utility semantics while rewriting the surfaced integration shell in first-party HyperTwist terms.", - "This target keeps helper abstractions subordinate to the landed 3R-F spatial support lane." - ] - }, - { - "ReferenceTargetId": "reference/browser-spatial-state-reference-page-stack", - "SurfaceType": "browser-spatial-state-reference", - "TrackTitle": "Browser 3D and XR Support", - "ItemTitle": "Browser Spatial State, Gesture, and Motion Contract", - "IncorporationChannel": "browser-spatial-state-motion-contract", - "TargetAssetFamily": "state-motion-note", - "PuzzleFamily": "Other", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "pmndrs/zustand", - "SourceLicense": "MIT", - "SourceTrackId": "spatial/state-gesture-motion", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist browser state target preserving bounded store, gesture-routing, spring-motion, and parameter-control semantics from the retained 3R-F lane." - }, - "PreserveFactualElements": [ - "lightweight store lifecycle", - "gesture composition and routing", - "spring-based motion and interpolation", - "schema-driven parameter controls" - ], - "RewriteRequiredElements": [ - "all donor playground wording", - "all donor demo framing", - "all donor package-marketing copy" - ], - "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", - "MatchFilter": { - "source": "pmndrs/zustand", - "source_scope": "repo-backed", - "structure_template": "browser-spatial-state-reference-page", - "family": "browser-spatial-state-motion", - "subset": null - }, - "MaterializationNotes": [ - "Preserve bounded state, gesture, and motion semantics while rewriting the surfaced control shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 3R-F state and motion contract." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-semantic-reference-page-stack", - "SurfaceType": "classic-cubing-semantic-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Classic-Cubing Semantic and State Contract", - "IncorporationChannel": "semantic-contract", - "TargetAssetFamily": "semantic-contract-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/semantic-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist semantic target preserving KPuzzle, transformation, notation, and binary interop semantics from cubing.js through the practical MPL-side adapter lane." - }, - "PreserveFactualElements": [ - "KPuzzle definitions", - "pattern and transformation semantics", - "notation interoperability", - "binary or Twizzle protocol translation" - ], - "RewriteRequiredElements": [ - "all donor docs or demo wording", - "all donor app-shell assumptions", - "all donor product-shell copy" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-semantic-reference-page", - "family": "classic-cubing-semantics", - "subset": "kpuzzle-state" - }, - "MaterializationNotes": [ - "Preserve factual classic-cubing state and interop semantics while rewriting the surfaced shell as first-party HyperTwist contract language.", - "This target pairs with the compiled Phase 4R-A semantic contract and runtime access layer." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-geometry-reference-page-stack", - "SurfaceType": "classic-cubing-geometry-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Classic-Cubing Geometry and Named Puzzle Contract", - "IncorporationChannel": "geometry-contract", - "TargetAssetFamily": "geometry-contract-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/geometry-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist geometry target preserving named-puzzle resolution, description parsing, and geometry-backed construction semantics from cubing.js beneath the MPL-aware classic-cubing lane." - }, - "PreserveFactualElements": [ - "named puzzle resolution", - "description-string parsing", - "PGNotation mapping", - "geometry-backed puzzle construction" - ], - "RewriteRequiredElements": [ - "all donor geometry-demo wording", - "all donor browser-shell framing", - "all donor puzzle-browser copy" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-geometry-reference-page", - "family": "classic-cubing-geometry", - "subset": "named-puzzle-and-geometry" - }, - "MaterializationNotes": [ - "Preserve named-puzzle and geometry semantics while rewriting the surfaced adapter shell in first-party HyperTwist terms.", - "This target pairs with the compiled Phase 4R-A geometry contract and keeps hyper-runtime ownership outside the cubing.js lane." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-viewer-reference-page-stack", - "SurfaceType": "classic-cubing-viewer-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Classic-Cubing Viewer, Player, and Editor Adapter", - "IncorporationChannel": "viewer-adapter-contract", - "TargetAssetFamily": "viewer-adapter-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/viewer-adapter-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist viewer target preserving embedded TwistyPlayer, algorithm-editor, and indexer semantics from cubing.js through a bounded MPL-side adapter lane." - }, - "PreserveFactualElements": [ - "TwistyPlayer embedding", - "algorithm viewer and editor surfaces", - "indexer behavior", - "puzzle-switching configuration" - ], - "RewriteRequiredElements": [ - "all donor Twizzle shell wording", - "all donor docs/demo framing", - "all donor app-shell chrome" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-viewer-reference-page", - "family": "classic-cubing-viewer-adapter", - "subset": "twisty-player-and-editor" - }, - "MaterializationNotes": [ - "Preserve bounded viewer and editor semantics while rewriting the surfaced playback shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-A viewer-adapter contract and does not replace the separate twisty.js clean-room lane." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-device-reference-page-boundary", - "SurfaceType": "classic-cubing-device-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Classic-Cubing Smart-Device and Protocol Adapter Boundary", - "IncorporationChannel": "device-adapter-boundary", - "TargetAssetFamily": "device-boundary-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/device-adapter-boundary", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist smart-device boundary target preserving connector families, timer or robot entry points, and binary protocol semantics from cubing.js beneath owned HyperTwist device flows." - }, - "PreserveFactualElements": [ - "smart puzzle connector families", - "smart timer and smart robot entry points", - "keyboard puzzle surface", - "protocol translation helpers" - ], - "RewriteRequiredElements": [ - "all donor pairing-shell wording", - "all donor vendor UI framing", - "all donor example-shell assumptions" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-device-reference-page", - "family": "classic-cubing-device-boundary", - "subset": "bluetooth-and-protocol" - }, - "MaterializationNotes": [ - "Preserve bounded smart-device and protocol semantics while rewriting the surfaced device shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-A device-adapter boundary and keeps vendor policy first-party." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-search-reference-page-stack", - "SurfaceType": "classic-cubing-search-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Classic-Cubing Search, Scramble, and Solve-Helper Contract", - "IncorporationChannel": "search-contract", - "TargetAssetFamily": "search-contract-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/search-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist search target preserving bounded solve-helper, random-state, and scramble-routing semantics from cubing.js while keeping retained solver benchmarks separate." - }, - "PreserveFactualElements": [ - "random-state helpers", - "solve-helper entry points", - "puzzle-kind dispatch", - "scramble export surface" - ], - "RewriteRequiredElements": [ - "all donor solver-shell wording", - "all donor docs/demo framing", - "all donor example-shell assumptions" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-search-reference-page", - "family": "classic-cubing-search", - "subset": "search-and-scramble" - }, - "MaterializationNotes": [ - "Preserve bounded search and scramble semantics while rewriting the surfaced solve-helper shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-A search contract and keeps retained solver benchmarks as separate validation authorities." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-bridge-reference-page-melinda", - "SurfaceType": "classic-cubing-bridge-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Melinda 2x2x2x2 Bridge Boundary", - "IncorporationChannel": "melinda-bridge-boundary", - "TargetAssetFamily": "bridge-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/geometry-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist bridge target preserving Melinda 2x2x2x2 registry and loader semantics from cubing.js while keeping hyper-runtime and clean-room ownership separate." - }, - "PreserveFactualElements": [ - "Melinda puzzle registration", - "bounded loader semantics", - "bridge-family naming", - "non-hyper runtime separation" - ], - "RewriteRequiredElements": [ - "all donor puzzle-browser wording", - "all donor demo framing", - "all donor product-shell copy" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-bridge-reference-page", - "family": "classic-cubing-melinda-bridge", - "subset": "melindas-2x2x2x2" - }, - "MaterializationNotes": [ - "Preserve the bounded Melinda bridge semantics while rewriting the surfaced shell in first-party HyperTwist language.", - "This target keeps the bridge explicit without collapsing the separate clean-room and hyper-runtime lanes." - ] - }, - { - "ReferenceTargetId": "reference/cubing-cubing-js-compliance-reference-page-boundary", - "SurfaceType": "classic-cubing-compliance-reference", - "TrackTitle": "Classic Cubing Semantics and Runtime", - "ItemTitle": "Classic-Cubing MPL Adapter and Notice Boundary", - "IncorporationChannel": "mpl-compliance-boundary", - "TargetAssetFamily": "compliance-boundary-note", - "PuzzleFamily": "ClassicCube", - "NotationProfile": "classic-wca", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cubing/cubing.js", - "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", - "SourceTrackId": "classic-cubing/mpl-compliance-boundary", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist compliance target preserving the practical MPL-side library-use posture and source-file modification duties documented by cubing.js." - }, - "PreserveFactualElements": [ - "MPL-side library-use posture", - "source-file modification publication duty", - "license-material retention", - "vendored acknowledgement preservation" - ], - "RewriteRequiredElements": [ - "all donor README wording", - "all donor docs/demo framing", - "all donor product-shell copy" - ], - "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", - "MatchFilter": { - "source": "cubing/cubing.js", - "source_scope": "repo-backed", - "structure_template": "classic-cubing-compliance-reference-page", - "family": "classic-cubing-mpl-boundary", - "subset": "compliance-and-notices" - }, - "MaterializationNotes": [ - "Preserve the MPL-side compliance boundary while rewriting the surfaced legal and packaging shell as first-party HyperTwist guidance.", - "This target pairs with the compiled Phase 4R-A compliance boundary and keeps the no-private-fork posture explicit." - ] - }, - { - "ReferenceTargetId": "reference/cutelyaware-magiccube4d-history-reference-page-stack", - "SurfaceType": "legacy-4d-history-reference", - "TrackTitle": "Legacy 4D Interaction and History", - "ItemTitle": "Legacy 4D History, Marks, and Save-Restore Contract", - "IncorporationChannel": "history-contract", - "TargetAssetFamily": "history-contract-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cutelyaware/magiccube4d", - "SourceLicense": "Custom permissive attribution-request license", - "SourceTrackId": "legacy-4d/history-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist history target preserving move-log, marks, macro brackets, undo-redo traversal, and save-restore semantics from MagicCube4D beneath owned higher-dimensional history flows." - }, - "PreserveFactualElements": [ - "history nodes", - "mark delimiters", - "macro brackets", - "undo redo traversal", - "save restore log semantics" - ], - "RewriteRequiredElements": [ - "all donor Swing shell wording", - "all donor menu and file-dialog framing", - "all donor legacy UI-state assumptions" - ], - "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", - "MatchFilter": { - "source": "cutelyaware/magiccube4d", - "source_scope": "repo-backed", - "structure_template": "legacy-4d-history-reference-page", - "family": "legacy-4d-history", - "subset": "move-log-and-marks" - }, - "MaterializationNotes": [ - "Preserve history, mark, macro-boundary, and replay semantics while rewriting the surfaced history shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-B history contract and keeps the higher-dimensional history lane beneath the Hyperspeedcube anchor." - ] - }, - { - "ReferenceTargetId": "reference/cutelyaware-magiccube4d-macro-reference-page-stack", - "SurfaceType": "legacy-4d-macro-reference", - "TrackTitle": "Legacy 4D Interaction and History", - "ItemTitle": "Legacy 4D Macro Remapping and Reversal Contract", - "IncorporationChannel": "macro-contract", - "TargetAssetFamily": "macro-contract-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cutelyaware/magiccube4d", - "SourceLicense": "Custom permissive attribution-request license", - "SourceTrackId": "legacy-4d/macro-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist macro target preserving reference-grip remapping, 4D transform application, reversal, and playback semantics from MagicCube4D beneath owned higher-dimensional teaching flows." - }, - "PreserveFactualElements": [ - "reference grips", - "4D transform remapping", - "closest-grip remap", - "macro reversal", - "macro serialization" - ], - "RewriteRequiredElements": [ - "all donor macro-editor wording", - "all donor file-format lock-in assumptions", - "all donor menu-shell choreography" - ], - "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", - "MatchFilter": { - "source": "cutelyaware/magiccube4d", - "source_scope": "repo-backed", - "structure_template": "legacy-4d-macro-reference-page", - "family": "legacy-4d-macro", - "subset": "reference-grip-remapping" - }, - "MaterializationNotes": [ - "Preserve macro remapping and reversal semantics while rewriting the surfaced authoring shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-B macro contract and keeps higher-dimensional macro playback first-party." - ] - }, - { - "ReferenceTargetId": "reference/cutelyaware-magiccube4d-puzzle-description-reference-page-stack", - "SurfaceType": "legacy-4d-puzzle-description-reference", - "TrackTitle": "Legacy 4D Interaction and History", - "ItemTitle": "Legacy 4D Puzzle Description and Topology Contract", - "IncorporationChannel": "puzzle-description-contract", - "TargetAssetFamily": "puzzle-description-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cutelyaware/magiccube4d", - "SourceLicense": "Custom permissive attribution-request license", - "SourceTrackId": "legacy-4d/puzzle-description-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist topology target preserving generic polytope slicing, Schlafli-product puzzle parsing, and grip-sticker-face relationships from MagicCube4D without displacing the Hyperspeedcube runtime anchor." - }, - "PreserveFactualElements": [ - "Schlafli product parsing", - "polytope slicing", - "grip to face mapping", - "face cut offsets", - "sticker and cubie relationships" - ], - "RewriteRequiredElements": [ - "all donor applet-shell wording", - "all donor TODO and issue-list narration", - "all donor legacy configuration shell assumptions" - ], - "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", - "MatchFilter": { - "source": "cutelyaware/magiccube4d", - "source_scope": "repo-backed", - "structure_template": "legacy-4d-puzzle-description-reference-page", - "family": "legacy-4d-puzzle-description", - "subset": "generic-polytope-slicing" - }, - "MaterializationNotes": [ - "Preserve generic puzzle-description and topology semantics while rewriting the surfaced adapter shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-B topology contract and does not replace the Hyperspeedcube runtime anchor." - ] - }, - { - "ReferenceTargetId": "reference/cutelyaware-magiccube4d-interaction-reference-page-stack", - "SurfaceType": "legacy-4d-interaction-reference", - "TrackTitle": "Legacy 4D Interaction and History", - "ItemTitle": "Legacy 4D Interaction, Picking, and Animation Contract", - "IncorporationChannel": "interaction-contract", - "TargetAssetFamily": "interaction-contract-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cutelyaware/magiccube4d", - "SourceLicense": "Custom permissive attribution-request license", - "SourceTrackId": "legacy-4d/interaction-contract", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist interaction target preserving 4D rotation grammar, snap behavior, sticker picking, highlight state, slice masks, and animation-queue semantics from MagicCube4D beneath owned higher-dimensional interaction flows." - }, - "PreserveFactualElements": [ - "4D view matrix state", - "snap to center semantics", - "spin continuation", - "sticker picking and highlighting", - "slice mask and animation queue" - ], - "RewriteRequiredElements": [ - "all donor Swing event-shell wording", - "all donor component lifecycle assumptions", - "all donor property-manager framing" - ], - "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", - "MatchFilter": { - "source": "cutelyaware/magiccube4d", - "source_scope": "repo-backed", - "structure_template": "legacy-4d-interaction-reference-page", - "family": "legacy-4d-interaction", - "subset": "rotation-and-drag-grammar" - }, - "MaterializationNotes": [ - "Preserve rotation grammar, picking, highlighting, slice-mask, and animation semantics while rewriting the surfaced interaction shell in first-party HyperTwist language.", - "This target pairs with the compiled Phase 4R-B interaction contract and keeps higher-dimensional runtime ownership outside the donor shell." - ] - }, - { - "ReferenceTargetId": "reference/cutelyaware-magiccube4d-view-reference-page-stack", - "SurfaceType": "legacy-4d-view-reference", - "TrackTitle": "Legacy 4D Interaction and History", - "ItemTitle": "Legacy 4D View Controller Composition Reference", - "IncorporationChannel": "view-controller-reference", - "TargetAssetFamily": "view-controller-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cutelyaware/magiccube4d", - "SourceLicense": "Custom permissive attribution-request license", - "SourceTrackId": "legacy-4d/view", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist view-controller reference preserving listener callbacks, queued move animation, motion-aware highlight refresh, and safe input routing from MagicCube4D without carrying over the Swing shell." - }, - "PreserveFactualElements": [ - "viewer controller composition", - "listener callbacks", - "queued move animation", - "motion-aware highlight refresh", - "component-safe input routing" - ], - "RewriteRequiredElements": [ - "all donor Swing component wording", - "all donor applet and panel framing", - "all donor Java event-thread assumptions" - ], - "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", - "MatchFilter": { - "source": "cutelyaware/magiccube4d", - "source_scope": "repo-backed", - "structure_template": "legacy-4d-view-reference-page", - "family": "legacy-4d-view-controller", - "subset": "viewer-composition" - }, - "MaterializationNotes": [ - "Preserve view-controller composition semantics while rewriting the surfaced component shell in first-party HyperTwist language.", - "This target keeps the interaction composition value explicit without promoting the donor Swing shell into HyperTwist ownership." - ] - }, - { - "ReferenceTargetId": "reference/cutelyaware-magiccube4d-attribution-reference-page-boundary", - "SurfaceType": "legacy-4d-attribution-reference", - "TrackTitle": "Legacy 4D Interaction and History", - "ItemTitle": "Legacy 4D Attribution and Provenance Boundary", - "IncorporationChannel": "attribution-boundary", - "TargetAssetFamily": "compliance-boundary-note", - "PuzzleFamily": "Hypercube", - "NotationProfile": "family-specific", - "SourceAttribution": { - "SourceMode": "DirectDonor", - "SourceRepo": "cutelyaware/magiccube4d", - "SourceLicense": "Custom permissive attribution-request license", - "SourceTrackId": "legacy-4d/attribution-boundary", - "SourceDeckId": "", - "SourceCaseId": "", - "SourceNotes": "First-party HyperTwist compliance target preserving visible attribution, required upstream link, notice retention, and the MyMath provenance caveat from MagicCube4D." - }, - "PreserveFactualElements": [ - "custom attribution-request license posture", - "required upstream link", - "copyright and notice retention", - "MyMath provenance caveat" - ], - "RewriteRequiredElements": [ - "all donor legal-shell wording beyond the preserved factual duties", - "all donor packaging assumptions", - "all donor UI placement assumptions" - ], - "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", - "MatchFilter": { - "source": "cutelyaware/magiccube4d", - "source_scope": "repo-backed", - "structure_template": "legacy-4d-attribution-reference-page", - "family": "legacy-4d-attribution", - "subset": "license-and-provenance" - }, - "MaterializationNotes": [ - "Preserve the attribution and provenance boundary while rewriting the surfaced compliance shell as first-party HyperTwist guidance.", - "This target pairs with the compiled Phase 4R-B attribution boundary and keeps the upstream link and MyMath provenance note explicit." - ] - } - ] + "generated_at": "2026-05-13T22:00:00Z", + "reference_targets": [ + { + "ReferenceTargetId": "reference/speedcubedb-course-reference-page-speedcubedb-root", + "SurfaceType": "course-reference", + "TrackTitle": "Advanced 3x3 Systems", + "ItemTitle": "Speedcubedb Root", + "IncorporationChannel": "course-reference-supplement", + "TargetAssetFamily": "reference-page", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "SpeedCubeDB", + "SourceLicense": "retained-web-content", + "SourceTrackId": "advanced-3x3-systems", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten curriculum brief for Speedcubedb Root, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "speedcubedb", + "source_scope": "httrack-retained", + "structure_template": "course-reference-page", + "family": "speedcubedb-root", + "subset": null + }, + "MaterializationNotes": [ + "Rewritten curriculum brief for Speedcubedb Root, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/speedcubedb-tool-reference-page-speedcubedb-root", + "SurfaceType": "tool-reference", + "TrackTitle": "Advanced 3x3 Systems", + "ItemTitle": "Speedcubedb Root", + "IncorporationChannel": "feature-reference", + "TargetAssetFamily": "tool-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "SpeedCubeDB", + "SourceLicense": "retained-web-content", + "SourceTrackId": "advanced-3x3-systems", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Feature-semantics reference for Speedcubedb Root, rewritten as first-party product guidance instead of donor utility-page copy." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "speedcubedb", + "source_scope": "httrack-retained", + "structure_template": "tool-reference-page", + "family": "speedcubedb-root", + "subset": null + }, + "MaterializationNotes": [ + "Feature-semantics reference for Speedcubedb Root, rewritten as first-party product guidance instead of donor utility-page copy.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-com-course-reference-page-magic-cube-4d-solution", + "SurfaceType": "course-reference", + "TrackTitle": "Hypercubing Software Manuals", + "ItemTitle": "Magic Cube 4D Solution Notes", + "IncorporationChannel": "course-reference-supplement", + "TargetAssetFamily": "reference-page", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "superliminal.com", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-software-manuals", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten curriculum brief for Magic Cube 4D Solution Notes, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal.com", + "source_scope": "httrack-retained", + "structure_template": "course-reference-page", + "family": "Magic Cube 4D", + "subset": "solution" + }, + "MaterializationNotes": [ + "Rewritten curriculum brief for Magic Cube 4D Solution Notes, preserving factual method structure while replacing donor page wording with first-party HyperTwist copy.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-cube-4d", + "SurfaceType": "software-manual", + "TrackTitle": "Hypercubing Software Manuals", + "ItemTitle": "Magic Cube 4D Manual", + "IncorporationChannel": "software-manual-surface", + "TargetAssetFamily": "manual-page", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "superliminal.com", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-software-manuals", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten operational guide target for Magic Cube 4D Manual, preserving behavior and workflow semantics without reusing donor manual prose." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal.com", + "source_scope": "httrack-retained", + "structure_template": "software-manual-reference-page", + "family": "Magic Cube 4D", + "subset": null + }, + "MaterializationNotes": [ + "Rewritten operational guide target for Magic Cube 4D Manual, preserving behavior and workflow semantics without reusing donor manual prose.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-cube-7d", + "SurfaceType": "software-manual", + "TrackTitle": "Hypercubing Software Manuals", + "ItemTitle": "Magic Cube 7D Manual", + "IncorporationChannel": "software-manual-surface", + "TargetAssetFamily": "manual-page", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "superliminal.com", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-software-manuals", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten operational guide target for Magic Cube 7D Manual, preserving behavior and workflow semantics without reusing donor manual prose." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal.com", + "source_scope": "httrack-retained", + "structure_template": "software-manual-reference-page", + "family": "Magic Cube 7D", + "subset": null + }, + "MaterializationNotes": [ + "Rewritten operational guide target for Magic Cube 7D Manual, preserving behavior and workflow semantics without reusing donor manual prose.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-hyperbolic-tile", + "SurfaceType": "software-manual", + "TrackTitle": "Hypercubing Software Manuals", + "ItemTitle": "Magic Hyperbolic Tile Manual", + "IncorporationChannel": "software-manual-surface", + "TargetAssetFamily": "manual-page", + "PuzzleFamily": "Tiling", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "superliminal.com", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-software-manuals", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten operational guide target for Magic Hyperbolic Tile Manual, preserving behavior and workflow semantics without reusing donor manual prose." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal.com", + "source_scope": "httrack-retained", + "structure_template": "software-manual-reference-page", + "family": "Magic Hyperbolic Tile", + "subset": null + }, + "MaterializationNotes": [ + "Rewritten operational guide target for Magic Hyperbolic Tile Manual, preserving behavior and workflow semantics without reusing donor manual prose.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-puzzle-ultimate", + "SurfaceType": "software-manual", + "TrackTitle": "Hypercubing Software Manuals", + "ItemTitle": "Magic Puzzle Ultimate Manual", + "IncorporationChannel": "software-manual-surface", + "TargetAssetFamily": "manual-page", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "superliminal.com", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-software-manuals", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten operational guide target for Magic Puzzle Ultimate Manual, preserving behavior and workflow semantics without reusing donor manual prose." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal.com", + "source_scope": "httrack-retained", + "structure_template": "software-manual-reference-page", + "family": "Magic Puzzle Ultimate", + "subset": null + }, + "MaterializationNotes": [ + "Rewritten operational guide target for Magic Puzzle Ultimate Manual, preserving behavior and workflow semantics without reusing donor manual prose.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-com-software-manual-reference-page-magic-simplex-5d", + "SurfaceType": "software-manual", + "TrackTitle": "Hypercubing Software Manuals", + "ItemTitle": "Magic Simplex 5D Manual", + "IncorporationChannel": "software-manual-surface", + "TargetAssetFamily": "manual-page", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "superliminal.com", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-software-manuals", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Rewritten operational guide target for Magic Simplex 5D Manual, preserving behavior and workflow semantics without reusing donor manual prose." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal.com", + "source_scope": "httrack-retained", + "structure_template": "software-manual-reference-page", + "family": "Magic Simplex 5D", + "subset": null + }, + "MaterializationNotes": [ + "Rewritten operational guide target for Magic Simplex 5D Manual, preserving behavior and workflow semantics without reusing donor manual prose.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/superliminal-wiki-historical-reference-page-hypercubing-reference", + "SurfaceType": "historical-reference", + "TrackTitle": "Hypercubing Reference", + "ItemTitle": "Hypercubing Historical Reference", + "IncorporationChannel": "historical-reference-supplement", + "TargetAssetFamily": "history-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "hypercubing-standard", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "Superliminal Wiki", + "SourceLicense": "retained-web-content", + "SourceTrackId": "hypercubing-reference", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "Historical and conceptual reference lane for hypercubing context, rewritten into concise HyperTwist-native background guidance." + }, + "PreserveFactualElements": [ + "topic scope", + "page role", + "factual software or method semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional/reference prose" + ], + "ContentSourceFile": "./raw-extracts/httrack-retained-reference-pages.jsonl", + "MatchFilter": { + "source": "superliminal-wiki", + "source_scope": "httrack-retained", + "structure_template": "historical-reference-page", + "family": "hypercubing-reference", + "subset": null + }, + "MaterializationNotes": [ + "Historical and conceptual reference lane for hypercubing context, rewritten into concise HyperTwist-native background guidance.", + "Reference/manual surfaces remain rewritten first-party content targets, not copied donor pages." + ] + }, + { + "ReferenceTargetId": "reference/hypercubing-xyz-course-reference-page-progression", + "SurfaceType": "course-reference", + "TrackTitle": "Hypercubing Progression", + "ItemTitle": "Hypercubing Progression Ladder", + "IncorporationChannel": "course-reference-supplement", + "TargetAssetFamily": "reference-page", + "PuzzleFamily": "Hypercube", + "NotationProfile": "hypercubing-standard", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "Hypercubers/hypercubing.xyz", + "SourceLicense": "MIT", + "SourceTrackId": "progression", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist progression contract target preserving stage order, prerequisites, and widening boundaries from the donor progression guide." + }, + "PreserveFactualElements": [ + "stage ordering", + "prerequisite relationships", + "family branching semantics" + ], + "RewriteRequiredElements": [ + "page title", + "all instructional prose", + "all donor-specific presentation language" + ], + "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", + "MatchFilter": { + "source": "hypercubing.xyz", + "source_scope": "repo-backed", + "structure_template": "progression-reference-page", + "family": "hypercubing-progression", + "subset": null + }, + "MaterializationNotes": [ + "Preserve the donor\u0027s progression ordering and branch logic while rewriting the actual instructional surface in first-party HyperTwist language.", + "This target feeds the Phase 3R-B knowledge and curriculum lane rather than the runtime simulation lane." + ] + }, + { + "ReferenceTargetId": "reference/hypercubing-xyz-notation-reference-page-cell-turning-hypercubes", + "SurfaceType": "notation-reference", + "TrackTitle": "Hypercubing Notation", + "ItemTitle": "Cell-Turning Hypercube Notation", + "IncorporationChannel": "notation-reference-supplement", + "TargetAssetFamily": "glossary-page", + "PuzzleFamily": "Hypercube", + "NotationProfile": "hypercubing-standard", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "Hypercubers/hypercubing.xyz", + "SourceLicense": "MIT", + "SourceTrackId": "notation", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist notation reference target preserving factual cell, twist, plane-rotation, and metric semantics from the donor notation guide." + }, + "PreserveFactualElements": [ + "cell naming semantics", + "twist and rotation rules", + "metric distinctions" + ], + "RewriteRequiredElements": [ + "page title", + "all explanatory prose", + "all donor-specific examples beyond factual notation payloads" + ], + "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", + "MatchFilter": { + "source": "hypercubing.xyz", + "source_scope": "repo-backed", + "structure_template": "notation-reference-page", + "family": "cell-turning-hypercubes", + "subset": null + }, + "MaterializationNotes": [ + "Preserve factual notation grammar and cross-links while rewriting reference prose into HyperTwist-native documentation.", + "This target is paired with the compiled Phase 3R-B notation glossary contract." + ] + }, + { + "ReferenceTargetId": "reference/hypercubing-xyz-tool-reference-page-software-matrix", + "SurfaceType": "tool-reference", + "TrackTitle": "Hypercubing Software", + "ItemTitle": "Hypercubing Software Matrix", + "IncorporationChannel": "feature-reference", + "TargetAssetFamily": "tool-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "hypercubing-standard", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "Hypercubers/hypercubing.xyz", + "SourceLicense": "MIT", + "SourceTrackId": "software", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist software-comparison target preserving factual platform and capability semantics from the donor feature matrix." + }, + "PreserveFactualElements": [ + "platform coverage", + "capability taxonomy", + "program-role distinctions" + ], + "RewriteRequiredElements": [ + "page title", + "all donor prose", + "all donor presentation formatting" + ], + "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", + "MatchFilter": { + "source": "hypercubing.xyz", + "source_scope": "repo-backed", + "structure_template": "tool-reference-page", + "family": "software-matrix", + "subset": null + }, + "MaterializationNotes": [ + "Preserve factual feature, platform, and recommendation semantics while rewriting the reference surface in first-party HyperTwist terms.", + "This target supports bounded software-comparison and community-guidance surfaces, not runtime ownership." + ] + }, + { + "ReferenceTargetId": "reference/hypercubing-xyz-community-reference-page-leaderboards", + "SurfaceType": "community-reference", + "TrackTitle": "Hypercubing Leaderboards", + "ItemTitle": "Hypercubing Leaderboard Conventions", + "IncorporationChannel": "community-reference-supplement", + "TargetAssetFamily": "leaderboard-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "hypercubing-standard", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "Hypercubers/hypercubing.xyz", + "SourceLicense": "MIT", + "SourceTrackId": "leaderboards", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist leaderboard/report contract target preserving event identity, time formatting, relative-date, and solver-profile semantics from the donor community site." + }, + "PreserveFactualElements": [ + "event naming and ids", + "format semantics", + "display-rule conventions" + ], + "RewriteRequiredElements": [ + "page title", + "all donor prose", + "all donor HTML or presentation output" + ], + "ContentSourceFile": "./raw-extracts/hypercubing-xyz-reference-pages.jsonl", + "MatchFilter": { + "source": "hypercubing.xyz", + "source_scope": "repo-backed", + "structure_template": "community-reference-page", + "family": "leaderboards", + "subset": null + }, + "MaterializationNotes": [ + "Preserve factual leaderboard contracts while rewriting community-reference copy into HyperTwist-native language.", + "This target pairs with the compiled Phase 3R-B leaderboard policy and event schema." + ] + }, + { + "ReferenceTargetId": "reference/apache-echarts-analytics-reference-page-session-outcome-and-progress", + "SurfaceType": "analytics-reference", + "TrackTitle": "Training Analytics", + "ItemTitle": "Session Outcome and Progress Reporting", + "IncorporationChannel": "analytics-report-contract", + "TargetAssetFamily": "dashboard-report", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "apache/echarts", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "analytics/session-outcome-balance", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist analytics contract target preserving bounded option, data-store, and outcome-reporting semantics from the retained echarts lane." + }, + "PreserveFactualElements": [ + "option and state layering", + "dataset separation", + "series-oriented outcome reporting" + ], + "RewriteRequiredElements": [ + "all donor source text", + "all donor component names", + "all donor shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", + "MatchFilter": { + "source": "apache/echarts", + "source_scope": "repo-backed", + "structure_template": "analytics-report-reference-page", + "family": "session-outcome-and-progress", + "subset": null + }, + "MaterializationNotes": [ + "Preserve the donor\u0027s option and dataset separation while rewriting the report contract in first-party HyperTwist analytics language.", + "This target pairs with the compiled Phase 3R-C analytics report bundle and runtime data-view helpers." + ] + }, + { + "ReferenceTargetId": "reference/apache-echarts-report-export-reference-page-data-view-and-export", + "SurfaceType": "report-export-reference", + "TrackTitle": "Training Analytics", + "ItemTitle": "Analytics Data View and Export", + "IncorporationChannel": "report-export-contract", + "TargetAssetFamily": "export-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "apache/echarts", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "analytics/export", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist analytics export target preserving bounded tabular data-view, image export, and SSR-ready reporting expectations from the retained echarts lane." + }, + "PreserveFactualElements": [ + "tabular data-view contract", + "image export behavior", + "SSR-ready report shell expectations" + ], + "RewriteRequiredElements": [ + "all donor UI wording", + "all donor shell framing", + "all donor implementation-specific presentation" + ], + "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", + "MatchFilter": { + "source": "apache/echarts", + "source_scope": "repo-backed", + "structure_template": "report-export-reference-page", + "family": "report-data-view-and-export", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded export and data-view semantics while rewriting the surfaced report shell and copy in first-party HyperTwist terms.", + "This target feeds the Phase 3R-C TSV data-view and accessible export layer, not a generic BI shell." + ] + }, + { + "ReferenceTargetId": "reference/apache-echarts-analytics-interaction-reference-page-timing-trend-history", + "SurfaceType": "analytics-interaction-reference", + "TrackTitle": "Training Analytics", + "ItemTitle": "Timing Trend History and Overview", + "IncorporationChannel": "analytics-interaction-contract", + "TargetAssetFamily": "interaction-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "apache/echarts", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "analytics/timing-trend-rolling-windows", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist timing-trend interaction target preserving bounded zoom-history, thumbnail overview, and rolling-window inspection semantics from the retained echarts lane." + }, + "PreserveFactualElements": [ + "history-aware zoom interactions", + "thumbnail overview behavior", + "windowed timing-trend inspection" + ], + "RewriteRequiredElements": [ + "all donor component wording", + "all donor UI text", + "all donor chart-shell presentation" + ], + "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", + "MatchFilter": { + "source": "apache/echarts", + "source_scope": "repo-backed", + "structure_template": "analytics-interaction-reference-page", + "family": "timing-trend-history", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded history and overview semantics while rewriting the actual interaction copy and report framing in first-party HyperTwist language.", + "This target pairs with the Phase 3R-C rolling-window timing report bundle." + ] + }, + { + "ReferenceTargetId": "reference/apache-echarts-analytics-explainer-reference-page-optional-3d-sidecar", + "SurfaceType": "analytics-explainer-reference", + "TrackTitle": "Training Analytics", + "ItemTitle": "Optional 3D Analytics Sidecar", + "IncorporationChannel": "analytics-sidecar-boundary", + "TargetAssetFamily": "explainer-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "apache/echarts", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "analytics/live-split-ladder", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist sidecar-boundary target preserving how optional richer explainers stay subordinate to the apache/echarts lane while bounded concepts from echarts-gl and zrender remain support-only." + }, + "PreserveFactualElements": [ + "optional 3D analytics sidecar boundary", + "camera and zoom helper behavior", + "subordinate 2D and GL renderer layering" + ], + "RewriteRequiredElements": [ + "all donor implementation text", + "all donor framework naming", + "all donor chart-shell presentation" + ], + "ContentSourceFile": "./raw-extracts/apache-echarts-reference-pages.jsonl", + "MatchFilter": { + "source": "apache/echarts", + "source_scope": "repo-backed", + "structure_template": "analytics-explainer-reference-page", + "family": "optional-3d-analytics-explainer", + "subset": null + }, + "MaterializationNotes": [ + "Preserve the subordinate-sidecar boundary while rewriting the actual explainer framing in first-party HyperTwist language.", + "This target keeps `ecomfe/echarts-gl` and `ecomfe/zrender` explicit as support-only beneath the landed `apache/echarts` lane." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-browser-viewer-reference-page-embed-contract", + "SurfaceType": "browser-viewer-reference", + "TrackTitle": "Browser Viewer and Asset QA", + "ItemTitle": "Browser Viewer Embed Contract", + "IncorporationChannel": "viewer-embed-contract", + "TargetAssetFamily": "support-widget", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "viewer/browser-viewer-embed", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser viewer target preserving bounded embed, camera, annotation, and readiness semantics from the retained model-viewer lane." + }, + "PreserveFactualElements": [ + "embeddable viewer lifecycle", + "camera and framing state", + "annotation and load-progress semantics" + ], + "RewriteRequiredElements": [ + "all donor docs and demo copy", + "all donor shell assumptions", + "all donor site framing" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer", + "source_scope": "repo-backed", + "structure_template": "browser-viewer-reference-page", + "family": "browser-viewer-embed", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded viewer, camera, and annotation semantics while rewriting the actual support-plane viewer shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-D browser viewer embed contract and runtime access layer." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-browser-editor-reference-page-compact-editor", + "SurfaceType": "browser-editor-reference", + "TrackTitle": "Browser Viewer and Asset QA", + "ItemTitle": "Compact Browser Editor and Inspection", + "IncorporationChannel": "viewer-editor-contract", + "TargetAssetFamily": "editor-panel", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/space-opera", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "viewer/compact-editor", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist compact editor target preserving bounded inspection, camera, hotspot, and preview-state semantics from the retained space-opera lane." + }, + "PreserveFactualElements": [ + "compact inspection state", + "camera settings behavior", + "hotspot authoring boundaries" + ], + "RewriteRequiredElements": [ + "all donor UI wording", + "all donor shell framing", + "all donor site-navigation assumptions" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer", + "source_scope": "repo-backed", + "structure_template": "browser-editor-reference-page", + "family": "compact-editor-and-inspection", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded compact editor and inspection semantics while rewriting the actual shell and copy in first-party HyperTwist language.", + "This target pairs with the compiled Phase 3R-D editor contract beneath the landed browser viewer lane." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-browser-export-reference-page-snippet-and-export", + "SurfaceType": "browser-export-reference", + "TrackTitle": "Browser Viewer and Asset QA", + "ItemTitle": "Snippet and Export Surface", + "IncorporationChannel": "viewer-export-contract", + "TargetAssetFamily": "export-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/modelviewer.dev", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "viewer/snippet-and-export", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist export target preserving bounded snippet, preview, and portable embed semantics from the retained modelviewer.dev and space-opera sidecars." + }, + "PreserveFactualElements": [ + "portable snippet generation", + "preview and export posture", + "single-source embed expectations" + ], + "RewriteRequiredElements": [ + "all donor docs copy", + "all donor example-shell framing", + "all donor tutorial wording" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer", + "source_scope": "repo-backed", + "structure_template": "browser-export-reference-page", + "family": "snippet-and-export", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded snippet and export semantics while rewriting the actual support-plane export shell in first-party HyperTwist language.", + "This target keeps docs/demo infrastructure subordinate while still surfacing snippet and portable-embed value." + ] + }, + { + "ReferenceTargetId": "reference/khronos-gltf-browser-qa-reference-page-validation-and-statistics", + "SurfaceType": "asset-qa-reference", + "TrackTitle": "Browser Viewer and Asset QA", + "ItemTitle": "Asset Validation and Statistics", + "IncorporationChannel": "asset-qa-contract", + "TargetAssetFamily": "qa-checklist", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "KhronosGroup/glTF-Sample-Viewer", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "qa/asset-validation-and-statistics", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist QA target preserving bounded validator, statistics, camera export, and failure-reporting semantics from the retained Khronos viewer lane." + }, + "PreserveFactualElements": [ + "validator and statistics boundary", + "standards-aware preview state", + "camera export and capture posture" + ], + "RewriteRequiredElements": [ + "all donor shell framing", + "all donor UI wording", + "all donor product assumptions" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", + "MatchFilter": { + "source": "KhronosGroup/glTF-Sample-Viewer", + "source_scope": "repo-backed", + "structure_template": "asset-qa-reference-page", + "family": "asset-validation-and-statistics", + "subset": null + }, + "MaterializationNotes": [ + "Preserve standards-aware validation and statistics semantics while rewriting the surfaced QA shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-D QA checks and keeps the Khronos lane subordinate to the landed viewer owner." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-renderer-comparison-reference-page-fidelity", + "SurfaceType": "renderer-comparison-reference", + "TrackTitle": "Browser Viewer and Asset QA", + "ItemTitle": "Renderer Comparison and Fidelity", + "IncorporationChannel": "renderer-comparison-contract", + "TargetAssetFamily": "regression-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/render-fidelity-tools", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "qa/renderer-comparison-and-fidelity", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist renderer-comparison target preserving bounded golden-result, delta, and threshold semantics from the retained render-fidelity-tools lane." + }, + "PreserveFactualElements": [ + "golden-result comparison", + "delta and threshold reporting", + "renderer parity discipline" + ], + "RewriteRequiredElements": [ + "all donor workflow text", + "all donor shell framing", + "all donor docs/demo wording" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer", + "source_scope": "repo-backed", + "structure_template": "renderer-comparison-reference-page", + "family": "renderer-comparison-and-fidelity", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded renderer-regression semantics while rewriting the surfaced comparison shell in first-party HyperTwist language.", + "This target keeps render-fidelity-tools subordinate to the landed viewer lane and the Khronos reference renderer." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-docs-boundary-reference-page-demo-separation", + "SurfaceType": "docs-boundary-reference", + "TrackTitle": "Browser Viewer and Asset QA", + "ItemTitle": "Docs and Demo Separation Boundary", + "IncorporationChannel": "docs-demo-boundary", + "TargetAssetFamily": "docs-boundary-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/modelviewer.dev", + "SourceLicense": "Apache-2.0", + "SourceTrackId": "viewer/docs-demo-separation", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist boundary target preserving snippet-to-demo infrastructure insights while keeping docs and demo shells explicitly outside the shippable viewer lane." + }, + "PreserveFactualElements": [ + "snippet-to-demo stamping", + "interactive docs support patterns", + "demo-only shell boundaries" + ], + "RewriteRequiredElements": [ + "all donor docs copy", + "all donor navigation framing", + "all donor example-site assumptions" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer", + "source_scope": "repo-backed", + "structure_template": "docs-boundary-reference-page", + "family": "docs-demo-separation", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded docs/demo separation semantics while rewriting the actual support copy and shell in first-party HyperTwist language.", + "This target keeps modelviewer.dev explicitly subordinate to the landed browser viewer lane." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-shared-assets-reference-page-allowlist", + "SurfaceType": "viewer-shared-asset-reference", + "TrackTitle": "Browser Viewer Shared Asset Fixtures", + "ItemTitle": "Shared-Asset Fixture Allowlist", + "IncorporationChannel": "fixture-allowlist", + "TargetAssetFamily": "qa-fixture-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/shared-assets", + "SourceLicense": "Apache-2.0 container; mixed per-asset terms", + "SourceTrackId": "shared-assets/allowlist-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist fixture-allowlist target preserving explicit ship-eligible, review-required, and local-only splits from the retained shared-assets lane." + }, + "PreserveFactualElements": [ + "explicit fixture allowlisting", + "ship-eligible versus review-required splits", + "fixture-family role beneath the browser viewer lane" + ], + "RewriteRequiredElements": [ + "all donor README wording", + "all donor docs and demo framing", + "all donor bundle-as-product assumptions" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer/packages/shared-assets", + "source_scope": "repo-backed", + "structure_template": "viewer-shared-asset-reference-page", + "family": "viewer-shared-assets", + "subset": "allowlist" + }, + "MaterializationNotes": [ + "Preserve explicit allowlist semantics while rewriting the surfaced fixture ledger in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-C shared-assets allowlist contract and prevents blanket mixed-asset shipping assumptions." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-shared-assets-lighting-reference-page-cc0-matrix", + "SurfaceType": "viewer-shared-asset-lighting-reference", + "TrackTitle": "Browser Viewer Shared Asset Fixtures", + "ItemTitle": "CC0 Environment Fixture Matrix", + "IncorporationChannel": "environment-fixture-matrix", + "TargetAssetFamily": "environment-fixture-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/shared-assets", + "SourceLicense": "Apache-2.0 container; mixed per-asset terms", + "SourceTrackId": "shared-assets/cc0-environment-matrix", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist environment-fixture target preserving the CC0 lighting families retained from shared-assets for browser viewer parity and regression workflows." + }, + "PreserveFactualElements": [ + "CC0 environment-lighting families", + "HDRI selection for lighting parity", + "outdoor versus indoor fixture coverage" + ], + "RewriteRequiredElements": [ + "all donor docs and demo wording", + "all donor fixture-browser assumptions", + "all donor product-shell framing" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer/packages/shared-assets", + "source_scope": "repo-backed", + "structure_template": "viewer-shared-asset-lighting-reference-page", + "family": "viewer-shared-assets-lighting", + "subset": "cc0-environments" + }, + "MaterializationNotes": [ + "Preserve the CC0 environment-fixture matrix while rewriting the surfaced QA shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-C shared-assets fixture bundle and keeps environment-fixture approval explicit." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-shared-assets-provenance-reference-page-review-boundary", + "SurfaceType": "viewer-shared-asset-provenance-reference", + "TrackTitle": "Browser Viewer Shared Asset Fixtures", + "ItemTitle": "Review-Required and Restricted Fixture Boundary", + "IncorporationChannel": "shipping-boundary", + "TargetAssetFamily": "compliance-boundary-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/shared-assets", + "SourceLicense": "Apache-2.0 container; mixed per-asset terms", + "SourceTrackId": "shared-assets/provenance-boundary", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist provenance target preserving review-required, notice-bound, and excluded fixture duties from the retained shared-assets lane." + }, + "PreserveFactualElements": [ + "CC-BY notice-bound fixtures", + "Smithsonian review-only terms", + "CC-BY-NC-SA local-only exclusion" + ], + "RewriteRequiredElements": [ + "all donor legal-shell wording beyond the preserved factual duties", + "all donor docs/demo framing", + "all donor blanket shipping assumptions" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer/packages/shared-assets", + "source_scope": "repo-backed", + "structure_template": "viewer-shared-asset-provenance-reference-page", + "family": "viewer-shared-assets-boundary", + "subset": "review-and-restricted" + }, + "MaterializationNotes": [ + "Preserve the per-asset provenance and review split while rewriting the surfaced compliance shell as first-party HyperTwist guidance.", + "This target pairs with the compiled Phase 4R-C provenance boundary and keeps review-only and excluded fixtures explicit." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-shared-assets-refresh-reference-page-pattern", + "SurfaceType": "viewer-shared-asset-refresh-reference", + "TrackTitle": "Browser Viewer Shared Asset Fixtures", + "ItemTitle": "Fixture Refresh and Attribution Recheck Pattern", + "IncorporationChannel": "fixture-refresh-pattern", + "TargetAssetFamily": "refresh-pattern-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/shared-assets", + "SourceLicense": "Apache-2.0 container; mixed per-asset terms", + "SourceTrackId": "shared-assets/refresh-pattern", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist refresh-pattern target preserving the shared-assets fixture sync and attribution recheck workflow without automatic allowlist widening." + }, + "PreserveFactualElements": [ + "reproducible fixture refresh pattern", + "attribution recheck discipline", + "sample-sync workflow" + ], + "RewriteRequiredElements": [ + "all donor shell wording", + "all donor automation assumptions beyond the preserved refresh steps", + "all donor docs/demo framing" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer/packages/shared-assets", + "source_scope": "repo-backed", + "structure_template": "viewer-shared-asset-refresh-reference-page", + "family": "viewer-shared-assets-refresh", + "subset": "refresh-pattern" + }, + "MaterializationNotes": [ + "Preserve the fixture refresh pattern while rewriting the surfaced sync checklist in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-C refresh pattern and keeps attribution rechecks mandatory." + ] + }, + { + "ReferenceTargetId": "reference/google-model-viewer-shared-assets-geometry-reference-page-smoke-tests", + "SurfaceType": "viewer-shared-asset-geometry-reference", + "TrackTitle": "Browser Viewer Shared Asset Fixtures", + "ItemTitle": "Contributed Geometry Smoke-Test Boundary", + "IncorporationChannel": "geometry-smoke-test-boundary", + "TargetAssetFamily": "geometry-fixture-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "google/model-viewer/packages/shared-assets", + "SourceLicense": "Apache-2.0 container; mixed per-asset terms", + "SourceTrackId": "shared-assets/contributed-geometry", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist geometry-fixture target preserving contributed smoke-test assets as bounded parsing and framing fixtures while keeping per-asset review duties explicit." + }, + "PreserveFactualElements": [ + "small geometry smoke-test families", + "parser and framing fixtures", + "contributor-noted provenance boundary" + ], + "RewriteRequiredElements": [ + "all donor product-shell framing", + "all donor sample-browser wording", + "all donor blanket shipping assumptions" + ], + "ContentSourceFile": "./raw-extracts/google-model-viewer-shared-assets-reference-pages.jsonl", + "MatchFilter": { + "source": "google/model-viewer/packages/shared-assets", + "source_scope": "repo-backed", + "structure_template": "viewer-shared-asset-geometry-reference-page", + "family": "viewer-shared-assets-geometry", + "subset": "contributed-geometry" + }, + "MaterializationNotes": [ + "Preserve parsing and framing smoke-test value while rewriting the surfaced fixture boundary in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-C geometry review boundary and keeps contributor-noted assets out of the blanket shipping lane." + ] + }, + { + "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-reference-page-narration", + "SurfaceType": "companion-reference", + "TrackTitle": "Embodied Companion and Narrated Coaching", + "ItemTitle": "Embodied Companion Narration", + "IncorporationChannel": "narration-contract", + "TargetAssetFamily": "companion-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "met4citizen/TalkingHead", + "SourceLicense": "MIT", + "SourceTrackId": "companion/narration-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist narration target preserving queued coach speech, subtitle timing, viseme alignment, and gesture-aware companion presentation from the retained TalkingHead lane." + }, + "PreserveFactualElements": [ + "queued speech lifecycle", + "subtitle timing", + "viseme alignment", + "gesture and mood cues" + ], + "RewriteRequiredElements": [ + "all donor example-shell framing", + "all donor vendor-specific copy", + "all donor avatar-demo wording" + ], + "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", + "MatchFilter": { + "source": "met4citizen/TalkingHead", + "source_scope": "repo-backed", + "structure_template": "embodied-companion-reference-page", + "family": "embodied-companion-narration", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded coach narration semantics while rewriting the actual companion shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-E narration contract and runtime access layer." + ] + }, + { + "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-subtitle-reference-page-sync", + "SurfaceType": "companion-subtitle-reference", + "TrackTitle": "Embodied Companion and Narrated Coaching", + "ItemTitle": "Subtitle and Viseme Synchronization", + "IncorporationChannel": "subtitle-sync-contract", + "TargetAssetFamily": "subtitle-checklist", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "met4citizen/TalkingHead", + "SourceLicense": "MIT", + "SourceTrackId": "companion/subtitle-and-viseme-sync", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist subtitle target preserving bounded caption timing, marker sync, and viseme-envelope behavior from the retained TalkingHead lane." + }, + "PreserveFactualElements": [ + "word-level subtitle cues", + "marker sync", + "blendshape viseme envelopes" + ], + "RewriteRequiredElements": [ + "all donor UI wording", + "all donor demo captions", + "all donor tutorial framing" + ], + "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", + "MatchFilter": { + "source": "met4citizen/TalkingHead", + "source_scope": "repo-backed", + "structure_template": "companion-subtitle-reference-page", + "family": "subtitle-and-viseme-sync", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded subtitle and viseme timing semantics while rewriting the surfaced cue shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 3R-E subtitle and viseme reference bundle." + ] + }, + { + "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-avatar-reference-page-embed", + "SurfaceType": "companion-avatar-reference", + "TrackTitle": "Embodied Companion and Narrated Coaching", + "ItemTitle": "Avatar-Only Embed Contract", + "IncorporationChannel": "avatar-embed-contract", + "TargetAssetFamily": "embed-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "met4citizen/TalkingHead", + "SourceLicense": "MIT", + "SourceTrackId": "companion/avatar-only-embed", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist embed target preserving bounded external-scene avatar composition, retargeting, and camera-safe companion presence from the retained TalkingHead lane." + }, + "PreserveFactualElements": [ + "external scene embedding", + "camera-safe avatar composition", + "retargeted motion and pose" + ], + "RewriteRequiredElements": [ + "all donor asset assumptions", + "all donor demo shell framing", + "all donor avatar picker UX" + ], + "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", + "MatchFilter": { + "source": "met4citizen/TalkingHead", + "source_scope": "repo-backed", + "structure_template": "companion-avatar-reference-page", + "family": "avatar-only-embedding", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded avatar-only embedding semantics while rewriting the actual companion scene shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-E avatar embed contract." + ] + }, + { + "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-gesture-reference-page-presets", + "SurfaceType": "companion-gesture-reference", + "TrackTitle": "Embodied Companion and Narrated Coaching", + "ItemTitle": "Gesture, Mood, and Pose Surface", + "IncorporationChannel": "gesture-mood-contract", + "TargetAssetFamily": "gesture-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "met4citizen/TalkingHead", + "SourceLicense": "MIT", + "SourceTrackId": "companion/gesture-mood-and-pose", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist gesture target preserving bounded coach acknowledgement, focus-callout, celebration, and mood-switching semantics from the retained TalkingHead lane." + }, + "PreserveFactualElements": [ + "gesture presets", + "mood switching", + "coach-facing pose cues" + ], + "RewriteRequiredElements": [ + "all donor animation-demo framing", + "all donor shell wording", + "all donor example choreography copy" + ], + "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", + "MatchFilter": { + "source": "met4citizen/TalkingHead", + "source_scope": "repo-backed", + "structure_template": "companion-gesture-reference-page", + "family": "gesture-mood-and-pose", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded gesture, mood, and pose semantics while rewriting the actual coach-presence shell in first-party HyperTwist language.", + "This target keeps expressive presentation inside the embodied companion lane rather than spreading it into unrelated owners." + ] + }, + { + "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-listening-reference-page-lifecycle", + "SurfaceType": "companion-listening-reference", + "TrackTitle": "Embodied Companion and Narrated Coaching", + "ItemTitle": "Streaming and Listening Lifecycle", + "IncorporationChannel": "listening-lifecycle-contract", + "TargetAssetFamily": "listening-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "met4citizen/TalkingHead", + "SourceLicense": "MIT", + "SourceTrackId": "companion/streaming-and-listening-lifecycle", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist listening target preserving bounded streaming playback, queue underrun handling, and microphone threshold-gating semantics from the retained TalkingHead lane." + }, + "PreserveFactualElements": [ + "audio stream buffering", + "queue underrun handling", + "listening thresholds", + "microphone handoff" + ], + "RewriteRequiredElements": [ + "all donor vendor tutorial text", + "all donor example shell framing", + "all donor microphone-demo wording" + ], + "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", + "MatchFilter": { + "source": "met4citizen/TalkingHead", + "source_scope": "repo-backed", + "structure_template": "companion-listening-reference-page", + "family": "streaming-and-listening-lifecycle", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded streaming and listening semantics while rewriting the surfaced audio and microphone shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-E queue lifecycle and listening contract surfaces." + ] + }, + { + "ReferenceTargetId": "reference/met4citizen-talkinghead-companion-boundary-reference-page-adapter", + "SurfaceType": "companion-boundary-reference", + "TrackTitle": "Embodied Companion and Narrated Coaching", + "ItemTitle": "TTS and Asset Adapter Boundary", + "IncorporationChannel": "vendor-adapter-boundary", + "TargetAssetFamily": "boundary-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "met4citizen/TalkingHead", + "SourceLicense": "MIT", + "SourceTrackId": "companion/tts-and-asset-adapter-boundary", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist boundary target preserving configurable TTS, JWT, avatar, and streaming seams while keeping donor examples and sample assets explicitly outside the shipped companion lane." + }, + "PreserveFactualElements": [ + "replaceable voice-service fields", + "asset-seam boundaries", + "demo-only shell separation" + ], + "RewriteRequiredElements": [ + "all donor vendor branding", + "all donor example copy", + "all donor sample-asset assumptions" + ], + "ContentSourceFile": "./raw-extracts/met4citizen-talkinghead-reference-pages.jsonl", + "MatchFilter": { + "source": "met4citizen/TalkingHead", + "source_scope": "repo-backed", + "structure_template": "companion-boundary-reference-page", + "family": "tts-and-asset-adapter-boundary", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded TTS and asset-adapter semantics while rewriting the surfaced configuration shell in first-party HyperTwist language.", + "This target keeps sample avatars, vendor wiring, and donor examples subordinate to the landed companion owner." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-scene-reference-page-stack", + "SurfaceType": "browser-spatial-scene-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "Browser Spatial Scene and Renderer Contract", + "IncorporationChannel": "browser-spatial-scene-contract", + "TargetAssetFamily": "scene-contract-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "mrdoob/three.js", + "SourceLicense": "MIT", + "SourceTrackId": "spatial/scene-substrate", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser spatial scene target preserving bounded three.js and react-three-fiber renderer, camera, frameloop, and WebXR-manager semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "scene and renderer lifecycle", + "camera and raycaster binding", + "frameloop invalidation", + "WebXR manager integration" + ], + "RewriteRequiredElements": [ + "all donor editor shell framing", + "all donor docs or demo wording", + "all donor example chrome" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "mrdoob/three.js", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-scene-reference-page", + "family": "browser-spatial-scene-substrate", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded browser scene and renderer semantics while rewriting the surfaced integration contract in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-F browser spatial scene contract and runtime access layer." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-react-reference-page-renderer", + "SurfaceType": "browser-spatial-react-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "React Scene Renderer and Event Bridge", + "IncorporationChannel": "browser-spatial-react-contract", + "TargetAssetFamily": "renderer-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "pmndrs/react-three-fiber", + "SourceLicense": "MIT", + "SourceTrackId": "spatial/react-renderer", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser spatial renderer target preserving bounded React canvas-root, event-manager, and camera-store bridge semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "canvas root configuration", + "event-manager bridge", + "pointer and raycaster routing", + "camera or store lifecycle" + ], + "RewriteRequiredElements": [ + "all donor docs or demo wording", + "all donor example framing", + "all donor package-marketing copy" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "pmndrs/react-three-fiber", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-react-reference-page", + "family": "browser-spatial-react-renderer", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded React renderer semantics while rewriting the surfaced browser spatial shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 3R-F browser spatial scene contract." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-xr-reference-page-session", + "SurfaceType": "browser-spatial-xr-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "Browser XR Session and Immersive Interaction Contract", + "IncorporationChannel": "browser-spatial-xr-contract", + "TargetAssetFamily": "xr-contract-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "pmndrs/xr", + "SourceLicense": "MIT", + "SourceTrackId": "spatial/xr-session-store", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser XR target preserving bounded session-store, controller or hand input, pointer-routing, and immersive interaction semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "XR store lifecycle", + "controller, hand, and gaze inputs", + "session visibility and origin management", + "pointer routing and immersive interaction" + ], + "RewriteRequiredElements": [ + "all donor showroom framing", + "all donor docs wording", + "all donor sample-app chrome" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "pmndrs/xr", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-xr-reference-page", + "family": "browser-spatial-xr-session", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded browser XR semantics while rewriting the immersive-support shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 3R-F XR session contract and runtime access layer." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-ui-reference-page-panels", + "SurfaceType": "browser-spatial-ui-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "Browser Spatial UI and World-Anchored Controls", + "IncorporationChannel": "browser-spatial-ui-contract", + "TargetAssetFamily": "spatial-ui-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "pmndrs/uikit", + "SourceLicense": "MIT", + "SourceTrackId": "spatial/world-anchored-ui", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser spatial UI target preserving bounded instanced-panel, text-input, and world-anchored control semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "instanced panels", + "world-anchored control families", + "text and input surfaces", + "themeable spatial UI kits" + ], + "RewriteRequiredElements": [ + "all donor dashboard framing", + "all donor example wording", + "all donor theme-kit copy" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "pmndrs/uikit", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-ui-reference-page", + "family": "browser-spatial-ui", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded spatial UI semantics while rewriting the surfaced world-anchored control shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-F spatial UI contract." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-effect-reference-page-boundary", + "SurfaceType": "browser-spatial-effect-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "Browser Post-Processing and Effect Boundary", + "IncorporationChannel": "browser-spatial-effect-boundary", + "TargetAssetFamily": "effect-boundary-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "pmndrs/postprocessing", + "SourceLicense": "Zlib", + "SourceTrackId": "spatial/effect-composer", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser effect target preserving bounded effect-composer, pass-orchestration, and render-priority semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "effect composer lifecycle", + "pass ordering and grouping", + "depth and normal pass orchestration", + "render-priority driven effect routing" + ], + "RewriteRequiredElements": [ + "all donor effect-gallery wording", + "all donor docs framing", + "all donor demo-shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "pmndrs/postprocessing", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-effect-reference-page", + "family": "browser-spatial-effects", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded post-processing semantics while rewriting the surfaced effect policy in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 3R-F effect boundary." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-helper-reference-page-stack", + "SurfaceType": "browser-spatial-helper-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "Browser Spatial Helper and Utility Stack", + "IncorporationChannel": "browser-spatial-helper-stack", + "TargetAssetFamily": "helper-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "pmndrs/drei", + "SourceLicense": "MIT", + "SourceTrackId": "spatial/helper-primitives", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist helper target preserving bounded view, HTML overlay, controller-helper, and motion-friendly math semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "scissored view embedding", + "HTML overlay bridging", + "XR controller model helpers", + "damping and easing helpers" + ], + "RewriteRequiredElements": [ + "all donor helper-demo wording", + "all donor example framing", + "all donor sample-shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "pmndrs/drei", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-helper-reference-page", + "family": "browser-spatial-helpers", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded helper and utility semantics while rewriting the surfaced integration shell in first-party HyperTwist terms.", + "This target keeps helper abstractions subordinate to the landed 3R-F spatial support lane." + ] + }, + { + "ReferenceTargetId": "reference/browser-spatial-state-reference-page-stack", + "SurfaceType": "browser-spatial-state-reference", + "TrackTitle": "Browser 3D and XR Support", + "ItemTitle": "Browser Spatial State, Gesture, and Motion Contract", + "IncorporationChannel": "browser-spatial-state-motion-contract", + "TargetAssetFamily": "state-motion-note", + "PuzzleFamily": "Other", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "pmndrs/zustand", + "SourceLicense": "MIT", + "SourceTrackId": "spatial/state-gesture-motion", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist browser state target preserving bounded store, gesture-routing, spring-motion, and parameter-control semantics from the retained 3R-F lane." + }, + "PreserveFactualElements": [ + "lightweight store lifecycle", + "gesture composition and routing", + "spring-based motion and interpolation", + "schema-driven parameter controls" + ], + "RewriteRequiredElements": [ + "all donor playground wording", + "all donor demo framing", + "all donor package-marketing copy" + ], + "ContentSourceFile": "./raw-extracts/browser-spatial-support-reference-pages.jsonl", + "MatchFilter": { + "source": "pmndrs/zustand", + "source_scope": "repo-backed", + "structure_template": "browser-spatial-state-reference-page", + "family": "browser-spatial-state-motion", + "subset": null + }, + "MaterializationNotes": [ + "Preserve bounded state, gesture, and motion semantics while rewriting the surfaced control shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 3R-F state and motion contract." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-semantic-reference-page-stack", + "SurfaceType": "classic-cubing-semantic-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Classic-Cubing Semantic and State Contract", + "IncorporationChannel": "semantic-contract", + "TargetAssetFamily": "semantic-contract-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/semantic-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist semantic target preserving KPuzzle, transformation, notation, and binary interop semantics from cubing.js through the practical MPL-side adapter lane." + }, + "PreserveFactualElements": [ + "KPuzzle definitions", + "pattern and transformation semantics", + "notation interoperability", + "binary or Twizzle protocol translation" + ], + "RewriteRequiredElements": [ + "all donor docs or demo wording", + "all donor app-shell assumptions", + "all donor product-shell copy" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-semantic-reference-page", + "family": "classic-cubing-semantics", + "subset": "kpuzzle-state" + }, + "MaterializationNotes": [ + "Preserve factual classic-cubing state and interop semantics while rewriting the surfaced shell as first-party HyperTwist contract language.", + "This target pairs with the compiled Phase 4R-A semantic contract and runtime access layer." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-geometry-reference-page-stack", + "SurfaceType": "classic-cubing-geometry-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Classic-Cubing Geometry and Named Puzzle Contract", + "IncorporationChannel": "geometry-contract", + "TargetAssetFamily": "geometry-contract-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/geometry-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist geometry target preserving named-puzzle resolution, description parsing, and geometry-backed construction semantics from cubing.js beneath the MPL-aware classic-cubing lane." + }, + "PreserveFactualElements": [ + "named puzzle resolution", + "description-string parsing", + "PGNotation mapping", + "geometry-backed puzzle construction" + ], + "RewriteRequiredElements": [ + "all donor geometry-demo wording", + "all donor browser-shell framing", + "all donor puzzle-browser copy" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-geometry-reference-page", + "family": "classic-cubing-geometry", + "subset": "named-puzzle-and-geometry" + }, + "MaterializationNotes": [ + "Preserve named-puzzle and geometry semantics while rewriting the surfaced adapter shell in first-party HyperTwist terms.", + "This target pairs with the compiled Phase 4R-A geometry contract and keeps hyper-runtime ownership outside the cubing.js lane." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-viewer-reference-page-stack", + "SurfaceType": "classic-cubing-viewer-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Classic-Cubing Viewer, Player, and Editor Adapter", + "IncorporationChannel": "viewer-adapter-contract", + "TargetAssetFamily": "viewer-adapter-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/viewer-adapter-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist viewer target preserving embedded TwistyPlayer, algorithm-editor, and indexer semantics from cubing.js through a bounded MPL-side adapter lane." + }, + "PreserveFactualElements": [ + "TwistyPlayer embedding", + "algorithm viewer and editor surfaces", + "indexer behavior", + "puzzle-switching configuration" + ], + "RewriteRequiredElements": [ + "all donor Twizzle shell wording", + "all donor docs/demo framing", + "all donor app-shell chrome" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-viewer-reference-page", + "family": "classic-cubing-viewer-adapter", + "subset": "twisty-player-and-editor" + }, + "MaterializationNotes": [ + "Preserve bounded viewer and editor semantics while rewriting the surfaced playback shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-A viewer-adapter contract and does not replace the separate twisty.js clean-room lane." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-device-reference-page-boundary", + "SurfaceType": "classic-cubing-device-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Classic-Cubing Smart-Device and Protocol Adapter Boundary", + "IncorporationChannel": "device-adapter-boundary", + "TargetAssetFamily": "device-boundary-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/device-adapter-boundary", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist smart-device boundary target preserving connector families, timer or robot entry points, and binary protocol semantics from cubing.js beneath owned HyperTwist device flows." + }, + "PreserveFactualElements": [ + "smart puzzle connector families", + "smart timer and smart robot entry points", + "keyboard puzzle surface", + "protocol translation helpers" + ], + "RewriteRequiredElements": [ + "all donor pairing-shell wording", + "all donor vendor UI framing", + "all donor example-shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-device-reference-page", + "family": "classic-cubing-device-boundary", + "subset": "bluetooth-and-protocol" + }, + "MaterializationNotes": [ + "Preserve bounded smart-device and protocol semantics while rewriting the surfaced device shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-A device-adapter boundary and keeps vendor policy first-party." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-search-reference-page-stack", + "SurfaceType": "classic-cubing-search-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Classic-Cubing Search, Scramble, and Solve-Helper Contract", + "IncorporationChannel": "search-contract", + "TargetAssetFamily": "search-contract-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/search-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist search target preserving bounded solve-helper, random-state, and scramble-routing semantics from cubing.js while keeping retained solver benchmarks separate." + }, + "PreserveFactualElements": [ + "random-state helpers", + "solve-helper entry points", + "puzzle-kind dispatch", + "scramble export surface" + ], + "RewriteRequiredElements": [ + "all donor solver-shell wording", + "all donor docs/demo framing", + "all donor example-shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-search-reference-page", + "family": "classic-cubing-search", + "subset": "search-and-scramble" + }, + "MaterializationNotes": [ + "Preserve bounded search and scramble semantics while rewriting the surfaced solve-helper shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-A search contract and keeps retained solver benchmarks as separate validation authorities." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-bridge-reference-page-melinda", + "SurfaceType": "classic-cubing-bridge-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Melinda 2x2x2x2 Bridge Boundary", + "IncorporationChannel": "melinda-bridge-boundary", + "TargetAssetFamily": "bridge-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/geometry-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist bridge target preserving Melinda 2x2x2x2 registry and loader semantics from cubing.js while keeping hyper-runtime and clean-room ownership separate." + }, + "PreserveFactualElements": [ + "Melinda puzzle registration", + "bounded loader semantics", + "bridge-family naming", + "non-hyper runtime separation" + ], + "RewriteRequiredElements": [ + "all donor puzzle-browser wording", + "all donor demo framing", + "all donor product-shell copy" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-bridge-reference-page", + "family": "classic-cubing-melinda-bridge", + "subset": "melindas-2x2x2x2" + }, + "MaterializationNotes": [ + "Preserve the bounded Melinda bridge semantics while rewriting the surfaced shell in first-party HyperTwist language.", + "This target keeps the bridge explicit without collapsing the separate clean-room and hyper-runtime lanes." + ] + }, + { + "ReferenceTargetId": "reference/cubing-cubing-js-compliance-reference-page-boundary", + "SurfaceType": "classic-cubing-compliance-reference", + "TrackTitle": "Classic Cubing Semantics and Runtime", + "ItemTitle": "Classic-Cubing MPL Adapter and Notice Boundary", + "IncorporationChannel": "mpl-compliance-boundary", + "TargetAssetFamily": "compliance-boundary-note", + "PuzzleFamily": "ClassicCube", + "NotationProfile": "classic-wca", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cubing/cubing.js", + "SourceLicense": "MPL-2.0 OR GPL-3.0-or-later", + "SourceTrackId": "classic-cubing/mpl-compliance-boundary", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist compliance target preserving the practical MPL-side library-use posture and source-file modification duties documented by cubing.js." + }, + "PreserveFactualElements": [ + "MPL-side library-use posture", + "source-file modification publication duty", + "license-material retention", + "vendored acknowledgement preservation" + ], + "RewriteRequiredElements": [ + "all donor README wording", + "all donor docs/demo framing", + "all donor product-shell copy" + ], + "ContentSourceFile": "./raw-extracts/cubing-cubing-js-reference-pages.jsonl", + "MatchFilter": { + "source": "cubing/cubing.js", + "source_scope": "repo-backed", + "structure_template": "classic-cubing-compliance-reference-page", + "family": "classic-cubing-mpl-boundary", + "subset": "compliance-and-notices" + }, + "MaterializationNotes": [ + "Preserve the MPL-side compliance boundary while rewriting the surfaced legal and packaging shell as first-party HyperTwist guidance.", + "This target pairs with the compiled Phase 4R-A compliance boundary and keeps the no-private-fork posture explicit." + ] + }, + { + "ReferenceTargetId": "reference/cutelyaware-magiccube4d-history-reference-page-stack", + "SurfaceType": "legacy-4d-history-reference", + "TrackTitle": "Legacy 4D Interaction and History", + "ItemTitle": "Legacy 4D History, Marks, and Save-Restore Contract", + "IncorporationChannel": "history-contract", + "TargetAssetFamily": "history-contract-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cutelyaware/magiccube4d", + "SourceLicense": "Custom permissive attribution-request license", + "SourceTrackId": "legacy-4d/history-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist history target preserving move-log, marks, macro brackets, undo-redo traversal, and save-restore semantics from MagicCube4D beneath owned higher-dimensional history flows." + }, + "PreserveFactualElements": [ + "history nodes", + "mark delimiters", + "macro brackets", + "undo redo traversal", + "save restore log semantics" + ], + "RewriteRequiredElements": [ + "all donor Swing shell wording", + "all donor menu and file-dialog framing", + "all donor legacy UI-state assumptions" + ], + "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", + "MatchFilter": { + "source": "cutelyaware/magiccube4d", + "source_scope": "repo-backed", + "structure_template": "legacy-4d-history-reference-page", + "family": "legacy-4d-history", + "subset": "move-log-and-marks" + }, + "MaterializationNotes": [ + "Preserve history, mark, macro-boundary, and replay semantics while rewriting the surfaced history shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-B history contract and keeps the higher-dimensional history lane beneath the Hyperspeedcube anchor." + ] + }, + { + "ReferenceTargetId": "reference/cutelyaware-magiccube4d-macro-reference-page-stack", + "SurfaceType": "legacy-4d-macro-reference", + "TrackTitle": "Legacy 4D Interaction and History", + "ItemTitle": "Legacy 4D Macro Remapping and Reversal Contract", + "IncorporationChannel": "macro-contract", + "TargetAssetFamily": "macro-contract-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cutelyaware/magiccube4d", + "SourceLicense": "Custom permissive attribution-request license", + "SourceTrackId": "legacy-4d/macro-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist macro target preserving reference-grip remapping, 4D transform application, reversal, and playback semantics from MagicCube4D beneath owned higher-dimensional teaching flows." + }, + "PreserveFactualElements": [ + "reference grips", + "4D transform remapping", + "closest-grip remap", + "macro reversal", + "macro serialization" + ], + "RewriteRequiredElements": [ + "all donor macro-editor wording", + "all donor file-format lock-in assumptions", + "all donor menu-shell choreography" + ], + "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", + "MatchFilter": { + "source": "cutelyaware/magiccube4d", + "source_scope": "repo-backed", + "structure_template": "legacy-4d-macro-reference-page", + "family": "legacy-4d-macro", + "subset": "reference-grip-remapping" + }, + "MaterializationNotes": [ + "Preserve macro remapping and reversal semantics while rewriting the surfaced authoring shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-B macro contract and keeps higher-dimensional macro playback first-party." + ] + }, + { + "ReferenceTargetId": "reference/cutelyaware-magiccube4d-puzzle-description-reference-page-stack", + "SurfaceType": "legacy-4d-puzzle-description-reference", + "TrackTitle": "Legacy 4D Interaction and History", + "ItemTitle": "Legacy 4D Puzzle Description and Topology Contract", + "IncorporationChannel": "puzzle-description-contract", + "TargetAssetFamily": "puzzle-description-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cutelyaware/magiccube4d", + "SourceLicense": "Custom permissive attribution-request license", + "SourceTrackId": "legacy-4d/puzzle-description-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist topology target preserving generic polytope slicing, Schlafli-product puzzle parsing, and grip-sticker-face relationships from MagicCube4D without displacing the Hyperspeedcube runtime anchor." + }, + "PreserveFactualElements": [ + "Schlafli product parsing", + "polytope slicing", + "grip to face mapping", + "face cut offsets", + "sticker and cubie relationships" + ], + "RewriteRequiredElements": [ + "all donor applet-shell wording", + "all donor TODO and issue-list narration", + "all donor legacy configuration shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", + "MatchFilter": { + "source": "cutelyaware/magiccube4d", + "source_scope": "repo-backed", + "structure_template": "legacy-4d-puzzle-description-reference-page", + "family": "legacy-4d-puzzle-description", + "subset": "generic-polytope-slicing" + }, + "MaterializationNotes": [ + "Preserve generic puzzle-description and topology semantics while rewriting the surfaced adapter shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-B topology contract and does not replace the Hyperspeedcube runtime anchor." + ] + }, + { + "ReferenceTargetId": "reference/cutelyaware-magiccube4d-interaction-reference-page-stack", + "SurfaceType": "legacy-4d-interaction-reference", + "TrackTitle": "Legacy 4D Interaction and History", + "ItemTitle": "Legacy 4D Interaction, Picking, and Animation Contract", + "IncorporationChannel": "interaction-contract", + "TargetAssetFamily": "interaction-contract-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cutelyaware/magiccube4d", + "SourceLicense": "Custom permissive attribution-request license", + "SourceTrackId": "legacy-4d/interaction-contract", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist interaction target preserving 4D rotation grammar, snap behavior, sticker picking, highlight state, slice masks, and animation-queue semantics from MagicCube4D beneath owned higher-dimensional interaction flows." + }, + "PreserveFactualElements": [ + "4D view matrix state", + "snap to center semantics", + "spin continuation", + "sticker picking and highlighting", + "slice mask and animation queue" + ], + "RewriteRequiredElements": [ + "all donor Swing event-shell wording", + "all donor component lifecycle assumptions", + "all donor property-manager framing" + ], + "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", + "MatchFilter": { + "source": "cutelyaware/magiccube4d", + "source_scope": "repo-backed", + "structure_template": "legacy-4d-interaction-reference-page", + "family": "legacy-4d-interaction", + "subset": "rotation-and-drag-grammar" + }, + "MaterializationNotes": [ + "Preserve rotation grammar, picking, highlighting, slice-mask, and animation semantics while rewriting the surfaced interaction shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-B interaction contract and keeps higher-dimensional runtime ownership outside the donor shell." + ] + }, + { + "ReferenceTargetId": "reference/cutelyaware-magiccube4d-view-reference-page-stack", + "SurfaceType": "legacy-4d-view-reference", + "TrackTitle": "Legacy 4D Interaction and History", + "ItemTitle": "Legacy 4D View Controller Composition Reference", + "IncorporationChannel": "view-controller-reference", + "TargetAssetFamily": "view-controller-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cutelyaware/magiccube4d", + "SourceLicense": "Custom permissive attribution-request license", + "SourceTrackId": "legacy-4d/view", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist view-controller reference preserving listener callbacks, queued move animation, motion-aware highlight refresh, and safe input routing from MagicCube4D without carrying over the Swing shell." + }, + "PreserveFactualElements": [ + "viewer controller composition", + "listener callbacks", + "queued move animation", + "motion-aware highlight refresh", + "component-safe input routing" + ], + "RewriteRequiredElements": [ + "all donor Swing component wording", + "all donor applet and panel framing", + "all donor Java event-thread assumptions" + ], + "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", + "MatchFilter": { + "source": "cutelyaware/magiccube4d", + "source_scope": "repo-backed", + "structure_template": "legacy-4d-view-reference-page", + "family": "legacy-4d-view-controller", + "subset": "viewer-composition" + }, + "MaterializationNotes": [ + "Preserve view-controller composition semantics while rewriting the surfaced component shell in first-party HyperTwist language.", + "This target keeps the interaction composition value explicit without promoting the donor Swing shell into HyperTwist ownership." + ] + }, + { + "ReferenceTargetId": "reference/cutelyaware-magiccube4d-attribution-reference-page-boundary", + "SurfaceType": "legacy-4d-attribution-reference", + "TrackTitle": "Legacy 4D Interaction and History", + "ItemTitle": "Legacy 4D Attribution and Provenance Boundary", + "IncorporationChannel": "attribution-boundary", + "TargetAssetFamily": "compliance-boundary-note", + "PuzzleFamily": "Hypercube", + "NotationProfile": "family-specific", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "cutelyaware/magiccube4d", + "SourceLicense": "Custom permissive attribution-request license", + "SourceTrackId": "legacy-4d/attribution-boundary", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist compliance target preserving visible attribution, required upstream link, notice retention, and the MyMath provenance caveat from MagicCube4D." + }, + "PreserveFactualElements": [ + "custom attribution-request license posture", + "required upstream link", + "copyright and notice retention", + "MyMath provenance caveat" + ], + "RewriteRequiredElements": [ + "all donor legal-shell wording beyond the preserved factual duties", + "all donor packaging assumptions", + "all donor UI placement assumptions" + ], + "ContentSourceFile": "./raw-extracts/cutelyaware-magiccube4d-reference-pages.jsonl", + "MatchFilter": { + "source": "cutelyaware/magiccube4d", + "source_scope": "repo-backed", + "structure_template": "legacy-4d-attribution-reference-page", + "family": "legacy-4d-attribution", + "subset": "license-and-provenance" + }, + "MaterializationNotes": [ + "Preserve the attribution and provenance boundary while rewriting the surfaced compliance shell as first-party HyperTwist guidance.", + "This target pairs with the compiled Phase 4R-B attribution boundary and keeps the upstream link and MyMath provenance note explicit." + ] + }, + { + "ReferenceTargetId": "reference/posthog-replay-diagnostics-reference-page", + "SurfaceType": "control-plane-replay-diagnostic-reference", + "TrackTitle": "Control-Plane Telemetry and Replay Governance", + "ItemTitle": "Replay Diagnostic Signals and Verdicts", + "IncorporationChannel": "replay-diagnostic-contract", + "TargetAssetFamily": "replay-diagnostic-note", + "PuzzleFamily": "CrossCutting", + "NotationProfile": "supporting", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "PostHog/posthog", + "SourceLicense": "MIT outside ee/; enterprise license inside ee/", + "SourceTrackId": "control-plane/replay-diagnostics", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist replay-diagnostic target preserving recording-state signals, trigger states, verdict taxonomy, and missing-recording review posture from PostHog replay surfaces while keeping ee/ excluded." + }, + "PreserveFactualElements": [ + "recording-state diagnostic properties", + "trigger and sampling verdict taxonomy", + "buffer and flush state interpretation", + "operator-facing troubleshooting actions" + ], + "RewriteRequiredElements": [ + "all PostHog product-shell wording", + "all PostHog web analytics framing", + "all direct session-recording UI composition assumptions" + ], + "ContentSourceFile": "./raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl", + "MatchFilter": { + "source": "PostHog/posthog", + "source_scope": "repo-backed", + "structure_template": "control-plane-replay-diagnostic-reference-page", + "family": "control-plane-replay", + "subset": "diagnostic-signals" + }, + "MaterializationNotes": [ + "Preserve replay diagnostic signals and verdicts while rewriting the surfaced troubleshooting shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-D replay-diagnostic contract and keeps ee/ replay surfaces excluded." + ] + }, + { + "ReferenceTargetId": "reference/posthog-replay-segmentation-reference-page", + "SurfaceType": "control-plane-replay-segmentation-reference", + "TrackTitle": "Control-Plane Telemetry and Replay Governance", + "ItemTitle": "Replay Segmentation and Warning Categorization", + "IncorporationChannel": "replay-segmentation-contract", + "TargetAssetFamily": "replay-segmentation-note", + "PuzzleFamily": "CrossCutting", + "NotationProfile": "supporting", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "PostHog/posthog", + "SourceLicense": "MIT outside ee/; enterprise license inside ee/", + "SourceTrackId": "control-plane/replay-segmentation", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist replay-segmentation target preserving tracked-window grouping, snapshot-window mapping, and replay warning categorization from PostHog session-recording utilities." + }, + "PreserveFactualElements": [ + "window-aware snapshot grouping", + "tracked-window filtering", + "warning-category extraction", + "ignored replay-warning buckets" + ], + "RewriteRequiredElements": [ + "all donor rrweb player shell assumptions", + "all donor browser-global log-storage wording", + "all donor scene wiring" + ], + "ContentSourceFile": "./raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl", + "MatchFilter": { + "source": "PostHog/posthog", + "source_scope": "repo-backed", + "structure_template": "control-plane-replay-segmentation-reference-page", + "family": "control-plane-replay", + "subset": "segmentation-and-warning-logging" + }, + "MaterializationNotes": [ + "Preserve segmentation and warning-triage semantics while rewriting the surfaced player shell in first-party HyperTwist language.", + "This target keeps replay review and troubleshooting value explicit without inheriting the broader donor replay product shell." + ] + }, + { + "ReferenceTargetId": "reference/posthog-feature-governance-reference-page", + "SurfaceType": "control-plane-feature-governance-reference", + "TrackTitle": "Control-Plane Telemetry and Replay Governance", + "ItemTitle": "Feature Governance and Blast Radius Contract", + "IncorporationChannel": "feature-governance-contract", + "TargetAssetFamily": "feature-governance-note", + "PuzzleFamily": "CrossCutting", + "NotationProfile": "supporting", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "PostHog/posthog", + "SourceLicense": "MIT outside ee/; enterprise license inside ee/", + "SourceTrackId": "control-plane/feature-governance", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist feature-governance target preserving rollout-group, variant, evaluation-runtime, blast-radius, and audit-summary posture from PostHog feature flags while keeping approvals-only enterprise surfaces excluded." + }, + "PreserveFactualElements": [ + "rollout groups and percentages", + "multivariate variants and payloads", + "evaluation runtime labels", + "blast-radius review posture", + "activity-log change summaries" + ], + "RewriteRequiredElements": [ + "all donor feature-flag scene wording", + "all donor experimentation-platform framing", + "all donor SaaS governance shell assumptions" + ], + "ContentSourceFile": "./raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl", + "MatchFilter": { + "source": "PostHog/posthog", + "source_scope": "repo-backed", + "structure_template": "control-plane-feature-governance-reference-page", + "family": "control-plane-governance", + "subset": "feature-flags-and-blast-radius" + }, + "MaterializationNotes": [ + "Preserve rollout and blast-radius semantics while rewriting the surfaced governance shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-D feature-governance contract and keeps enterprise-only approvals outside the landed lane." + ] + }, + { + "ReferenceTargetId": "reference/posthog-scheduled-change-reference-page", + "SurfaceType": "control-plane-scheduled-change-reference", + "TrackTitle": "Control-Plane Telemetry and Replay Governance", + "ItemTitle": "Scheduled Change and Recurrence Policy", + "IncorporationChannel": "scheduled-change-contract", + "TargetAssetFamily": "scheduled-change-note", + "PuzzleFamily": "CrossCutting", + "NotationProfile": "supporting", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "PostHog/posthog", + "SourceLicense": "MIT outside ee/; enterprise license inside ee/", + "SourceTrackId": "control-plane/scheduled-change", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist scheduled-change target preserving future activation, cron validation, recurrence, and patch-only update posture from PostHog feature-governance scheduling." + }, + "PreserveFactualElements": [ + "future activation and deactivation scheduling", + "5-field cron validation", + "recurrence intervals and end-date rules", + "patch-only update posture" + ], + "RewriteRequiredElements": [ + "all donor schedule-edit modal wording", + "all donor toast and API patch shell assumptions", + "all donor global team state assumptions" + ], + "ContentSourceFile": "./raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl", + "MatchFilter": { + "source": "PostHog/posthog", + "source_scope": "repo-backed", + "structure_template": "control-plane-scheduled-change-reference-page", + "family": "control-plane-governance", + "subset": "scheduled-changes" + }, + "MaterializationNotes": [ + "Preserve scheduled-change and recurrence semantics while rewriting the surfaced schedule-edit shell in first-party HyperTwist language.", + "This target keeps rollout timing value explicit without inheriting the donor feature-management shell." + ] + }, + { + "ReferenceTargetId": "reference/posthog-early-access-reference-page", + "SurfaceType": "control-plane-early-access-reference", + "TrackTitle": "Control-Plane Telemetry and Replay Governance", + "ItemTitle": "Early Access Lifecycle and Enrollment Flow", + "IncorporationChannel": "early-access-rollout-contract", + "TargetAssetFamily": "early-access-note", + "PuzzleFamily": "CrossCutting", + "NotationProfile": "supporting", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "PostHog/posthog", + "SourceLicense": "MIT outside ee/; enterprise license inside ee/", + "SourceTrackId": "control-plane/early-access-lifecycle", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist early-access rollout target preserving stage transitions, feature enrollment, rollout-to-all behavior, and internal lifecycle events from PostHog early-access features." + }, + "PreserveFactualElements": [ + "draft-to-ga lifecycle stages", + "active-stage enrollment linkage", + "rollout-to-all transition rules", + "documentation URL and payload metadata", + "internal lifecycle event emission" + ], + "RewriteRequiredElements": [ + "all donor product-preview shell wording", + "all donor feature-flag serializer naming", + "all donor SaaS account-management assumptions" + ], + "ContentSourceFile": "./raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl", + "MatchFilter": { + "source": "PostHog/posthog", + "source_scope": "repo-backed", + "structure_template": "control-plane-early-access-reference-page", + "family": "control-plane-governance", + "subset": "early-access-rollout" + }, + "MaterializationNotes": [ + "Preserve early-access lifecycle and enrollment semantics while rewriting the surfaced release shell in first-party HyperTwist language.", + "This target pairs with the compiled Phase 4R-D early-access rollout contract and keeps broader donor product-preview shell ownership outside the lane." + ] + }, + { + "ReferenceTargetId": "reference/posthog-compliance-boundary-reference-page", + "SurfaceType": "control-plane-compliance-boundary-reference", + "TrackTitle": "Control-Plane Telemetry and Replay Governance", + "ItemTitle": "MIT Core and ee Exclusion Boundary", + "IncorporationChannel": "compliance-boundary", + "TargetAssetFamily": "compliance-boundary-note", + "PuzzleFamily": "CrossCutting", + "NotationProfile": "supporting", + "SourceAttribution": { + "SourceMode": "DirectDonor", + "SourceRepo": "PostHog/posthog", + "SourceLicense": "MIT outside ee/; enterprise license inside ee/", + "SourceTrackId": "control-plane/compliance-boundary", + "SourceDeckId": "", + "SourceCaseId": "", + "SourceNotes": "First-party HyperTwist compliance target preserving the PostHog MIT-core versus enterprise-subtree split so the landed control-plane lane keeps ee/ excluded." + }, + "PreserveFactualElements": [ + "MIT outside ee", + "enterprise license inside ee", + "bounded control-plane donor posture", + "explicit ee exclusion" + ], + "RewriteRequiredElements": [ + "all donor product pricing and cloud shell wording", + "all donor self-hosting platform assumptions", + "all donor broad analytics-platform ownership claims" + ], + "ContentSourceFile": "./raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl", + "MatchFilter": { + "source": "PostHog/posthog", + "source_scope": "repo-backed", + "structure_template": "control-plane-compliance-boundary-reference-page", + "family": "control-plane-compliance", + "subset": "mit-core-and-ee-boundary" + }, + "MaterializationNotes": [ + "Preserve the MIT-core versus ee boundary while rewriting the surfaced compliance shell as first-party HyperTwist guidance.", + "This target pairs with the compiled Phase 4R-D compliance boundary and keeps enterprise paths excluded from the landed lane." + ] + } + ] } diff --git a/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl b/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl new file mode 100644 index 0000000..66e738a --- /dev/null +++ b/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl @@ -0,0 +1,6 @@ +{"source":"PostHog/posthog","source_scope":"repo-backed","family":"control-plane-replay","subset":"diagnostic-signals","page_id":"posthog-replay-diagnostics","page_title":"Replay Diagnostic Signals and Verdicts","surface_type":"control-plane-replay-diagnostic-reference","origin_paths":["C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\frontend\\src\\scenes\\session-recordings\\utils\\replayCaptureDiagnostics.ts","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\products\\replay\\skills\\diagnosing-missing-recordings\\references\\diagnostic-signals.md"],"preserve_factual_elements":["recording-state diagnostic properties","capture-failure verdict taxonomy","trigger-pending versus trigger-matched distinctions","sampling and buffer-state interpretation"],"notes":"Source-backed PostHog replay diagnostic target for first-party HyperTwist replay troubleshooting, missing-recording review, and operator-facing capture diagnostics with ee/ excluded."} +{"source":"PostHog/posthog","source_scope":"repo-backed","family":"control-plane-replay","subset":"segmentation-and-warning-logging","page_id":"posthog-replay-segmentation-and-logging","page_title":"Replay Segmentation and Warning Categorization","surface_type":"control-plane-replay-segmentation-reference","origin_paths":["C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\frontend\\src\\scenes\\session-recordings\\player\\utils\\segmenter.ts","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\frontend\\src\\scenes\\session-recordings\\player\\utils\\player-logging.ts"],"preserve_factual_elements":["window-aware snapshot segmentation","tracked-window filtering","ignored warning buckets","warning category extraction from replay logs"],"notes":"Source-backed PostHog replay segmentation target for first-party HyperTwist timeline review, grouped replay slices, and replay warning triage without inheriting the broader session-replay shell."} +{"source":"PostHog/posthog","source_scope":"repo-backed","family":"control-plane-governance","subset":"feature-flags-and-blast-radius","page_id":"posthog-feature-governance","page_title":"Feature Governance and Blast Radius Contract","surface_type":"control-plane-feature-governance-reference","origin_paths":["C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\frontend\\src\\scenes\\feature-flags\\featureFlagReleaseConditionsLogic.ts","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\frontend\\src\\scenes\\feature-flags\\activityDescriptions.tsx","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\products\\feature_flags\\backend\\models\\team_feature_flag_defaults_config.py"],"preserve_factual_elements":["rollout groups and percentages","multivariate variants and payload changes","evaluation runtime labels","blast-radius review posture","activity-log summary patterns"],"notes":"Source-backed PostHog feature-governance target for first-party HyperTwist rollout control, audit summaries, and blast-radius review with enterprise-only approvals excluded."} +{"source":"PostHog/posthog","source_scope":"repo-backed","family":"control-plane-governance","subset":"scheduled-changes","page_id":"posthog-scheduled-changes","page_title":"Scheduled Change and Recurrence Policy","surface_type":"control-plane-scheduled-change-reference","origin_paths":["C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\frontend\\src\\scenes\\feature-flags\\featureFlagScheduleEditLogic.ts"],"preserve_factual_elements":["future activation and deactivation scheduling","5-field cron validation","recurrence intervals and end-date checks","patch-only schedule updates"],"notes":"Source-backed PostHog scheduled-change target for first-party HyperTwist feature rollout timing, recurrence validation, and future-change review flows with generic platform scheduler ownership excluded."} +{"source":"PostHog/posthog","source_scope":"repo-backed","family":"control-plane-governance","subset":"early-access-rollout","page_id":"posthog-early-access-lifecycle","page_title":"Early Access Lifecycle and Enrollment Flow","surface_type":"control-plane-early-access-reference","origin_paths":["C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\products\\early_access_features\\backend\\models.py","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\products\\early_access_features\\backend\\api.py"],"preserve_factual_elements":["draft-to-ga lifecycle stages","active-stage enrollment linkage","rollout-to-all transition rules","documentation URL and payload metadata","internal lifecycle event emission"],"notes":"Source-backed PostHog early-access target for first-party HyperTwist gated feature rollouts, documentation handoff, and feature-enrollment transitions without inheriting the larger product-preview shell."} +{"source":"PostHog/posthog","source_scope":"repo-backed","family":"control-plane-compliance","subset":"mit-core-and-ee-boundary","page_id":"posthog-mit-core-ee-boundary","page_title":"MIT Core and ee Exclusion Boundary","surface_type":"control-plane-compliance-boundary-reference","origin_paths":["C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\LICENSE","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\ee\\LICENSE","C:\\Workspaces\\HyperTwist\\mirrors\\restrictive\\PostHog\\posthog\\README.md"],"preserve_factual_elements":["MIT outside ee","enterprise license inside ee","root versus enterprise subtree split","bounded control-plane donor posture"],"notes":"Source-backed PostHog compliance-boundary target for first-party HyperTwist control-plane implementation with explicit ee exclusion, notice retention, and no whole-product analytics-shell inheritance."} diff --git a/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.cpp b/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.cpp new file mode 100644 index 0000000..2efd757 --- /dev/null +++ b/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.cpp @@ -0,0 +1,562 @@ +#include "HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h" + +namespace HyperTwistTrainingControlPlaneLibraryInternal +{ + const TCHAR* ControlPlaneRepo = TEXT("PostHog/posthog"); + const TCHAR* ControlPlaneLicense = TEXT("MIT outside ee/; enterprise license inside ee/"); + + FHyperTwistTrainingSourceAttribution MakeAttribution( + const FString& TrackId, + const FString& Notes + ) + { + FHyperTwistTrainingSourceAttribution Attribution; + Attribution.SourceMode = EHyperTwistTrainingSourceMode::DirectDonor; + Attribution.SourceRepo = ControlPlaneRepo; + Attribution.SourceLicense = ControlPlaneLicense; + Attribution.SourceTrackId = TrackId; + Attribution.SourceNotes = Notes; + return Attribution; + } + + FHyperTwistTrainingControlPlanePackageReference MakePackageReference( + const FString& PackageId, + const FString& Label, + const FString& PackagePath, + const FString& UsagePosture, + const FString& LicensePosture, + const FString& Summary, + const TArray& ApprovedWorkflowTags, + const TArray& ExplicitExclusions, + const FHyperTwistTrainingSourceAttribution& SourceAttribution + ) + { + FHyperTwistTrainingControlPlanePackageReference Reference; + Reference.PackageId = PackageId; + Reference.Label = Label; + Reference.PackagePath = PackagePath; + Reference.UsagePosture = UsagePosture; + Reference.LicensePosture = LicensePosture; + Reference.Summary = Summary; + Reference.ApprovedWorkflowTags = ApprovedWorkflowTags; + Reference.ExplicitExclusions = ExplicitExclusions; + Reference.SourceAttribution = SourceAttribution; + return Reference; + } +} + +FHyperTwistTrainingControlPlaneReferenceBundle +UHyperTwistTrainingControlPlaneLibrary::BuildBundledControlPlaneReferenceBundle() +{ + using namespace HyperTwistTrainingControlPlaneLibraryInternal; + + FHyperTwistTrainingControlPlaneReferenceBundle Bundle; + Bundle.ReferenceUtc = TEXT("2026-05-13T23:59:00Z"); + Bundle.PrimaryReplayDiagnosticContractId = TEXT("posthog-replay-diagnostics-and-segmentation"); + Bundle.PrimaryFeatureGovernanceContractId = TEXT("posthog-feature-governance-and-blast-radius"); + Bundle.PrimaryScheduledChangeContractId = TEXT("posthog-feature-scheduled-change-policy"); + Bundle.PrimaryEarlyAccessRolloutContractId = TEXT("posthog-early-access-rollout-lifecycle"); + Bundle.PrimaryComplianceBoundaryId = TEXT("posthog-mit-core-and-ee-exclusion-boundary"); + + Bundle.PackageReferences = + { + MakePackageReference( + TEXT("package/posthog-root"), + TEXT("PostHog root MIT core"), + TEXT("./"), + TEXT("bounded-control-plane-reference"), + TEXT("MIT outside ee/; enterprise-restricted ee/ subtree excluded"), + TEXT("Root monorepo boundary reference for telemetry, replay, and feature-governance extraction while keeping the broader product analytics shell and enterprise subtree outside HyperTwist ownership."), + {TEXT("control-plane-boundary"), TEXT("source-routing"), TEXT("notice-retention")}, + { + TEXT("ee/ subtree"), + TEXT("whole-product analytics shell adoption"), + TEXT("deployment and self-hosting inheritance") + }, + MakeAttribution( + TEXT("control-plane/package-root"), + TEXT("Preserves the root MIT-versus-ee subtree split so HyperTwist can use replay and feature-governance value while keeping the enterprise boundary explicit.") + ) + ), + MakePackageReference( + TEXT("package/posthog-replay"), + TEXT("Replay and session-recordings surfaces"), + TEXT("./products/replay + ./frontend/src/scenes/session-recordings + ./common/replay-shared"), + TEXT("bounded-replay-diagnostic-reference"), + TEXT("MIT outside ee/"), + TEXT("Replay diagnostic, recording-state, timeline-segmentation, warning-categorization, and capture-debug reference surfaces for HyperTwist replay troubleshooting and review workflows."), + {TEXT("replay-diagnostics"), TEXT("timeline-analysis"), TEXT("capture-troubleshooting")}, + { + TEXT("full analytics dashboard shell"), + TEXT("general web session recorder product ownership") + }, + MakeAttribution( + TEXT("control-plane/replay"), + TEXT("Preserves replay diagnostic signals, session-recording workflow patterns, and window-aware segmentation seams from the retained PostHog replay lane.") + ) + ), + MakePackageReference( + TEXT("package/posthog-feature-flags"), + TEXT("Feature flags and rollout governance surfaces"), + TEXT("./products/feature_flags + ./frontend/src/scenes/feature-flags"), + TEXT("bounded-feature-governance-reference"), + TEXT("MIT outside ee/"), + TEXT("Feature-flag targeting, rollout percentage, multivariate variant, evaluation-runtime, blast-radius, and activity-log reference surfaces for HyperTwist control-plane governance."), + {TEXT("feature-governance"), TEXT("blast-radius-review"), TEXT("scheduled-rollout")}, + { + TEXT("whole feature-management product shell"), + TEXT("general product analytics or experimentation platform ownership") + }, + MakeAttribution( + TEXT("control-plane/feature-flags"), + TEXT("Preserves the retained feature-governance seams from PostHog for bounded HyperTwist rollout control, audit summaries, and blast-radius review.") + ) + ), + MakePackageReference( + TEXT("package/posthog-early-access"), + TEXT("Early access feature lifecycle surfaces"), + TEXT("./products/early_access_features"), + TEXT("bounded-early-access-reference"), + TEXT("MIT outside ee/"), + TEXT("Early-access lifecycle, stage-to-flag enrollment, rollout-to-all transitions, documentation links, and internal-event posture for bounded HyperTwist gated-feature release workflows."), + {TEXT("early-access-lifecycle"), TEXT("gated-release"), TEXT("rollout-transition")}, + { + TEXT("whole SaaS product-preview shell"), + TEXT("generic customer-marketing workflow ownership") + }, + MakeAttribution( + TEXT("control-plane/early-access"), + TEXT("Preserves the retained early-access lifecycle and feature-enrollment patterns from PostHog for bounded HyperTwist release-governance use.") + ) + ) + }; + + FHyperTwistTrainingReplayDiagnosticContract ReplayContract; + ReplayContract.ContractId = TEXT("posthog-replay-diagnostics-and-segmentation"); + ReplayContract.Title = TEXT("Replay diagnostics and segmentation"); + ReplayContract.Summary = TEXT("First-party HyperTwist replay diagnostic contract preserving recording-state signals, trigger states, capture-failure verdicts, warning categorization, and window-aware timeline segmentation from the retained PostHog replay lane."); + ReplayContract.DiagnosticSignalKeys = + { + TEXT("$has_recording"), + TEXT("$recording_status"), + TEXT("$session_recording_start_reason"), + TEXT("$sdk_debug_replay_url_trigger_status"), + TEXT("$sdk_debug_replay_event_trigger_status"), + TEXT("$sdk_debug_replay_linked_flag_trigger_status"), + TEXT("$sdk_debug_replay_internal_buffer_length"), + TEXT("$sdk_debug_replay_internal_buffer_size"), + TEXT("$sdk_debug_replay_flushed_size"), + TEXT("$sdk_debug_recording_script_not_loaded"), + TEXT("$replay_sample_rate"), + TEXT("$replay_minimum_duration"), + TEXT("$session_recording_remote_config"), + TEXT("$sdk_debug_replay_remote_trigger_matching_config") + }; + ReplayContract.VerdictKeys = + { + TEXT("captured"), + TEXT("ad_blocked"), + TEXT("disabled"), + TEXT("trigger_pending"), + TEXT("sampled_out"), + TEXT("buffering_empty"), + TEXT("unknown") + }; + ReplayContract.TimelineSemantics = + { + TEXT("treat missing diagnostic properties as unknown rather than false"), + TEXT("preserve trigger-disabled, trigger-pending, and trigger-matched state distinctions"), + TEXT("preserve buffered-versus-flushed recording diagnostics"), + TEXT("preserve window-aware snapshot grouping and tracked-window segmentation boundaries"), + TEXT("preserve recorder-warning categorization while ignoring known low-value missing-node noise") + }; + ReplayContract.WarningCategoryRules = + { + TEXT("bucket warning categories from the first meaningful non-prefix string or error message"), + TEXT("ignore warnings beginning with 'Could not find node with id'"), + TEXT("surface non-ignored replay warnings into operator-facing diagnostics rather than raw console spam") + }; + ReplayContract.SuggestedOperatorActions = + { + TEXT("inspect replay settings when recording status is disabled or trigger-gated"), + TEXT("differentiate ad-blocked recorder failures from sampling and minimum-duration failures"), + TEXT("review sample rate, minimum duration, and remote trigger configuration before declaring a replay ingestion bug"), + TEXT("use segmentation and tracked-window posture to explain missing or fragmented replay slices") + }; + ReplayContract.ApprovedWorkflowTags = + { + TEXT("replay-diagnostics"), + TEXT("capture-troubleshooting"), + TEXT("timeline-analysis"), + TEXT("warning-categorization") + }; + ReplayContract.ExplicitExclusions = + { + TEXT("full session-replay product shell"), + TEXT("generic website analytics playback ownership"), + TEXT("ee/ replay or enterprise debugging surfaces") + }; + ReplayContract.SourceAttribution = MakeAttribution( + TEXT("control-plane/replay-diagnostics"), + TEXT("Preserves replay diagnostic signals, segment creation posture, and warning-categorization seams from the retained PostHog replay lane for first-party HyperTwist troubleshooting flows.") + ); + Bundle.ReplayDiagnosticContracts = {ReplayContract}; + + FHyperTwistTrainingFeatureGovernanceContract FeatureGovernance; + FeatureGovernance.ContractId = TEXT("posthog-feature-governance-and-blast-radius"); + FeatureGovernance.Title = TEXT("Feature governance and blast radius"); + FeatureGovernance.Summary = TEXT("First-party HyperTwist feature-governance contract preserving rollout groups, evaluation runtime, blast-radius review, variant management, and activity-log summary posture from the retained PostHog feature-flags lane."); + FeatureGovernance.SupportedConditionScopes = + { + TEXT("person-scoped conditions"), + TEXT("group-scoped conditions"), + TEXT("mixed-targeting with per-condition aggregation scope"), + TEXT("default evaluation contexts") + }; + FeatureGovernance.SupportedRolloutControls = + { + TEXT("rollout percentage per condition group"), + TEXT("multivariate variants and variant-specific payloads"), + TEXT("evaluation runtime labels for client, server, or both"), + TEXT("condition ordering and drag-reorder semantics"), + TEXT("linked-flag and trigger-aware gating posture") + }; + FeatureGovernance.EvaluationRuntimeLabels = + { + TEXT("both client and server"), + TEXT("client-side only"), + TEXT("server-side only") + }; + FeatureGovernance.BlastRadiusReviewRules = + { + TEXT("preserve affected-count and total-count review per condition set"), + TEXT("avoid live blast-radius calls in readonly displays"), + TEXT("reset incompatible property filters when switching aggregation scopes"), + TEXT("treat mixed-targeting transitions as explicit control-plane events rather than silent state drift") + }; + FeatureGovernance.AuditActivityPatterns = + { + TEXT("enable or disable state changes"), + TEXT("payload changes"), + TEXT("release-condition additions or removals"), + TEXT("variant rollout and variant deletion changes"), + TEXT("runtime and targeting-scope changes") + }; + FeatureGovernance.ApprovedWorkflowTags = + { + TEXT("feature-governance"), + TEXT("blast-radius-review"), + TEXT("variant-rollout"), + TEXT("audit-summary") + }; + FeatureGovernance.ExplicitExclusions = + { + TEXT("whole feature-management product shell"), + TEXT("general experimentation suite ownership"), + TEXT("ee/ approvals or enterprise-only governance surfaces") + }; + FeatureGovernance.SourceAttribution = MakeAttribution( + TEXT("control-plane/feature-governance"), + TEXT("Preserves rollout-group, blast-radius, evaluation-runtime, and activity-log semantics from the retained PostHog feature-governance lane for first-party HyperTwist control-plane use.") + ); + Bundle.FeatureGovernanceContracts = {FeatureGovernance}; + + FHyperTwistTrainingScheduledChangeContract ScheduledChange; + ScheduledChange.ContractId = TEXT("posthog-feature-scheduled-change-policy"); + ScheduledChange.Title = TEXT("Scheduled change policy"); + ScheduledChange.Summary = TEXT("First-party HyperTwist scheduled-change contract preserving future activation, pause/resume-safe editing, recurrence, cron validation, and patch-only update posture from the retained PostHog feature-governance lane."); + ScheduledChange.SupportedOperationTypes = + { + TEXT("update_status"), + TEXT("future activation or deactivation"), + TEXT("pause-safe schedule editing") + }; + ScheduledChange.SupportedRepeatModes = + { + TEXT("one-time"), + TEXT("daily"), + TEXT("weekly"), + TEXT("monthly"), + TEXT("cron") + }; + ScheduledChange.ValidationRules = + { + TEXT("scheduled date is required"), + TEXT("non-recurring schedules must be in the future"), + TEXT("support only 5-field cron expressions"), + TEXT("cron must parse successfully before previewing next occurrence"), + TEXT("end date must be after the scheduled start date") + }; + ScheduledChange.PatchSemantics = + { + TEXT("save only changed fields rather than rewriting the entire schedule payload"), + TEXT("recompute scheduled-at preview from cron when the expression changes"), + TEXT("clear recurrence and end-date state when switching back to one-time schedules") + }; + ScheduledChange.ApprovedWorkflowTags = + { + TEXT("scheduled-rollout"), + TEXT("cron-validation"), + TEXT("change-review"), + TEXT("future-activation") + }; + ScheduledChange.ExplicitExclusions = + { + TEXT("whole generic task-scheduler ownership"), + TEXT("enterprise approval-routing surfaces"), + TEXT("deployment-orchestration platform ownership") + }; + ScheduledChange.SourceAttribution = MakeAttribution( + TEXT("control-plane/scheduled-change"), + TEXT("Preserves the bounded future-change, recurrence, cron-validation, and patch-only schedule-edit semantics from the retained PostHog feature-governance lane.") + ); + Bundle.ScheduledChangeContracts = {ScheduledChange}; + + FHyperTwistTrainingEarlyAccessRolloutContract EarlyAccess; + EarlyAccess.ContractId = TEXT("posthog-early-access-rollout-lifecycle"); + EarlyAccess.Title = TEXT("Early access rollout lifecycle"); + EarlyAccess.Summary = TEXT("First-party HyperTwist early-access rollout contract preserving staged release lifecycle, feature-enrollment linkage, documentation handoff, and rollout-to-all transitions from the retained PostHog early-access lane."); + EarlyAccess.LifecycleStages = + { + TEXT("draft"), + TEXT("concept"), + TEXT("alpha"), + TEXT("beta"), + TEXT("general-availability"), + TEXT("archived") + }; + EarlyAccess.ActiveStages = + { + TEXT("alpha"), + TEXT("beta"), + TEXT("general-availability") + }; + EarlyAccess.EnrollmentRules = + { + TEXT("active-stage entry enables feature-flag enrollment for opted-in users"), + TEXT("concept stage gauges interest without enabling functionality"), + TEXT("non-active stages clear feature-enrollment super-group posture"), + TEXT("link only to single-variant, non-group-based feature flags") + }; + EarlyAccess.RolloutToAllRules = + { + TEXT("when promoting to general availability with rollout_to_all, clear enrollment gates"), + TEXT("replace opt-in conditions with a 100 percent rollout group"), + TEXT("preserve documentation URL and payload as first-party release metadata") + }; + EarlyAccess.InternalEventOutputs = + { + TEXT("$early_access_feature_updated internal event with previous and next serialized state"), + TEXT("stage-change event production for release-lifecycle transitions") + }; + EarlyAccess.ApprovedWorkflowTags = + { + TEXT("early-access-lifecycle"), + TEXT("opt-in-rollout"), + TEXT("documentation-handoff"), + TEXT("ga-transition") + }; + EarlyAccess.ExplicitExclusions = + { + TEXT("whole product-preview marketing shell"), + TEXT("generic SaaS customer portal ownership"), + TEXT("enterprise-only product-management surfaces") + }; + EarlyAccess.SourceAttribution = MakeAttribution( + TEXT("control-plane/early-access-lifecycle"), + TEXT("Preserves stage-based early-access rollout, enrollment, and GA transition semantics from the retained PostHog early-access lane for first-party HyperTwist release control.") + ); + Bundle.EarlyAccessRolloutContracts = {EarlyAccess}; + + FHyperTwistTrainingControlPlaneComplianceBoundary ComplianceBoundary; + ComplianceBoundary.BoundaryId = TEXT("posthog-mit-core-and-ee-exclusion-boundary"); + ComplianceBoundary.Title = TEXT("PostHog MIT-core and ee-exclusion boundary"); + ComplianceBoundary.Summary = TEXT("First-party HyperTwist compliance boundary for using PostHog MIT-core replay and feature-governance patterns while keeping the enterprise-restricted ee subtree and full analytics platform shell outside the landed lane."); + ComplianceBoundary.AllowedSourceRoots = + { + TEXT("./frontend/src/scenes/session-recordings"), + TEXT("./frontend/src/scenes/feature-flags"), + TEXT("./products/replay"), + TEXT("./products/feature_flags"), + TEXT("./products/early_access_features"), + TEXT("./common/replay-shared") + }; + ComplianceBoundary.ExcludedSourceRoots = + { + TEXT("./ee"), + TEXT("./products/product_analytics"), + TEXT("./products/web_analytics"), + TEXT("./products/experiments"), + TEXT("./products/data_warehouse"), + TEXT("./products/workflows") + }; + ComplianceBoundary.RequiredNoticeActions = + { + TEXT("preserve root MIT license materials for any reused core-path code or closely adapted notices"), + TEXT("keep the ee/ exclusion explicit in packet docs, manifests, and future widening notes"), + TEXT("do not represent the landed control-plane lane as permission to consume enterprise paths") + }; + ComplianceBoundary.ProvenanceCaveats = + { + TEXT("the root MIT license does not flatten the ee/ subtree into an ordinary donor lane"), + TEXT("the retained value is control-plane telemetry, replay diagnostics, and feature governance rather than whole-product analytics ownership"), + TEXT("HyperTwist should preserve replay and rollout semantics in first-party contracts instead of inheriting the larger PostHog deployment model") + }; + ComplianceBoundary.ExplicitExclusions = + { + TEXT("ee/ subtree use without separate rights"), + TEXT("whole product analytics shell adoption"), + TEXT("generic cloud telemetry platform ownership"), + TEXT("broad self-hosting and infrastructure inheritance") + }; + ComplianceBoundary.SourceAttribution = MakeAttribution( + TEXT("control-plane/compliance-boundary"), + TEXT("Preserves the PostHog MIT-core versus enterprise-subtree boundary so HyperTwist can land a bounded control-plane lane without inheriting the excluded ee/ posture.") + ); + Bundle.ComplianceBoundaries = {ComplianceBoundary}; + + return Bundle; +} + +bool UHyperTwistTrainingControlPlaneLibrary::TryGetPackageReferenceById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& PackageId, + FHyperTwistTrainingControlPlanePackageReference& OutReference +) +{ + for (const FHyperTwistTrainingControlPlanePackageReference& Reference : Bundle.PackageReferences) + { + if (Reference.PackageId.Equals(PackageId, ESearchCase::IgnoreCase)) + { + OutReference = Reference; + return true; + } + } + + OutReference = FHyperTwistTrainingControlPlanePackageReference(); + return false; +} + +bool UHyperTwistTrainingControlPlaneLibrary::TryGetReplayDiagnosticContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingReplayDiagnosticContract& OutContract +) +{ + for (const FHyperTwistTrainingReplayDiagnosticContract& Contract : Bundle.ReplayDiagnosticContracts) + { + if (Contract.ContractId.Equals(ContractId, ESearchCase::IgnoreCase)) + { + OutContract = Contract; + return true; + } + } + + OutContract = FHyperTwistTrainingReplayDiagnosticContract(); + return false; +} + +bool UHyperTwistTrainingControlPlaneLibrary::TryGetFeatureGovernanceContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingFeatureGovernanceContract& OutContract +) +{ + for (const FHyperTwistTrainingFeatureGovernanceContract& Contract : Bundle.FeatureGovernanceContracts) + { + if (Contract.ContractId.Equals(ContractId, ESearchCase::IgnoreCase)) + { + OutContract = Contract; + return true; + } + } + + OutContract = FHyperTwistTrainingFeatureGovernanceContract(); + return false; +} + +bool UHyperTwistTrainingControlPlaneLibrary::TryGetScheduledChangeContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingScheduledChangeContract& OutContract +) +{ + for (const FHyperTwistTrainingScheduledChangeContract& Contract : Bundle.ScheduledChangeContracts) + { + if (Contract.ContractId.Equals(ContractId, ESearchCase::IgnoreCase)) + { + OutContract = Contract; + return true; + } + } + + OutContract = FHyperTwistTrainingScheduledChangeContract(); + return false; +} + +bool UHyperTwistTrainingControlPlaneLibrary::TryGetEarlyAccessRolloutContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingEarlyAccessRolloutContract& OutContract +) +{ + for (const FHyperTwistTrainingEarlyAccessRolloutContract& Contract : Bundle.EarlyAccessRolloutContracts) + { + if (Contract.ContractId.Equals(ContractId, ESearchCase::IgnoreCase)) + { + OutContract = Contract; + return true; + } + } + + OutContract = FHyperTwistTrainingEarlyAccessRolloutContract(); + return false; +} + +bool UHyperTwistTrainingControlPlaneLibrary::TryGetComplianceBoundaryById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& BoundaryId, + FHyperTwistTrainingControlPlaneComplianceBoundary& OutBoundary +) +{ + for (const FHyperTwistTrainingControlPlaneComplianceBoundary& Boundary : Bundle.ComplianceBoundaries) + { + if (Boundary.BoundaryId.Equals(BoundaryId, ESearchCase::IgnoreCase)) + { + OutBoundary = Boundary; + return true; + } + } + + OutBoundary = FHyperTwistTrainingControlPlaneComplianceBoundary(); + return false; +} + +FString UHyperTwistTrainingControlPlaneLibrary::BuildPackageChecklistTsv( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle +) +{ + FString Output = TEXT("package_id\tlabel\tpackage_path\tusage_posture\tlicense_posture\tsummary\n"); + for (const FHyperTwistTrainingControlPlanePackageReference& Reference : Bundle.PackageReferences) + { + if (!Reference.IsStructurallyValid()) + { + continue; + } + + Output.Append(Reference.PackageId); + Output.Append(TEXT("\t")); + Output.Append(Reference.Label); + Output.Append(TEXT("\t")); + Output.Append(Reference.PackagePath); + Output.Append(TEXT("\t")); + Output.Append(Reference.UsagePosture); + Output.Append(TEXT("\t")); + Output.Append(Reference.LicensePosture); + Output.Append(TEXT("\t")); + Output.Append(Reference.Summary.Replace(TEXT("\t"), TEXT(" "))); + Output.Append(TEXT("\n")); + } + + return Output; +} diff --git a/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp b/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp index c1aa580..99f9694 100644 --- a/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp +++ b/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp @@ -497,6 +497,11 @@ FHyperTwistTrainingSharedAssetReferenceBundle UHyperTwistTrainingRuntimeLibrary: return UHyperTwistTrainingSharedAssetLibrary::BuildBundledSharedAssetReferenceBundle(); } +FHyperTwistTrainingControlPlaneReferenceBundle UHyperTwistTrainingRuntimeLibrary::GetBundledControlPlaneReferenceBundle() +{ + return UHyperTwistTrainingControlPlaneLibrary::BuildBundledControlPlaneReferenceBundle(); +} + bool UHyperTwistTrainingRuntimeLibrary::TryGetLatestGeneratedModeLaunchRequestForDeck( UObject* WorldContextObject, const FString& UserId, @@ -1006,6 +1011,85 @@ FString UHyperTwistTrainingRuntimeLibrary::BuildBundledSharedAssetFixtureCheckli ); } +bool UHyperTwistTrainingRuntimeLibrary::TryGetBundledControlPlanePackageReference( + const FString& PackageId, + FHyperTwistTrainingControlPlanePackageReference& OutReference +) +{ + return UHyperTwistTrainingControlPlaneLibrary::TryGetPackageReferenceById( + GetBundledControlPlaneReferenceBundle(), + PackageId, + OutReference + ); +} + +bool UHyperTwistTrainingRuntimeLibrary::TryGetBundledControlPlaneReplayDiagnosticContract( + const FString& ContractId, + FHyperTwistTrainingReplayDiagnosticContract& OutContract +) +{ + return UHyperTwistTrainingControlPlaneLibrary::TryGetReplayDiagnosticContractById( + GetBundledControlPlaneReferenceBundle(), + ContractId, + OutContract + ); +} + +bool UHyperTwistTrainingRuntimeLibrary::TryGetBundledControlPlaneFeatureGovernanceContract( + const FString& ContractId, + FHyperTwistTrainingFeatureGovernanceContract& OutContract +) +{ + return UHyperTwistTrainingControlPlaneLibrary::TryGetFeatureGovernanceContractById( + GetBundledControlPlaneReferenceBundle(), + ContractId, + OutContract + ); +} + +bool UHyperTwistTrainingRuntimeLibrary::TryGetBundledControlPlaneScheduledChangeContract( + const FString& ContractId, + FHyperTwistTrainingScheduledChangeContract& OutContract +) +{ + return UHyperTwistTrainingControlPlaneLibrary::TryGetScheduledChangeContractById( + GetBundledControlPlaneReferenceBundle(), + ContractId, + OutContract + ); +} + +bool UHyperTwistTrainingRuntimeLibrary::TryGetBundledControlPlaneEarlyAccessRolloutContract( + const FString& ContractId, + FHyperTwistTrainingEarlyAccessRolloutContract& OutContract +) +{ + return UHyperTwistTrainingControlPlaneLibrary::TryGetEarlyAccessRolloutContractById( + GetBundledControlPlaneReferenceBundle(), + ContractId, + OutContract + ); +} + +bool UHyperTwistTrainingRuntimeLibrary::TryGetBundledControlPlaneComplianceBoundary( + const FString& BoundaryId, + FHyperTwistTrainingControlPlaneComplianceBoundary& OutBoundary +) +{ + return UHyperTwistTrainingControlPlaneLibrary::TryGetComplianceBoundaryById( + GetBundledControlPlaneReferenceBundle(), + BoundaryId, + OutBoundary + ); +} + +FString UHyperTwistTrainingRuntimeLibrary::BuildBundledControlPlanePackageChecklistTsv() +{ + return UHyperTwistTrainingControlPlaneLibrary::BuildPackageChecklistTsv( + GetBundledControlPlaneReferenceBundle() + ); +} + FHyperTwistTrainingLearnerDeckStateSummary UHyperTwistTrainingRuntimeLibrary::GetActiveTrainingLearnerDeckStateSummary(UObject* WorldContextObject) { if (UHyperTwistTrainingSubsystem* TrainingSubsystem = GetTrainingSubsystem(WorldContextObject)) diff --git a/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h b/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h new file mode 100644 index 0000000..67d8a41 --- /dev/null +++ b/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h @@ -0,0 +1,360 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Kismet/BlueprintFunctionLibrary.h" +#include "HyperTwistTraining/HyperTwistTrainingTypes.h" +#include "HyperTwistTrainingControlPlaneLibrary.generated.h" + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingControlPlanePackageReference +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PackageId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Label; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PackagePath; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString UsagePosture; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString LicensePosture; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Summary; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ApprovedWorkflowTags; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExplicitExclusions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FHyperTwistTrainingSourceAttribution SourceAttribution; + + bool IsStructurallyValid() const + { + return !PackageId.IsEmpty() && !Label.IsEmpty() && !PackagePath.IsEmpty() && !UsagePosture.IsEmpty() + && !LicensePosture.IsEmpty() && SourceAttribution.IsStructurallyValid(); + } +}; + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingReplayDiagnosticContract +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString ContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Title; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Summary; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray DiagnosticSignalKeys; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray VerdictKeys; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray TimelineSemantics; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray WarningCategoryRules; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray SuggestedOperatorActions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ApprovedWorkflowTags; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExplicitExclusions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FHyperTwistTrainingSourceAttribution SourceAttribution; + + bool IsStructurallyValid() const + { + return !ContractId.IsEmpty() && !Title.IsEmpty() && SourceAttribution.IsStructurallyValid(); + } +}; + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingFeatureGovernanceContract +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString ContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Title; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Summary; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray SupportedConditionScopes; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray SupportedRolloutControls; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray EvaluationRuntimeLabels; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray BlastRadiusReviewRules; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray AuditActivityPatterns; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ApprovedWorkflowTags; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExplicitExclusions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FHyperTwistTrainingSourceAttribution SourceAttribution; + + bool IsStructurallyValid() const + { + return !ContractId.IsEmpty() && !Title.IsEmpty() && SourceAttribution.IsStructurallyValid(); + } +}; + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingScheduledChangeContract +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString ContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Title; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Summary; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray SupportedOperationTypes; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray SupportedRepeatModes; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ValidationRules; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray PatchSemantics; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ApprovedWorkflowTags; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExplicitExclusions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FHyperTwistTrainingSourceAttribution SourceAttribution; + + bool IsStructurallyValid() const + { + return !ContractId.IsEmpty() && !Title.IsEmpty() && SourceAttribution.IsStructurallyValid(); + } +}; + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingEarlyAccessRolloutContract +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString ContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Title; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Summary; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray LifecycleStages; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ActiveStages; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray EnrollmentRules; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray RolloutToAllRules; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray InternalEventOutputs; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ApprovedWorkflowTags; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExplicitExclusions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FHyperTwistTrainingSourceAttribution SourceAttribution; + + bool IsStructurallyValid() const + { + return !ContractId.IsEmpty() && !Title.IsEmpty() && SourceAttribution.IsStructurallyValid(); + } +}; + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingControlPlaneComplianceBoundary +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString BoundaryId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Title; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString Summary; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray AllowedSourceRoots; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExcludedSourceRoots; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray RequiredNoticeActions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ProvenanceCaveats; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ExplicitExclusions; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FHyperTwistTrainingSourceAttribution SourceAttribution; + + bool IsStructurallyValid() const + { + return !BoundaryId.IsEmpty() && !Title.IsEmpty() && SourceAttribution.IsStructurallyValid(); + } +}; + +USTRUCT(BlueprintType) +struct FHyperTwistTrainingControlPlaneReferenceBundle +{ + GENERATED_BODY() + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString ReferenceUtc; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PrimaryReplayDiagnosticContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PrimaryFeatureGovernanceContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PrimaryScheduledChangeContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PrimaryEarlyAccessRolloutContractId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + FString PrimaryComplianceBoundaryId; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray PackageReferences; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ReplayDiagnosticContracts; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray FeatureGovernanceContracts; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ScheduledChangeContracts; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray EarlyAccessRolloutContracts; + + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "HyperTwist") + TArray ComplianceBoundaries; + + bool IsStructurallyValid() const + { + return !PrimaryReplayDiagnosticContractId.IsEmpty() && !PrimaryFeatureGovernanceContractId.IsEmpty() + && !PrimaryScheduledChangeContractId.IsEmpty() && !PrimaryEarlyAccessRolloutContractId.IsEmpty() + && !PrimaryComplianceBoundaryId.IsEmpty() && PackageReferences.Num() > 0; + } +}; + +UCLASS() +class UNREALHYPERTWIST_API UHyperTwistTrainingControlPlaneLibrary : public UBlueprintFunctionLibrary +{ + GENERATED_BODY() + +public: + UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|ControlPlane") + static FHyperTwistTrainingControlPlaneReferenceBundle BuildBundledControlPlaneReferenceBundle(); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetPackageReferenceById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& PackageId, + FHyperTwistTrainingControlPlanePackageReference& OutReference + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetReplayDiagnosticContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingReplayDiagnosticContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetFeatureGovernanceContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingFeatureGovernanceContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetScheduledChangeContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingScheduledChangeContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetEarlyAccessRolloutContractById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& ContractId, + FHyperTwistTrainingEarlyAccessRolloutContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetComplianceBoundaryById( + const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle, + const FString& BoundaryId, + FHyperTwistTrainingControlPlaneComplianceBoundary& OutBoundary + ); + + UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|ControlPlane") + static FString BuildPackageChecklistTsv(const FHyperTwistTrainingControlPlaneReferenceBundle& Bundle); +}; diff --git a/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h b/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h index 08b374b..b9dd999 100644 --- a/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h +++ b/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h @@ -7,6 +7,7 @@ #include "HyperTwistTraining/HyperTwistTrainingAnalyticsLibrary.h" #include "HyperTwistTraining/HyperTwistTrainingClassicCubingLibrary.h" #include "HyperTwistTraining/HyperTwistTrainingCompanionLibrary.h" +#include "HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h" #include "HyperTwistTraining/HyperTwistTrainingCoachLibrary.h" #include "HyperTwistTraining/HyperTwistTrainingKnowledgeLibrary.h" #include "HyperTwistTraining/HyperTwistTrainingLegacy4DLibrary.h" @@ -172,6 +173,9 @@ public: UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|SharedAssets") static FHyperTwistTrainingSharedAssetReferenceBundle GetBundledSharedAssetReferenceBundle(); + UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|ControlPlane") + static FHyperTwistTrainingControlPlaneReferenceBundle GetBundledControlPlaneReferenceBundle(); + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training", meta = (WorldContext = "WorldContextObject")) static bool TryGetLatestGeneratedModeLaunchRequestForDeck( UObject* WorldContextObject, @@ -400,6 +404,45 @@ public: UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|SharedAssets") static FString BuildBundledSharedAssetFixtureChecklistTsv(); + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetBundledControlPlanePackageReference( + const FString& PackageId, + FHyperTwistTrainingControlPlanePackageReference& OutReference + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetBundledControlPlaneReplayDiagnosticContract( + const FString& ContractId, + FHyperTwistTrainingReplayDiagnosticContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetBundledControlPlaneFeatureGovernanceContract( + const FString& ContractId, + FHyperTwistTrainingFeatureGovernanceContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetBundledControlPlaneScheduledChangeContract( + const FString& ContractId, + FHyperTwistTrainingScheduledChangeContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetBundledControlPlaneEarlyAccessRolloutContract( + const FString& ContractId, + FHyperTwistTrainingEarlyAccessRolloutContract& OutContract + ); + + UFUNCTION(BlueprintCallable, Category = "HyperTwist|Training|ControlPlane") + static bool TryGetBundledControlPlaneComplianceBoundary( + const FString& BoundaryId, + FHyperTwistTrainingControlPlaneComplianceBoundary& OutBoundary + ); + + UFUNCTION(BlueprintPure, Category = "HyperTwist|Training|ControlPlane") + static FString BuildBundledControlPlanePackageChecklistTsv(); + UFUNCTION(BlueprintPure, Category = "HyperTwist|Training", meta = (WorldContext = "WorldContextObject")) static FHyperTwistTrainingLearnerDeckStateSummary GetActiveTrainingLearnerDeckStateSummary(UObject* WorldContextObject); diff --git a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md index b582ac2..e451980 100644 --- a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md +++ b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md @@ -53,6 +53,11 @@ Important correction added on `2026-05-13`: - `google/model-viewer/packages/shared-assets` is now a currently verified live boundary-sensitive lane through `Phase 4R-C`. - it is live through first-party Unreal shared-assets allowlist, provenance-boundary, fixture-refresh contract code, and bundled reference-target materialization rather than through direct donor asset import into owned source. +Important correction added on `2026-05-13`: + +- `PostHog/posthog` is now a currently verified live boundary-sensitive lane through `Phase 4R-D`. +- it is live through first-party Unreal control-plane contract code plus bundled reference-target materialization rather than through donor shell adoption or any carryover from the excluded `ee/` subtree. + ## Scope - Current repo set audited: the 71 `HyperTwist` rows in `docs/repo_portfolio_unified_source_audit_v6_3.csv`. @@ -126,6 +131,7 @@ These rows are now materially present in checked first-party Unreal source, even | `apache/echarts` | Apache-2.0 | landed via `Phase 3R-C` | `HyperTwistTrainingAnalyticsLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `apache-echarts-reference-pages.jsonl` | First-party analytics report bundle, TSV data-view export, live-timer reporting accessors, and bundled analytics reference-target surfaces now landed in first-party source and materialized reference outputs | | `google/model-viewer` | Apache-2.0 | landed via `Phase 3R-D` | `HyperTwistTrainingViewerLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `google-model-viewer-reference-pages.jsonl` | First-party browser viewer, compact editor, asset-validation, renderer-comparison, and docs-boundary reference surfaces now landed in first-party source and materialized reference outputs | | `google/model-viewer/packages/shared-assets` | `Apache-2.0` container; mixed per-asset terms | landed via `Phase 4R-C` | `HyperTwistTrainingSharedAssetLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `google-model-viewer-shared-assets-reference-pages.jsonl` | First-party shared-assets allowlist, provenance-boundary, fixture-refresh, and bundled fixture/reference-target surfaces now landed in first-party source and materialized reference outputs without blanket donor asset shipping | +| `PostHog/posthog` | `MIT` outside `ee/`; enterprise-restricted inside `ee/` | landed via `Phase 4R-D` | `HyperTwistTrainingControlPlaneLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `posthog-posthog-control-plane-reference-pages.jsonl` | First-party replay-diagnostic, feature-governance, scheduled-change, early-access, and subtree-compliance reference surfaces now landed in first-party source and materialized reference outputs while keeping `ee/` excluded | | `met4citizen/TalkingHead` | MIT | landed via `Phase 3R-E` | `HyperTwistTrainingCompanionLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `met4citizen-talkinghead-reference-pages.jsonl` | First-party embodied companion narration, subtitle timing, viseme/lip-sync, avatar-only embed, gesture/mood, and vendor-boundary reference surfaces now landed in first-party source and materialized reference outputs | | `mrdoob/three.js` | MIT | landed via `Phase 3R-F` | `HyperTwistTrainingSpatialLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `browser-spatial-support-reference-pages.jsonl` | First-party browser scene, renderer, camera, render-loop, and WebXR support contracts now landed in first-party source and materialized reference outputs | | `pmndrs/react-three-fiber` | MIT | landed via `Phase 3R-F` | `HyperTwistTrainingSpatialLibrary.h/.cpp`; `HyperTwistTrainingRuntimeLibrary.h/.cpp`; `hypertwist-reference-incorporation-targets.json`; `hypertwist-catalog-materialization-summary.json`; `browser-spatial-support-reference-pages.jsonl` | First-party React-side browser renderer, createRoot/frameloop, store, and event-bridge contracts now landed in first-party source and materialized reference outputs | @@ -175,7 +181,6 @@ These rows are donor-approved or integration-shaped in the current docs, but thi - `pmndrs/uikit` - `pmndrs/use-gesture` - `pmndrs/zustand` -- `PostHog/posthog` - `roice3/Magic120Cell` - `roice3/MagicCube5D` - `roice3/MagicTile` @@ -350,7 +355,7 @@ That does not make them legally cleared or deeply audited. It only means this pa ## Recommended next implementation slice -The next clean bounded move is to preserve the seventeen landed lanes as the current truth, keep the `onionhoney/roux-trainers` clean-room status explicit everywhere, keep the landed `cubing/cubing.js` `MPL` boundary explicit everywhere, keep the landed `cutelyaware/magiccube4d` attribution/provenance boundary explicit everywhere, keep the landed `google/model-viewer/packages/shared-assets` allowlist/provenance boundary explicit everywhere, and continue from the closed retained-set packet sequence with `Phase 4R-D` for `PostHog/posthog`, while leaving the optional `Phase 3R-G` browser comparison lane deferred unless the landed primary browser spatial stack exposes a real gap. After that, do a second pass focused on the additional live non-71 surfaces (`SpeedCubeDB` and `CubingApp`) so the active training catalog has a complete provenance board before any further widening work resumes. +The next clean bounded move is to preserve the eighteen landed lanes as the current truth, keep the `onionhoney/roux-trainers` clean-room status explicit everywhere, keep the landed `cubing/cubing.js` `MPL` boundary explicit everywhere, keep the landed `cutelyaware/magiccube4d` attribution/provenance boundary explicit everywhere, keep the landed `google/model-viewer/packages/shared-assets` allowlist/provenance boundary explicit everywhere, keep the landed `PostHog/posthog` root-`MIT`-core-versus-`ee/` subtree boundary explicit everywhere, and continue from the closed retained-set packet sequence with `Phase 4R-E` for `screenpipe/screenpipe`, while leaving the optional `Phase 3R-G` browser comparison lane deferred unless the landed primary browser spatial stack exposes a real gap. After that, close the commercially sensitive `remotion-dev/remotion` sidecar decision and then do a second pass focused on the additional live non-71 surfaces (`SpeedCubeDB` and `CubingApp`) so the active training catalog has a complete provenance board before any further widening work resumes. For the readable all-rows follow-up board that pairs this audit with the reset schedule, use: diff --git a/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md b/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md index c3480de..273cca7 100644 --- a/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md +++ b/docs/HYPERTWIST_CANONICAL_RESTART_RECONCILIATION_2026-05-12.md @@ -38,9 +38,9 @@ Current handling: The current reconciled HyperTwist truth is: - current curated HyperTwist shallow-eval set: `71` repos -- currently verified live in checked `UnrealHyperTwist` surfaces: `17` +- currently verified live in checked `UnrealHyperTwist` surfaces: `18` - currently verified live permissive lanes: `13` -- currently verified live boundary-sensitive lanes: `3` +- currently verified live boundary-sensitive lanes: `4` - currently verified live restrictive lanes: `1` The thirteen currently verified live permissive lanes are: @@ -59,11 +59,12 @@ The thirteen currently verified live permissive lanes are: - `poliva/cubedex` - `newyork-anthonyng/rubiks-cross-trainer` -The three currently verified live boundary-sensitive lanes are: +The four currently verified live boundary-sensitive lanes are: - `cubing/cubing.js` - `cutelyaware/magiccube4d` - `google/model-viewer/packages/shared-assets` +- `PostHog/posthog` The one currently verified live restrictive lane is: @@ -161,11 +162,11 @@ Use the following only as lineage or historical context unless a restart doc exp The restart is not a mass revert. -It is a provenance and planning reset around the remaining `54` current non-live rows while preserving the seventeen already-landed lanes. +It is a provenance and planning reset around the remaining `53` current non-live rows while preserving the eighteen already-landed lanes. Required standing rules: -- preserve the seventeen landed lanes +- preserve the eighteen landed lanes - preserve `onionhoney/roux-trainers` as the only currently verified landed restrictive clean-room lane - do not collapse `selected`, `retained`, `integrate`, `repurpose`, or `donor bench` into `already implemented` - do not widen new donor-shaped implementation from the remaining `54` current non-live rows until the closed packet sequence routes it @@ -507,13 +508,14 @@ Result: - `cubing/cubing.js` is now the fifteenth live row overall and one live boundary-sensitive lane through the closed `Phase 4R-A` classic-cubing adapter packet - `cutelyaware/magiccube4d` is now the sixteenth live row overall and the second live boundary-sensitive lane through the closed `Phase 4R-B` attributed legacy `4D` adapter packet - `google/model-viewer/packages/shared-assets` is now the seventeenth live row overall and the third live boundary-sensitive lane through the closed `Phase 4R-C` shared-assets allowlist packet -- `PostHog/posthog`, `screenpipe/screenpipe`, and `remotion-dev/remotion` remain bounded sidecar, allowlist, or reference lanes rather than broad donor shells +- `PostHog/posthog` is now the eighteenth live row overall and the fourth live boundary-sensitive lane through the closed `Phase 4R-D` control-plane packet +- `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 -- `docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` is the source-backed preservation authority for the seventeen already-live rows +- `docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` is the source-backed preservation authority for the eighteen already-live rows - `docs/HYPERTWIST_PHASE_2R_PACKET_2R_A_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md` is the packet authority for the five core retained permissive rows once source extraction has already been read - `docs/HYPERTWIST_PHASE_2R_PACKET_2R_B_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md` is the packet authority for the primary retained permissive support-plane rows once source extraction has already been read - `docs/HYPERTWIST_PHASE_2R_PACKET_2R_C_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md` is the packet authority for the final residual permissive `0R-B` adjunct and alternative-support rows once source extraction has already been read @@ -527,7 +529,7 @@ License-tracking boundary: The next bounded move is: -1. preserve the seventeen landed rows as the current truth -2. keep `Aarav2709/KubeTimr`, `Hypercubers/hypercubing.xyz`, `apache/echarts`, `google/model-viewer`, `met4citizen/TalkingHead`, `mrdoob/three.js`, `pmndrs/react-three-fiber`, `pmndrs/xr`, `cubing/cubing.js`, `cutelyaware/magiccube4d`, and `google/model-viewer/packages/shared-assets` on preserve-and-enhance footing through their landed packets -3. open `Phase 4R-D` -4. widen `PostHog/posthog` as the retained telemetry, replay-diagnostic, and feature-governance boundary-sensitive lane with `ee/` excluded, while keeping the optional `Phase 3R-G` browser comparison lane deferred unless the landed primary browser spatial stack exposes a real gap +1. preserve the eighteen landed rows as the current truth +2. keep `Aarav2709/KubeTimr`, `Hypercubers/hypercubing.xyz`, `apache/echarts`, `google/model-viewer`, `met4citizen/TalkingHead`, `mrdoob/three.js`, `pmndrs/react-three-fiber`, `pmndrs/xr`, `cubing/cubing.js`, `cutelyaware/magiccube4d`, `google/model-viewer/packages/shared-assets`, and `PostHog/posthog` on preserve-and-enhance footing through their landed packets +3. open `Phase 4R-E` +4. widen `screenpipe/screenpipe` as the retained capture, history, replay, deterministic-permission, and local-vault boundary-sensitive lane with `ee/` excluded, while keeping `remotion-dev/remotion` as the later commercially sensitive media-export sidecar and keeping the optional `Phase 3R-G` browser comparison lane deferred unless the landed primary browser spatial stack exposes a real gap diff --git a/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md b/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md index 1849524..64905f8 100644 --- a/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md +++ b/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md @@ -6,12 +6,12 @@ Created on `2026-05-13` This audit is `closed`. -It is the canonical source-backed preservation authority for the seventeen HyperTwist rows that are already live in checked first-party Unreal surfaces. +It is the canonical source-backed preservation authority for the eighteen HyperTwist rows that are already live in checked first-party Unreal surfaces. It closes the symmetry gap that remained after `Phase 0R` and `Phase 1R`: -- the `54` non-live rows already have source-backed authority through `Packet 0R-A` through `Packet 0R-E` -- the `17` live rows now have source-backed authority through this live-lane preservation audit +- the `53` non-live rows already have source-backed authority through `Packet 0R-A` through `Packet 0R-E` +- the `18` live rows now have source-backed authority through this live-lane preservation audit ## Purpose @@ -28,7 +28,7 @@ Use this document to answer the live-lane questions that the `0R-*` packets do n This document intentionally separates permissive, boundary-sensitive, and restrictive handling: - the thirteen permissive live lanes below are documented from donor mirror source plus first-party Unreal outputs -- the three live boundary-sensitive lanes, `cubing/cubing.js`, `cutelyaware/magiccube4d`, and `google/model-viewer/packages/shared-assets`, are documented from donor mirror source plus first-party Unreal outputs while preserving their explicit notice, attribution, and adapter/provenance boundaries +- the four live boundary-sensitive lanes, `cubing/cubing.js`, `cutelyaware/magiccube4d`, `google/model-viewer/packages/shared-assets`, and `PostHog/posthog`, are documented from donor mirror source plus first-party Unreal outputs while preserving their explicit notice, attribution, adapter/provenance, and subtree-exclusion boundaries - the one restrictive live lane, `onionhoney/roux-trainers`, is documented here only from first-party Unreal outputs, `REPO_LICENSE_TRACKING.md`, and scrubbed clean-room materials Do not use this document as permission for `Model B` to read the restrictive mirror. @@ -38,20 +38,20 @@ Do not use this document as permission for `Model B` to read the restrictive mir Current result: - current curated HyperTwist shallow-eval set: `71` -- already covered by `0R-A` through `0R-E`: `55` current non-live rows -- covered by this audit: `17` live rows +- already covered by `0R-A` through `0R-E`: `53` current non-live rows +- covered by this audit: `18` live rows - total rows with source-backed authority now visible in canonical docs: `71` - live permissive preserve lanes: `13` -- live boundary-sensitive preserve lanes: `3` +- live boundary-sensitive preserve lanes: `4` - live restrictive clean-room preserve lanes: `1` -- additional live rows discovered beyond the original six from the 2026-05-11 audit: `11` +- additional live rows discovered beyond the original six from the 2026-05-11 audit: `12` ## Authority order For future work on the already-live lanes, read in this order: 1. this live-lane audit -2. the relevant landed implementation packet where one exists, currently [HYPERTWIST_PHASE_3R_PACKET_3R_A_KUBETIMR_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_A_KUBETIMR_IMPLEMENTATION_2026-05-13.md:1) for `Aarav2709/KubeTimr`, [HYPERTWIST_PHASE_3R_PACKET_3R_B_HYPERCUBING_XYZ_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_B_HYPERCUBING_XYZ_IMPLEMENTATION_2026-05-13.md:1) for `Hypercubers/hypercubing.xyz`, [HYPERTWIST_PHASE_3R_PACKET_3R_C_ECHARTS_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_C_ECHARTS_IMPLEMENTATION_2026-05-13.md:1) for `apache/echarts`, [HYPERTWIST_PHASE_3R_PACKET_3R_D_MODEL_VIEWER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_D_MODEL_VIEWER_IMPLEMENTATION_2026-05-13.md:1) for `google/model-viewer`, [HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) for `cubing/cubing.js`, [HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) for `cutelyaware/magiccube4d`, [HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md:1) for `google/model-viewer/packages/shared-assets`, [HYPERTWIST_PHASE_3R_PACKET_3R_E_TALKINGHEAD_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_E_TALKINGHEAD_IMPLEMENTATION_2026-05-13.md:1) for `met4citizen/TalkingHead`, and [HYPERTWIST_PHASE_3R_PACKET_3R_F_BROWSER_SPATIAL_SUPPORT_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_F_BROWSER_SPATIAL_SUPPORT_IMPLEMENTATION_2026-05-13.md:1) for `mrdoob/three.js`, `pmndrs/react-three-fiber`, and `pmndrs/xr` +2. the relevant landed implementation packet where one exists, currently [HYPERTWIST_PHASE_3R_PACKET_3R_A_KUBETIMR_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_A_KUBETIMR_IMPLEMENTATION_2026-05-13.md:1) for `Aarav2709/KubeTimr`, [HYPERTWIST_PHASE_3R_PACKET_3R_B_HYPERCUBING_XYZ_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_B_HYPERCUBING_XYZ_IMPLEMENTATION_2026-05-13.md:1) for `Hypercubers/hypercubing.xyz`, [HYPERTWIST_PHASE_3R_PACKET_3R_C_ECHARTS_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_C_ECHARTS_IMPLEMENTATION_2026-05-13.md:1) for `apache/echarts`, [HYPERTWIST_PHASE_3R_PACKET_3R_D_MODEL_VIEWER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_D_MODEL_VIEWER_IMPLEMENTATION_2026-05-13.md:1) for `google/model-viewer`, [HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) for `cubing/cubing.js`, [HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) for `cutelyaware/magiccube4d`, [HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md:1) for `google/model-viewer/packages/shared-assets`, [HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md:1) for `PostHog/posthog`, [HYPERTWIST_PHASE_3R_PACKET_3R_E_TALKINGHEAD_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_E_TALKINGHEAD_IMPLEMENTATION_2026-05-13.md:1) for `met4citizen/TalkingHead`, and [HYPERTWIST_PHASE_3R_PACKET_3R_F_BROWSER_SPATIAL_SUPPORT_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_3R_PACKET_3R_F_BROWSER_SPATIAL_SUPPORT_IMPLEMENTATION_2026-05-13.md:1) for `mrdoob/three.js`, `pmndrs/react-three-fiber`, and `pmndrs/xr` 3. [HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md:1) 4. [REPO_LICENSE_TRACKING.md](C:/HyperTwist/docs/REPO_LICENSE_TRACKING.md:1) 5. [MODEL_B_SOURCE_ACCESS_BOUNDARY.md](C:/HyperTwist/docs/MODEL_B_SOURCE_ACCESS_BOUNDARY.md:1) for the `onionhoney/roux-trainers` lane @@ -65,6 +65,7 @@ For future work on the already-live lanes, read in this order: | `apache/echarts` | `Apache-2.0` | landed analytics, reporting, export, and progress-visualization lane | the main landed permissive analytics and report-contract preserve lane | gameplay/runtime ownership, generic BI shell ownership, or separate live-lane claims for `zrender` / `echarts-gl` | | `google/model-viewer` | `Apache-2.0` | landed browser presentation, compact editor, and standards-aware asset-QA lane | the main landed permissive browser viewer and support-plane asset-QA preserve lane | gameplay/runtime ownership, donor docs/demo shell ownership, mixed-asset shipping outside the explicit `shared-assets` allowlist boundary, or separate live-lane claims for the subordinate package rows and Khronos sidecars | | `google/model-viewer/packages/shared-assets` | `Apache-2.0` container with mixed per-asset terms | landed shared-asset allowlist, provenance-boundary, and fixture-refresh lane | the landed boundary-sensitive fixture, environment-lighting, documentation-example, and visual-QA preserve lane beneath `google/model-viewer` | blanket shipping of the full mixed-provenance bundle, gameplay/runtime ownership, or silent erasure of attribution, review-only, and local-only boundaries | +| `PostHog/posthog` | `MIT` outside `ee/`; enterprise license inside `ee/` | landed replay-diagnostic, feature-governance, scheduled-change, early-access, and subtree-compliance lane | the landed boundary-sensitive control-plane preserve lane for replay diagnostics, staged rollout governance, early-access lifecycle, and explicit `MIT`-core-versus-`ee/` compliance boundaries | `ee/` subtree carryover, product-analytics-shell ownership, broad PostHog product adoption, or silent erosion of the mixed-license boundary | | `cubing/cubing.js` | `MPL-2.0 OR GPL-3.0-or-later` | landed classic-cubing semantic, geometry, viewer-adapter, device-adapter, and search-contract lane | the main landed boundary-sensitive classic-cubing adapter preserve lane | private upstream fork posture, hyper-runtime replacement, donor Twizzle shell ownership, or a shortcut around future `twisty.js` clean-room discipline | | `cutelyaware/magiccube4d` | `custom permissive attribution-request license` | landed legacy `4D` history, macro, topology-reference, interaction, and provenance-boundary lane | the main landed boundary-sensitive legacy `4D` interaction/history preserve lane beneath the `Hyperspeedcube` anchor | runtime-anchor replacement, donor Swing shell ownership, or silent erasure of attribution, upstream-link, and `MyMath` provenance duties | | `mrdoob/three.js` | `MIT` | landed browser scene, renderer, camera, and controller-space substrate lane | the main landed permissive browser `3D` substrate preserve lane | gameplay/runtime ownership, browser-first product-shell ownership, or separate live-lane claims for subordinate helper packages | @@ -623,6 +624,73 @@ Future widening rule: - keep the `MyMath.java` provenance caveat visible when closely related numeric helper parity work is discussed - read the landed [HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) before treating this lane as an open donor candidate again +### `PostHog/posthog` + +Current status: + +- `implemented_live_boundary_sensitive` +- preserve as a landed first-party boundary-sensitive control-plane lane + +Licensing posture: + +- `MIT` outside `ee/`; enterprise license inside `ee/` +- preserve the explicit root-versus-`ee/` subtree boundary +- no donor `ee/` files were copied into first-party owned source in the landed `Phase 4R-D` packet + +Source surfaces inspected: + +- [README.md](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/README.md:1) +- [LICENSE](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/LICENSE:1) +- [ee/LICENSE](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/ee/LICENSE:1) +- [frontend/src/scenes/session-recordings/utils/replayCaptureDiagnostics.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/session-recordings/utils/replayCaptureDiagnostics.ts:1) +- [products/replay/skills/diagnosing-missing-recordings/references/diagnostic-signals.md](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/replay/skills/diagnosing-missing-recordings/references/diagnostic-signals.md:1) +- [frontend/src/scenes/session-recordings/player/utils/segmenter.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/session-recordings/player/utils/segmenter.ts:1) +- [frontend/src/scenes/session-recordings/player/utils/player-logging.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/session-recordings/player/utils/player-logging.ts:1) +- [frontend/src/scenes/feature-flags/featureFlagReleaseConditionsLogic.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/feature-flags/featureFlagReleaseConditionsLogic.ts:1) +- [frontend/src/scenes/feature-flags/featureFlagScheduleEditLogic.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/feature-flags/featureFlagScheduleEditLogic.ts:1) +- [frontend/src/scenes/feature-flags/activityDescriptions.tsx](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/feature-flags/activityDescriptions.tsx:1) +- [products/feature_flags/backend/models/team_feature_flag_defaults_config.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/feature_flags/backend/models/team_feature_flag_defaults_config.py:1) +- [products/early_access_features/backend/models.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/early_access_features/backend/models.py:1) +- [products/early_access_features/backend/api.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/early_access_features/backend/api.py:1) + +First-party live evidence: + +- [HyperTwistTrainingControlPlaneLibrary.h](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h:1) +- [HyperTwistTrainingControlPlaneLibrary.cpp](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.cpp:1) +- [HyperTwistTrainingRuntimeLibrary.h](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h:1) +- [HyperTwistTrainingRuntimeLibrary.cpp](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp:1) +- [hypertwist-reference-incorporation-targets.json](C:/HyperTwist/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-reference-incorporation-targets.json:1) +- [hypertwist-catalog-materialization-summary.json](C:/HyperTwist/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-catalog-materialization-summary.json:1) +- [posthog-posthog-control-plane-reference-pages.jsonl](C:/HyperTwist/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl:1) + +Preserved landed value: + +- explicit replay capture-failure diagnostics, trigger-state interpretation, sampling semantics, and warning categorization +- explicit replay segmentation and timeline interpretation posture for capture gaps and replay-health signals +- explicit feature-flag rollout-group, multivariate, evaluation-runtime, and blast-radius review semantics +- explicit scheduled rollout, recurrence, and cron-validation rules +- explicit early-access enrollment, rollout-to-all, stage-transition, and lifecycle-event semantics +- explicit root-`MIT`-core-versus-`ee/` subtree compliance boundary in first-party runtime surfaces + +Excluded or non-promotion boundary: + +- do not promote this lane into the `ee/` subtree +- do not promote it into blanket PostHog product-shell adoption +- do not promote it into product analytics, experiments, or warehouse platform ownership +- do not erase the explicit mixed-license boundary between the root `MIT` core and enterprise paths + +Rationale: + +- the repo is valuable because it is the strongest retained telemetry, replay-diagnostic, staged-rollout, and early-access control-plane donor in the set +- its strongest landed value is bounded control-plane semantics rather than full analytics-shell ownership +- the correct posture is a first-party Unreal control-plane lane with explicit subtree exclusion and compliance visibility, not broad mixed-license donor carryover + +Future widening rule: + +- widen only through ordinary first-party enhancement work that preserves the explicit `MIT`-core-versus-`ee/` boundary +- preserve the checked root license materials while keeping enterprise subtrees excluded from relaxed donor use +- read the landed [HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md:1) before treating this lane as an open donor candidate again + ### `met4citizen/TalkingHead` Current status: @@ -1042,7 +1110,7 @@ Future widening rule: HyperTwist now has symmetric source-backed authority across the current `71`-row curated set: -- `55` current non-live rows through `Packet 0R-A` through `Packet 0R-E` -- `16` live rows through this live-lane preservation audit +- `53` current non-live rows through `Packet 0R-A` through `Packet 0R-E` +- `18` live rows through this live-lane preservation audit For live-lane work, the next instance should not start from stale donor labels or from the raw mirror alone. It should start from this document, then the retained-set contract, then the repo-row license tracker. diff --git a/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md b/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md index df43606..7d016cd 100644 --- a/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md +++ b/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md @@ -68,21 +68,21 @@ Document responsibilities are now strict: Current post-`Phase 1R` truth: - curated HyperTwist shallow-eval set: `71` -- currently verified live in checked Unreal surfaces: `17` +- currently verified live in checked Unreal surfaces: `18` - rows with source-backed authority now visible in canonical docs: `71` - retained rows total: `68` - discarded from the active retained set: `3` Retained split: -- landed/live preserve lanes: `17` -- non-live active implementation-board rows: `42` +- landed/live preserve lanes: `18` +- non-live active implementation-board rows: `41` - non-live benchmark, oracle, or clean-room-later rows outside the active implementation board: `9` -The `43` non-live active implementation-board rows break down as: +The `41` non-live active implementation-board rows break down as: - straight permissive implementation candidates: `35` -- boundary-sensitive adapter or sidecar candidates: `3` +- boundary-sensitive adapter or sidecar candidates: `2` - restrictive clean-room-only candidates: `4` ## Contract classes @@ -90,10 +90,10 @@ The `43` non-live active implementation-board rows break down as: | Class | Count | Earliest next phase | Meaning | | --- | --- | --- | --- | | `landed_permissive_preserve` | `13` | ordinary first-party enhancement only | Already live. Preserve notices and attribution. Do not treat as speculative donor backlog. | -| `landed_boundary_sensitive_preserve` | `3` | ordinary first-party enhancement only with explicit notice discipline | Already live. Preserve the explicit notice, attribution, and adapter/provenance boundaries and do not turn them into silent donor-shell carryover. | +| `landed_boundary_sensitive_preserve` | `4` | ordinary first-party enhancement only with explicit notice discipline | Already live. Preserve the explicit notice, attribution, subtree, and adapter/provenance boundaries and do not turn them into silent donor-shell carryover. | | `landed_clean_room_preserve` | `1` | ordinary first-party enhancement only | Already live. Preserve the clean-room chain and work from first-party outputs, not the restrictive mirror. | | `phase3r_permissive_candidate` | `35` | `Phase 3R` | Retained for direct permissive implementation or bounded first-party adaptation. No clean-room lane is needed. | -| `phase4r_boundary_candidate` | `4` | `Phase 4R` | Retained only through explicit adapter, allowlist, sidecar, or notice-sensitive use. | +| `phase4r_boundary_candidate` | `2` | `Phase 4R` | Retained only through explicit adapter, allowlist, sidecar, or notice-sensitive use. | | `phase5r_clean_room_candidate` | `4` | `Phase 5R` | Retained only through refreshed Model A / Model B clean-room work. | | `benchmark_oracle_only` | `9` | outside the active implementation board | Retained only for validation, parity, oracle behavior, or a later explicitly reopened clean-room-later lane. | | `discarded_active_set` | `3` | none | Excluded from the retained implementation board. Do not schedule new work from these rows. | @@ -111,7 +111,7 @@ The `43` non-live active implementation-board rows break down as: ## Landed preserve lanes -These seventeen rows are the only currently verified live rows in checked Unreal surfaces. +These eighteen rows are the only currently verified live rows in checked Unreal surfaces. ### Landed permissive preserve @@ -141,16 +141,19 @@ Contract: - `cubing/cubing.js` โ€” `MPL-2.0 OR GPL-3.0-or-later` - `cutelyaware/magiccube4d` โ€” `custom permissive attribution-request license` - `google/model-viewer/packages/shared-assets` โ€” `Apache-2.0 container; mixed per-asset terms` +- `PostHog/posthog` โ€” `MIT` outside `ee/`; enterprise license inside `ee/` Contract: - preserve as the landed first-party boundary-sensitive classic-cubing adapter lane - preserve as the landed first-party attributed legacy `4D` interaction, history, macro, topology-reference, and provenance-boundary lane beneath the `Hyperspeedcube` anchor - preserve as the landed first-party shared-assets allowlist, provenance-boundary, and fixture-refresh lane beneath `google/model-viewer` +- preserve as the landed first-party control-plane telemetry, replay-diagnostic, scheduled-change, early-access, and explicit root-`MIT`-core-versus-`ee/` compliance lane - preserve the explicit `MPL` notice and publication-duty boundary - preserve the explicit attribution, upstream-link, and provenance boundary for `cutelyaware/magiccube4d` - preserve the explicit per-asset allowlist, review-only, and local-only boundary for `google/model-viewer/packages/shared-assets` -- read [HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md:1), then [HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md:1), [HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md:1), or [HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md:1) as appropriate, then [HYPERTWIST_MODEL_A_MAX_VALUE_EXTRACTION_MODUS_OPERANDI_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_MODEL_A_MAX_VALUE_EXTRACTION_MODUS_OPERANDI_2026-05-13.md:1), before widening these lanes +- preserve the explicit `ee/` exclusion and mixed-license subtree boundary for `PostHog/posthog` +- read [HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md:1), then [HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md:1), [HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md:1), [HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md:1), or [HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md:1) as appropriate, then [HYPERTWIST_MODEL_A_MAX_VALUE_EXTRACTION_MODUS_OPERANDI_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_MODEL_A_MAX_VALUE_EXTRACTION_MODUS_OPERANDI_2026-05-13.md:1), before widening these lanes - do not treat either mirror as a silent private-fork or donor-shell surface ### Landed restrictive clean-room preserve @@ -255,7 +258,6 @@ Contract: ### Remaining `0R-C` boundary-sensitive set -> `Phase 4R` -- `PostHog/posthog` โ€” bounded telemetry/replay/feature-governance donor with `ee/` excluded - `remotion-dev/remotion` โ€” bounded commercial-sensitive media-export and explainer sidecar/reference lane - `screenpipe/screenpipe` โ€” bounded capture/history/replay donor with `ee/` excluded @@ -349,12 +351,14 @@ Do not: ## Next move -`Phase 2R` is now closed, `Phase 3R-A` through `Phase 3R-F` are now also closed for the primary straight-permissive widening path, and `Phase 4R-A` through `Phase 4R-C` are now closed for the first three boundary-sensitive live lanes. +`Phase 2R` is now closed, `Phase 3R-A` through `Phase 3R-F` are now also closed for the primary straight-permissive widening path, and `Phase 4R-A` through `Phase 4R-D` are now closed for the first four boundary-sensitive live lanes. -The next bounded move after those closures is `Phase 4R-D`: +The next bounded move after those closures is `Phase 4R-E`: - preserve the landed `cubing/cubing.js` lane through its live-lane audit and `Phase 4R-A` packet authority - preserve the landed `cutelyaware/magiccube4d` lane through its live-lane audit and `Phase 4R-B` packet authority - preserve the landed `google/model-viewer/packages/shared-assets` lane through its live-lane audit and `Phase 4R-C` packet authority -- widen `PostHog/posthog` as the retained telemetry, replay-diagnostic, and feature-governance boundary-sensitive lane with `ee/` excluded +- preserve the landed `PostHog/posthog` lane through its live-lane audit and `Phase 4R-D` packet authority +- widen `screenpipe/screenpipe` as the retained capture, history, replay, deterministic-permission, and local-vault boundary-sensitive lane with `ee/` excluded +- keep `remotion-dev/remotion` behind the later commercially sensitive media-export and explainer sidecar decision - keep the optional `Phase 3R-G` `pissang/claygl` and `pissang/clay-viewer` comparison lane deferred unless the landed primary browser spatial stack exposes a real gap that requires it diff --git a/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md b/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md new file mode 100644 index 0000000..52e5492 --- /dev/null +++ b/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md @@ -0,0 +1,205 @@ +# HyperTwist Phase 4R Packet 4R-D PostHog Control-Plane Implementation + +Created on `2026-05-13` + +## Status + +`Phase 4R / Packet 4R-D` is now `closed`. + +This packet converts the retained boundary-sensitive `PostHog/posthog` row from a queued replay, telemetry, and feature-governance donor into a landed first-party HyperTwist control-plane lane. + +It does not reopen `Phase 0R`, `Phase 1R`, `Phase 2R`, `Phase 3R`, `Phase 4R-A`, `Phase 4R-B`, or `Phase 4R-C`. + +Those earlier packets still own: + +- source-value extraction +- retained-set routing +- ownership and acceptance boundaries +- landed browser viewer, browser spatial, classic-cubing, legacy `4D`, and shared-assets owner decisions + +This packet owns the next question instead: + +- what first-party control-plane implementation actually landed +- how the retained PostHog value was reduced to replay diagnostics, feature governance, scheduled changes, early-access rollout, and compliance boundaries +- how the `ee/` subtree stayed excluded +- what validation was completed +- what the next bounded move is after this landing + +## Authority order + +For future work on the PostHog boundary-sensitive lane, read in this order: + +1. this packet for landed control-plane scope, `ee/` exclusion result, and validation result +2. [HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md:1) for live-lane preserve posture +3. [HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md:1) for retained-set routing +4. [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) for source-value extraction and non-promotion rationale +5. [HYPERTWIST_MODEL_A_MAX_VALUE_EXTRACTION_MODUS_OPERANDI_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_MODEL_A_MAX_VALUE_EXTRACTION_MODUS_OPERANDI_2026-05-13.md:1) for the canonical interpretation rule that keeps future `Model A` extraction rich rather than shallow +6. [REPO_LICENSE_TRACKING.md](C:/HyperTwist/docs/REPO_LICENSE_TRACKING.md:1) for path-level license, subtree, notice, and provenance obligations + +## Packet licensing snapshot + +Owner row widened by this packet: + +- `PostHog/posthog`: `MIT` outside `ee/`; enterprise license inside `ee/` + +Checked local notice and boundary surfaces: + +- [README.md](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/README.md:1) +- [LICENSE](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/LICENSE:1) +- [ee/LICENSE](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/ee/LICENSE:1) + +Checked retained source surfaces: + +- [frontend/src/scenes/session-recordings/utils/replayCaptureDiagnostics.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/session-recordings/utils/replayCaptureDiagnostics.ts:1) +- [products/replay/skills/diagnosing-missing-recordings/references/diagnostic-signals.md](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/replay/skills/diagnosing-missing-recordings/references/diagnostic-signals.md:1) +- [frontend/src/scenes/session-recordings/player/utils/segmenter.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/session-recordings/player/utils/segmenter.ts:1) +- [frontend/src/scenes/session-recordings/player/utils/player-logging.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/session-recordings/player/utils/player-logging.ts:1) +- [frontend/src/scenes/feature-flags/featureFlagReleaseConditionsLogic.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/feature-flags/featureFlagReleaseConditionsLogic.ts:1) +- [frontend/src/scenes/feature-flags/featureFlagScheduleEditLogic.ts](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/feature-flags/featureFlagScheduleEditLogic.ts:1) +- [frontend/src/scenes/feature-flags/activityDescriptions.tsx](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/frontend/src/scenes/feature-flags/activityDescriptions.tsx:1) +- [products/feature_flags/backend/models/team_feature_flag_defaults_config.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/feature_flags/backend/models/team_feature_flag_defaults_config.py:1) +- [products/early_access_features/backend/models.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/early_access_features/backend/models.py:1) +- [products/early_access_features/backend/api.py](C:/Workspaces/HyperTwist/mirrors/restrictive/PostHog/posthog/products/early_access_features/backend/api.py:1) + +Boundary result: + +- no donor `ee/` files were copied into first-party owned source in this packet +- no claim was made that the whole PostHog product shell is now live in HyperTwist +- the landed surface is a first-party Unreal control-plane contract and runtime API that preserves bounded replay-diagnostic, feature-governance, scheduled-change, and early-access value + +## Packet result + +`4R-D` lands the PostHog row as: + +- `PostHog/posthog` -> `implemented_live_boundary_sensitive` + +Current portfolio effect: + +- curated HyperTwist shallow-eval set: `71` +- currently verified live in checked Unreal surfaces: `18` +- live permissive lanes: `13` +- live boundary-sensitive lanes: `4` +- live restrictive clean-room lanes: `1` +- active non-live implementation-board rows: `41` + +## First-party landing surfaces + +The landed first-party Unreal surfaces are: + +- [HyperTwistTrainingControlPlaneLibrary.h](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.h:1) +- [HyperTwistTrainingControlPlaneLibrary.cpp](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingControlPlaneLibrary.cpp:1) +- [HyperTwistTrainingRuntimeLibrary.h](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Public/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.h:1) +- [HyperTwistTrainingRuntimeLibrary.cpp](C:/HyperTwist/UnrealHyperTwist/Source/UnrealHyperTwist/Private/HyperTwistTraining/HyperTwistTrainingRuntimeLibrary.cpp:1) +- [hypertwist-reference-incorporation-targets.json](C:/HyperTwist/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-reference-incorporation-targets.json:1) +- [hypertwist-catalog-materialization-summary.json](C:/HyperTwist/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/hypertwist-catalog-materialization-summary.json:1) +- [posthog-posthog-control-plane-reference-pages.jsonl](C:/HyperTwist/UnrealHyperTwist/Content/HyperTwistTraining/MaterializedCatalog/raw-extracts/posthog-posthog-control-plane-reference-pages.jsonl:1) + +## Landed implementation scope + +What landed: + +- a first-party control-plane package ledger covering: + - root `MIT` core versus `ee/` split + - replay/session-recording surfaces + - feature-flag governance surfaces + - early-access rollout surfaces +- a first-party replay-diagnostic contract that records: + - signal keys + - verdict taxonomy + - trigger and buffer semantics + - timeline segmentation notes + - replay warning categorization +- a first-party feature-governance contract that records: + - rollout groups + - multivariate variants + - evaluation runtimes + - blast-radius review posture + - activity-log summary patterns +- a first-party scheduled-change contract that records: + - supported change operations + - recurrence modes + - cron and date validation + - patch-only update posture +- a first-party early-access rollout contract that records: + - lifecycle stages + - active-stage behavior + - enrollment and rollout-to-all rules + - internal lifecycle events +- a first-party compliance boundary that keeps `ee/` and the broader analytics shell excluded +- first-party runtime-library accessors and TSV checklist export for the new control-plane bundle +- bundled first-party reference targets and raw source-reference capture for replay diagnostics, replay segmentation, feature governance, scheduled changes, early-access lifecycle, and the `ee/` compliance boundary + +What that means in practice: + +- `PostHog/posthog` now owns the landed boundary-sensitive control-plane preserve lane in HyperTwist +- the landed surface is a first-party Unreal contract and runtime API, not a vague future donor note +- the practical path is bounded replay, feature-governance, and staged-release value extraction rather than product-analytics-shell inheritance +- the `ee/` subtree remains explicitly excluded from the landed lane + +## Preserved landed value + +The donor value that was actually promoted is: + +- replay capture-failure diagnostics +- replay trigger, sampling, and buffer-state interpretation +- replay warning categorization and segmentation posture +- feature-flag rollout groups, variants, and evaluation-runtime semantics +- blast-radius review and activity-log summary posture +- scheduled future rollout, recurrence, and cron-validation rules +- early-access lifecycle and feature-enrollment transition rules +- explicit root-versus-`ee/` compliance boundaries + +## Excluded or non-promotion boundary + +Do not promote this packet into: + +- the `ee/` subtree +- a blanket license to consume the entire PostHog monorepo +- product analytics ownership +- experimentation or warehouse platform ownership +- SaaS deployment or self-hosting architecture ownership +- generic whole-product shell adoption + +Rationale: + +- the retained value is concentrated in control-plane telemetry, replay-diagnostic, and rollout-governance patterns +- the right legal and architectural posture is a bounded first-party control-plane lane, not broad product adoption +- the `ee/` split must stay explicit because the root `MIT` license does not flatten enterprise paths into ordinary donor surfaces + +## Acceptance markers satisfied + +The `0R-C` and `Phase 1R` retained-value markers for this lane are now satisfied in first-party Unreal surfaces: + +- a first-party replay-diagnostic contract exists +- a first-party feature-governance contract exists +- a first-party scheduled-change contract exists +- a first-party early-access rollout contract exists +- a first-party compliance boundary exists for `MIT` core versus `ee/` +- bundled first-party reference targets exist for replay diagnostics, segmentation, feature governance, scheduled changes, early-access lifecycle, and subtree compliance + +## Validation + +Validation completed for this packet: + +- Unreal build succeeded with: + - `C:\Program Files\Epic Games\UE_5.7\Engine\Build\BatchFiles\Build.bat UnrealHyperTwistEditor Win64 Development C:\HyperTwist\UnrealHyperTwist\UnrealHyperTwist.uproject -WaitMutex -NoHotReloadFromIDE` +- packet-bearing code compiled after the new `HyperTwistTrainingControlPlaneLibrary` and runtime accessors were added + +Build result: + +- `Succeeded` on `2026-05-13` + +Packet-close validation completed before landing: + +- `git diff --check` +- JSON validation for the updated materialized-catalog files and workspace manifest +- CSV import validation for the four canonical v6.3 ledgers +- final repo status check before commit + +## Next move + +The next bounded move is `Phase 4R-E`: + +- widen `screenpipe/screenpipe` as the retained boundary-sensitive capture, history, replay, permission, and local-vault sidecar lane with `ee/` excluded +- keep the optional `Phase 3R-G` `pissang/claygl` and `pissang/clay-viewer` comparison lane deferred unless the landed browser spatial stack exposes a real gap +- keep `remotion-dev/remotion` behind the later commercially sensitive media-export sidecar decision after the more immediate replay-support lane is closed 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 8642d14..f903640 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 @@ -527,22 +527,22 @@ Current curated HyperTwist shallow-eval set: Current verified live implementation state in checked `UnrealHyperTwist` source and materialized training surfaces: -- `17` repos are implemented/live +- `18` repos are implemented/live - `13` of those are permissive `MIT` or `Apache-2.0` lanes -- `3` of those are boundary-sensitive lanes +- `4` of those are boundary-sensitive lanes - `1` of those is a restrictive repo that was properly clean-roomed and then implemented Current 2026-05-11 repo-row reset counts: - `implemented_live_permissive`: `13` -- `implemented_live_boundary_sensitive`: `3` +- `implemented_live_boundary_sensitive`: `4` - `implemented_live_clean_room_verified`: `1` - `selected_not_live_permissive_candidate`: `35` -- `selected_not_live_boundary_sensitive`: `3` +- `selected_not_live_boundary_sensitive`: `2` - `selected_not_live_clean_room_candidate`: `4` - `not_live_reference_or_discard_candidate`: `12` -### The seventeen currently implemented/live repos +### The eighteen currently implemented/live repos Permissive `MIT` or `Apache-2.0` lanes already implemented/live: @@ -569,6 +569,7 @@ Boundary-sensitive lanes already implemented/live: - `cubing/cubing.js` - `cutelyaware/magiccube4d` - `google/model-viewer/packages/shared-assets` +- `PostHog/posthog` ### What this means @@ -614,16 +615,16 @@ At the moment, only one HyperTwist repo should be described this way: HyperTwist should now proceed from the following rule: -- preserve the seventeen live lanes +- preserve the eighteen live lanes - do not reopen the `onionhoney/roux-trainers` lane as if it were an unresolved accidental donor import -- do not treat the remaining `54` current non-live rows as already implemented +- do not treat the remaining `53` current non-live rows as already implemented - keep `Phase 0R`, `Phase 1R`, and `Phase 2R` closed as completed packet classes -- continue later-phase widening from the closed packet sequence, with `Phase 4R-D` as the next non-optional move and `Phase 3R-G` deferred unless a real browser comparison gap appears +- continue later-phase widening from the closed packet sequence, with `Phase 4R-E` as the next non-optional move and `Phase 3R-G` deferred unless a real browser comparison gap appears In practical terms: -- no, do **not** mass-revert the seventeen landed lanes -- no, do **not** pretend the remaining `54` current non-live rows are already implemented +- no, do **not** mass-revert the eighteen landed lanes +- no, do **not** pretend the remaining `53` current non-live rows are already implemented - yes, preserve the landed `Aarav2709/KubeTimr`, `Hypercubers/hypercubing.xyz`, `apache/echarts`, `google/model-viewer`, `met4citizen/TalkingHead`, `mrdoob/three.js`, `pmndrs/react-three-fiber`, `pmndrs/xr`, `cubing/cubing.js`, `cutelyaware/magiccube4d`, and `google/model-viewer/packages/shared-assets` lanes as normal first-party enhancement surfaces within their packet-specific legal boundaries - yes, widen the next retained lane only through its closed packet stack and packet-specific legal boundary @@ -990,7 +991,7 @@ Only after that: The clean practical sequence is: -1. preserve the seventeen landed lanes +1. preserve the eighteen landed lanes 2. make the current truth explicit everywhere 3. deep-evaluate the remaining `54` 4. discard what should not survive @@ -1012,7 +1013,8 @@ Current status: - `Phase 4R-A` is now also complete - `Phase 4R-B` is now also complete - `Phase 4R-C` is now also complete -- the next bounded move is `Phase 4R-D` for `PostHog/posthog`, with the optional `Phase 3R-G` comparison lane deferred unless the landed primary browser spatial stack exposes a real gap +- `Phase 4R-D` is now also complete +- the next bounded move is `Phase 4R-E` for `screenpipe/screenpipe`, with the optional `Phase 3R-G` comparison lane deferred unless the landed primary browser spatial stack exposes a real gap ## Companion docs @@ -1025,6 +1027,8 @@ Read together with: - `docs/HYPERTWIST_PHASE_2R_PACKET_2R_C_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md` - `docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md` - `docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md` +- `docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md` +- `docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md` - `docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md` - `docs/REPO_LICENSE_TRACKING.md` - `docs/HYPERTWIST_ROADMAP_OVERHAUL_EXPANSION_GUIDE.md` diff --git a/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md b/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md index 628daef..0314e20 100644 --- a/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md +++ b/docs/HYPERTWIST_REPO_STATE_BOARD_2026-05-11.md @@ -7,15 +7,15 @@ This board is the readable row-by-row companion to the v6.3 CSVs. It is derived ## Canonical summary - Current curated HyperTwist shallow-eval set: `71` repos -- Currently verified live in checked `UnrealHyperTwist` surfaces: `17` repos +- Currently verified live in checked `UnrealHyperTwist` surfaces: `18` repos - Live permissive lanes: `13` -- Live boundary-sensitive lanes: `3` +- Live boundary-sensitive lanes: `4` - Live restrictive clean-room lanes: `1` - Remaining rows requiring `Phase 0R` deep repo evaluation: `0` ## 2026-05-13 packet and contract overlay -The baseline live-state counts above now include the landed `Phase 3R-C` analytics lane, the landed `Phase 3R-D` browser viewer lane, the landed `Phase 3R-E` embodied companion lane, the landed `Phase 3R-F` browser spatial owner stack, the landed `Phase 4R-A` classic-cubing boundary-sensitive adapter lane, the landed `Phase 4R-B` attributed legacy `4D` boundary-sensitive lane, and the landed `Phase 4R-C` shared-assets allowlist lane, while `Phase 0R` and `Phase 1R` remain closed. +The baseline live-state counts above now include the landed `Phase 3R-C` analytics lane, the landed `Phase 3R-D` browser viewer lane, the landed `Phase 3R-E` embodied companion lane, the landed `Phase 3R-F` browser spatial owner stack, the landed `Phase 4R-A` classic-cubing boundary-sensitive adapter lane, the landed `Phase 4R-B` attributed legacy `4D` boundary-sensitive lane, the landed `Phase 4R-C` shared-assets allowlist lane, and the landed `Phase 4R-D` PostHog control-plane lane, while `Phase 0R` and `Phase 1R` remain closed. Read together with: @@ -38,6 +38,7 @@ Read together with: - [HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) - [HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md:1) - [HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md:1) +- [HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md](C:/HyperTwist/docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md:1) That overlay closes evaluation for: @@ -57,7 +58,7 @@ Important authority correction: - `Packet 0R-C` is now the deep-source value-extraction and exclusion-rationale authority for its six boundary-sensitive repos - `Packet 0R-D` is now the governance and Model A authority for its four restrictive clean-room repos - `Packet 0R-E` is now the deep-source benchmark, reference, clean-room-later, and discard authority for its twelve rows -- the live-lane preservation audit is now the source-backed authority for the seventeen already-landed rows +- the live-lane preservation audit is now the source-backed authority for the eighteen already-landed rows - `Phase 1R` is now the retained-set contract and handoff authority for all post-`Phase 0R` routing - `Phase 2R-A` is now the core ownership and acceptance authority for the five retained core permissive rows - `Phase 2R-B` is now the support-plane ownership and acceptance authority for the primary retained permissive support rows @@ -68,10 +69,11 @@ Important authority correction: - `Phase 3R-D` is now the landed implementation authority for `google/model-viewer` - `Phase 3R-E` is now the landed implementation authority for `met4citizen/TalkingHead` - `Phase 3R-F` is now the landed implementation authority for `mrdoob/three.js`, `pmndrs/react-three-fiber`, and `pmndrs/xr` -- future enhancement or preservation work for the sixteen landed rows should start from the live-lane audit, then the repo-specific landed packet where one exists, not from this board alone +- `Phase 4R-D` is now the landed implementation authority for `PostHog/posthog` +- future enhancement or preservation work for the eighteen landed rows should start from the live-lane audit, then the repo-specific landed packet where one exists, not from this board alone - future implementation of those seven repos should start from `Packet 0R-A`, not from this board alone - future implementation of the `0R-B` permissive set should start from `Packet 0R-B`, then the relevant closed `2R-B` or `2R-C` ownership packet, not from this board alone -- future implementation of the remaining five non-live boundary-sensitive repos should start from `Packet 0R-C`, not from this board alone +- future implementation of the remaining two non-live boundary-sensitive repos should start from `Packet 0R-C`, not from this board alone - future widening of the landed `cubing/cubing.js` lane should start from the live-lane audit, then `Phase 4R-A`, then `REPO_LICENSE_TRACKING.md` - future implementation of those four restrictive repos should start from `Packet 0R-D`, then `REPO_LICENSE_TRACKING.md`, then the repo-specific scrubbed Model A handoff - future implementation or benchmarking decisions for the twelve `0R-E` rows should start from `Packet 0R-E`, not from this board alone @@ -84,7 +86,7 @@ Packet overlay result: - all `6` boundary-sensitive rows have now been packet-evaluated - all `4` restrictive clean-room rows have now been packet-evaluated - all `12` reference, benchmark, reserve, and discard rows have now been packet-evaluated -- all `16` live rows now also have symmetric source-backed preservation authority +- all `18` live rows now also have symmetric source-backed preservation authority - `Phase 2R-A` is now closed for the five core retained permissive rows - `Phase 2R-B` is now closed for the retained permissive support-plane owners, subordinate packages, and helper/dependency lanes in scope - `Phase 2R-C` is now closed for the final retained permissive `0R-B` residual rows @@ -94,6 +96,7 @@ Packet overlay result: - `Phase 3R-D` is now closed for the `google/model-viewer` browser presentation, compact editor, and standards-aware asset-QA lane - `Phase 3R-E` is now closed for the `met4citizen/TalkingHead` embodied companion, narration, lip-sync, gesture, subtitle, and avatar-embed lane - `Phase 3R-F` is now closed for the `mrdoob/three.js`, `pmndrs/react-three-fiber`, and `pmndrs/xr` browser spatial owner trio +- `Phase 4R-D` is now closed for the `PostHog/posthog` replay-diagnostic, feature-governance, scheduled-change, early-access, and subtree-compliance control-plane lane - `Phase 2R` is now fully closed for the retained permissive set - `Aarav2709/KubeTimr` is now newly proven live in checked Unreal surfaces through `Phase 3R-A` - `Hypercubers/hypercubing.xyz` is now newly proven live in checked Unreal surfaces through `Phase 3R-B` @@ -103,20 +106,21 @@ Packet overlay result: - `mrdoob/three.js` is now newly proven live in checked Unreal surfaces through `Phase 3R-F` - `pmndrs/react-three-fiber` is now newly proven live in checked Unreal surfaces through `Phase 3R-F` - `pmndrs/xr` is now newly proven live in checked Unreal surfaces through `Phase 3R-F` +- `PostHog/posthog` is now newly proven live in checked Unreal surfaces through `Phase 4R-D` - `Phase 0R` is now fully closed - `Phase 1R` is now fully closed - the `0R-E` result split is: - `9` retained benchmark, oracle, or clean-room-later rows - `3` discarded active-set rows -- the next bounded move is `Phase 4R-D` +- the next bounded move is `Phase 4R-E` ## Count by live-state class - `implemented_live_permissive`: `13` -- `implemented_live_boundary_sensitive`: `3` +- `implemented_live_boundary_sensitive`: `4` - `implemented_live_clean_room_verified`: `1` - `selected_not_live_permissive_candidate`: `35` -- `selected_not_live_boundary_sensitive`: `3` +- `selected_not_live_boundary_sensitive`: `2` - `selected_not_live_clean_room_candidate`: `4` - `not_live_reference_or_discard_candidate`: `12` @@ -153,13 +157,14 @@ Count: `13` These are the currently verified live boundary-sensitive repos already implemented through explicit adapter, attribution, and provenance boundaries. -Count: `3` +Count: `4` | 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` | `implemented_live_boundary_sensitive` | `landed_boundary_sensitive_preserve` | `Phase 4R-A` closed. Preserve as the landed first-party classic-cubing semantic/runtime adapter lane; start future widening from the live-lane audit, then `Phase 4R-A`, then `REPO_LICENSE_TRACKING.md`; keep the explicit `MPL` notice and publication-duty boundary visible. | | `cutelyaware/magiccube4d` | `Custom broad-use license with attribution requested` | Locked Strategic Donor | `repurpose` | `implemented_live_boundary_sensitive` | `landed_boundary_sensitive_preserve` | `Phase 4R-B` closed. Preserve as the landed first-party attributed legacy `4D` interaction, history, macro, topology-reference, and provenance-boundary lane; start future widening from the live-lane audit, then `Phase 4R-B`, then `REPO_LICENSE_TRACKING.md`; keep the explicit attribution, upstream-link, and `MyMath` provenance duties visible. | | `google/model-viewer/packages/shared-assets` | `Apache-2.0 container; mixed per-asset terms` | Donor Bench | `repurpose` | `implemented_live_boundary_sensitive` | `landed_boundary_sensitive_preserve` | `Phase 4R-C` closed. Preserve as the landed first-party shared-assets allowlist, provenance-boundary, and fixture-refresh lane; start future widening from the live-lane audit, then `Phase 4R-C`, then `REPO_LICENSE_TRACKING.md`; keep the explicit per-asset allowlist, review-only, and local-only boundaries visible. | +| `PostHog/posthog` | `MIT outside ee/; enterprise-restricted in ee/` | Donor Bench | `repurpose` | `implemented_live_boundary_sensitive` | `landed_boundary_sensitive_preserve` | `Phase 4R-D` closed. Preserve as the landed first-party control-plane telemetry, replay-diagnostic, scheduled-change, early-access, and explicit root-`MIT`-core-versus-`ee/` subtree-compliance lane; start future widening from the live-lane audit, then `Phase 4R-D`, then `REPO_LICENSE_TRACKING.md`; keep the explicit `ee/` exclusion and mixed-license subtree boundary visible. | ## Landed Restrictive Clean-Room Lane @@ -219,11 +224,10 @@ Count: `35` These rows are not currently proven live and have now cleared `Phase 0R` deep evaluation. `Phase 1R` places them on the active implementation board with earliest re-entry through `Phase 4R`. -Count: `3` +Count: `2` | Repo | License | Prior bucket | Prior action | Current live state | Reset lane | Next step | | --- | --- | --- | --- | --- | --- | --- | -| `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. | @@ -268,4 +272,4 @@ Count: `12` - Keep `cubing/cubing.js`, `cutelyaware/magiccube4d`, and `google/model-viewer/packages/shared-assets` explicitly marked as the three currently verified live boundary-sensitive lanes. - `Phase 0R` is now fully closed for the remaining `55` non-live rows. - `Phase 1R` is now the routing authority for retained-set widening and benchmark exclusion. -- The next bounded move is `Phase 4R-D` for the retained `PostHog/posthog` telemetry/replay-governance lane with `ee/` excluded, while the optional `Phase 3R-G` browser comparison lane remains deferred unless the landed primary browser spatial stack exposes a real gap. +- The next bounded move is `Phase 4R-E` for the retained `screenpipe/screenpipe` capture/history/replay and deterministic-permission lane with `ee/` excluded, while the later `remotion-dev/remotion` commercial sidecar decision and the optional `Phase 3R-G` browser comparison lane remain deferred unless the landed primary browser spatial stack exposes a real gap. diff --git a/docs/REPO_LICENSE_TRACKING.md b/docs/REPO_LICENSE_TRACKING.md index 811fd90..3c276e5 100644 --- a/docs/REPO_LICENSE_TRACKING.md +++ b/docs/REPO_LICENSE_TRACKING.md @@ -48,14 +48,14 @@ Use it for: Do not use it as the primary architecture ledger. The architecture and donor decisions remain in the GPT parse files. -## 2026-05-11 current HyperTwist implementation truth +## 2026-05-13 current HyperTwist implementation truth This file now also preserves the current truth that future models must not lose: - current curated HyperTwist shallow-eval set: `71` repos -- currently verified live/implemented in checked `UnrealHyperTwist` surfaces: `16` +- currently verified live/implemented in checked `UnrealHyperTwist` surfaces: `18` - permissive live lanes: `13` -- boundary-sensitive live lanes: `2` +- boundary-sensitive live lanes: `4` - restrictive live lanes: `1` The thirteen permissive live lanes are: @@ -74,10 +74,12 @@ The thirteen permissive live lanes are: - `poliva/cubedex` - `newyork-anthonyng/rubiks-cross-trainer` -The two boundary-sensitive live lanes are: +The four boundary-sensitive live lanes are: - `cubing/cubing.js` - `cutelyaware/magiccube4d` +- `google/model-viewer/packages/shared-assets` +- `PostHog/posthog` The one restrictive live lane is: @@ -96,7 +98,7 @@ Interpretation rule: Reset rule: -- preserve the sixteen landed/live lanes +- preserve the eighteen landed/live lanes - do not treat the remaining non-live rows as already absorbed - route all non-live rows only through the closed `Phase 1R` retained-set contract and the relevant `0R-*` packet @@ -132,7 +134,8 @@ Current practical interpretation: - the landed `cubing/cubing.js` boundary-sensitive widening packet now lives in `docs/HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md` - the landed `cutelyaware/magiccube4d` boundary-sensitive widening packet now lives in `docs/HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md` - the landed `google/model-viewer/packages/shared-assets` boundary-sensitive widening packet now lives in `docs/HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md` -- the next bounded move is `Phase 4R-D` +- the landed `PostHog/posthog` boundary-sensitive widening packet now lives in `docs/HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md` +- the next bounded move is `Phase 4R-E` Companion docs: @@ -1180,6 +1183,7 @@ Approved working posture: Decision date: - `2026-04-24` +- refreshed on `2026-05-13` Current licensing judgment: @@ -1187,14 +1191,22 @@ Current licensing judgment: - content outside `ee/` is available under `MIT` - content under `ee/` is enterprise-licensed and production-restricted - this is not a clean-room requirement by default, but it is not a carefree permissive donor either +- treat it as the landed boundary-sensitive control-plane preserve lane through `Phase 4R-D` Source basis: - `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\LICENSE` - `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\ee\LICENSE` -- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\replay\manifest.tsx` -- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\replay\skills\diagnosing-missing-recordings\SKILL.md` -- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\feature_flags\mcp\tools.yaml` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\frontend\src\scenes\session-recordings\utils\replayCaptureDiagnostics.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\replay\skills\diagnosing-missing-recordings\references\diagnostic-signals.md` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\frontend\src\scenes\session-recordings\player\utils\segmenter.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\frontend\src\scenes\session-recordings\player\utils\player-logging.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\frontend\src\scenes\feature-flags\featureFlagReleaseConditionsLogic.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\frontend\src\scenes\feature-flags\featureFlagScheduleEditLogic.ts` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\frontend\src\scenes\feature-flags\activityDescriptions.tsx` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\feature_flags\backend\models\team_feature_flag_defaults_config.py` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\early_access_features\backend\models.py` +- `C:\Workspaces\HyperTwist\mirrors\restrictive\PostHog\posthog\products\early_access_features\backend\api.py` Important distinction: @@ -1202,14 +1214,18 @@ Important distinction: - it is not a vision/perception donor - the useful value is telemetry, replay, feature-flag governance, and product/service boundary architecture - the legal boundary is also not โ€œwhole repo MITโ€; any relaxed donor use must explicitly exclude `ee/` +- `Phase 4R-D` did not copy donor `ee/` files into owned Unreal source +- the landed surface is a first-party control-plane contract and runtime lane, not a broad PostHog product-shell adoption Approved working posture: - keep the mirror in restrictive/manual-review custody because the repo contains both MIT and enterprise-licensed code - do not flatten it into benchmark-only status, because the replay and feature-flag lanes are genuinely useful - do not treat it as a direct shell donor or as a vision donor -- if HyperTwist borrows directly, keep that borrowing to clearly MIT paths and continue to exclude `ee/` -- if later implementation work needs deeper reuse, create a scrubbed extraction path for the exact MIT subsystems rather than letting mixed-license source drift into generic implementation work +- keep the landed HyperTwist result on preserve-and-enhance footing as the first-party replay-diagnostic, feature-governance, scheduled-change, early-access, and subtree-compliance lane +- keep any relaxed donor use strictly inside clearly MIT paths and continue to exclude `ee/` +- preserve the explicit root-license-versus-enterprise-subtree boundary in future widening packets +- start future enhancement work from the live-lane audit, then `Phase 4R-D`, then this tracker, rather than from the raw mirror alone ### `remotion-dev/remotion` diff --git a/docs/repo_portfolio_unified_copyleft_strategy_matrix_v6_3.csv b/docs/repo_portfolio_unified_copyleft_strategy_matrix_v6_3.csv index 265f4cb..6e5d13e 100644 --- a/docs/repo_portfolio_unified_copyleft_strategy_matrix_v6_3.csv +++ b/docs/repo_portfolio_unified_copyleft_strategy_matrix_v6_3.csv @@ -38,7 +38,7 @@ "Hypercubers/hypercubing.xyz","https://github.com/Hypercubers/hypercubing.xyz","HyperTwist","Locked Strategic Donor","locked strategic donor","repurpose","moderate modification","MIT","known_from_reference_material","uploaded_reference_docs","permissive_or_noncopyleft_known","direct_incorporation_ok","The repo is MIT and is retained as a high-value knowledge and curriculum donor. Direct use of code/content structures is legally straightforward where it materially helps HyperTwist.","high","permissive-knowledge-donor","v6.3_final_source_of_truth","implemented_live_permissive","landed_permissive_preserve","Phase 3R-B closed. Preserve as the landed first-party hypercubing knowledge, notation, progression, software-reference, and leaderboard-contract lane; start future widening from the live-lane audit, then the 3R-B implementation packet, then REPO_LICENSE_TRACKING.md." "Aarav2709/KubeTimr","https://github.com/Aarav2709/KubeTimr","HyperTwist","Donor Bench","donor bench","repurpose","moderate modification","MIT","known_from_reference_material","uploaded_reference_docs","permissive_or_noncopyleft_known","direct_incorporation_ok","This repo is permissively licensed and currently best treated as a focused subsystem donor for timer-state logic, split-phase handling, local persistence, and keyboard-first practice flow. Selective incorporation is legally straightforward, but the product shell should still be reshaped to fit HyperTwist.","high","routine-review-only","v6.3_final_source_of_truth","implemented_live_permissive","landed_permissive_preserve","Phase 3R-A closed. Preserve as the landed first-party timer, inspection, splits, stats, persistence, and timer-scoped replay lane; start future widening from the live-lane audit, then the 3R-A implementation packet, then REPO_LICENSE_TRACKING.md." "roice3/MagicTile","https://github.com/roice3/MagicTile","HyperTwist","Locked Strategic Donor","locked strategic donor","repurpose","moderate modification","MIT","known_from_reference_material","uploaded_reference_docs","permissive_or_noncopyleft_known","direct_incorporation_ok","The repo is MIT and is explicitly retained as a top-tier geometry/topology donor. Direct donor use is legally straightforward if the architecture benefits from it.","high","permissive-top-tier-donor","v6.3_final_source_of_truth","selected_not_live_permissive_candidate","phase0r_permissive_eval_then_implement","Phase 1R closed. Retain as a Phase 3R permissive implementation candidate; implement only from its packet authority and the retained-set contract, not by reopening Phase 0R." -"PostHog/posthog","https://github.com/PostHog/posthog","HyperTwist","","donor bench","repurpose","moderate modification","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","high","mixed-license-path-review-required","v6.3_final_source_of_truth","selected_not_live_boundary_sensitive","phase0r_boundary_sensitive_eval_then_adapter_or_sidecar","Phase 1R closed. Retain as a Phase 4R bounded telemetry and replay sidecar candidate; keep ee/ excluded and use explicit allowlists or first-party reimplementation where needed." +"PostHog/posthog","https://github.com/PostHog/posthog","HyperTwist","","donor bench","repurpose","moderate modification","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","high","mixed-license-path-review-required","v6.3_final_source_of_truth","implemented_live_boundary_sensitive","landed_boundary_sensitive_preserve","Phase 4R-D closed. Preserve as the landed first-party control-plane telemetry, replay-diagnostic, scheduled-change, early-access, and explicit root-MIT-core-versus-ee/ subtree-compliance lane; start future widening from the live-lane audit, then Phase 4R-D, then REPO_LICENSE_TRACKING.md; keep the explicit ee/ exclusion and mixed-license subtree boundary visible." "met4citizen/TalkingHead","https://github.com/met4citizen/TalkingHead","HyperTwist","Donor Bench","donor bench","repurpose","moderate modification","MIT","known_from_reference_material","uploaded_reference_docs","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is MIT and direct use is allowed. Treat it as a bounded browser-side donor for embodied coach presentation rather than as a product shell.","high","standard-notice-review","v6.3_markdown_backfill","implemented_live_permissive","landed_permissive_preserve","Phase 3R-E closed. Preserve as the landed first-party embodied companion, narration, lip-sync, gesture, subtitle, and avatar-embed lane; start future widening from the live-lane audit, then the 3R-E implementation packet, then REPO_LICENSE_TRACKING.md." "apache/echarts","https://github.com/apache/echarts","HyperTwist","Donor Bench","donor bench","repurpose","moderate modification","Apache-2.0","known_from_reference_material","uploaded_reference_docs","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is Apache-2.0 and direct use is allowed. Treat it as a bounded reporting and analytics donor.","high","notice-file-review","v6.3_markdown_backfill","implemented_live_permissive","landed_permissive_preserve","Phase 3R-C closed. Preserve as the landed first-party analytics, reporting, export, and progress-visualization lane; start future widening from the live-lane audit, then the 3R-C implementation packet, then REPO_LICENSE_TRACKING.md." "ecomfe/echarts-gl","https://github.com/ecomfe/echarts-gl","HyperTwist","Merge Bench","merge bench","integrate","moderate modification","BSD-3-Clause","known_from_reference_material","uploaded_reference_docs","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is BSD-3-Clause and direct use is allowed. Treat it as a bounded 3D analytics extension rather than a runtime foundation.","high","standard-notice-review","v6.3_markdown_backfill","selected_not_live_permissive_candidate","phase0r_permissive_eval_then_implement","Phase 3R-C closed for the anchor. Retain as an optional subordinate 3D analytics and explainer sidecar beneath the landed apache/echarts lane; do not treat it as separately live." diff --git a/docs/repo_portfolio_unified_operational_v6_3.csv b/docs/repo_portfolio_unified_operational_v6_3.csv index bcff3f4..2f06752 100644 --- a/docs/repo_portfolio_unified_operational_v6_3.csv +++ b/docs/repo_portfolio_unified_operational_v6_3.csv @@ -38,7 +38,7 @@ "11939","Hypercubers/hypercubing.xyz","https://github.com/Hypercubers/hypercubing.xyz","HyperTwist","32.0","92.0","101.0","C","hypercubing / nD engine","subsystem donor","simulation donor","locked strategic donor","repurpose","moderate modification","Treat this as a mineable codebase: keep selected internals (algorithms, renderers, adapters, parsers, schedulers) while replacing the surrounding product assumptions and architecture. For this repo class, that usually means preserving generalized puzzle/state/render logic while building a new application shell around it.","Website for the Hypercubing community","Repurpose selected subsystems rather than the whole product. Mine the repo for nD state model, move notation, renderer, projection controls, solver/traversal logic, puzzle serialization, replay; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, tao-yu/Alg-Trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, tao-yu/Alg-Trainer.","Repurpose here means: turn it into a higher-dimensional renderer/simulator donor and shared interaction grammar for HyperTwist and long-horizon VectorShell.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Isolate puzzle/state core; Extract render/input abstractions; Document notation and save format","deep source audit","Hidden value is likely in generalized puzzle/state representations, higher-dimensional transforms, notation systems, save formats, puzzle generators, and rendering abstractions.","Inspect generalized puzzle/state model; notation parser; transform math; rendering abstraction; save/load format; puzzle generator; input mapping; performance optimizations.","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for higher-dimensional state/notation representations, projection math, renderer abstractions, puzzle serialization, controls, and replay/training hooks.","Audit Hypercubers/hypercubing.xyz as a hypercubing / nD engine candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect generalized puzzle/state model; notation parser; transform math; rendering abstraction; save/load format; puzzle generator; input mapping; performance optimizations. Decide whether the best extraction path is heavy modification and whether it belongs as subsystem donor / simulation donor. Test the three merger paths in order: 1) HactarCE/Hyperspeedcube [foundation + donor]; 2) cubing/cubing.js [3D engine + notation/state donor]; 3) tao-yu/Alg-Trainer [training UX donor]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","HactarCE/Hyperspeedcube","foundation + donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","cubing/cubing.js","3D engine + notation/state donor","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","tao-yu/Alg-Trainer","training UX donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","Website for the Hypercubing community","","Hypercubers/hypercubing.xyz is treated as repurpose for HyperTwist because visible metadata points to the hypercubing / nD simulation layer. Surface signal: Website for the Hypercubing community The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_hyper_engine","HT_hyper_engine_0006","hypercubing / nD simulation","Integrate primarily for HyperTwist. Its description and bookmark placement under ""HyperTwist Consider"" place it in the hypercubing / nD simulation layer.","HyperTwist","hypercubing / nD simulation","integrate","heavy modification","medium","hypercubers/hypercubing.xyz","HyperTwist","","","","","","","","","","","","","","","","Original global operational v3 retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","32.0","5","92.0","Locked Strategic Donor","Knowledge and curriculum donor","","P1","permissive_or_noncopyleft_known","direct_incorporation_ok","The repo is MIT and is retained as a high-value knowledge and curriculum donor. Direct use of code/content structures is legally straightforward where it materially helps HyperTwist.","Use selectively as a donor for knowledge structures, notation, taxonomy, and leaderboard-generation logic; do not confuse the site snapshot with the canonical repo.","Preserve MIT notices and attribution where required.","Usually unnecessary unless later replacing a narrow implementation seam is cleaner than carrying the upstream code.","high","permissive-knowledge-donor","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Corrected on 2026-04-25 from stale unknown-license donor-bench posture to dossier-backed MIT knowledge/curriculum donor status.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-B closed. Preserve as the landed first-party hypercubing knowledge, notation, progression, software-reference, and leaderboard-contract lane; start future widening from the live-lane audit, then the 3R-B implementation packet, then REPO_LICENSE_TRACKING.md." "11945","Aarav2709/KubeTimr","https://github.com/Aarav2709/KubeTimr","HyperTwist","34.0","88.0","97.0","C","cubing trainer / solver / timing","subsystem donor","training donor","donor bench","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving cube-state, scramble, scheduling, or timer internals while adapting pedagogy, analytics, and UI.","Aarav2709/KubeTimr โ€” MIT โ€” Keyboard-first offline timer. | Aarav2709/KubeTimr โ€” MIT โ€” Offline timer.","Repurpose selected subsystems rather than the whole product. Mine the repo for scramble generation, algorithm database, recognition/training loop, timing/statistics, virtual cube, smartcube hooks, spaced repetition; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Repurpose here means: turn it into a trainer engine, solver/timer backend, recognition drill module, or method-specific practice mode for HyperTwist.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Extract cube-state model; Normalize trainer/case schema; Expose analytics and replay hooks","deep source audit","Hidden value often sits in cube-state representation, scramble generation, weighted drill scheduling, recognition datasets, replay/timer internals, and case database schemas.","Inspect cube-state model; scramble generator; trainer weighting/scheduling; case database and metadata; replay/timer model; import/export of alg sets; smartcube or sensor adapters.","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for algorithm databases, spaced-repetition logic, scramble generation, timer/stat code, virtual cube components, smartcube adapters, and custom-trainer configuration support.","Audit Aarav2709/KubeTimr as a cubing trainer / solver / timing candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect cube-state model; scramble generator; trainer weighting/scheduling; case database and metadata; replay/timer model; import/export of alg sets; smartcube or sensor adapters. Decide whether the best extraction path is moderate modification and whether it belongs as subsystem donor / training donor. Test the three merger paths in order: 1) tao-yu/Alg-Trainer [base + donor swarm]; 2) poliva/cubedex [specialized training UX donor]; 3) Lykos/cube_trainer [sampling/analytics donor]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","tao-yu/Alg-Trainer","base + donor swarm","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","poliva/cubedex","specialized training UX donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","Lykos/cube_trainer","sampling/analytics donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","project-local first","Cross-project transfer is possible, but the value is clearest inside the assigned project until source audit exposes more reusable primitives.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium","single-source signal; clear taxonomy; mostly donor/reference role","medium","strong adjacency to identified core stack; memo mentions: 2","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","","","","Aarav2709/KubeTimr โ€” MIT โ€” Keyboard-first offline timer. | Aarav2709/KubeTimr โ€” MIT โ€” Offline timer.","Aarav2709/KubeTimr is treated as repurpose for HyperTwist because the current dossier keeps it as a focused subsystem donor for timer-state logic, split-phase handling, local persistence, rolling stats, and keyboard-first offline practice flow rather than as a broader training-platform anchor.","memo","False","True","0.0","2.0","HT_training_stack","HT_training_stack_0015","cubing / algorithm training","Integrate primarily for HyperTwist. Its memo and bookmark signals place it in the cubing / algorithm training layer.","HyperTwist","cubing / algorithm training","integrate","moderate modification","medium","aarav2709/kubetimr","HyperTwist","","","","","","","","","","","","","","","","Original global operational v3 retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","34.0","5","88.0","Donor Bench","Focused subsystem donor","","","permissive_or_noncopyleft_known","direct_incorporation_ok","This repo is permissively licensed and currently best treated as a focused subsystem donor for timer-state logic, split-phase handling, local persistence, and keyboard-first practice flow. Selective incorporation is legally straightforward, but the product shell should still be reshaped to fit HyperTwist.","Direct embed, vendored module, package dependency, or tightly integrated adapter as the architecture requires.","Typically preserve notices, attribution, and license text where required; no special copyleft-driven disclosure posture is normally needed.","Usually unnecessary unless you later decide the existing implementation is too constraining architecturally.","high","routine-review-only","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Normalized legacy adjacency wording and stale clean-room boundary posture to dossier-backed focused subsystem donor on 2026-04-25.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-A closed. Preserve as the landed first-party timer, inspection, splits, stats, persistence, and timer-scoped replay lane; start future widening from the live-lane audit, then the 3R-A implementation packet, then REPO_LICENSE_TRACKING.md." "11951","roice3/MagicTile","https://github.com/roice3/MagicTile","HyperTwist","36.0","88.0","97.0","C","infra / runtime / observability / integration","subsystem donor","integration utility","locked strategic donor","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving collectors/adapters/runtime topology logic while integrating into a larger control plane.","Non-euclidean Rubik's Cube Analogues","Repurpose selected subsystems rather than the whole product. Mine the repo for scramble generation, algorithm database, recognition/training loop, timing/statistics, virtual cube, smartcube hooks, spaced repetition; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Repurpose here means: turn it into a trainer engine, solver/timer backend, recognition drill module, or method-specific practice mode for HyperTwist.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Extract collectors/adapters; Normalize topology/config schema; Bridge into control-plane API","deep source audit","Hidden value usually sits in service topology schemas, collector agents, auth/integration adapters, caching, deployment abstractions, and metrics/event correlation.","Inspect topology/service schema; collectors/agents; auth/integration adapters; caching/state sync; deployment/runtime abstractions; metrics/event correlation; config layering.","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for algorithm databases, spaced-repetition logic, scramble generation, timer/stat code, virtual cube components, smartcube adapters, and custom-trainer configuration support.","Audit roice3/MagicTile as a infra / runtime / observability / integration candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect topology/service schema; collectors/agents; auth/integration adapters; caching/state sync; deployment/runtime abstractions; metrics/event correlation; config layering. Decide whether the best extraction path is moderate modification and whether it belongs as subsystem donor / integration utility. Test the three merger paths in order: 1) project-local anchor [base + donor]; 2) shared portfolio utility [augmenter]; 3) cross-project transfer candidate [future merger]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","project-local anchor","base + donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","shared portfolio utility","augmenter","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cross-project transfer candidate","future merger","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","project-local first","Cross-project transfer is possible, but the value is clearest inside the assigned project until source audit exposes more reusable primitives.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","Non-euclidean Rubik's Cube Analogues","","roice3/MagicTile is treated as repurpose for HyperTwist because visible metadata points to the cubing / algorithm training layer. Surface signal: Non-euclidean Rubik's Cube Analogues The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_hyper_engine","HT_hyper_engine_0007","cubing / algorithm training","Integrate primarily for HyperTwist. Its description and bookmark placement under ""HyperTwist Consider"" place it in the cubing / algorithm training layer.","HyperTwist","cubing / algorithm training","integrate","moderate modification","medium","roice3/magictile","HyperTwist","","","","","","","","","","","","","","","","Original global operational v3 retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","36.0","5","88.0","Locked Strategic Donor","Top-tier non-Euclidean geometry and topology donor","","P1","permissive_or_noncopyleft_known","direct_incorporation_ok","The repo is MIT and is explicitly retained as a top-tier geometry/topology donor. Direct donor use is legally straightforward if the architecture benefits from it.","Direct donor use or bounded adapter extraction are both acceptable; choose the seam that best preserves the topology and twist infrastructure.","Preserve MIT notices and attribution where required.","Usually unnecessary unless later replacing a narrow seam is cleaner than carrying the upstream code.","high","permissive-top-tier-donor","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned from legacy HY_misc to HT_hyper_engine during cluster normalization on 2026-04-25.","selected_not_live_permissive_candidate","phase0r_permissive_eval_then_implement","Phase 1R closed. Retain as a Phase 3R permissive implementation candidate; implement only from its packet authority and the retained-set contract, not by reopening Phase 0R." -"11967","PostHog/posthog","https://github.com/PostHog/posthog","HyperTwist","41.0","72.0","81.0","C","telemetry / replay / feature governance","subsystem donor","telemetry donor","donor bench","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving calibration/detection/state-reconstruction logic while replacing camera UX and integration surfaces.","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ...","Repurpose selected subsystems rather than the whole product. Mine the repo for telemetry and event schemas, replay diagnostics, replay query surfaces, feature-flag governance, activity logs, and product/service boundary patterns; keep what materially shortens build time, but rebind data contracts, permissions, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Repurpose here means: turn it into a telemetry spine, replay diagnostics donor, feature-governance donor, or control-plane integration layer.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Benchmark calibration pipeline; Extract state reconstruction; Wrap with camera/AR adapter","deep source audit","Hidden value often sits in calibration, preprocessing, stabilization, object/state reconstruction, replay artifacts, and camera-to-domain state pipelines that are not obvious from demos.","Inspect replay routes and deep links; replay diagnostics; feature-flag CRUD, dependencies, and evaluation; telemetry and event schemas; product and service boundaries; MIT versus ee path splits.","Inspect package manifests, README/docs, product slices, services, tests, migrations/schemas, and hidden feature flags or experimental modules. Look for replay diagnostics, replay query surfaces, feature-flag governance, activity logs, event schemas, service boundaries, and MIT versus ee/ path splits.","Audit PostHog/posthog as a telemetry / replay / feature-governance candidate for HyperTwist. Do not stop at README-level features. Inspect: replay routes and deep links, replay diagnostics, feature-flag CRUD/dependencies/evaluation, telemetry and event schemas, product/service boundaries, and MIT versus ee/ path splits. Decide whether the best extraction path remains moderate modification and which seams should stay bounded due mixed licensing or mission misfit. Return hidden modules, reusable schemas, protocol layers, plugin hooks, replay/debugging surfaces, and any subsystem stronger than the visible product shell.","kkoomen/qbr","foundation + perception donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","vivaansinghvi07/rubix-cube-solver","perception + replay donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cubing/cubing.js","state/render backend","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.","","PostHog/posthog is treated as repurpose for HyperTwist because visible metadata points to the cloud / infra / observability / api layer. Surface signal: ๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ... The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_control_plane","HT_control_plane_0001","cloud / infra / observability / api","Repurpose selectively for HyperTwist. Its visible platform signal and source audit place it in telemetry, replay, and feature-governance rather than computer vision or AR.","HyperTwist","telemetry / replay / feature governance","repurpose","moderate modification","medium","posthog/posthog","HyperTwist","","","","","","","","","","","","","","","","Original global operational v3 retained","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","41.0","5","72.0","","Telemetry / replay / feature-governance donor","","","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","Use only clearly MIT paths outside ee/ as bounded telemetry, replay, and feature-governance donor surfaces; exclude enterprise paths or reimplement equivalent seams.","Keep MIT notices for reused paths and do not incorporate ee/ without separate commercial rights; verify path provenance before shipping.","Sometimes useful for enterprise-gated or off-mission slices, but not required for clearly MIT paths.","high","mixed-license-path-review-required","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_control_plane and normalized telemetry/replay/feature-governance wording on 2026-04-25.","selected_not_live_boundary_sensitive","phase0r_boundary_sensitive_eval_then_adapter_or_sidecar","Phase 1R closed. Retain as a Phase 4R bounded telemetry and replay sidecar candidate; keep ee/ excluded and use explicit allowlists or first-party reimplementation where needed." +"11967","PostHog/posthog","https://github.com/PostHog/posthog","HyperTwist","41.0","72.0","81.0","C","telemetry / replay / feature governance","subsystem donor","telemetry donor","donor bench","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving calibration/detection/state-reconstruction logic while replacing camera UX and integration surfaces.","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ...","Repurpose selected subsystems rather than the whole product. Mine the repo for telemetry and event schemas, replay diagnostics, replay query surfaces, feature-flag governance, activity logs, and product/service boundary patterns; keep what materially shortens build time, but rebind data contracts, permissions, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Repurpose here means: turn it into a telemetry spine, replay diagnostics donor, feature-governance donor, or control-plane integration layer.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Benchmark calibration pipeline; Extract state reconstruction; Wrap with camera/AR adapter","deep source audit","Hidden value often sits in calibration, preprocessing, stabilization, object/state reconstruction, replay artifacts, and camera-to-domain state pipelines that are not obvious from demos.","Inspect replay routes and deep links; replay diagnostics; feature-flag CRUD, dependencies, and evaluation; telemetry and event schemas; product and service boundaries; MIT versus ee path splits.","Inspect package manifests, README/docs, product slices, services, tests, migrations/schemas, and hidden feature flags or experimental modules. Look for replay diagnostics, replay query surfaces, feature-flag governance, activity logs, event schemas, service boundaries, and MIT versus ee/ path splits.","Audit PostHog/posthog as a telemetry / replay / feature-governance candidate for HyperTwist. Do not stop at README-level features. Inspect: replay routes and deep links, replay diagnostics, feature-flag CRUD/dependencies/evaluation, telemetry and event schemas, product/service boundaries, and MIT versus ee/ path splits. Decide whether the best extraction path remains moderate modification and which seams should stay bounded due mixed licensing or mission misfit. Return hidden modules, reusable schemas, protocol layers, plugin hooks, replay/debugging surfaces, and any subsystem stronger than the visible product shell.","kkoomen/qbr","foundation + perception donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","vivaansinghvi07/rubix-cube-solver","perception + replay donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cubing/cubing.js","state/render backend","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.","","PostHog/posthog is treated as repurpose for HyperTwist because visible metadata points to the cloud / infra / observability / api layer. Surface signal: ๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ... The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_control_plane","HT_control_plane_0001","cloud / infra / observability / api","Repurpose selectively for HyperTwist. Its visible platform signal and source audit place it in telemetry, replay, and feature-governance rather than computer vision or AR.","HyperTwist","telemetry / replay / feature governance","repurpose","moderate modification","medium","posthog/posthog","HyperTwist","","","","","","","","","","","","","","","","Original global operational v3 retained","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","41.0","5","72.0","","Telemetry / replay / feature-governance donor","","","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","Use only clearly MIT paths outside ee/ as bounded telemetry, replay, and feature-governance donor surfaces; exclude enterprise paths or reimplement equivalent seams.","Keep MIT notices for reused paths and do not incorporate ee/ without separate commercial rights; verify path provenance before shipping.","Sometimes useful for enterprise-gated or off-mission slices, but not required for clearly MIT paths.","high","mixed-license-path-review-required","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_control_plane and normalized telemetry/replay/feature-governance wording on 2026-04-25.","implemented_live_boundary_sensitive","landed_boundary_sensitive_preserve","Phase 4R-D closed. Preserve as the landed first-party control-plane telemetry, replay-diagnostic, scheduled-change, early-access, and explicit root-MIT-core-versus-ee/ subtree-compliance lane; start future widening from the live-lane audit, then Phase 4R-D, then REPO_LICENSE_TRACKING.md; keep the explicit ee/ exclusion and mixed-license subtree boundary visible." "","met4citizen/TalkingHead","https://github.com/met4citizen/TalkingHead","HyperTwist","","","","","interface / visualization / shell surface","subsystem donor","interface donor","donor bench","repurpose","moderate modification","Retain the reusable avatar, lip-sync, and retargeting layers, but replace the demo shell, asset assumptions, and voice-service integration with HyperTwist-owned surfaces.","","Repurpose selected subsystems rather than the whole product. Mine the repo for embodied coach avatar runtime, lip-sync and subtitle timing, avatar-only embedding, retargeting, and streamed speech playback; keep what shortens build time, but rebind assets, voice services, and UI shell to the HyperTwist architecture.","","Repurpose here means: turn it into a browser-side embodied coach or companion layer.","","","","Inspect talkinghead runtime; speech queueing and streaming; viseme and blendshape flow; avatarOnly embedding; retargeting; and audio worklet behavior.","Inspect modules, examples, tests, site config, streaming demos, retargeter, and playback worklet code. Look for embodied-coach embedding, lip-sync, subtitle timing, gesture and expression surfaces, and asset assumptions.","Audit met4citizen/TalkingHead as a browser embodied-coach candidate for HyperTwist. Inspect the avatar runtime, streaming lip-sync, subtitle timing, avatarOnly embedding, retargeting, and audio worklet behavior. Decide which seams can be used directly and which must remain bounded behind the HyperTwist coaching shell.","","","","","","","","","","","","","","medium","Canonized Markdown dossier exists and the repo has been source-backed, but CSV backfill is later than the original v6.3 board generation.","medium","Source-backed dossier exists and the repo has been reconciled into the later Markdown authority stack.","","","","","","","","","","","","HT_browser_surface","HT_browser_surface_0001","browser / 3D / XR / presentation","Repurpose selectively for HyperTwist. Its source-backed role is an embodied coach and companion presentation donor, not a generic avatar product shell.","HyperTwist","browser / 3D / XR / presentation","repurpose","moderate modification","medium","met4citizen/talkinghead","","","","","","","","","","","","","","","","","","MIT","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","","","","Donor Bench","Browser embodied coach surface","Included","P2","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is MIT and direct use is allowed. Treat it as a bounded browser-side donor for embodied coach presentation rather than as a product shell.","Use directly as a bounded browser-side dependency or adapter layer; keep voice services, product logic, and asset provenance outside the upstream shell.","Typically preserve notices, attribution, and license text where required; review sample avatars or media separately from the code license.","Usually unnecessary unless you later replace a narrow upstream layer for product-shaping reasons.","high","standard-notice-review","yes","","","","","","","","","","","","","v6.3_markdown_backfill","Backfilled from canonized Markdown dossier pass on 2026-04-24.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-E closed. Preserve as the landed first-party embodied companion, narration, lip-sync, gesture, subtitle, and avatar-embed lane; start future widening from the live-lane audit, then the 3R-E implementation packet, then REPO_LICENSE_TRACKING.md." "","apache/echarts","https://github.com/apache/echarts","HyperTwist","","","","","analytics / visualization / reporting","subsystem donor","interface donor","donor bench","repurpose","moderate modification","Retain the reusable chart runtime and reporting patterns, but keep HyperTwist domain schemas, page shell, and training logic outside the upstream system.","","Repurpose selected subsystems rather than the whole product. Mine the repo for chart runtime, option and data-store patterns, export and save-as-image behavior, zoom and history handling, and SSR reporting surfaces; keep what shortens build time, but rebind analytics schemas and application shell to the HyperTwist architecture.","","Repurpose here means: turn it into a bounded browser analytics and reporting layer for dashboards, replay summaries, and coaching views.","","","","Inspect OptionManager, DataStore, zoom and history behavior, thumbnail and export features, SSR and hydration seams, and accessibility surface.","Inspect manifests, README/docs, src core, model, data, component, export, and SSR folders. Look for modular chart runtime, data-store abstractions, export surfaces, and reporting-specific UI behavior.","Audit apache/echarts as a browser analytics and reporting candidate for HyperTwist. Inspect the modular chart runtime, OptionManager and DataStore, export surfaces, zoom and history behavior, SSR path, and accessibility seams. Decide which parts should remain direct dependencies versus concept-only references.","","","","","","","","","","","","","","medium","Canonized Markdown dossier exists and the repo has been source-backed, but CSV backfill is later than the original v6.3 board generation.","medium","Source-backed dossier exists and the repo has been reconciled into the later Markdown authority stack.","","","","","","","","","","","","HT_browser_surface","HT_browser_surface_0002","analytics / visualization / reporting","Repurpose selectively for HyperTwist. Its source-backed role is a bounded analytics and reporting donor rather than a generic dashboard widget.","HyperTwist","analytics / visualization / reporting","repurpose","moderate modification","medium","apache/echarts","","","","","","","","","","","","","","","","","","Apache-2.0","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","","","","Donor Bench","Browser analytics and reporting surface","Included","P2","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is Apache-2.0 and direct use is allowed. Treat it as a bounded reporting and analytics donor.","Use directly as a bounded browser analytics dependency; keep HyperTwist data contracts and product logic outside the upstream shell.","Preserve LICENSE and NOTICE materials where required and review redistributed assets separately from the code license.","Usually unnecessary unless you later replace a narrow upstream layer for product-shaping reasons.","high","notice-file-review","yes","","","","","","","","","","","","","v6.3_markdown_backfill","Backfilled from canonized Markdown dossier pass on 2026-04-24.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-C closed. Preserve as the landed first-party analytics, reporting, export, and progress-visualization lane; start future widening from the live-lane audit, then the 3R-C implementation packet, then REPO_LICENSE_TRACKING.md." "","ecomfe/echarts-gl","https://github.com/ecomfe/echarts-gl","HyperTwist","","","","","interface / visualization / shell surface","subsystem donor","visualization donor","merge bench","integrate","moderate modification","Retain selective 3D analytics surfaces, but keep HyperTwist domain models, scene ownership, and broader product shell outside the upstream package.","","Integrate selected subsystems rather than the whole product. Mine the repo for 3D analytics and explainer surfaces, GL layer mounting, and view helper behavior; keep what shortens build time, but bind it to HyperTwist analytics schemas and browser companion UI.","","Integrate here means: merge bounded 3D analytics and explainer surfaces into the browser reporting stack.","","","","Inspect 3D and GL chart exports, GL layer mounting, graph and flow surfaces, view helper behavior, and chart-space interaction handling.","Inspect manifests, README/docs, src chart and component exports, GL helper modules, and integration points with echarts and zrender.","Audit ecomfe/echarts-gl as a browser 3D analytics companion to apache/echarts. Inspect the 3D chart exports, GL view handling, and interaction seams. Decide which pieces deserve direct dependency use versus conceptual guidance only.","","","","","","","","","","","","","","medium","Canonized Markdown dossier exists and the repo has been source-backed, but CSV backfill is later than the original v6.3 board generation.","medium","Source-backed dossier exists and the repo has been reconciled into the later Markdown authority stack.","","","","","","","","","","","","HT_browser_surface","HT_browser_surface_0003","browser / 3D / XR / presentation","Integrate selectively for HyperTwist. Its source-backed role is a 3D analytics and explainer extension beneath echarts rather than a standalone simulation lane.","HyperTwist","browser / 3D / XR / presentation","integrate","moderate modification","medium","ecomfe/echarts-gl","","","","","","","","","","","","","","","","","","BSD-3-Clause","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","","","","Merge Bench","Browser 3D analytics and explainer surface","Included","P3","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is BSD-3-Clause and direct use is allowed. Treat it as a bounded 3D analytics extension rather than a runtime foundation.","Use directly as a bounded browser-side dependency beneath the reporting stack; keep HyperTwist scene ownership and product logic outside the upstream shell.","Typically preserve notices, attribution, and license text where required.","Usually unnecessary unless you later replace a narrow upstream layer for product-shaping reasons.","high","standard-notice-review","yes","","","","","","","","","","","","","v6.3_markdown_backfill","Backfilled from canonized Markdown dossier pass on 2026-04-24.","selected_not_live_permissive_candidate","phase0r_permissive_eval_then_implement","Phase 3R-C closed for the anchor. Retain as an optional subordinate 3D analytics and explainer sidecar beneath the landed apache/echarts lane; do not treat it as separately live." diff --git a/docs/repo_portfolio_unified_phase_g_v6_3.csv b/docs/repo_portfolio_unified_phase_g_v6_3.csv index e3f2980..0002915 100644 --- a/docs/repo_portfolio_unified_phase_g_v6_3.csv +++ b/docs/repo_portfolio_unified_phase_g_v6_3.csv @@ -38,7 +38,7 @@ "32.0","Hypercubers/hypercubing.xyz","https://github.com/Hypercubers/hypercubing.xyz","HyperTwist","32.0","92.0","101.0","C","hypercubing / nD engine","subsystem donor","simulation donor","locked strategic donor","repurpose","moderate modification","Treat this as a mineable codebase: keep selected internals (algorithms, renderers, adapters, parsers, schedulers) while replacing the surrounding product assumptions and architecture. For this repo class, that usually means preserving generalized puzzle/state/render logic while building a new application shell around it.","Website for the Hypercubing community","Repurpose selected subsystems rather than the whole product. Mine the repo for nD state model, move notation, renderer, projection controls, solver/traversal logic, puzzle serialization, replay; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, tao-yu/Alg-Trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, tao-yu/Alg-Trainer.","Repurpose here means: turn it into a higher-dimensional renderer/simulator donor and shared interaction grammar for HyperTwist and long-horizon VectorShell.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Isolate puzzle/state core; Extract render/input abstractions; Document notation and save format","deep source audit","Hidden value is likely in generalized puzzle/state representations, higher-dimensional transforms, notation systems, save formats, puzzle generators, and rendering abstractions.","Inspect generalized puzzle/state model; notation parser; transform math; rendering abstraction; save/load format; puzzle generator; input mapping; performance optimizations.","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for higher-dimensional state/notation representations, projection math, renderer abstractions, puzzle serialization, controls, and replay/training hooks.","Audit Hypercubers/hypercubing.xyz as a hypercubing / nD engine candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect generalized puzzle/state model; notation parser; transform math; rendering abstraction; save/load format; puzzle generator; input mapping; performance optimizations. Decide whether the best extraction path is heavy modification and whether it belongs as subsystem donor / simulation donor. Test the three merger paths in order: 1) HactarCE/Hyperspeedcube [foundation + donor]; 2) cubing/cubing.js [3D engine + notation/state donor]; 3) tao-yu/Alg-Trainer [training UX donor]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","HactarCE/Hyperspeedcube","foundation + donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","cubing/cubing.js","3D engine + notation/state donor","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","tao-yu/Alg-Trainer","training UX donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","Website for the Hypercubing community","","Hypercubers/hypercubing.xyz is treated as repurpose for HyperTwist because visible metadata points to the hypercubing / nD simulation layer. Surface signal: Website for the Hypercubing community The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_hyper_engine","HT_hyper_engine_0006","hypercubing / nD simulation","Integrate primarily for HyperTwist. Its description and bookmark placement under ""HyperTwist Consider"" place it in the hypercubing / nD simulation layer.","HyperTwist","hypercubing / nD simulation","integrate","heavy modification","medium","hypercubers/hypercubing.xyz","1.0","Locked Strategic Donor","4.0","MIT knowledge/curriculum donor with canonical notation, progression, taxonomy, and leaderboard-generation value.","Knowledge and curriculum donor","Included","P1","Keep as one of the strongest non-runtime donors in the hypercubing half of HyperTwist; the dossier-backed MIT posture and content value justify promotion above the old donor-bench treatment.","2.0","2.0","2.0","11938.0","134.0","Thin-fit assignment; verify project mapping during source audit","hypercubers/hypercubing.xyz","HyperTwist","","","","","","","","","","Original global Phase G v4 retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","32.0","3","4.0","92.0","permissive_or_noncopyleft_known","direct_incorporation_ok","The repo is MIT and is retained as a high-value knowledge and curriculum donor. Direct use of code/content structures is legally straightforward where it materially helps HyperTwist.","Use selectively as a donor for knowledge structures, notation, taxonomy, and leaderboard-generation logic; do not confuse the site snapshot with the canonical repo.","Preserve MIT notices and attribution where required.","Usually unnecessary unless later replacing a narrow implementation seam is cleaner than carrying the upstream code.","high","permissive-knowledge-donor","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Corrected on 2026-04-25 from stale unknown-license donor-bench posture to dossier-backed MIT knowledge/curriculum donor status.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-B closed. Preserve as the landed first-party hypercubing knowledge, notation, progression, software-reference, and leaderboard-contract lane; start future widening from the live-lane audit, then the 3R-B implementation packet, then REPO_LICENSE_TRACKING.md." "34.0","Aarav2709/KubeTimr","https://github.com/Aarav2709/KubeTimr","HyperTwist","34.0","88.0","97.0","C","cubing trainer / solver / timing","subsystem donor","training donor","donor bench","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving cube-state, scramble, scheduling, or timer internals while adapting pedagogy, analytics, and UI.","Aarav2709/KubeTimr โ€” MIT โ€” Keyboard-first offline timer. | Aarav2709/KubeTimr โ€” MIT โ€” Offline timer.","Repurpose selected subsystems rather than the whole product. Mine the repo for scramble generation, algorithm database, recognition/training loop, timing/statistics, virtual cube, smartcube hooks, spaced repetition; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Repurpose here means: turn it into a trainer engine, solver/timer backend, recognition drill module, or method-specific practice mode for HyperTwist.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Extract cube-state model; Normalize trainer/case schema; Expose analytics and replay hooks","deep source audit","Hidden value often sits in cube-state representation, scramble generation, weighted drill scheduling, recognition datasets, replay/timer internals, and case database schemas.","Inspect cube-state model; scramble generator; trainer weighting/scheduling; case database and metadata; replay/timer model; import/export of alg sets; smartcube or sensor adapters.","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for algorithm databases, spaced-repetition logic, scramble generation, timer/stat code, virtual cube components, smartcube adapters, and custom-trainer configuration support.","Audit Aarav2709/KubeTimr as a cubing trainer / solver / timing candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect cube-state model; scramble generator; trainer weighting/scheduling; case database and metadata; replay/timer model; import/export of alg sets; smartcube or sensor adapters. Decide whether the best extraction path is moderate modification and whether it belongs as subsystem donor / training donor. Test the three merger paths in order: 1) tao-yu/Alg-Trainer [base + donor swarm]; 2) poliva/cubedex [specialized training UX donor]; 3) Lykos/cube_trainer [sampling/analytics donor]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","tao-yu/Alg-Trainer","base + donor swarm","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","poliva/cubedex","specialized training UX donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","Lykos/cube_trainer","sampling/analytics donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","project-local first","Cross-project transfer is possible, but the value is clearest inside the assigned project until source audit exposes more reusable primitives.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium","single-source signal; clear taxonomy; mostly donor/reference role","medium","strong adjacency to identified core stack; memo mentions: 2","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","","","","Aarav2709/KubeTimr โ€” MIT โ€” Keyboard-first offline timer. | Aarav2709/KubeTimr โ€” MIT โ€” Offline timer.","Aarav2709/KubeTimr is treated as repurpose for HyperTwist because the current dossier keeps it as a focused subsystem donor for timer-state logic, split-phase handling, local persistence, rolling stats, and keyboard-first offline practice flow rather than as a broader training-platform anchor.","memo","False","True","0.0","2.0","HT_training_stack","HT_training_stack_0015","cubing / algorithm training","Integrate primarily for HyperTwist. Its memo and bookmark signals place it in the cubing / algorithm training layer.","HyperTwist","cubing / algorithm training","integrate","moderate modification","medium","aarav2709/kubetimr","1.0","Donor Bench","4.0","Useful subsystem donor for timer-state logic, split-phase handling, local persistence, rolling stats, and keyboard-first offline practice flow.","Focused subsystem donor","Included","P2","Aarav2709/KubeTimr is placed in Donor Bench for HyperTwist because it best serves the 'Focused subsystem donor' role; recommended action is 'repurpose' with repurposing scope 'moderate modification'. Confidence is medium because this remains a metadata-level judgment until source audit confirms hidden modules, plugin points, adapters, or architectural strengths.","2.0","3.0","2.0","11944.0","135.0","","aarav2709/kubetimr","HyperTwist","","","","","","","","","","Original global Phase G v4 retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","34.0","3","4.0","88.0","permissive_or_noncopyleft_known","direct_incorporation_ok","This repo is permissively licensed and currently best treated as a focused subsystem donor for timer-state logic, split-phase handling, local persistence, and keyboard-first practice flow. Selective incorporation is legally straightforward, but the product shell should still be reshaped to fit HyperTwist.","Direct embed, vendored module, package dependency, or tightly integrated adapter as the architecture requires.","Typically preserve notices, attribution, and license text where required; no special copyleft-driven disclosure posture is normally needed.","Usually unnecessary unless you later decide the existing implementation is too constraining architecturally.","high","routine-review-only","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Normalized legacy adjacency wording and stale clean-room boundary posture to dossier-backed focused subsystem donor on 2026-04-25.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-A closed. Preserve as the landed first-party timer, inspection, splits, stats, persistence, and timer-scoped replay lane; start future widening from the live-lane audit, then the 3R-A implementation packet, then REPO_LICENSE_TRACKING.md." "36.0","roice3/MagicTile","https://github.com/roice3/MagicTile","HyperTwist","36.0","88.0","97.0","C","infra / runtime / observability / integration","subsystem donor","integration utility","locked strategic donor","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving collectors/adapters/runtime topology logic while integrating into a larger control plane.","Non-euclidean Rubik's Cube Analogues","Repurpose selected subsystems rather than the whole product. Mine the repo for scramble generation, algorithm database, recognition/training loop, timing/statistics, virtual cube, smartcube hooks, spaced repetition; keep what materially shortens build time, but rebind data contracts, permissions, UI shell, storage, and deployment to the HyperTwist architecture. Best first pairing order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: tao-yu/Alg-Trainer, poliva/cubedex, Lykos/cube_trainer.","Repurpose here means: turn it into a trainer engine, solver/timer backend, recognition drill module, or method-specific practice mode for HyperTwist.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Extract collectors/adapters; Normalize topology/config schema; Bridge into control-plane API","deep source audit","Hidden value usually sits in service topology schemas, collector agents, auth/integration adapters, caching, deployment abstractions, and metrics/event correlation.","Inspect topology/service schema; collectors/agents; auth/integration adapters; caching/state sync; deployment/runtime abstractions; metrics/event correlation; config layering.","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, config files, migrations/schemas, and hidden feature flags or experimental modules. Look for algorithm databases, spaced-repetition logic, scramble generation, timer/stat code, virtual cube components, smartcube adapters, and custom-trainer configuration support.","Audit roice3/MagicTile as a infra / runtime / observability / integration candidate for HyperTwist. Do not stop at README-level features. Inspect: Inspect topology/service schema; collectors/agents; auth/integration adapters; caching/state sync; deployment/runtime abstractions; metrics/event correlation; config layering. Decide whether the best extraction path is moderate modification and whether it belongs as subsystem donor / integration utility. Test the three merger paths in order: 1) project-local anchor [base + donor]; 2) shared portfolio utility [augmenter]; 3) cross-project transfer candidate [future merger]. Return hidden modules, reusable schemas, protocol layers, plugin hooks, render/state models, datasets/test fixtures, and any subsystem stronger than the visible product shell.","project-local anchor","base + donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","shared portfolio utility","augmenter","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cross-project transfer candidate","future merger","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","project-local first","Cross-project transfer is possible, but the value is clearest inside the assigned project until source audit exposes more reusable primitives.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","Non-euclidean Rubik's Cube Analogues","","roice3/MagicTile is treated as repurpose for HyperTwist because visible metadata points to the cubing / algorithm training layer. Surface signal: Non-euclidean Rubik's Cube Analogues The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_hyper_engine","HT_hyper_engine_0007","cubing / algorithm training","Integrate primarily for HyperTwist. Its description and bookmark placement under ""HyperTwist Consider"" place it in the cubing / algorithm training layer.","HyperTwist","cubing / algorithm training","integrate","moderate modification","medium","roice3/magictile","1.0","Locked Strategic Donor","4.0","MIT donor with unusually strong non-Euclidean tiling, topology, and generalized twist infrastructure value.","Top-tier non-Euclidean geometry and topology donor","Included","P1","Keep as a top-tier non-Euclidean geometry and topology donor for HyperTwist; the dossier-backed MIT posture and source richness justify promotion above the old donor-bench treatment.","2.0","2.0","2.0","11950.0","136.0","Thin-fit assignment; verify project mapping during source audit","roice3/magictile","HyperTwist","","","","","","","","","","Original global Phase G v4 retained","MIT","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","36.0","3","4.0","88.0","permissive_or_noncopyleft_known","direct_incorporation_ok","The repo is MIT and is explicitly retained as a top-tier geometry/topology donor. Direct donor use is legally straightforward if the architecture benefits from it.","Direct donor use or bounded adapter extraction are both acceptable; choose the seam that best preserves the topology and twist infrastructure.","Preserve MIT notices and attribution where required.","Usually unnecessary unless later replacing a narrow seam is cleaner than carrying the upstream code.","high","permissive-top-tier-donor","yes","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned from legacy HY_misc to HT_hyper_engine during cluster normalization on 2026-04-25.","selected_not_live_permissive_candidate","phase0r_permissive_eval_then_implement","Phase 1R closed. Retain as a Phase 3R permissive implementation candidate; implement only from its packet authority and the retained-set contract, not by reopening Phase 0R." -"41.0","PostHog/posthog","https://github.com/PostHog/posthog","HyperTwist","41.0","72.0","81.0","C","telemetry / replay / feature governance","subsystem donor","telemetry donor","donor bench","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving calibration/detection/state-reconstruction logic while replacing camera UX and integration surfaces.","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ...","Repurpose selected subsystems rather than the whole product. Mine the repo for telemetry and event schemas, replay diagnostics, replay query surfaces, feature-flag governance, activity logs, and product/service boundary patterns; keep what materially shortens build time, but rebind data contracts, permissions, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Repurpose here means: turn it into a telemetry spine, replay diagnostics donor, feature-governance donor, or control-plane integration layer.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Benchmark calibration pipeline; Extract state reconstruction; Wrap with camera/AR adapter","deep source audit","Hidden value often sits in calibration, preprocessing, stabilization, object/state reconstruction, replay artifacts, and camera-to-domain state pipelines that are not obvious from demos.","Inspect replay routes and deep links; replay diagnostics; feature-flag CRUD, dependencies, and evaluation; telemetry and event schemas; product and service boundaries; MIT versus ee path splits.","Inspect package manifests, README/docs, product slices, services, tests, migrations/schemas, and hidden feature flags or experimental modules. Look for replay diagnostics, replay query surfaces, feature-flag governance, activity logs, event schemas, service boundaries, and MIT versus ee/ path splits.","Audit PostHog/posthog as a telemetry / replay / feature-governance candidate for HyperTwist. Do not stop at README-level features. Inspect: replay routes and deep links, replay diagnostics, feature-flag CRUD/dependencies/evaluation, telemetry and event schemas, product/service boundaries, and MIT versus ee/ path splits. Decide whether the best extraction path remains moderate modification and which seams should stay bounded due mixed licensing or mission misfit. Return hidden modules, reusable schemas, protocol layers, plugin hooks, replay/debugging surfaces, and any subsystem stronger than the visible product shell.","kkoomen/qbr","foundation + perception donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","vivaansinghvi07/rubix-cube-solver","perception + replay donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cubing/cubing.js","state/render backend","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.","","PostHog/posthog is treated as repurpose for HyperTwist because visible metadata points to the cloud / infra / observability / api layer. Surface signal: ๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ... The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_control_plane","HT_control_plane_0001","cloud / infra / observability / api","Repurpose selectively for HyperTwist. Its visible platform signal and source audit place it in telemetry, replay, and feature-governance rather than computer vision or AR.","HyperTwist","telemetry / replay / feature governance","repurpose","moderate modification","medium","posthog/posthog","1.0","Donor Bench","4.0","Useful subsystem donor for HyperTwist in telemetry, replay diagnostics, feature flags, event-schema design, and vertical-slice control-plane patterns rather than the core runtime or product shell.","Telemetry / replay / feature-governance donor","Included","P2","PostHog/posthog is placed in Donor Bench for HyperTwist because it best serves the 'Telemetry / replay / feature-governance donor' role; recommended action remains 'repurpose' with repurposing scope 'moderate modification'. Its real retained value is replay diagnostics, flag governance, event-schema thinking, and service-boundary patterns rather than any vision or perception role.","2.0","2.0","2.0","11966.0","139.0","Thin-fit assignment; verify project mapping during source audit","posthog/posthog","HyperTwist","","","","","","","","","","Original global Phase G v4 retained","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","41.0","3","4.0","72.0","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","Use only clearly MIT paths outside ee/ as bounded telemetry, replay, and feature-governance donor surfaces; exclude enterprise paths or reimplement equivalent seams.","Keep MIT notices for reused paths and do not incorporate ee/ without separate commercial rights; verify path provenance before shipping.","Sometimes useful for enterprise-gated or off-mission slices, but not required for clearly MIT paths.","high","mixed-license-path-review-required","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_control_plane and normalized telemetry/replay/feature-governance wording on 2026-04-25.","selected_not_live_boundary_sensitive","phase0r_boundary_sensitive_eval_then_adapter_or_sidecar","Phase 1R closed. Retain as a Phase 4R bounded telemetry and replay sidecar candidate; keep ee/ excluded and use explicit allowlists or first-party reimplementation where needed." +"41.0","PostHog/posthog","https://github.com/PostHog/posthog","HyperTwist","41.0","72.0","81.0","C","telemetry / replay / feature governance","subsystem donor","telemetry donor","donor bench","repurpose","moderate modification","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving calibration/detection/state-reconstruction logic while replacing camera UX and integration surfaces.","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ...","Repurpose selected subsystems rather than the whole product. Mine the repo for telemetry and event schemas, replay diagnostics, replay query surfaces, feature-flag governance, activity logs, and product/service boundary patterns; keep what materially shortens build time, but rebind data contracts, permissions, storage, and deployment to the HyperTwist architecture. Best first pairing order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Consolidate under the Hyperspeedcube + cubing.js + qbr nucleus, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: HactarCE/Hyperspeedcube, cubing/cubing.js, kkoomen/qbr.","Repurpose here means: turn it into a telemetry spine, replay diagnostics donor, feature-governance donor, or control-plane integration layer.","Map module boundaries; Identify hidden reusable internals; Define adapter/API boundary to target anchors; Write extraction tests against upstream behavior; Benchmark calibration pipeline; Extract state reconstruction; Wrap with camera/AR adapter","deep source audit","Hidden value often sits in calibration, preprocessing, stabilization, object/state reconstruction, replay artifacts, and camera-to-domain state pipelines that are not obvious from demos.","Inspect replay routes and deep links; replay diagnostics; feature-flag CRUD, dependencies, and evaluation; telemetry and event schemas; product and service boundaries; MIT versus ee path splits.","Inspect package manifests, README/docs, product slices, services, tests, migrations/schemas, and hidden feature flags or experimental modules. Look for replay diagnostics, replay query surfaces, feature-flag governance, activity logs, event schemas, service boundaries, and MIT versus ee/ path splits.","Audit PostHog/posthog as a telemetry / replay / feature-governance candidate for HyperTwist. Do not stop at README-level features. Inspect: replay routes and deep links, replay diagnostics, feature-flag CRUD/dependencies/evaluation, telemetry and event schemas, product/service boundaries, and MIT versus ee/ path splits. Decide whether the best extraction path remains moderate modification and which seams should stay bounded due mixed licensing or mission misfit. Return hidden modules, reusable schemas, protocol layers, plugin hooks, replay/debugging surfaces, and any subsystem stronger than the visible product shell.","kkoomen/qbr","foundation + perception donor","Use this repo against the partner as an augmenting layer; preserve the partner as the likely base and mine this repo for capabilities that improve breadth, UX, or specialization.","vivaansinghvi07/rubix-cube-solver","perception + replay donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cubing/cubing.js","state/render backend","Use the partner for canonical state or rendering abstractions and merge this repo's specialized logic on top.","VectorShell | ScriptoriumAI","VectorShell can borrow spatial/rendering and perception primitives; ScriptoriumAI can borrow tutorial/educational visualization patterns rather than the full engine.","exclude from core, keep as donor","Do not let it consume roadmap as a full product shell; mine reusable engines, adapters, schemas, UX patterns, or datasets.","medium-low","single-source signal; clear taxonomy; mostly donor/reference role","medium","explicit bookmark description available","Licensing intentionally ignored as a decision filter in this canonical evaluation; assess only architecture, capability, donor value, and concept transfer.","HyperTwist(1)","HyperTwist Consider","๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.","","PostHog/posthog is treated as repurpose for HyperTwist because visible metadata points to the cloud / infra / observability / api layer. Surface signal: ๐Ÿฆ” PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product ... The fit looks real, but more as a donor/augmenter than as a standalone foundation.","bookmarks","True","False","1.0","0.0","HT_control_plane","HT_control_plane_0001","cloud / infra / observability / api","Repurpose selectively for HyperTwist. Its visible platform signal and source audit place it in telemetry, replay, and feature-governance rather than computer vision or AR.","HyperTwist","telemetry / replay / feature governance","repurpose","moderate modification","medium","posthog/posthog","1.0","Donor Bench","4.0","Useful subsystem donor for HyperTwist in telemetry, replay diagnostics, feature flags, event-schema design, and vertical-slice control-plane patterns rather than the core runtime or product shell.","Telemetry / replay / feature-governance donor","Included","P2","PostHog/posthog is placed in Donor Bench for HyperTwist because it best serves the 'Telemetry / replay / feature-governance donor' role; recommended action remains 'repurpose' with repurposing scope 'moderate modification'. Its real retained value is replay diagnostics, flag governance, event-schema thinking, and service-boundary patterns rather than any vision or perception role.","2.0","2.0","2.0","11966.0","139.0","Thin-fit assignment; verify project mapping during source audit","posthog/posthog","HyperTwist","","","","","","","","","","Original global Phase G v4 retained","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","41.0","3","4.0","72.0","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","Use only clearly MIT paths outside ee/ as bounded telemetry, replay, and feature-governance donor surfaces; exclude enterprise paths or reimplement equivalent seams.","Keep MIT notices for reused paths and do not incorporate ee/ without separate commercial rights; verify path provenance before shipping.","Sometimes useful for enterprise-gated or off-mission slices, but not required for clearly MIT paths.","high","mixed-license-path-review-required","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_control_plane and normalized telemetry/replay/feature-governance wording on 2026-04-25.","implemented_live_boundary_sensitive","landed_boundary_sensitive_preserve","Phase 4R-D closed. Preserve as the landed first-party control-plane telemetry, replay-diagnostic, scheduled-change, early-access, and explicit root-MIT-core-versus-ee/ subtree-compliance lane; start future widening from the live-lane audit, then Phase 4R-D, then REPO_LICENSE_TRACKING.md; keep the explicit ee/ exclusion and mixed-license subtree boundary visible." "","met4citizen/TalkingHead","https://github.com/met4citizen/TalkingHead","HyperTwist","","","","","interface / visualization / shell surface","subsystem donor","interface donor","donor bench","repurpose","moderate modification","Retain the reusable avatar, lip-sync, and retargeting layers, but replace the demo shell, asset assumptions, and voice-service integration with HyperTwist-owned surfaces.","","Repurpose selected subsystems rather than the whole product. Mine the repo for embodied coach avatar runtime, lip-sync and subtitle timing, avatar-only embedding, retargeting, and streamed speech playback; keep what shortens build time, but rebind assets, voice services, and UI shell to the HyperTwist architecture.","","Repurpose here means: turn it into a browser-side embodied coach or companion layer.","","","","Inspect talkinghead runtime; speech queueing and streaming; viseme and blendshape flow; avatarOnly embedding; retargeting; and audio worklet behavior.","Inspect modules, examples, tests, site config, streaming demos, retargeter, and playback worklet code. Look for embodied-coach embedding, lip-sync, subtitle timing, gesture and expression surfaces, and asset assumptions.","Audit met4citizen/TalkingHead as a browser embodied-coach candidate for HyperTwist. Inspect the avatar runtime, streaming lip-sync, subtitle timing, avatarOnly embedding, retargeting, and audio worklet behavior. Decide which seams can be used directly and which must remain bounded behind the HyperTwist coaching shell.","","","","","","","","","","","","","","medium","Canonized Markdown dossier exists and the repo has been source-backed, but CSV backfill is later than the original v6.3 board generation.","medium","Source-backed dossier exists and the repo has been reconciled into the later Markdown authority stack.","","","","","","","","","","","","HT_browser_surface","HT_browser_surface_0001","browser / 3D / XR / presentation","Repurpose selectively for HyperTwist. Its source-backed role is an embodied coach and companion presentation donor, not a generic avatar product shell.","HyperTwist","browser / 3D / XR / presentation","repurpose","moderate modification","medium","met4citizen/talkinghead","","Donor Bench","4.0","Useful subsystem donor for HyperTwist, primarily in the browser companion layer; strongest embodied coach and avatar presentation donor in the current stack.","Browser embodied coach surface","Included","P2","met4citizen/TalkingHead is placed in Donor Bench for HyperTwist because it provides embodied coach UI, streaming lip-sync, retargeting, and avatar-only embedding behavior. Recommended action remains repurpose, but the retained value is a bounded browser coach surface rather than a general avatar product.","","","","","","","met4citizen/talkinghead","","","","","","","","","","","","MIT","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","v6_unified_source_of_truth_pack","","","","","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is MIT and direct use is allowed. Treat it as a bounded browser-side donor for embodied coach presentation rather than as a product shell.","Use directly as a bounded browser-side dependency or adapter layer; keep voice services, product logic, and asset provenance outside the upstream shell.","Typically preserve notices, attribution, and license text where required; review sample avatars or media separately from the code license.","Usually unnecessary unless you later replace a narrow upstream layer for product-shaping reasons.","high","standard-notice-review","yes","","","","","","","","","","","","","v6.3_markdown_backfill","Backfilled from canonized Markdown dossier pass on 2026-04-24.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-E closed. Preserve as the landed first-party embodied companion, narration, lip-sync, gesture, subtitle, and avatar-embed lane; start future widening from the live-lane audit, then the 3R-E implementation packet, then REPO_LICENSE_TRACKING.md." "","apache/echarts","https://github.com/apache/echarts","HyperTwist","","","","","analytics / visualization / reporting","subsystem donor","interface donor","donor bench","repurpose","moderate modification","Retain the reusable chart runtime and reporting patterns, but keep HyperTwist domain schemas, page shell, and training logic outside the upstream system.","","Repurpose selected subsystems rather than the whole product. Mine the repo for chart runtime, option and data-store patterns, export and save-as-image behavior, zoom and history handling, and SSR reporting surfaces; keep what shortens build time, but rebind analytics schemas and application shell to the HyperTwist architecture.","","Repurpose here means: turn it into a bounded browser analytics and reporting layer for dashboards, replay summaries, and coaching views.","","","","Inspect OptionManager, DataStore, zoom and history behavior, thumbnail and export features, SSR and hydration seams, and accessibility surface.","Inspect manifests, README/docs, src core, model, data, component, export, and SSR folders. Look for modular chart runtime, data-store abstractions, export surfaces, and reporting-specific UI behavior.","Audit apache/echarts as a browser analytics and reporting candidate for HyperTwist. Inspect the modular chart runtime, OptionManager and DataStore, export surfaces, zoom and history behavior, SSR path, and accessibility seams. Decide which parts should remain direct dependencies versus concept-only references.","","","","","","","","","","","","","","medium","Canonized Markdown dossier exists and the repo has been source-backed, but CSV backfill is later than the original v6.3 board generation.","medium","Source-backed dossier exists and the repo has been reconciled into the later Markdown authority stack.","","","","","","","","","","","","HT_browser_surface","HT_browser_surface_0002","analytics / visualization / reporting","Repurpose selectively for HyperTwist. Its source-backed role is a bounded analytics and reporting donor rather than a generic dashboard widget.","HyperTwist","analytics / visualization / reporting","repurpose","moderate modification","medium","apache/echarts","","Donor Bench","4.0","Useful subsystem donor for HyperTwist, primarily in the browser companion layer; strongest current analytics and reporting donor in the browser stack.","Browser analytics and reporting surface","Included","P2","apache/echarts is placed in Donor Bench for HyperTwist because it provides the strongest current browser analytics and reporting stack with SSR, export, and serious data-store behavior. Recommended action remains repurpose, but the retained value is bounded reporting and coaching analytics rather than a product shell.","","","","","","","apache/echarts","","","","","","","","","","","","Apache-2.0","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","v6_unified_source_of_truth_pack","","","","","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is Apache-2.0 and direct use is allowed. Treat it as a bounded reporting and analytics donor.","Use directly as a bounded browser analytics dependency; keep HyperTwist data contracts and product logic outside the upstream shell.","Preserve LICENSE and NOTICE materials where required and review redistributed assets separately from the code license.","Usually unnecessary unless you later replace a narrow upstream layer for product-shaping reasons.","high","notice-file-review","yes","","","","","","","","","","","","","v6.3_markdown_backfill","Backfilled from canonized Markdown dossier pass on 2026-04-24.","implemented_live_permissive","landed_permissive_preserve","Phase 3R-C closed. Preserve as the landed first-party analytics, reporting, export, and progress-visualization lane; start future widening from the live-lane audit, then the 3R-C implementation packet, then REPO_LICENSE_TRACKING.md." "","ecomfe/echarts-gl","https://github.com/ecomfe/echarts-gl","HyperTwist","","","","","interface / visualization / shell surface","subsystem donor","visualization donor","merge bench","integrate","moderate modification","Retain selective 3D analytics surfaces, but keep HyperTwist domain models, scene ownership, and broader product shell outside the upstream package.","","Integrate selected subsystems rather than the whole product. Mine the repo for 3D analytics and explainer surfaces, GL layer mounting, and view helper behavior; keep what shortens build time, but bind it to HyperTwist analytics schemas and browser companion UI.","","Integrate here means: merge bounded 3D analytics and explainer surfaces into the browser reporting stack.","","","","Inspect 3D and GL chart exports, GL layer mounting, graph and flow surfaces, view helper behavior, and chart-space interaction handling.","Inspect manifests, README/docs, src chart and component exports, GL helper modules, and integration points with echarts and zrender.","Audit ecomfe/echarts-gl as a browser 3D analytics companion to apache/echarts. Inspect the 3D chart exports, GL view handling, and interaction seams. Decide which pieces deserve direct dependency use versus conceptual guidance only.","","","","","","","","","","","","","","medium","Canonized Markdown dossier exists and the repo has been source-backed, but CSV backfill is later than the original v6.3 board generation.","medium","Source-backed dossier exists and the repo has been reconciled into the later Markdown authority stack.","","","","","","","","","","","","HT_browser_surface","HT_browser_surface_0003","browser / 3D / XR / presentation","Integrate selectively for HyperTwist. Its source-backed role is a 3D analytics and explainer extension beneath echarts rather than a standalone simulation lane.","HyperTwist","browser / 3D / XR / presentation","integrate","moderate modification","medium","ecomfe/echarts-gl","","Merge Bench","5.0","Useful merge candidate for HyperTwist, primarily in the browser companion layer; strongest value sits in 3D chart and GL explainer surfaces beneath the echarts lane.","Browser 3D analytics and explainer surface","Included","P3","ecomfe/echarts-gl is placed in Merge Bench for HyperTwist because it adds bounded 3D analytics and explainer value on top of echarts. Recommended action remains integrate, but the retained value is selective 3D reporting and graph surface behavior rather than a product runtime.","","","","","","","ecomfe/echarts-gl","","","","","","","","","","","","BSD-3-Clause","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","v6_unified_source_of_truth_pack","","","","","permissive_or_noncopyleft_known","direct_incorporation_ok","The code license is BSD-3-Clause and direct use is allowed. Treat it as a bounded 3D analytics extension rather than a runtime foundation.","Use directly as a bounded browser-side dependency beneath the reporting stack; keep HyperTwist scene ownership and product logic outside the upstream shell.","Typically preserve notices, attribution, and license text where required.","Usually unnecessary unless you later replace a narrow upstream layer for product-shaping reasons.","high","standard-notice-review","yes","","","","","","","","","","","","","v6.3_markdown_backfill","Backfilled from canonized Markdown dossier pass on 2026-04-24.","selected_not_live_permissive_candidate","phase0r_permissive_eval_then_implement","Phase 3R-C closed for the anchor. Retain as an optional subordinate 3D analytics and explainer sidecar beneath the landed apache/echarts lane; do not treat it as separately live." diff --git a/docs/repo_portfolio_unified_source_audit_v6_3.csv b/docs/repo_portfolio_unified_source_audit_v6_3.csv index f0f923a..9682b30 100644 --- a/docs/repo_portfolio_unified_source_audit_v6_3.csv +++ b/docs/repo_portfolio_unified_source_audit_v6_3.csv @@ -237,7 +237,7 @@ 6) Best merge partners and exact coupling seam 7) Reasons to promote / retain / demote 8) Confidence change after source audit -9) Open questions / blockers","Primary: Phase G v4 board (canonical ranking and current bucket); Operational v3 board filtered to this repo; Merger matrix rows involving this repo; VS Code packet row for this repo, if present. Optional: Cluster narratives row for matching cluster; Bookmark occurrence rows for this repo. Do not attach v1/v2 or preliminary memo unless a judgment conflict, lineage ambiguity, or rationale gap needs arbitration.","PostHog/posthog is placed in Donor Bench for HyperTwist because it best serves the 'Telemetry / replay / feature-governance donor' role; recommended action remains 'repurpose' with repurposing scope 'moderate modification'. Its real retained value is replay diagnostics, flag governance, event-schema thinking, and service-boundary patterns rather than any vision or perception role.","Useful subsystem donor for HyperTwist in telemetry, replay diagnostics, feature flags, event-schema design, and vertical-slice control-plane patterns rather than the core runtime or product shell.","Audit PostHog/posthog as a telemetry / replay / feature-governance candidate for HyperTwist. Do not stop at README-level features. Inspect: replay routes and deep links, replay diagnostics, feature-flag CRUD/dependencies/evaluation, telemetry and event schemas, product/service boundaries, and MIT versus ee/ path splits. Decide whether the best extraction path remains moderate modification and which seams should stay bounded due mixed licensing or mission misfit. Return hidden modules, reusable schemas, protocol layers, plugin hooks, replay/debugging surfaces, and any subsystem stronger than the visible product shell.","HT_control_plane_0001","HT_control_plane","posthog/posthog","","","","","","","Original global P0-P3 source audit retained","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","2","3","72.0","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","Use only clearly MIT paths outside ee/ as bounded telemetry, replay, and feature-governance donor surfaces; exclude enterprise paths or reimplement equivalent seams.","Keep MIT notices for reused paths and do not incorporate ee/ without separate commercial rights; verify path provenance before shipping.","Sometimes useful for enterprise-gated or off-mission slices, but not required for clearly MIT paths.","high","mixed-license-path-review-required","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_control_plane and normalized telemetry/replay/feature-governance wording on 2026-04-25.","selected_not_live_boundary_sensitive","phase0r_boundary_sensitive_eval_then_adapter_or_sidecar","Phase 1R closed. Retain as a Phase 4R bounded telemetry and replay sidecar candidate; keep ee/ excluded and use explicit allowlists or first-party reimplementation where needed." +9) Open questions / blockers","Primary: Phase G v4 board (canonical ranking and current bucket); Operational v3 board filtered to this repo; Merger matrix rows involving this repo; VS Code packet row for this repo, if present. Optional: Cluster narratives row for matching cluster; Bookmark occurrence rows for this repo. Do not attach v1/v2 or preliminary memo unless a judgment conflict, lineage ambiguity, or rationale gap needs arbitration.","PostHog/posthog is placed in Donor Bench for HyperTwist because it best serves the 'Telemetry / replay / feature-governance donor' role; recommended action remains 'repurpose' with repurposing scope 'moderate modification'. Its real retained value is replay diagnostics, flag governance, event-schema thinking, and service-boundary patterns rather than any vision or perception role.","Useful subsystem donor for HyperTwist in telemetry, replay diagnostics, feature flags, event-schema design, and vertical-slice control-plane patterns rather than the core runtime or product shell.","Audit PostHog/posthog as a telemetry / replay / feature-governance candidate for HyperTwist. Do not stop at README-level features. Inspect: replay routes and deep links, replay diagnostics, feature-flag CRUD/dependencies/evaluation, telemetry and event schemas, product/service boundaries, and MIT versus ee/ path splits. Decide whether the best extraction path remains moderate modification and which seams should stay bounded due mixed licensing or mission misfit. Return hidden modules, reusable schemas, protocol layers, plugin hooks, replay/debugging surfaces, and any subsystem stronger than the visible product shell.","HT_control_plane_0001","HT_control_plane","posthog/posthog","","","","","","","Original global P0-P3 source audit retained","MIT outside ee/; enterprise-restricted in ee/","known_from_reference_material","uploaded_reference_docs","no","","","","Supplemental intake references are advisory only; v6 adjudication remains the source of truth.","Usually indirect","yes","v6 unified all-project source-of-truth pack","v5_carry_forward","","v6_unified_source_of_truth_pack","2","3","72.0","mixed_or_boundary_sensitive_known","bounded_sidecar_or_selective_reimplementation","The repo is mixed-license: MIT outside ee/ and enterprise-restricted inside ee/. Use only clearly MIT paths as bounded telemetry, replay, and feature-governance donor material, and exclude or reimplement enterprise-gated paths.","Use only clearly MIT paths outside ee/ as bounded telemetry, replay, and feature-governance donor surfaces; exclude enterprise paths or reimplement equivalent seams.","Keep MIT notices for reused paths and do not incorporate ee/ without separate commercial rights; verify path provenance before shipping.","Sometimes useful for enterprise-gated or off-mission slices, but not required for clearly MIT paths.","high","mixed-license-path-review-required","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_control_plane and normalized telemetry/replay/feature-governance wording on 2026-04-25.","implemented_live_boundary_sensitive","landed_boundary_sensitive_preserve","Phase 4R-D closed. Preserve as the landed first-party control-plane telemetry, replay-diagnostic, scheduled-change, early-access, and explicit root-MIT-core-versus-ee/ subtree-compliance lane; start future widening from the live-lane audit, then Phase 4R-D, then REPO_LICENSE_TRACKING.md; keep the explicit ee/ exclusion and mixed-license subtree boundary visible." "HactarCE/2x2x2x2-Scrambler","https://github.com/HactarCE/2x2x2x2-Scrambler","HyperTwist","Donor Bench","Focused restrictive clean-room donor target","P2","7496","9251","2.0","63.0","63.0","low-to-medium","Architecture only. Treat HactarCE/2x2x2x2-Scrambler as a design and subsystem reference first; source audit should look for transplantable patterns, adapters, data contracts, pipeline ideas, or UI/control abstractions before any decision to operationalize.","repurpose","architecture only","Determine the real reusable value of HactarCE/2x2x2x2-Scrambler for HyperTwist and decide whether it should be promoted, retained, or demoted in the v6 corpus.","Inspect state representations, move/alg parsers, scrambler generators, geometry/math cores, renderer abstractions, engine bindings, and XR/web surfaces.","Inspect state representations, move/alg parsers, scrambler generators, geometry/math cores, renderer abstractions, engine bindings, and XR/web surfaces.","Inspect state representations, move/alg parsers, scrambler generators, geometry/math cores, renderer abstractions, engine bindings, and XR/web surfaces.","Primary realization path: use as a simulation, training, renderer, binding, or integration donor inside HyperTwist's dual stack of physical-cube analysis and higher-dimensional virtual training.","Consolidate by HyperTwist layer: core puzzle logic, scramblers/algs, renderer/bindings, XR/game-engine surfaces, experiments/comparators.","Repurpose toward renderer abstractions, puzzle-logic libraries, solver bindings, training UIs, or XR/engine adapters.","HactarCE/Hyperspeedcube","foundation repo + feature donor","Use HactarCE/2x2x2x2-Scrambler as a HyperTwist donor into HactarCE/Hyperspeedcube for puzzle logic, bindings, renderer ideas, or training/runtime augmentation.","cubing/cubing.js","engine repo + interface donor","Use HactarCE/2x2x2x2-Scrambler as a HyperTwist donor into cubing/cubing.js for puzzle logic, bindings, renderer ideas, or training/runtime augmentation.","kkoomen/qbr","feature extraction only","Use HactarCE/2x2x2x2-Scrambler as a HyperTwist donor into kkoomen/qbr for puzzle logic, bindings, renderer ideas, or training/runtime augmentation.","multi-project","Audit for hidden abstractions that travel across projects.","Source reveals a strong reusable subsystem, extensibility layer, protocol boundary, renderer core, data model, or automation surface that clearly strengthens one of the project stacks.","Source reveals the repo is mostly documentation, thin wrappers, packaging glue, stale scaffolding, or a weak duplicate with no meaningful transplantable subsystem.","Source-audit note, role recommendation, hidden-value extraction, exact integration path, and reclassification decision.","Implemented capability; hidden reusable modules; strongest integration path; strongest merger path; upgrade triggers; downgrade triggers; final recommended bucket.","Use v6 unified board + P2 tier packet + project design language + relevant family references.","Keep as a narrow but real clean-room donor for Melinda 2x2x2x2 state encoding, handedness/parity repair, random-state generation, move-family representation, and flat debug/teaching views.","GPL scrambler with copied-port lineage notes; valuable only through restrictive clean-room extraction, not donor use.","Inspect HactarCE/2x2x2x2-Scrambler directly in source. Do not dismiss for license. Preserve nuanced distinctions between donor, reserve, comparator, and exclusion.","HT_cube_semantics_0004","HT_cube_semantics","hactarce/2x2x2x2-scrambler","supplemental_v6_not_runtime_anchored","","","","","no","v6_unified_source_of_truth_pack","GPL-3.0","known_from_reference_material","uploaded_reference_docs","","","","","","","","","","","","2","3","63.0","mixed_or_boundary_sensitive_known","reverse_engineer_preferred","The repo is GPL-3.0 and the source explicitly notes a ported lineage from an earlier scrambler. Retain it only as a focused clean-room donor target and implement any valuable behavior through a scrubbed first-party specification.","Model A may inspect the restrictive source; Model B should implement only from a scrubbed first-party specification.","Direct incorporation would require GPL-compatible distribution/compliance and is not the planned HyperTwist path.","Yes รขโ‚ฌโ€ this is the preferred path for reproducing the 2x2x2x2 scrambler/state behaviors in first-party code.","high","gpl-clean-room-donor","no","","","","","","","","","","","","","v6.3_final_source_of_truth","Assigned to HT_cube_semantics during cluster normalization on 2026-04-25.","selected_not_live_clean_room_candidate","phase0r_clean_room_eval_then_model_a_model_b","Phase 1R closed. Retain as a Phase 5R clean-room-only Melinda 2x2x2x2 candidate; keep copied-port lineage explicit and implement only from the scrubbed Model A dossier." "SYSTRAN/faster-whisper","https://github.com/SYSTRAN/faster-whisper","multi-project","Donor Bench","Cross-project / future-adjacent","P2","8351","10345","49.0","71.0","80.0","medium","Retain the valuable internal engine, but expect to replace UI/product shell, adapt schemas/APIs, and refactor boundaries so it can plug into the target anchors cleanly. For this repo class, that usually means preserving parsers/graph schema/indexing while swapping layout, storage, or UX layers.","repurpose","moderate modification","Determine whether SYSTRAN/faster-whisper should stay donor/merge-tier for multi-project, be promoted, or be demoted; identify concrete salvageable modules and best merge path.","STT API surface, VAD chunking, batch inference, timestamps, service boundaries, model/runtime constraints, hidden modules","Inspect package manifests, README/docs, src tree, examples, tests, CI workflows, benchmark scripts, and hidden experimental modules. Look for VAD, batch inference, timestamps, hotwords, model/runtime constraints, and service-layer boundaries.","Inspect transcription API and dataclasses; batched inference; VAD chunking; word timestamps; hotwords and prefix conditioning; service-layer boundaries; benchmark and test coverage.","Repurpose selected subsystems rather than the whole product. Mine the repo for VAD-aware segmentation, batch transcription, timestamps, hotword and prefix conditioning, and Python service ergonomics; keep what materially shortens build time, but rebind data contracts, permissions, storage, and deployment to the target architecture. Best first pairing order: ggml-org/whisper.cpp, rhasspy/piper, coqui-ai/TTS.","Consolidate under the project-specific anchor stack, not beside it as a separate silo. Normalize data contracts, auth/permissions, storage, and telemetry; then attach as a service, plugin, canvas layer, trainer, or analysis module. Descending combination order: sentrux/sentrux, HactarCE/Hyperspeedcube, outline/outline.","Repurpose here means: turn it into a Python STT service, timestamped speech pipeline, or batch transcription donor.","project-local anchor","base + donor","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","shared portfolio utility","augmenter","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","cross-project transfer candidate","future merger","Treat this pairing as a candidate donor merge rather than a replacement decision; inspect module boundaries to determine which side owns the final shell.","project-local first","Cross-project transfer is possible, but the value is clearest inside the assigned project until source audit exposes more reusable primitives.","Upgrade if source reveals clean modular architecture, reusable core abstractions, strong adapters/plugins, robust tests, and direct fit to a locked stack.","Demote if reusable value is mostly superficial, undocumented complexity overwhelms salvage value, or higher-ranked repos clearly dominate the same role.","Capability inventory + salvage targets + promotion/demotion verdict","1) Confirmed visible capabilities 2) Hidden capabilities found only in source diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/AGENTS.md b/docs/v6_5_deep_manual_pack/HyperTwist/AGENTS.md index 3eae489..ba9d7b7 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/AGENTS.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/AGENTS.md @@ -86,9 +86,9 @@ Canonical doctrine doc: For HyperTwist, keep this explicit: - current shallow-eval set: `71` repos -- currently verified live/implemented in checked Unreal surfaces: `17` +- currently verified live/implemented in checked Unreal surfaces: `18` - permissive live lanes: `13` -- boundary-sensitive live lanes: `3` +- boundary-sensitive live lanes: `4` - restrictive live lane: `1` - the restrictive landed lane is `onionhoney/roux-trainers`, and it is to be treated as properly clean-roomed and then implemented @@ -105,8 +105,8 @@ into: ## Reset rule -Before recommending new HyperTwist donor-shaped widening from the remaining `54` current non-live rows: +Before recommending new HyperTwist donor-shaped widening from the remaining `53` current non-live rows: - do not reopen the already closed `Phase 0R`, `Phase 1R`, or `Phase 2R` packets -- preserve the seventeen landed rows as current truth -- continue from the closed packet sequence, with `Phase 4R-D` as the next non-optional move and the optional `Phase 3R-G` comparison lane deferred unless the landed primary browser spatial stack exposes a real gap +- preserve the eighteen landed rows as current truth +- continue from the closed packet sequence, with `Phase 4R-E` as the next non-optional move and the optional `Phase 3R-G` comparison lane deferred unless the landed primary browser spatial stack exposes a real gap diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/DEVELOPMENT.md b/docs/v6_5_deep_manual_pack/HyperTwist/DEVELOPMENT.md index 49618b9..a7b8b1e 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/DEVELOPMENT.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/DEVELOPMENT.md @@ -15,11 +15,11 @@ Do not reopen broad donor-driven widening as if the whole retained portfolio wer Current truth: -- `17` repos are currently verified live in checked Unreal surfaces +- `18` repos are currently verified live in checked Unreal surfaces - `13` are permissive `MIT` or `Apache-2.0` -- `3` are boundary-sensitive lanes: `cubing/cubing.js` through the practical `MPL` adapter path, `cutelyaware/magiccube4d` through the landed attribution/provenance boundary path, and `google/model-viewer/packages/shared-assets` through the landed allowlist/provenance boundary path +- `4` are boundary-sensitive lanes: `cubing/cubing.js` through the practical `MPL` adapter path, `cutelyaware/magiccube4d` through the landed attribution/provenance boundary path, `google/model-viewer/packages/shared-assets` through the landed allowlist/provenance boundary path, and `PostHog/posthog` through the landed control-plane subtree-boundary path - `1` is the restrictive `onionhoney/roux-trainers` lane that is already properly clean-roomed and implemented -- `Phase 0R` is now closed for the remaining `54` non-live rows +- `Phase 0R` is now closed for the remaining `53` non-live rows - `Phase 1R` is now closed as the retained-set contract and handoff overhaul - `Phase 2R` is now closed as the retained-set ownership and acceptance packet sequence - `Phase 3R-A` is now closed as the landed `Aarav2709/KubeTimr` widening packet @@ -30,6 +30,8 @@ Current truth: - `Phase 3R-F` is now closed as the landed `mrdoob/three.js`, `pmndrs/react-three-fiber`, and `pmndrs/xr` widening packet - `Phase 4R-A` is now closed as the landed `cubing/cubing.js` classic-cubing adapter widening packet - `Phase 4R-B` is now closed as the landed `cutelyaware/magiccube4d` legacy `4D` interaction/history/macro widening packet +- `Phase 4R-C` is now closed as the landed `google/model-viewer/packages/shared-assets` allowlist/provenance widening packet +- `Phase 4R-D` is now closed as the landed `PostHog/posthog` control-plane widening packet ## Model A interpretation rule @@ -43,13 +45,14 @@ Canonical doctrine doc: Next sequence: -1. preserve the sixteen landed lanes -1. preserve the seventeen landed lanes +1. preserve the eighteen landed lanes 2. preserve the landed `cubing/cubing.js` boundary-sensitive adapter lane with its `MPL` notice posture explicit 3. preserve the landed `cutelyaware/magiccube4d` boundary-sensitive lane with its attribution, upstream-link, and provenance posture explicit -4. use the retained-set contract as the only legal/roadmap routing surface for non-live rows -5. keep `Aarav2709/KubeTimr`, `Hypercubers/hypercubing.xyz`, `apache/echarts`, `google/model-viewer`, `met4citizen/TalkingHead`, `cubing/cubing.js`, `cutelyaware/magiccube4d`, and `google/model-viewer/packages/shared-assets` on preserve-and-enhance footing through their landed packets -6. continue broader widening from `Phase 4R-D`, with optional `Phase 3R-G` comparison work only if the landed primary browser spatial stack exposes a real gap +4. preserve the landed `google/model-viewer/packages/shared-assets` boundary-sensitive lane with its allowlist, review-only, and local-only posture explicit +5. preserve the landed `PostHog/posthog` boundary-sensitive lane with its explicit root-`MIT`-core-versus-`ee/` subtree boundary explicit +6. use the retained-set contract as the only legal/roadmap routing surface for non-live rows +7. keep `Aarav2709/KubeTimr`, `Hypercubers/hypercubing.xyz`, `apache/echarts`, `google/model-viewer`, `met4citizen/TalkingHead`, `cubing/cubing.js`, `cutelyaware/magiccube4d`, `google/model-viewer/packages/shared-assets`, and `PostHog/posthog` on preserve-and-enhance footing through their landed packets +8. continue broader widening from `Phase 4R-E`, with optional `Phase 3R-G` comparison work only if the landed primary browser spatial stack exposes a real gap ## Suggested repo structure diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/LICENSETRACKING.md b/docs/v6_5_deep_manual_pack/HyperTwist/LICENSETRACKING.md index 7b0816c..857ebbd 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/LICENSETRACKING.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/LICENSETRACKING.md @@ -42,9 +42,9 @@ They still must point back to `C:\HyperTwist\docs\REPO_LICENSE_TRACKING.md` for At the moment, HyperTwist should be described this way: - current curated shallow-eval set: `71` repos -- currently verified live/implemented in checked Unreal surfaces: `17` +- currently verified live/implemented in checked Unreal surfaces: `18` - permissive live lanes: `13` -- boundary-sensitive live lanes: `3` +- boundary-sensitive live lanes: `4` - restrictive live lanes: `1` The thirteen permissive live lanes are: @@ -63,6 +63,13 @@ The thirteen permissive live lanes are: - `poliva/cubedex` - `newyork-anthonyng/rubiks-cross-trainer` +The four boundary-sensitive live lanes are: + +- `cubing/cubing.js` +- `cutelyaware/magiccube4d` +- `google/model-viewer/packages/shared-assets` +- `PostHog/posthog` + The one restrictive live lane is: - `onionhoney/roux-trainers` @@ -125,7 +132,7 @@ Current practical interpretation: - `Phase 2R-B` is now fully closed for the primary retained permissive support-plane rows in scope - `Phase 2R-C` is now fully closed for the final residual `0R-B` permissive rows - `Phase 2R` is now fully closed for the retained permissive set -- the seventeen already-live rows now have source-backed preservation authority in `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` +- the eighteen already-live rows now have source-backed preservation authority in `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` - the retained-set contract now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_1R_RETAINED_SET_CONTRACT_AND_HANDOFF_2026-05-13.md` - the core ownership and acceptance packet now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_2R_PACKET_2R_A_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md` - the support-plane ownership and acceptance packet now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_2R_PACKET_2R_B_OWNERSHIP_AND_ACCEPTANCE_CONTRACT_2026-05-13.md` @@ -139,7 +146,8 @@ Current practical interpretation: - the landed `cubing/cubing.js` boundary-sensitive widening packet now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_4R_PACKET_4R_A_CUBING_JS_ADAPTER_IMPLEMENTATION_2026-05-13.md` - the landed `cutelyaware/magiccube4d` boundary-sensitive widening packet now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_4R_PACKET_4R_B_MAGICCUBE4D_ADAPTER_IMPLEMENTATION_2026-05-13.md` - the landed `google/model-viewer/packages/shared-assets` boundary-sensitive widening packet now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_4R_PACKET_4R_C_SHARED_ASSETS_ALLOWLIST_IMPLEMENTATION_2026-05-13.md` -- the next bounded move is `Phase 4R-D` +- the landed `PostHog/posthog` boundary-sensitive widening packet now lives in `C:\HyperTwist\docs\HYPERTWIST_PHASE_4R_PACKET_4R_D_POSTHOG_CONTROL_PLANE_IMPLEMENTATION_2026-05-13.md` +- the next bounded move is `Phase 4R-E` Read together with: @@ -169,7 +177,7 @@ These are often strategic donors or comparators rather than foundations. Current HyperTwist correction: - thirteen permissive lanes are already live, including the landed analytics/reporting lane, the landed hypercubing knowledge and community-reference lane, and the landed browser spatial owner trio -- two boundary-sensitive lanes are already live: `cubing/cubing.js` through an explicit `MPL`-aware adapter posture and `cutelyaware/magiccube4d` through an explicit attribution/provenance boundary +- four boundary-sensitive lanes are already live: `cubing/cubing.js` through an explicit `MPL`-aware adapter posture, `cutelyaware/magiccube4d` through an explicit attribution/provenance boundary, `google/model-viewer/packages/shared-assets` through an explicit allowlist/provenance boundary, and `PostHog/posthog` through an explicit root-`MIT`-core-versus-`ee/` subtree boundary - `onionhoney/roux-trainers` is the one restrictive training lane already landed through clean-room implementation - timer comparators such as `cstimer` still remain benchmark/reference rows until deep evaluation says otherwise diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md b/docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md index a5018ef..5a6f0a9 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/ROADMAP.md @@ -5,12 +5,12 @@ Before widening new HyperTwist donor-driven implementation beyond the already landed lanes, preserve this current truth: - current shallow-eval set: `71` repos -- currently verified live/implemented in checked Unreal surfaces: `17` +- currently verified live/implemented in checked Unreal surfaces: `18` - permissive live lanes: `13` -- boundary-sensitive live lanes: `3` +- boundary-sensitive live lanes: `4` - restrictive live lane: `1` - the restrictive landed lane is `onionhoney/roux-trainers`, and it is to be treated as properly clean-roomed and then implemented -- `Phase 0R` is now closed for the remaining `55` non-live rows +- `Phase 0R` is now closed for the remaining `53` non-live rows - `Phase 1R` is now closed as the retained-set contract and handoff overhaul - `Phase 2R` is now closed as the retained-set ownership and acceptance packet sequence - `Phase 3R-A` is now closed as the landed `Aarav2709/KubeTimr` timer subsystem widening packet @@ -22,15 +22,16 @@ Before widening new HyperTwist donor-driven implementation beyond the already la - `Phase 4R-A` is now closed as the landed `cubing/cubing.js` classic-cubing semantic/runtime adapter widening packet - `Phase 4R-B` is now closed as the landed `cutelyaware/magiccube4d` legacy `4D` interaction/history/macro/provenance widening packet - `Phase 4R-C` is now closed as the landed `google/model-viewer/packages/shared-assets` fixture allowlist/provenance widening packet +- `Phase 4R-D` is now closed as the landed `PostHog/posthog` control-plane subtree-boundary widening packet Current routing truth: - retained rows total: `68` - discarded from the active retained set: `3` -- active non-live implementation-board rows: `42` +- active non-live implementation-board rows: `41` - retained benchmark, oracle, or clean-room-later rows outside the active implementation board: `9` -The next bounded move is `Phase 4R-D`, with the optional `Phase 3R-G` browser comparison lane deferred unless the landed primary browser spatial stack exposes a real gap. +The next bounded move is `Phase 4R-E`, with the optional `Phase 3R-G` browser comparison lane deferred unless the landed primary browser spatial stack exposes a real gap. ## Reset phases