Upload 15 files

HF_RUNTIME_FIX_RECEIPT_6.md

@@ -0,0 +1,24 @@
+# HF Runtime Fix Receipt 6 — PATCHED8 Preview Rehydration
+
+## Status
+HELD for preview-repair packet generation.
+
+## Fault observed
+The app route processed the video and generated trace receipts, but both top video preview panes showed blank/NaN preview behavior in the Gradio UI.
+
+## Cause class
+Gradio `Video` upload/preview behavior was unreliable for this Space runtime even though the uploaded video was readable by OpenCV and the route completed.
+
+## Patch applied
+- Replaced the left upload `gr.Video` control with a `gr.File` video uploader so file intake is stable and path-bound.
+- Added `coerce_uploaded_path()` to support Gradio file/video payload variants.
+- Added `make_preview_mp4()` to create a browser-stable MP4 preview without mutating the canonical source video.
+- Added upload-time preview rehydration via `video_input.change(...)`.
+- Returned the browser-safe preview MP4 after route execution instead of returning the raw uploaded path.
+- Kept source hashing, atomization, frame extraction, scene detection, trace-stack construction, receipt generation, and packet creation intact.
+
+## Boundary preserved
+The preview MP4 is a display artifact only. The canonical source remains the uploaded video hash and source capsule authority.
+
+## Expected result
+After upload, the right preview pane should populate with a playable browser-safe MP4. After route execution, the same preview pane should remain populated while receipts/tables/gallery are generated.

HF_Substrate_Video_Atomization_Runtime_v0_1_PATCHED8.zip.sha256

@@ -0,0 +1 @@
+58ad79d19f38a0a9a7ad5c86b87fae64355dbb80b05cc07ce3d55decd2333c06  /mnt/data/HF_Substrate_Video_Atomization_Runtime_v0_1_PATCHED8.zip

README.md

@@ -12,9 +12,9 @@ license: cc-by-nc-sa-4.0
 short_description: Video atomization and trace-stack rehydration
 ---
 
-# Substrate Video Atomization Runtime v0.1
+# Substrate Video Atomization Runtime v0.1.1
 
-Upload a short video and run a source-bound atomization route.
+Upload a short video and run a source-bound atomization route. v0.1.1 adds browser-safe preview rehydration while preserving source-bound receipts.
 
 This Space demonstrates Video Atomization, Trace-Stack Rehydration, and Data Hologram formation as a Substrate Mesh runtime surface. The uploaded video is not treated as a monolithic compressed payload. Instead, the runtime hashes the source, samples frame atoms, detects scene intervals, records motion deltas, applies trace capsules, stacks the traces, and returns a rehydrated review surface with an HIR × OAM receipt.
 

app.py

@@ -2,6 +2,7 @@ import os
 import cv2
 import json
 import hashlib
+import subprocess
 import tempfile
 import zipfile
 from datetime import datetime, timezone
@@ -38,7 +39,7 @@ def _install_gradio_schema_guard() -> None:
 _install_gradio_schema_guard()
 
 
