Stop pointing comments and test headers at notes and QA scripts the repository does not carry

scripts/format-scope.json

@@ -1227,7 +1227,6 @@
   "src/layers/vessels/renderer.test.mjs",
   "src/layers/vessels/render/navara.js",
   "src/layers/shared/render/engineView.js",
-  "scripts/qa-vessels-engines.mjs",
   "src/layers/installations/render/cesium/lifecycle.js",
   "src/layers/installations/render/cesium/rendering.js",
   "src/layers/installations/render/cesium/selection.js",
@@ -1266,8 +1265,6 @@
   "src/layers/alpr/render/navaraOverlay.test.mjs",
   "scripts/fixtures/w2/alpr.mjs",
   "scripts/fixtures/w2/cctv.mjs",
-  "scripts/qa-w2-alpr.mjs",
-  "scripts/qa-w2-cctv.mjs",
   "src/layers/alpr/render/cesiumOverlay.js",
   "src/layers/radio/render/cesium.js",
   "src/layers/radio/render/navara.js",
@@ -1292,7 +1289,6 @@
   "src/globe/cesium/engineFromViewer.js",
   "src/globe/cesium/engineFromViewer.test.mjs",
   "src/globe/cesium/testing/fakeViewer.mjs",
-  "scripts/qa-globe-contract.mjs",
   "src/app/globeEngine.js",
   "src/app/globeEngine.test.mjs",
   "src/layers/transit/render/cesium.js",
@@ -1303,16 +1299,11 @@
   "src/layers/transit/render/navaraTrail.js",
   "src/layers/transit/render/navara.test.mjs",
   "scripts/fixtures/w2/transit.mjs",
-  "scripts/qa-w2-transit.mjs",
   "src/layers/localAdsb/render/cesium.js",
   "src/layers/localAdsb/render/navara.js",
   "src/layers/localAdsb/renderer.test.mjs",
   "build/navaraAssets.js",
-  "scripts/qa-engine-bench.mjs",
-  "scripts/qa-engine-shell.mjs",
   "scripts/qa-engine-switch.mjs",
-  "scripts/qa/navara-contract.html",
-  "scripts/qa/navaraContractPage.js",
   "scripts/qa/tileCache.mjs",
   "src/annotations/resolverEngine.test.mjs",
   "src/voice/gevActionsEngine.test.mjs",
@@ -1371,9 +1362,7 @@
   "src/tooling/tileCache.test.mjs",
   "scripts/check-main-chunk.mjs",
   "src/tooling/mainChunkComposition.test.mjs",
-  "scripts/qa-w1-baseline.mjs",
   "src/tooling/initialChunkGuard.test.mjs",
-  "src/tooling/w1Baseline.test.mjs",
   "src/globe/movers.test.mjs",
   "src/globe/cesium/movers.test.mjs",
   "src/globe/navara/movers/pack.test.mjs",
@@ -1388,7 +1377,6 @@
   "src/globe/navara/picking.test.mjs",
   "src/data/selectionDispatcher.test.mjs",
   "src/globe/navara/cascadedLightCopy.test.mjs",
-  "src/tooling/w1Feeds.test.mjs",
   "src/tooling/navaraDependencies.test.mjs",
   "build/navaraDependencies.js",
   "build/initialChunkGuard.js",
@@ -1398,11 +1386,9 @@
   "src/globe/cesium/follow.test.mjs",
   "src/globe/surfaceDetail.js",
   "src/globe/surfaceDetail.test.mjs",
-  "scripts/qa-surface-heights.mjs",
   "src/globe/navara/followGestures.js",
   "src/globe/navara/followGestures.test.mjs",
   "src/globe/cpuPicks.test.mjs",
-  "scripts/qa-overlay-engines.mjs",
   "src/app/layers/directory.js",
   "src/app/layers/renderers.js",
   "src/app/layers/renderers.test.mjs",
