add health check

demo/app.py

@@ -1,12 +1,23 @@
+from __future__ import annotations
+
 import os
 
 import gradio as gr
 
+import health
+from layout import CELL_CSS, wrap_cell
+
+
+def render_health_panel() -> str:
+    return wrap_cell(health.render_health_notice())
+
 
 def create_app() -> gr.Blocks:
-    """Return a blank Gradio interface for placeholder purposes."""
+    """Create the Gradio application with a minimal notebook-like health cell."""
     with gr.Blocks(title="Aileen3 Demo") as demo:
-        gr.HTML("")
+        gr.HTML(f"<style>{CELL_CSS}</style>")
+        health_panel = gr.HTML(value=wrap_cell(health.render_placeholder_notice()))
+        demo.load(fn=render_health_panel, outputs=health_panel, queue=False)
     return demo
 
 

demo/health.py

@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+import html
+import importlib.util
+import re
+import shutil
+import subprocess
+from dataclasses import dataclass
+from itertools import zip_longest
+from typing import Iterable
+
+
+MIN_DENO_VERSION = (2, 0, 0)
+MIN_YTDLP_VERSION = (2025, 11, 12)
+
+
+@dataclass
+class ToolStatus:
+    label: str
+    ok: bool
+    detail: str
+
+
+@dataclass
+class HealthReport:
+    ok: bool
+    summary: str
+    tools: list[ToolStatus]
+
+
+def _split_version(raw: str) -> Iterable[int]:
+    return tuple(int(part) for part in re.findall(r"\d+", raw))
+
+
+def _version_at_least(raw: str, expected: tuple[int, ...]) -> bool:
+    parsed = _split_version(raw)
+    if not parsed:
+        return False
+    for current, required in zip_longest(parsed, expected, fillvalue=0):
+        if current > required:
+            return True
+        if current < required:
+            return False
+    return True
+
+
+def _check_deno() -> ToolStatus:
+    label = "🦕 Deno"
+    binary = shutil.which("deno")
+    if not binary:
+        return ToolStatus(label, False, "`deno` command not found on PATH")
+    try:
+        completed = subprocess.run(
+            [binary, "--version"],
+            check=False,
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+    except (FileNotFoundError, subprocess.SubprocessError, OSError) as exc:
+        return ToolStatus(label, False, f"Unable to execute: {exc}")
+    if completed.returncode != 0:
+        detail = completed.stderr.strip() or completed.stdout.strip() or "Unknown error"
+        return ToolStatus(label, False, detail)
+    match = re.search(r"deno\s+([0-9.]+)", completed.stdout)
+    if not match:
+        return ToolStatus(label, False, "Could not parse version output")
+    version = match.group(1)
+    if not _version_at_least(version, MIN_DENO_VERSION):
+        return ToolStatus(label, False, f"Found v{version}; need ≥ {'.'.join(map(str, MIN_DENO_VERSION))}")
+    return ToolStatus(label, True, f"v{version} ready for yt-dlp")
+
+
+def _check_yt_dlp_python() -> ToolStatus:
+    label = "📼 yt-dlp Python"
+    try:
+        import yt_dlp
+        from yt_dlp import YoutubeDL
+        from yt_dlp.version import __version__ as version_str
+    except Exception as exc:
+        return ToolStatus(label, False, f"Import failed: {exc}")
+
+    try:
+        with YoutubeDL(params={"skip_download": True, "quiet": True}) as ydl:
+            _ = ydl.params.get("skip_download")
+    except Exception as exc:
+        return ToolStatus(label, False, f"YoutubeDL bootstrap failed: {exc}")
+
+    if not _version_at_least(version_str, MIN_YTDLP_VERSION):
+        minimum = ".".join(map(str, MIN_YTDLP_VERSION))
+        return ToolStatus(label, False, f"Detected {version_str}; require ≥ {minimum}")
+
+    has_ejs = importlib.util.find_spec("yt_dlp_ejs") is not None
+    addon_note = "yt_dlp_ejs ready" if has_ejs else "yt_dlp_ejs missing (JS sites will fail)"
+    return ToolStatus(label, has_ejs, f"v{version_str} import OK — {addon_note}")
+
+
+def run_health_report() -> HealthReport:
+    tool_statuses = [_check_deno(), _check_yt_dlp_python()]
+    ok = all(status.ok for status in tool_statuses)
+    if ok:
+        summary = "All systems look good—ready for notebook-style experimentation."
+    else:
+        blocking = ", ".join(status.label for status in tool_statuses if not status.ok)
+        summary = f"Needs attention: {blocking}."
+    return HealthReport(ok=ok, summary=summary, tools=tool_statuses)
+
+
+def _sanitize(text: str) -> str:
+    return html.escape(text, quote=False)
+
+
+def render_health_notice() -> str:
+    report = run_health_report()
+    if report.ok:
+        bg = "#dcfce7"
+        border = "#86efac"
+        text_color = "#14532d"
+        icon = "✅"
+    else:
+        bg = "#fee2e2"
+        border = "#fecaca"
+        text_color = "#7f1d1d"
+        icon = "🧯"
+    bullet_rows = "".join(
+        f"<li>{_sanitize(status.label)}: "
+        f"<strong>{'Ready' if status.ok else 'Needs attention'}</strong> — "
+        f"{_sanitize(status.detail)}</li>"
+        for status in report.tools
+    )
+    return (
+        f"<div class='health-box' style='background:{bg};border-color:{border};color:{text_color};'>"
+        f"<div class='health-head'>{icon} {_sanitize(report.summary)}</div>"
+        f"<ul>{bullet_rows}</ul>"
+        "</div>"
+    )
+
+
+def render_placeholder_notice() -> str:
+    return (
+        "<div class='health-box health-placeholder'>"
+        "<div class='health-head'>⏳ Running automated health check…</div>"
+        "<p>Step 0 runs implicitly to validate Deno and yt-dlp before any other cell.</p>"
+        "</div>"
+    )

demo/layout.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+CELL_CSS = """
+.cell-wrapper {
+    border: 1px solid rgba(0, 0, 0, 0.9);
+    border-radius: 14px;
+    padding: 10px;
+    margin-bottom: 10px;
+    background: transparent;
+}
+.cell-title {
+    font-size: 1.15rem;
+    font-weight: 600;
+    margin: 0 0 10px;
+}
+.health-box {
+    border-radius: 14px;
+    padding: 18px;
+    border: 1px solid transparent;
+}
+.health-box ul {
+    margin: 12px 0 0;
+    padding-left: 22px;
+}
+.health-box li {
+    margin-bottom: 6px;
+}
+.health-placeholder {
+    background: #f5f5f5 !important;
+    border-color: #d4d4d4 !important;
+    color: #1f2937 !important;
+}
+@media (prefers-color-scheme: dark) {
+    .cell-wrapper {
+        border-color: rgba(255, 255, 255, 0.45);
+    }
+    .health-placeholder {
+        background: rgba(148, 163, 184, 0.15) !important;
+        border-color: rgba(148, 163, 184, 0.4) !important;
+        color: #e2e8f0 !important;
+    }
+}
+"""
+
+
+def wrap_cell(body_html: str) -> str:
+    return (
+        "<section class='cell-wrapper'>"
+        "<div class='cell-title'>🧪 Health check</div>"
+        f"{body_html}"
+        "</section>"
+    )