@t3lnet/sceneforge 1.0.29 → 1.0.31

package/cli/commands/record-demo.js

@@ -182,8 +182,6 @@ export async function runRecordDemoCommand(argv) {
   const hqVideo = hasFlag(args, "--hq-video");
   const hqFormat = getFlagValue(args, "--hq-format") ?? "jpeg";
   const hqQuality = parseInt(getFlagValue(args, "--hq-quality") ?? "100", 10);
-  const hqFpsArg = getFlagValue(args, "--hq-fps");
-  const hqFps = hqFpsArg ? parseInt(hqFpsArg, 10) : undefined; // undefined = use actual capture rate
 
   if (!baseUrl) {
     console.error("[error] --base-url is required");
@@ -308,7 +306,7 @@ export async function runRecordDemoCommand(argv) {
     const finalVideoPath = path.join(outputPaths.videosDir, `${definition.name}.webm`);
     try {
       if (!demoError && result?.success) {
-        await cdpRecorder.assembleVideo(finalVideoPath, hqFps ? { fps: hqFps } : {});
+        await cdpRecorder.assembleVideo(finalVideoPath);
         console.log(`[record] High-quality video saved: ${finalVideoPath}`);
         if (result.scriptPath) {
           // Use the actual first frame time for alignment, not when we started the recorder

package/cli/utils/cdp-recorder.js

@@ -209,12 +209,9 @@ export function createCDPRecorder(page, options) {
      * Uses timestamp-aware assembly to preserve real-time playback timing
      *
      * @param {string} outputPath - Output video path
-     * @param {Object} [assembleOptions] - Assembly options
-     * @param {number} [assembleOptions.fps] - Output framerate for encoding (default: 30)
      * @returns {Promise<string>} - Path to assembled video
      */
-    async assembleVideo(outputPath, assembleOptions = {}) {
-      const { fps: outputFps = 30 } = assembleOptions;
+    async assembleVideo(outputPath) {
 
       if (frameTimestamps.length === 0) {
         throw new Error("No frames captured - cannot assemble video");
@@ -234,8 +231,8 @@ export function createCDPRecorder(page, options) {
           // Last frame - use average duration or minimum display time
           const avgDuration = sortedFrames.length > 1
             ? (sortedFrames[sortedFrames.length - 1].timestamp - sortedFrames[0].timestamp) / (sortedFrames.length - 1)
-            : 1 / outputFps;
-          duration = Math.max(avgDuration, 1 / outputFps);
+            : 1 / 30;
+          duration = Math.max(avgDuration, 1 / 30);
         }
         // Clamp duration to reasonable bounds (min 1ms, max 10 seconds per frame)
         duration = Math.max(0.001, Math.min(duration, 10));
@@ -279,6 +276,8 @@ export function createCDPRecorder(page, options) {
       }
 
       // Use concat demuxer for timestamp-aware assembly
+      // Output at 30fps CFR - FFmpeg will duplicate frames as needed to fill time
+      // This creates a seekable video while preserving the correct timing from the concat durations
       await runFFmpeg([
         "-y",
         "-f", "concat",
@@ -286,8 +285,8 @@ export function createCDPRecorder(page, options) {
         "-i", concatFilePath,
         ...encodingArgs,
         "-pix_fmt", "yuv420p",
-        "-r", String(outputFps),  // Output framerate (for smooth playback)
-        "-vsync", "vfr",          // Variable framerate to preserve timing
+        "-r", "30",               // Output at constant 30fps for seekability
+        "-fps_mode", "cfr",       // Constant framerate output
         outputPath,
       ]);
 
@@ -317,9 +316,7 @@ export function getCDPRecordingHelpText() {
   return `
 High-Quality Recording Options:
   --hq-video              Use CDP-based high-quality recording instead of Playwright
-                          Captures frames at maximum quality and assembles with FFmpeg
+                          Captures frames with timestamps and assembles with real-time timing
   --hq-format <format>    Frame format: jpeg (default) or png (lossless, larger files)
-  --hq-quality <1-100>    JPEG quality (default: 100, ignored for PNG)
-  --hq-fps <fps>          Output framerate (default: actual capture rate for real-time)
-                          Override only if you want to change playback speed`;
+  --hq-quality <1-100>    JPEG quality (default: 100, ignored for PNG)`;
 }

package/context/templates/base/cli-reference.md

@@ -466,7 +466,6 @@ The CDP-based recorder captures frames directly from Chrome DevTools Protocol an
 --hq-video              # Enable CDP-based high-quality recording
 --hq-format <format>    # Frame format: jpeg (default) or png
 --hq-quality <1-100>    # JPEG quality (default: 100, ignored for PNG)
---hq-fps <fps>          # Override output framerate (default: actual capture rate for real-time)
 ```
 
 ### Frame Formats
@@ -478,9 +477,9 @@ The CDP-based recorder captures frames directly from Chrome DevTools Protocol an
 
 ### How It Works
 
-1. **Frame Capture**: Uses Chrome's `Page.startScreencast` CDP method
+1. **Frame Capture**: Uses Chrome's `Page.startScreencast` CDP method with timestamps
 2. **Frame Storage**: Saves frames as JPEG (quality 100) or lossless PNG
-3. **Video Assembly**: FFmpeg assembles frames with lossless intermediate encoding
+3. **Timestamp-Aware Assembly**: FFmpeg assembles frames using per-frame durations to preserve real-time playback (waits stay as waits, actions stay as actions)
 4. **Final Output**: Quality settings applied at concat step
 
 ### Examples

package/dist/templates/base/cli-reference.md

@@ -466,7 +466,6 @@ The CDP-based recorder captures frames directly from Chrome DevTools Protocol an
 --hq-video              # Enable CDP-based high-quality recording
 --hq-format <format>    # Frame format: jpeg (default) or png
 --hq-quality <1-100>    # JPEG quality (default: 100, ignored for PNG)
---hq-fps <fps>          # Override output framerate (default: actual capture rate for real-time)
 ```
 
 ### Frame Formats
@@ -478,9 +477,9 @@ The CDP-based recorder captures frames directly from Chrome DevTools Protocol an
 
 ### How It Works
 
-1. **Frame Capture**: Uses Chrome's `Page.startScreencast` CDP method
+1. **Frame Capture**: Uses Chrome's `Page.startScreencast` CDP method with timestamps
 2. **Frame Storage**: Saves frames as JPEG (quality 100) or lossless PNG
-3. **Video Assembly**: FFmpeg assembles frames with lossless intermediate encoding
+3. **Timestamp-Aware Assembly**: FFmpeg assembles frames using per-frame durations to preserve real-time playback (waits stay as waits, actions stay as actions)
 4. **Final Output**: Quality settings applied at concat step
 
 ### Examples

package/package.json

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