@@ -1412,17 +1398,11 @@
   "src/app/qaProbe.test.mjs",
   "src/app/layers/qaSources.js",
   "src/app/layers/qaSources.test.mjs",
-  "scripts/qa-w1-layers.mjs",
-  "scripts/qa-flights-engines.mjs",
   "src/bench/w1Feeds.js",
-  "scripts/qa-map-switch.mjs",
-  "scripts/qa-engine-notice.mjs",
   "src/bench/satelliteFixture.js",
   "src/bench/satelliteFixture.test.mjs",
   "src/layers/satellites/render/cesium.js",
   "src/celestialRing/render/cesium.js",
-  "scripts/qa-satellites.mjs",
-  "scripts/qa-satellites-compare.mjs",
   "src/celestialRing/view.js",
   "src/layers/satellites/render/navara.js",
   "src/layers/satellites/render/navara.test.mjs",
@@ -1430,22 +1410,16 @@
   "src/geo/ellipsoidGeodesic.test.mjs",
   "src/bench/launchFixture.js",
   "src/layers/launches/replayClock.test.mjs",
-  "scripts/qa-launches.mjs",
   "src/geo/boundingSphere.test.mjs",
   "src/layers/launches/render/cesium.js",
   "src/layers/launches/launchPadFrame.test.mjs",
   "src/layers/launches/render/navara.js",
   "src/layers/launches/render/navara.test.mjs",
-  "scripts/qa-launches-compare.mjs",
   "src/layers/satellites/interaction.test.mjs",
   "src/layers/launches/lifecycleSnapshot.test.mjs",
-  "scripts/vite-w1-qa.config.mjs",
   "src/data/render/cesiumProjection.js",
   "src/data/render/cesiumTrailRenderer.js",
   "src/data/render/cesiumContactTrailRenderer.js",
-  "scripts/qa-follow-gestures.mjs",
-  "scripts/qa-w1-baseline-pixels.mjs",
-  "src/tooling/w1QaComparison.test.mjs",
   "src/layers/flights/trackingRefresh.test.mjs",
   "scripts/qa-heading-navara.mjs",
   "src/layers/aircraft/qaDrawn.test.mjs",
@@ -1458,9 +1432,7 @@
   "src/layers/localAdsb/qaDrawn.js",
   "src/layers/localAdsb/qaDrawn.test.mjs",
   "src/tooling/w1RuntimeEvidence.test.mjs",
-  "scripts/qa-w2-layers.mjs",
   "scripts/fixtures/w2/earthquakes.mjs",
-  "src/tooling/w2QaComparison.test.mjs",
   "src/layers/earthquakes/render/cesium.js",
   "src/layers/earthquakes/render/cesium.test.mjs",
   "src/layers/earthquakes/render/navara.js",
@@ -1469,43 +1441,25 @@
   "src/layers/earthquakes/render/navaraGrid.js",
   "src/layers/earthquakes/render/navaraGrid.test.mjs",
   "src/layers/earthquakes/render/navara.test.mjs",
-  "src/bench/w2GroundProbe.js",
-  "scripts/qa-w2-ground-mesh.mjs",
-  "scripts/qa-w2-ground-perf.mjs",
-  "scripts/qa-w2-ground-equivalence.mjs",
   "src/layers/firms/render/cesium.js",
   "src/layers/firms/render/cesium.test.mjs",
   "src/layers/firms/rectangle.js",
   "src/layers/firms/rectangle.test.mjs",
   "src/layers/firms/viewport.test.mjs",
-  "scripts/qa-w2-firms.mjs",
   "scripts/fixtures/w2/firms.mjs",
-  "scripts/qa-w2-sprite-alpha.mjs",
   "src/layers/firms/render/navara.test.mjs",
   "src/layers/firms/render/navaraGeometry.test.mjs",
   "src/layers/firms/render/navaraSprites.test.mjs",
