Validate CCTV terrain regime and frame calibration drag fixture

changelog.d/1133-cctv-qa-terrain-drag-fixture.md

@@ -0,0 +1,3 @@
+- Make CCTV QA ground-sampling checks respect the active terrain regime and
+  frame the actual calibration gizmo for the drag regression, preserving the
+  photoreal completion floor and all drag invariants.

scripts/qa-cctv-v2.mjs

@@ -658,6 +658,13 @@ async function main() {
     // (existence, not just ceiling). The wait below tolerates the update-tick
     // latency of the completion pass (update interval is 10s).
     // -----------------------------------------------------------------------
+    // Globe terrain uses the cached DEM/prior and intentionally never calls
+    // scene.sampleHeight. Only the photoreal regime owns a one-shot mesh snap.
+    // Keep the mesh completion floor strict when that regime is active.
+    const photorealRegime = await page.evaluate(
+      () => window.__godsEyeView.viewer.scene.globe?.show === false,
+    );
+    if (photorealRegime) {
       console.log('Waiting for tiles + the one-shot completion pass...');
       const tilesSeenLoaded = await waitForTilesLoaded(page, 45000);
       let sampleFloorOk = false;
@@ -676,6 +683,14 @@ async function main() {
           ? `total real samples since enable=${cFloor.sampleHeight - c0.sampleHeight}`
           : 'tilesLoaded never observed within 45s — floor not assessable this run',
       );
+    } else {
+      const cFloor = await readCounters();
+      record(
+        'terrain-globe uses its DEM/prior without photoreal mesh sampling',
+        cFloor.sampleHeight === c0.sampleHeight,
+        `mesh samples since enable=${cFloor.sampleHeight - c0.sampleHeight}`,
+      );
+    }
 
     // Let the completion pass finish before the steady-state window: require
     // the sampleHeight counter quiet for 12s (> the 10s update interval, so
@@ -1732,6 +1747,34 @@ async function main() {
       gizmoStates.map((s, i) => `${GIZMO_PARTS[i]}=${s}`).join(' '),
     );
 
+    // Frame the actual gizmo for the drag fixture. Default autofocus can leave
+    // its shaft below the 10px interaction threshold; that distant view is not
+    // the drag-usability scenario this regression exercises.
+    const dragFraming = await page.evaluate(async () => {
+      const viewer = window.__godsEyeView.viewer;
+      const e = viewer.entities.getById('cctv-gizmo-move-east');
+      if (!e) return null;
+      const pts = e.polyline.positions.getValue(viewer.clock.currentTime);
+      const target = pts?.[0];
+      if (!target) return null;
+      const measure = () => {
+        const a = viewer.scene.cartesianToCanvasCoordinates(pts[0]);
+        const b = viewer.scene.cartesianToCanvasCoordinates(pts[pts.length - 1]);
+        return {
+          shaftPx: a && b ? Math.hypot(b.x - a.x, b.y - a.y) : null,
+          rangeM: target.constructor.distance(viewer.camera.positionWC, target),
+        };
+      };
+      const before = measure();
+      viewer.camera.cancelFlight();
+      viewer.camera.lookAt(target, new target.constructor(0, -200, 180));
+      viewer.camera.lookAtTransform(viewer.camera.transform.constructor.IDENTITY);
+      viewer.scene.requestRender();
+      const frames = await window.__qaRenderFrames(3, 10000);
+      return { before, after: measure(), frames };
+    });
+    console.log('Drag fixture framing:', JSON.stringify(dragFraming));
+
     // Synthetic CDP drag on the EAST arrow — the owner's field-test
     // regression. Sample effective elevation after every mouse move: it must
     // stay frozen until release, with no transient sampleHeight calls.