@t3lnet/sceneforge 1.0.26 → 1.0.27

package/cli/commands/record-demo.js

@@ -292,8 +292,9 @@ export async function runRecordDemoCommand(argv) {
   }
 
   // Stop CDP recorder before closing context
+  let cdpStopInfo = null;
   if (cdpRecorder) {
-    await cdpRecorder.stop();
+    cdpStopInfo = await cdpRecorder.stop();
   }
 
   await context.close();
@@ -307,7 +308,9 @@ export async function runRecordDemoCommand(argv) {
         await cdpRecorder.assembleVideo(finalVideoPath, { fps: hqFps });
         console.log(`[record] High-quality video saved: ${finalVideoPath}`);
         if (result.scriptPath) {
-          await alignScriptToVideo(result.scriptPath, finalVideoPath, videoRecordingStartTime);
+          // Use the actual first frame time for alignment, not when we started the recorder
+          const actualVideoStartTime = cdpStopInfo?.firstFrameTime || videoRecordingStartTime;
+          await alignScriptToVideo(result.scriptPath, finalVideoPath, actualVideoStartTime);
         }
       }
     } finally {

package/cli/utils/cdp-recorder.js

@@ -55,6 +55,7 @@ export function createCDPRecorder(page, options) {
   let frameTimestamps = [];
   let isRecording = false;
   let startTime = null;
+  let firstFrameTime = null; // Wall clock time when first frame was received
   let writeQueue = Promise.resolve();
   let nextFrameNumber = 0;
 
@@ -64,6 +65,11 @@ export function createCDPRecorder(page, options) {
     const { data, metadata, sessionId } = params;
     frameCount += 1;
 
+    // Track when we receive the first frame (wall clock time)
+    if (firstFrameTime === null) {
+      firstFrameTime = Date.now();
+    }
+
     // Acknowledge the frame immediately to continue receiving
     cdpSession.send("Page.screencastFrameAck", { sessionId }).catch(() => {
       // Session may be closed
@@ -156,15 +162,21 @@ export function createCDPRecorder(page, options) {
       // Wait for all pending frame writes to complete
       await writeQueue;
 
+      const delayToFirstFrame = firstFrameTime ? firstFrameTime - startTime : 0;
       console.log(
         `[cdp-recorder] Captured ${frameTimestamps.length} frames in ${(duration / 1000).toFixed(2)}s`
       );
+      if (delayToFirstFrame > 100) {
+        console.log(`[cdp-recorder] First frame delay: ${delayToFirstFrame}ms`);
+      }
 
       return {
         frameCount: frameTimestamps.length,
         duration,
         framesDir,
         frameTimestamps,
+        firstFrameTime, // Wall clock time when first frame was captured
+        startTime,      // Wall clock time when recording was started
       };
     },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t3lnet/sceneforge",
-  "version": "1.0.26",
+  "version": "1.0.27",
   "description": "SceneForge runner and generation utilities for YAML-driven demos",
   "license": "MIT",
   "author": "T3LNET",