-  "scripts/qa-w2-firms-glows.mjs",
-  "scripts/qa-firms-glow-metrics.mjs",
-  "src/tooling/firmsGlowMetrics.test.mjs",
-  "scripts/fixtures/w2/glow-metrics/capture.json",
   "src/layers/firms/lifecycle.test.mjs",
-  "scripts/qa-w2-firms-renderer-entry.mjs",
-  "scripts/qa-w2-firms-perf.mjs",
-  "scripts/qa-w2-firms-ground.mjs",
-  "scripts/qa-w2-radio.mjs",
   "scripts/fixtures/w2/radio.mjs",
   "scripts/qa-map-policy.mjs",
   "scripts/qa-map-policy.test.mjs",
-  "scripts/qa-map-startup.mjs",
   "src/layers/recentImagery/render/tiles.test.mjs",
   "src/layers/recentImagery/render/navara.test.mjs",
   "src/ui/imageryBoxNavara.test.mjs",
   "scripts/qa-w2-imagery.mjs",
   "src/globe/navara/postSamplingPass.test.mjs",
   "src/globe/navara/emptySceneRender.test.mjs",
-  "scripts/qa-post-sampling.mjs",
-  "scripts/qa-installation-stencil.mjs",
-  "scripts/qa-installation-stencil-entry.mjs",
   "src/layers/installations/render/navaraStencilBatch.test.mjs",
   "src/data/firmsIntensity.js",
   "src/data/firmsIntensity.test.mjs",

scripts/qa-strict-harness.mjs

