Debug: add image preview (first page) with PyMuPDF/pdfium; return PDF path from debug flows; chain .then to render image

app.py

@@ -1381,7 +1381,8 @@ def debug_compile_output_zip():
     if not zip_path.exists():
         return (
             "<div style='color:#b00'><b>output.zip not found at repo root.</b></div>"
-            + f"<div>Expected at: {zip_path}</div>"
+            + f"<div>Expected at: {zip_path}</div>",
+            None,
         )
     logs = [f"🐞 Stage(repo zip) at {_now_str()}"]
     _, WORK_DIR, LOG_PATH, ZIP_PATH = _prepare_workspace(logs)
@@ -1417,7 +1418,7 @@ def debug_compile_output_zip():
     except Exception as e:
         logs.append(f"❌ unzip failed: {e}")
         _write_logs(LOG_PATH, logs)
-        return "<div style='color:#b00'>Unzip failed.</div>"
+        return "<div style='color:#b00'>Unzip failed.</div>", None
 
     # Locate poster_output.tex (fallback to poster.tex)
     tex_path = None
@@ -1434,7 +1435,7 @@ def debug_compile_output_zip():
     if tex_path is None:
         logs.append("❌ No .tex file found in output.zip")
         _write_logs(LOG_PATH, logs)
-        return "<div style='color:#b00'>No .tex found in output.zip</div>"
+        return "<div style='color:#b00'>No .tex found in output.zip</div>", None
 
     # If left_logo missing, disable \logoleft
     try:
@@ -1465,7 +1466,8 @@ def debug_compile_output_zip():
             "<div style='color:#b00'><b>Compile failed.</b></div>"
             + "<pre style='white-space:pre-wrap;background:#f7f7f8;padding:8px;border-radius:6px'>"
             + "\n".join(logs)
-            + "</pre>"
+            + "</pre>",
+            None,
         )
 
     try:
@@ -1476,11 +1478,11 @@ def debug_compile_output_zip():
             + _pdf_to_iframe_html(pdf_path, height="700px")
         )
         _write_logs(LOG_PATH, logs)
-        return html
+        return html, str(pdf_path)
     except Exception as e:
         logs.append(f"⚠️ preview failed: {e}")
         _write_logs(LOG_PATH, logs)
-        return f"<div>Compiled but preview failed: {e}</div>"
+        return f"<div>Compiled but preview failed: {e}</div>", None
 
 def _find_last_pipeline_zip():
     try:
@@ -1501,7 +1503,7 @@ def _find_last_pipeline_zip():
         return None
 
 def debug_compile_last_pipeline_zip():
-    """Find the most recent runs/*/output.zip from pipeline, compile, and preview the PDF."""
+    """Find the most recent runs/*/output.zip from pipeline, compile, and return preview HTML + PDF path."""
     logs = [f"🐞 Debug(last-pipeline-zip) at {_now_str()}"]
     last_zip = _find_last_pipeline_zip()
     if not last_zip:
@@ -1516,7 +1518,7 @@ def debug_compile_last_pipeline_zip():
                 logs.append(f"❌ Auto-stage failed: {e}")
                 return "<div style='color:#b00'>No recent pipeline output.zip found and auto-stage failed.</div>"
         else:
-            return "<div style='color:#b00'>No recent pipeline output.zip found under runs/.</div>"
+            return "<div style='color:#b00'>No recent pipeline output.zip found under runs/.</div>", None
 
     # Prepare workspace
     run_id, WORK_DIR, LOG_PATH, _ = _prepare_workspace(logs)
@@ -1533,7 +1535,7 @@ def debug_compile_last_pipeline_zip():
     except Exception as e:
         logs.append(f"❌ unzip failed: {e}")
         _write_logs(LOG_PATH, logs)
-        return "<div style='color:#b00'>Unzip failed.</div>"
+        return "<div style='color:#b00'>Unzip failed.</div>", None
 
     # Locate tex
     tex_path = None
@@ -1549,7 +1551,7 @@ def debug_compile_last_pipeline_zip():
     if tex_path is None:
         logs.append("❌ No .tex file found in last pipeline zip")
         _write_logs(LOG_PATH, logs)
-        return "<div style='color:#b00'>No .tex found in last pipeline zip</div>"
+        return "<div style='color:#b00'>No .tex found in last pipeline zip</div>", None
 
     # Ensure local fonts and theme precedence (same as other debug path)
     try:
@@ -1585,7 +1587,8 @@ def debug_compile_last_pipeline_zip():
             "<div style='color:#b00'><b>Compile failed.</b></div>"
             + "<pre style='white-space:pre-wrap;background:#f7f7f8;padding:8px;border-radius:6px'>"
             + "\n".join(logs)
-            + "</pre>"
+            + "</pre>",
+            None,
         )
     try:
         b64 = base64.b64encode(pdf_path.read_bytes()).decode("utf-8")
@@ -1595,17 +1598,17 @@ def debug_compile_last_pipeline_zip():
             + _pdf_to_iframe_html(pdf_path, height="700px")
         )
         _write_logs(LOG_PATH, logs)
-        return html
+        return html, str(pdf_path)
     except Exception as e:
         logs.append(f"⚠️ preview failed: {e}")
         _write_logs(LOG_PATH, logs)
-        return f"<div>Compiled but preview failed: {e}</div>"
+        return f"<div>Compiled but preview failed: {e}</div>", None
 
 def debug_compile_uploaded_zip(zip_file):
-    """Compile an uploaded poster zip (user-provided) and preview PDF."""
+    """Compile an uploaded poster zip (user-provided); return preview HTML + PDF path."""
     logs = [f"🐞 Debug(upload) at {_now_str()}"]
     if not zip_file:
-        return "<div style='color:#b00'>Please upload a .zip file first.</div>"
+        return "<div style='color:#b00'>Please upload a .zip file first.</div>", None
     # Prepare workspace
     run_id, WORK_DIR, LOG_PATH, _ = _prepare_workspace(logs)
     work_zip_dir = WORK_DIR / "zip_upload"
@@ -1617,7 +1620,7 @@ def debug_compile_uploaded_zip(zip_file):
     except Exception as e:
         logs.append(f"❌ save upload failed: {e}")
         _write_logs(LOG_PATH, logs)
-        return "<div style='color:#b00'>Save upload failed.</div>"
+        return "<div style='color:#b00'>Save upload failed.</div>", None
     # Extract
     try:
         import zipfile as _zf
@@ -1626,7 +1629,7 @@ def debug_compile_uploaded_zip(zip_file):
     except Exception as e:
         logs.append(f"❌ unzip failed: {e}")
         _write_logs(LOG_PATH, logs)
-        return "<div style='color:#b00'>Unzip failed.</div>"
+        return "<div style='color:#b00'>Unzip failed.</div>", None
     # Find tex
     tex_path = None
     for name in ("poster_output.tex", "poster.tex"):
@@ -1670,7 +1673,8 @@ def debug_compile_uploaded_zip(zip_file):
             "<div style='color:#b00'><b>Compile failed.</b></div>"
             + "<pre style='white-space:pre-wrap;background:#f7f7f8;padding:8px;border-radius:6px'>"
             + "\n".join(logs)
-            + "</pre>"
+            + "</pre>",
+            None,
         )
     try:
         b64 = base64.b64encode(pdf_path.read_bytes()).decode("utf-8")