-APP_TITLE = "Substrate Video Atomization Runtime v0.1"
+APP_TITLE = "Substrate Video Atomization Runtime v0.1.1"
 BOUNDARY_NOTE = (
     "This demo performs source-bound video atomization and trace-stack rehydration. "
     "It is not video compression, not a codec replacement, and not a physical hologram generator. "
@@ -96,6 +97,82 @@ def make_run_dir() -> Path:
     return Path(tempfile.mkdtemp(prefix=f"video_atomization_{stamp}_"))
 
 
+def coerce_uploaded_path(uploaded) -> str | None:
+    """Return a filesystem path from Gradio File/Video payload variants."""
+    if uploaded is None:
+        return None
+    if isinstance(uploaded, (str, os.PathLike)):
+        return str(uploaded)
+    if isinstance(uploaded, dict):
+        for key in ("path", "name", "orig_name"):
+            value = uploaded.get(key)
+            if value and os.path.exists(str(value)):
+                return str(value)
+        return None
+    name = getattr(uploaded, "name", None)
+    if name and os.path.exists(str(name)):
+        return str(name)
+    return None
+
+
+def make_preview_mp4(video_payload, target_dir: Path | None = None) -> str | None:
+    """Create a browser-stable MP4 preview path without mutating the source video."""
+    video_path = coerce_uploaded_path(video_payload)
+    if not video_path or not os.path.exists(video_path):
+        return None
+
+    if target_dir is None:
+        target_dir = Path(tempfile.mkdtemp(prefix="video_atomization_preview_"))
+    target_dir.mkdir(parents=True, exist_ok=True)
+    preview_path = target_dir / "source_video_preview.mp4"
+
+    # First try a fast stream-copy with +faststart. This fixes many browser/Gradio
+    # preview failures without the cost of a full transcode.
+    faststart_cmd = [
+        "ffmpeg", "-y", "-hide_banner", "-loglevel", "error",
+        "-i", video_path,
+        "-map", "0:v:0", "-map", "0:a?",
+        "-c", "copy",
+        "-movflags", "+faststart",
+        str(preview_path),
+    ]
+    try:
+        subprocess.run(faststart_cmd, check=True, timeout=90)
+        if preview_path.exists() and preview_path.stat().st_size > 0:
+            return str(preview_path)
+    except Exception:
+        pass
+
+    # Fallback: browser-safe H.264/AAC transcode. This is slower, but bounded to
+    # preview generation and still keeps the original file as the canonical source.
+    transcode_cmd = [
+        "ffmpeg", "-y", "-hide_banner", "-loglevel", "error",
+        "-i", video_path,
+        "-map", "0:v:0", "-map", "0:a?",
+        "-c:v", "libx264", "-preset", "veryfast", "-crf", "23",
+        "-pix_fmt", "yuv420p",
+        "-c:a", "aac", "-b:a", "128k",
+        "-movflags", "+faststart",
+        str(preview_path),
+    ]
+    try:
+        subprocess.run(transcode_cmd, check=True, timeout=240)
+        if preview_path.exists() and preview_path.stat().st_size > 0:
+            return str(preview_path)
+    except Exception:
+        pass
+
+    # Last resort: return the source path so the rest of the route still holds.
+    return video_path
+
+
+def prepare_video_preview(video_payload):
+    preview_path = make_preview_mp4(video_payload)
+    if not preview_path:
+        return None, "Preview waiting for source video."
+    return preview_path, "Preview rehydrated from source-bound upload. Source remains canonical authority."
+
+
 def classify_pressure(motion_delta: float, scene_threshold: float) -> str:
     if motion_delta >= scene_threshold * 1.6:
         return "STRAINED_SCENE_BREAK_PRESSURE"
@@ -154,7 +231,8 @@ def create_run_packet(run_dir: Path, packet_name: str = "video_atomization_run_p
 
 
 def atomize_video(video_path, sample_every_seconds=1.0, scene_threshold=32.0, max_frame_atoms=72):
-    if not video_path:
+    source_video_path = coerce_uploaded_path(video_path)
+    if not source_video_path:
         empty = pd.DataFrame()
         return (
             None,
@@ -181,15 +259,15 @@ def atomize_video(video_path, sample_every_seconds=1.0, scene_threshold=32.0, ma
     scene_threshold = max(safe_float(scene_threshold, 32.0), 1.0)
     max_frame_atoms = max(safe_int(max_frame_atoms, 72), 1)
 
-    source_hash = sha256_file(video_path)
-    file_size = os.path.getsize(video_path)
-    filename = os.path.basename(video_path)
+    source_hash = sha256_file(source_video_path)
+    file_size = os.path.getsize(source_video_path)
+    filename = os.path.basename(source_video_path)
 
-    cap = cv2.VideoCapture(video_path)
+    cap = cv2.VideoCapture(source_video_path)
     if not cap.isOpened():
         empty = pd.DataFrame()
         return (
-            video_path,
+            make_preview_mp4(source_video_path, run_dir),
             {"error": "OpenCV could not read this video. Try MP4/H.264, WebM, or MOV."},
             empty,
             empty,
@@ -428,8 +506,10 @@ def atomize_video(video_path, sample_every_seconds=1.0, scene_threshold=32.0, ma
         "Trace stack formed. Data hologram review surface generated. Human validation required."
     )
 
+    preview_path = make_preview_mp4(source_video_path, run_dir)
+
     return (
-        video_path,
+        preview_path,
         source_capsule,
         frame_df,
         scene_df,
@@ -450,7 +530,7 @@ custom_css = """
 with gr.Blocks(title=APP_TITLE, css=custom_css) as demo:
     gr.Markdown(
         """
-# Substrate Video Atomization Runtime v0.1
+# Substrate Video Atomization Runtime v0.1.1
 
 Upload a short video and run a source-bound atomization route.
 
@@ -463,11 +543,23 @@ This v0.1 Space demonstrates the source-bound data-hologram layer.
     )
 
     with gr.Row():
-        video_input = gr.Video(
-            label="Upload source video",
-            sources=["upload"]
+        video_input = gr.File(
+            label="Upload source video file",
+            file_types=["video", ".mp4", ".mov", ".webm", ".mkv"],
+            type="filepath"
+        )
+        video_output = gr.Video(
+            label="Source video preview / rehydrated browser-safe MP4",
+            format="mp4",
+            interactive=False,
+            show_download_button=True
         )
-        video_output = gr.Video(label="Source video preview")
+
+    preview_status = gr.Textbox(
+        label="Preview Status",
+        value="Upload a video to rehydrate a browser-safe source preview.",
+        interactive=False
+    )
 
     with gr.Row():
         sample_every_seconds = gr.Slider(
@@ -525,6 +617,12 @@ This v0.1 Space demonstrates the source-bound data-hologram layer.
         with gr.Tab("Download Run Packet"):
             run_packet = gr.File(label="Download JSON receipts and sampled frame atoms")
 
+    video_input.change(
+        prepare_video_preview,
+        inputs=[video_input],
+        outputs=[video_output, preview_status]
+    )
+
     run_btn.click(
         atomize_video,
         inputs=[video_input, sample_every_seconds, scene_threshold, max_frame_atoms],