@@ -711,7 +711,7 @@ export function createStrict({
     },
     /**
      * Switch with real input in the same document and wait until `kind`
-     * runs (the picker counterpart of qa-switch-globe.mjs).
+     * runs.
      */
     async switchTo(page, kind) {
       const origin = await page.evaluate(() => performance.timeOrigin);

src/bench/w1Feeds.js

@@ -2,9 +2,8 @@
 // states), the /api/military snapshot (readsb rows), 12 000 AIS vessels on /api/vessels (with and without an area) and
 // the local receivers' 1090 MHz and 978 MHz UAT aircraft near JFK, timed
 // relative to one instant, so every run sees the same objects at the same
-// places. Pure: Node and browser, no I/O. Used by the W1 baseline recordings
-// (src/tooling/w1Feeds.js) and the app's QA fixture sources
-// (src/app/layers/qaSources.js).
+// places. Pure: Node and browser, no I/O. Used by the app's QA fixture
+// sources (src/app/layers/qaSources.js).
 
 import { createSyntheticFlights } from './syntheticFlights.js';
 

src/data/bhoteKoshiLocator.edgeCases.test.mjs

@@ -1,7 +1,6 @@
-// Edge cases from docs/migration/planet-separation/layers.md
-// (bhote-koshi-locator): a boundary that resolves late, after its request was
-// cancelled, does not change the live scene; both engines show the same area
-// and the same target.
+// Edge cases for bhote-koshi-locator: a boundary that resolves late, after its
+// request was cancelled, does not change the live scene; both engines show the
+// same area and the same target.
 import assert from 'node:assert/strict';
 import test from 'node:test';
 import * as Cesium from 'cesium';

src/data/militaryFlights.edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases for the military layer from docs/migration/planet-separation/layers.md:
+// Edge cases for the military layer:
 // one ICAO present in both feeds yields one target with the military card, and
 // when the owning feed loses the contact the follow camera is released.
 import { test } from 'node:test';

src/layers/awareness/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases for military-awareness from docs/migration/planet-separation/layers.md:
+// Edge cases for military-awareness:
 // with no scene the same nearest contacts come back, and NEXT/PREV, a type
 // filter and an exhausted list lead to the same ID whatever scene is attached
 // and whatever order the feeds list equally distant contacts in.

src/layers/cctv/render/navaraMeshes.js

@@ -49,7 +49,7 @@ export function createCctvNavaraMeshes(engine, { view, MeshDesc }) {
         // The opaque scene draws after the scene depth is copied into its
         // target, so walls and terrain hide the frame and volume; Navara's
         // transparent pass runs after the effects without that depth and
-        // painted them through (scripts/qa-edge-cctv-occlusion.mjs).
+        // painted them through.
         getPassKey() {
           return 'opaque';
         }

src/layers/ghostMaps/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases from docs/migration/planet-separation/layers.md (s2-ghostmaps):
+// Edge cases for s2-ghostmaps:
 // change the KMZ edition and the engine before parsing finishes; only the
 // selected edition is shown, and a bad archive does not erase the working one.
 import assert from 'node:assert/strict';

src/layers/localAdsb/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases for the local-adsb layer from docs/migration/planet-separation/layers.md:
+// Edge cases for the local-adsb layer:
 // a scene switch does not reopen the USB device, decoder stream or tuner
 // permission; an unplugged device ends exactly one session; and no local ID
 // reaches a public share link.

src/layers/satellites/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge case for the satellites layer from docs/migration/planet-separation/layers.md:
+// Edge case for the satellites layer:
 // with the clock stopped at a known epoch, switching the scene while a
 // satellite is followed leaves the pass list and the coordinates unchanged.
 import test from 'node:test';

src/layers/shared/render/navaraSceneDepth.js

@@ -5,7 +5,7 @@
 // its look. This test keeps the mesh in the transparent pass and drops every
 // fragment that lies behind the depth Navara packs after its opaque pass
 // (globe, 3D tiles, MRT and opaque meshes): an unhidden fragment is drawn
-// exactly as before. scripts/qa-edge-occlusion.mjs checks it in a browser.
+// exactly as before.
 import { RGBADepthPacking, Vector2 } from 'three';
 
 const KEY = 'gevSceneDepth';

src/layers/streetLevel/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases from docs/migration/planet-separation/layers.md (street-level):
+// Edge cases for street-level:
 // without a paid source, a late answer from a provider the user switched away
 // from is ignored and the lit provider keeps the panel.
 import assert from 'node:assert/strict';

src/layers/transit/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases from docs/migration/planet-separation/layers.md (transit): a stop,
+// Edge cases for transit: a stop,
 // a turn, a feed loss and its return keep the heading and the data age
 // continuous, and the selection stays bound to the vehicle/trip identity.
 import test from 'node:test';

src/layers/vessels/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge case for ais-live-vessels from docs/migration/planet-separation/layers.md:
+// Edge case for ais-live-vessels:
 // a vessel crosses into the next area cell while AIS is interrupted. There is
 // never a second request in flight and the card comes back by MMSI.
 import test from 'node:test';

src/layers/wind/edgeCases.test.mjs

@@ -1,4 +1,4 @@
-// Edge cases from docs/migration/planet-separation/layers.md (wind): on a fixed
+// Edge cases for wind: on a fixed
 // grid direction, speed and legend agree whichever way the centre is picked,
 // and an empty field is never presented as calm.
 import test from 'node:test';

src/services/meshFloorSampler.js

@@ -3,8 +3,8 @@ import { engineFromViewer } from '../globe/cesium/engineFromViewer.js';
 import { acceptedSurfaceHeight } from '../globe/surfaceDetail.js';
 
 /** Answers from tiles larger than this are too coarse to latch (m).
- *  Measured on Navara (scripts/qa-surface-heights.mjs): from 800 m the
- *  answering tiles were 112-314 m and within 2 m of Cesium; from 15 km, cold,
+ *  Measured on Navara: from 800 m the answering tiles were 112-314 m and
+ *  within 2 m of Cesium; from 15 km, cold,
  *  3.5-4 km tiles were off by -16.2 to +6.2 m; while streaming a 27.9 km tile
  *  read 143.2 m at Austin where the ground is 122.5 m. A 1.8 km tile at
  *  Austin (the hidden tile under a 600 m camera looking ahead) read the