Resolve scrambles as historical source alias

docs/HYPERTWIST_REPO_LICENSE_EVIDENCE_AUDIT_2026-05-27.md

@@ -6,6 +6,7 @@ Boundary:
 - this is the repo-local legal-evidence pass for mirrored HyperTwist custody, not a rewrite of the broader historical workbook universe
 - only standalone git roots count in the live audit
 - package-subpath rows that live inside a mirrored monorepo and resolve to the same repo URL are normalized under the parent git-root authority instead of being treated as standalone repo roots
+- historical alias rows whose standalone repo surfaces are gone but whose maintained public source surfaces now live elsewhere are kept visible as historical references, not as unresolved mirror-restoration work
 - upstream-unavailable rows, unresolved missing mirror paths, and genuinely unrelated non-standalone paths stay visible outside the standalone count instead of being silently discarded
 - when later repos are mirrored or their root-license evidence changes, rerun `C:\HyperTwist\scripts\Write-HyperTwistRepoLicenseEvidenceAudit.ps1` in the same pass that updates the legal tracker
 
@@ -18,7 +19,8 @@ Counts:
 - no clear repo-local license signal: 5
 - no-clear bucket where current HyperTwist manifest already carries a legal call: 5
 - package-subpath rows normalized under parent root authority: 11
-- unresolved upstream-unavailable, missing, or unrelated non-standalone rows outside the live standalone count: 1
+- historical alias rows outside active mirror expectation: 1
+- unresolved upstream-unavailable, missing, or unrelated non-standalone rows outside the live standalone count: 0
 - total rows outside the standalone live count: 12
 
 Artifacts:
@@ -52,6 +54,9 @@ Package-subpath rows normalized under parent root authority:
 - C:\Workspaces\HyperTwist\mirrors\permissive\pmndrs\react-spring\packages\shared -> C:/Workspaces/HyperTwist/mirrors/permissive/pmndrs/react-spring (`package_subpath_under_parent_root_authority`)
 - C:\Workspaces\HyperTwist\mirrors\permissive\pmndrs\react-spring\packages\types -> C:/Workspaces/HyperTwist/mirrors/permissive/pmndrs/react-spring (`package_subpath_under_parent_root_authority`)
 
-Excluded from the live standalone-git-root count:
-- C:\Workspaces\HyperTwist\mirrors\restrictive\cubing\scrambles (`upstream_unavailable_or_not_publicly_resolvable`)
+Historical alias rows not expected to be mirrored:
+- C:\Workspaces\HyperTwist\mirrors\restrictive\cubing\scrambles (`historical_alias_not_expected_to_be_mirrored`)
+
+Excluded from the live standalone-git-root count:
+- none
 

docs/REPO_LICENSE_TRACKING.md

@@ -104,6 +104,9 @@ Required rule:
   record that as an explicit `upstream-unavailable` exclusion in the manifest,
   generated audit bundle, and this root tracker instead of leaving it as an
   accidental generic missing-path row
+- if a missing standalone repo row is only a historical alias and maintained
+  public source surfaces now live elsewhere, convert it into a historical alias
+  row instead of keeping it in the active mirror-restoration queue
 - if a manifest row points at a package subpath inside a mirrored monorepo and
   the parent git root resolves to the same repo URL, normalize that row under
   the parent root authority in the generated audit rather than treating it as a
@@ -692,32 +695,43 @@ Decision date:
 
 Current licensing judgment:
 
-- the retained repo URL is currently not publicly resolvable from this pass
+- the standalone `cubing/scrambles` repo URL is currently not publicly
+  resolvable from this pass
 - no local mirror is present
-- no repo-root license signal could be checked in current local custody
+- no repo-root license signal can be checked from that standalone alias row
+- maintained public scramble source surfaces are already visible elsewhere in
+  the cubing family:
+  - `cubing/cubing.js` via `cubing/scramble`
+  - `cubing/scramble.cubing.net`
+  - `cubing/mark3`
 - direct donor use is not cleared
-- keep the row as an explicit upstream-unavailable supplemental exclusion
-  rather than a generic missing-path oversight
+- keep this row as a historical alias only, not as an active mirror-restoration
+  target
 
 Source basis:
 
 - `C:\Workspaces\HyperTwist\repos.manifest.json`
+- `C:\Workspaces\HyperTwist\mirrors\permissive\cubing\cubing.js\src\cubing\scramble\index.ts`
+- `C:\Workspaces\HyperTwist\mirrors\permissive\cubing\cubing.js\src\docs\js.cubing.net\cubing\scramble\index.html`
 - `C:\HyperTwist\docs\HYPERTWIST_REPO_LICENSE_EVIDENCE_AUDIT_2026-05-27.md`
 
 Practical obligations:
 
 - do not fabricate a local mirror or assume permissive terms from older intake
   prose
-- keep the row outside the live standalone-git-root count until public source
-  is restorable and reviewed
-- if upstream becomes public again, clone and re-audit before donor
-  classification or source use
+- do not keep this row in the active mirror-restoration queue
+- if scramble-generation source is needed, read the maintained public cubing
+  family surfaces first
+- if the exact standalone alias repo ever reappears publicly, re-audit it as a
+  new source event rather than silently reviving the old expectation
 
 Approved working posture:
 
-- retain as a historical or supplemental reference row only
-- do not treat it as mirror-ready today
-- do not treat it as a donor-use lane today
+- retain as a historical alias reference row only
+- do not treat it as mirror-ready
+- do not treat it as a donor-use lane
+- do not let it keep the mirror audit in an unresolved state when maintained
+  public scramble sources are already elsewhere in the cubing family
 
 ### `onionhoney/roux-trainers`
 

docs/ops/HYPERTWIST_DEEP_SOURCE_CLOSEOUT_AND_LEGAL_EVIDENCE_SEQUENCE_2026-05-26.md

@@ -71,6 +71,10 @@ For each resumed repo pass:
     reviewed in the same pass, mark the row as an explicit
     `upstream-unavailable` exclusion in the manifest, generated audit, and root
     tracker instead of leaving it as a generic missing-path artifact
+8aa. if the missing standalone row is only a historical alias and maintained
+     public source surfaces already exist elsewhere, convert it into a
+     historical alias row instead of keeping it in the active
+     mirror-restoration queue
 8b. if a manifest row points at a package subpath inside a mirrored monorepo
     and the parent git root resolves to the same repo URL, normalize that row
     under the parent root authority in the generated audit instead of leaving it

docs/v6_5_deep_manual_pack/HyperTwist/LICENSETRACKING.md

@@ -77,6 +77,9 @@ Required rule:
   record that as an explicit `upstream-unavailable` exclusion in the manifest,
   generated audit bundle, and root tracker instead of leaving it as a generic
   missing-path row
+- if a missing standalone repo row is only a historical alias and maintained
+  public source surfaces now live elsewhere, convert it into a historical alias
+  row instead of keeping it in the active mirror-restoration queue
 - if a manifest row points at a package subpath inside a mirrored monorepo and
   the parent git root resolves to the same repo URL, normalize that row under
   the parent root authority in the generated audit rather than treating it as a
@@ -249,7 +252,8 @@ Current HyperTwist correction:
 - twenty-two permissive lanes are already live, including the landed analytics/reporting lane, the landed hypercubing knowledge and community-reference lane, the landed browser spatial owner trio, the landed bounded speech/voice permissive lanes, and the landed bounded hyper/simulation widening lanes
 - six 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, `PostHog/posthog` through an explicit root-`MIT`-core-versus-`ee/` subtree boundary, `screenpipe/screenpipe` through an explicit permissive-core-versus-`ee/` subtree boundary, and `remotion-dev/remotion` through an explicit package-split commercial boundary
 - six restrictive lanes are now live in custody terms, with `onionhoney/roux-trainers` preserved as the earlier clean-room precedent, the later retained restrictive rows landed through accepted clean-room routing, and `poliva/cubedex` corrected into restrictive custody while its existing first-party outputs remain preserved and donor widening is blocked
-- supplemental rows `cubing/qqTimer` and `cubing/scrambles` are not live lanes: `qqTimer` is now mirrored under restrictive custody with no clear root license signal, while `scrambles` remains an explicit upstream-unavailable exclusion until a public repo surface can be restored and reviewed
+- supplemental row `cubing/qqTimer` is mirrored under restrictive custody with no clear root license signal
+- `cubing/scrambles` is now a historical alias row rather than an active unresolved mirror-restoration target, because maintained public scramble source surfaces are already visible elsewhere in the cubing family
 - the `google/model-viewer/packages/*` and `pmndrs/react-spring/packages/*`
   rows remain package-specific authority slices, but generated legal-evidence
   passes should normalize them under their parent git-root authority rather

scripts/Write-HyperTwistRepoLicenseEvidenceAudit.ps1

@@ -317,7 +317,9 @@ foreach ($entry in $entries) {
     $path = $entry.PrimaryPath
     $exists = Test-Path -LiteralPath $path
     if (-not $exists) {
-        $missingReason = if ($entry.CurrentManifestLicenseStatus -eq "upstream-unavailable") {
+        $missingReason = if ($entry.CurrentManifestLicenseStatus -eq "historical-alias-unavailable") {
+            "historical_alias_not_expected_to_be_mirrored"
+        } elseif ($entry.CurrentManifestLicenseStatus -eq "upstream-unavailable") {
             "upstream_unavailable_or_not_publicly_resolvable"
         } else {
             "missing_local_path"
@@ -531,7 +533,11 @@ $noClearWithCanonCount = @($orderedAuditRows | Where-Object {
         $_.current_manifest_license
     }).Count
 $normalizedSubpathCount = @($excludedRows | Where-Object { $_.Reason -eq "package_subpath_under_parent_root_authority" }).Count
-$remainingExcludedCount = @($excludedRows | Where-Object { $_.Reason -ne "package_subpath_under_parent_root_authority" }).Count
+$historicalAliasCount = @($excludedRows | Where-Object { $_.Reason -eq "historical_alias_not_expected_to_be_mirrored" }).Count
+$remainingExcludedCount = @($excludedRows | Where-Object {
+        $_.Reason -ne "package_subpath_under_parent_root_authority" -and
+        $_.Reason -ne "historical_alias_not_expected_to_be_mirrored"
+    }).Count
 $excludedCount = $excludedRows.Count
 
 $markdown = New-Object System.Collections.Generic.List[string]
@@ -543,6 +549,7 @@ $markdown.Add("Boundary:")
 $markdown.Add("- this is the repo-local legal-evidence pass for mirrored HyperTwist custody, not a rewrite of the broader historical workbook universe")
 $markdown.Add("- only standalone git roots count in the live audit")
 $markdown.Add("- package-subpath rows that live inside a mirrored monorepo and resolve to the same repo URL are normalized under the parent git-root authority instead of being treated as standalone repo roots")
+$markdown.Add("- historical alias rows whose standalone repo surfaces are gone but whose maintained public source surfaces now live elsewhere are kept visible as historical references, not as unresolved mirror-restoration work")
 $markdown.Add("- upstream-unavailable rows, unresolved missing mirror paths, and genuinely unrelated non-standalone paths stay visible outside the standalone count instead of being silently discarded")
 $markdown.Add('- when later repos are mirrored or their root-license evidence changes, rerun `C:\HyperTwist\scripts\Write-HyperTwistRepoLicenseEvidenceAudit.ps1` in the same pass that updates the legal tracker')
 $markdown.Add("")
@@ -555,6 +562,7 @@ $markdown.Add("- MIT from repo metadata only, no root license file: $mitMetadata
 $markdown.Add("- no clear repo-local license signal: $noClearCount")
 $markdown.Add("- no-clear bucket where current HyperTwist manifest already carries a legal call: $noClearWithCanonCount")
 $markdown.Add("- package-subpath rows normalized under parent root authority: $normalizedSubpathCount")
+$markdown.Add("- historical alias rows outside active mirror expectation: $historicalAliasCount")
 $markdown.Add("- unresolved upstream-unavailable, missing, or unrelated non-standalone rows outside the live standalone count: $remainingExcludedCount")
 $markdown.Add("- total rows outside the standalone live count: $excludedCount")
 $markdown.Add("")
@@ -612,7 +620,21 @@ if ($normalizedRows.Count -eq 0) {
 }
 $markdown.Add("")
 
-$remainingExcludedRows = @($excludedRows | Where-Object { $_.Reason -ne "package_subpath_under_parent_root_authority" } | Sort-Object RepoId, Path)
+$historicalAliasRows = @($excludedRows | Where-Object { $_.Reason -eq "historical_alias_not_expected_to_be_mirrored" } | Sort-Object RepoId, Path)
+$markdown.Add("Historical alias rows not expected to be mirrored:")
+if ($historicalAliasRows.Count -eq 0) {
+    $markdown.Add("- none")
+} else {
+    foreach ($row in $historicalAliasRows) {
+        $markdown.Add("- $($row.Path) (``$($row.Reason)``)")
+    }
+}
+$markdown.Add("")
+
+$remainingExcludedRows = @($excludedRows | Where-Object {
+        $_.Reason -ne "package_subpath_under_parent_root_authority" -and
+        $_.Reason -ne "historical_alias_not_expected_to_be_mirrored"
+    } | Sort-Object RepoId, Path)
 $markdown.Add("Excluded from the live standalone-git-root count:")
 if ($remainingExcludedRows.Count -eq 0) {
     $markdown.Add("- none")