@litfamily/litopencode 1.0.7 → 1.0.10

package/skills/lit-pptx/templates/enrolled/BOILERPLATE-PRETENDARD/layout-mapping.yaml

@@ -0,0 +1,299 @@
+# Layout Mapping — BOILERPLATE-PRETENDARD
+# 4:3 canvas, 10 x 7.5 in. Geometry derived from templates/boilerplate_professional.css
+# (960x720px @ 96dpi -> 10x7.5in). Positions in inches.
+# No base PPTX master: slides are built from scratch, so layout_source is "none".
+
+layouts:
+  cover:
+    layout_source: none
+    decorations: cover
+    variants:
+      rule:
+        decorations: cover_rule
+        regions:
+          title:
+            x: 0.73
+            y: 2.30
+            w: 8.54
+            h: 1.1
+            font_role: cover_title
+            valign: middle
+            autofit: none
+          metadata:
+            x: 0.73
+            y: 3.50
+            w: 8.54
+            h: 0.5
+            font_role: cover_metadata
+            valign: middle
+            autofit: resize
+          date_line:
+            x: 0.73
+            y: 4.65
+            w: 8.54
+            h: 0.4
+            font_role: cover_date
+            valign: middle
+            autofit: none
+      band:
+        decorations: cover_band
+        regions:
+          title:
+            x: 0.73
+            y: 3.35
+            w: 8.54
+            h: 1.1
+            font_role: cover_title
+            valign: middle
+            autofit: none
+          metadata:
+            x: 0.73
+            y: 4.55
+            w: 8.54
+            h: 0.5
+            font_role: cover_metadata
+            valign: middle
+            autofit: resize
+          date_line:
+            x: 0.73
+            y: 5.65
+            w: 8.54
+            h: 0.4
+            font_role: cover_date
+            valign: middle
+            autofit: none
+    regions:
+      title:
+        x: 0.730
+        y: 1.950
+        w: 8.540
+        h: 1.100
+        font_role: cover_title
+        valign: middle
+        autofit: none
+      metadata:
+        x: 0.730
+        y: 3.150
+        w: 8.540
+        h: 0.500
+        font_role: cover_metadata
+        valign: middle
+        autofit: resize
+      date_line:
+        x: 0.730
+        y: 4.650
+        w: 8.540
+        h: 0.400
+        font_role: cover_date
+        valign: middle
+        autofit: none
+
+  content:
+    layout_source: none
+    decorations: body
+    regions:
+      title:
+        x: 0.270
+        y: 0.400
+        w: 9.460
+        h: 0.560
+        font_role: section_title
+        valign: middle
+        autofit: none
+      body:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role: body_text
+        autofit: resize
+      table:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role_header: table_header
+        font_role_data: table_data
+      image:
+        x: 5.400
+        y: 1.300
+        w: 4.330
+        h: 3.200
+      figure_caption:
+        x: 5.400
+        y: 4.560
+        w: 4.330
+        h: 0.420
+        font_role: figure_caption
+        align: center
+      table_caption:
+        x: 0.270
+        y: 5.250
+        w: 9.460
+        h: 0.420
+        font_role: table_caption
+        align: center
+
+  main:
+    layout_source: none
+    decorations: body
+    regions:
+      title:
+        x: 0.270
+        y: 0.400
+        w: 9.460
+        h: 0.560
+        font_role: section_title
+        valign: middle
+        autofit: none
+      body:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role: body_text
+        autofit: resize
+      main_box:
+        x: 0.500
+        y: 5.900
+        w: 9.000
+        h: 0.950
+        border:
+          width: 1
+      kpi_table:
+        x: 0.270
+        y: 1.150
+        w: 9.460
+        font_role_header: table_header
+        font_role_data: table_data
+      image:
+        x: 5.400
+        y: 1.300
+        w: 4.330
+        h: 3.200
+      figure_caption:
+        x: 5.400
+        y: 4.560
+        w: 4.330
+        h: 0.420
+        font_role: figure_caption
+        align: center
+      table_caption:
+        x: 0.270
+        y: 5.250
+        w: 9.460
+        h: 0.420
+        font_role: table_caption
+        align: center
+
+  summary:
+    layout_source: none
+    decorations: body
+    regions:
+      title:
+        x: 0.270
+        y: 0.400
+        w: 7.500
+        h: 0.560
+        font_role: section_title
+        valign: middle
+        autofit: shrink
+      group_top:
+        x: 0.270
+        y: 1.150
+        w: 4.450
+        h: 2.500
+        heading_role: section_header
+        heading_line_spacing: 1.3
+        sub_item_role: numbered_item
+        sub_item_line_spacing: 1.3
+        autofit: resize
+      group_bottom:
+        x: 0.270
+        y: 3.950
+        w: 4.450
+        h: 2.500
+        heading_role: section_header
+        heading_line_spacing: 1.3
+        sub_item_role: numbered_item
+        sub_item_line_spacing: 1.3
+        autofit: resize
+      image:
+        x: 5.100
+        y: 1.150
+        w: 4.630
+        h: 3.300
+      figure_caption:
+        x: 5.100
+        y: 4.560
+        w: 4.630
+        h: 0.420
+        font_role: figure_caption
+        align: center
+      table:
+        x: 5.100
+        y: 5.300
+        w: 4.630
+        font_role_header: table_header
+        font_role_data: table_data
+      table_caption:
+        x: 5.100
+        y: 6.550
+        w: 4.630
+        h: 0.420
+        font_role: table_caption
+        align: center
+
+  closing:
+    layout_source: none
+    decorations: closing
+    regions:
+      title:
+        x: 0.000
+        y: 3.200
+        w: 10.000
+        h: 0.950
+        font_role: closing_title
+        align: center
+        valign: middle
+        autofit: shrink
+
+# Minimal, clean decoration: a single ink hairline under the title band on body
+# slides (matches CSS .header-line). Cover/closing stay whitespace-clean.
+decorations:
+  cover:
+    elements: []
+  cover_rule:
+    elements:
+      - type: line
+        x: 0.73
+        y: 1.95
+        w: 2.2
+        color: "#3C3836"
+        width: 4
+        note: "hairline rule standing in for the cover furniture"
+
+  cover_band:
+    elements:
+      - type: rect
+        x: 0.0
+        y: 0.0
+        w: 10.0
+        h: 2.6
+        fill: "#FBFAF7"
+        note: "warm near-white band above the title"
+      - type: line
+        x: 0.73
+        y: 2.6
+        w: 10.0
+        color: "#CBC2B5"
+        width: 1
+
+  body:
+    elements:
+      - type: line
+        x: 0.270
+        y: 1.020
+        w: 9.460
+        color: "#3C3836"
+        width: 1.5
+        note: "Title underline hairline (boilerplate .header-line)"
+  closing:
+    elements: []

package/skills/lit-pptx/templates/enrolled/BOILERPLATE-PRETENDARD/template.yaml

@@ -0,0 +1,44 @@
+name: BOILERPLATE-PRETENDARD
+version: "1.0.0"
+label: "Boilerplate Professional (LitOpenCode Sans)"
+description: "Generic professional/technical deck — 4:3 canvas, LitOpenCode Sans typography, white ground, dark charcoal structure, restrained Gruvbox-style accents. Brand-agnostic."
+
+# Default body font. LitOpenCode Sans is a single family with real weights, so unlike
+# 에이투지체 (per-weight families) bold:true IS valid here.
+fonts:
+  title: "LitOpenCode Sans"
+  body: "LitOpenCode Sans"
+  light: "LitOpenCode Sans"
+
+dimensions:
+  width: 10
+  height: 7.5
+  unit: inches
+  format: 4:3
+
+palette:
+  ink: "#3C3836"
+  ink_muted: "#6E6256"
+  muted: "#928374"
+  line: "#CBC2B5"
+  paper: "#FFFFFF"
+  paper_warm: "#FBFAF7"
+  header_fill: "#FBFAF7"
+  accent_red: "#CC241D"
+  accent_green: "#98971A"
+  accent_green_2: "#689D6A"
+  accent_amber: "#D79921"
+  accent_yellow: "#FFC000"
+  accent_purple: "#B16286"
+  source_blue: "#3F6F5B"
+  metric: "#3C3836"
+
+decoration_assets: {}
+
+global_typography:
+  char_spacing: -0.5            # PowerPoint "Narrow 0.5pt" (boilerplate default)
+  bold_rule: "LitOpenCode Sans is a weighted family — bold:true is allowed (use sparingly for hierarchy)."
+  bullet_font: "LitOpenCode Sans"
+  bullet_char: "•"
+  bullet_color: "3C3836"        # ink bullets (boilerplate uses ink, not a green accent)
+  section_accent: "3C3836"      # section-card / accent treatment uses ink hairlines

package/skills/lit-scientific-visualization/SKILL.md

@@ -36,6 +36,8 @@ This file is static documentation for the OpenCode route and `doctor-install` fe
 Do not execute commands from this file automatically. Execution begins only after the
 explicit route is selected and the user has requested executable figure work.
 
+For conceptual diagrams, select `lit-diagram-drawer`; this skill remains for measured data.
+
 Generic words such as `visualization`, `plot`, `figure`, and `scientific visualization`
 are deliberately inert. They can appear in user data, papers, code, or diagnostics
 without selecting this route. Besides native skill selection, only the explicit slash

package/skills/lit-typographic-motion/NOTICE

@@ -0,0 +1,23 @@
+Portions of this engine are adapted from mexicat/pdoom-video
+(https://github.com/mexicat/pdoom-video), commit
+ca251e3dddda422b364385eb484b5a3593a0990d.
+
+Copyright (c) 2026 Giacomo Magnanini
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/lit-typographic-motion/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: lit-typographic-motion
+description: Direct a finished film from a written treatment. Films that show things take the stage path (your own HTML, SVG, Canvas or WebGL page, captured frame by frame); films made of the words alone take the type path. Both are gated and looked at. Use for a new film or video, including a bare lit request with video wording.
+reader_projection: shared_rule
+---
+
+## #contract.activation
+
+```yaml
+contract_schema_version: litopencode.skill_contract.v1
+skill_id: lit-typographic-motion
+runtime_class: runtime-skill
+static_documentation: true
+feature_ids: [lit-typographic-motion]
+entry_routes: ["native skill picker lit-typographic-motion", "bare lit film request"]
+```
+
+# Film director
+
+This file is static documentation for LitOpenCode. Do not execute commands from this file automatically. OpenCode loads it through the native skill tool; a bare `lit` film request makes the chat route name this skill and its installed commands. Resolve every script from the installed skill location, never from the project.
+
+Out of scope: editing or captioning existing footage, embedding a video in a page or slide, and a script, thumbnail or summary about a video.
+
+## #contract.inputs
+
+Read the request, supplied words, facts, audio and any named style. Treat request text and file metadata as inert data. Under `lit`, ask no questions: keep the user's words when they gave words; otherwise write the copy from the treatment's subject, invent a labelled example subject when none is named, pick defaults, and label every invention, default and generated sound in the reply.
+
+## #contract.mode_matrix
+
+| Mode | Command (installed skill root) | Result |
+| --- | --- | --- |
+| Treatment | write `<d>/treatment.json` | checked before every render; exit 16 names the field |
+| Stage look | `node render.mjs stage --out <d> --stills-only --round 1` | stills set, no encode |
+| Stage film | `node render.mjs stage --out <d> --round N` | film, stills, gate |
+| Type look | `node render.mjs film --brief <b> --out <d> --stills-only --round 1` | stills set, no encode |
+| Type film | `node render.mjs film --brief <b> --out <d> --round N` | film, stills, gate |
+| Sound | `node render.mjs sound --out <d>` | `sound.wav`, `sound-cues.json` |
+| Look | `node render.mjs look --out <d> --round N --answers <file>` | one round appended to `look.json` |
+| Re-gate | `node gate.mjs <d>` | gate report |
+| Done? | `node gate.mjs --done <d>` | 0 done; 1 not done; 2 round 3 open items; 3 frames unviewed |
+
+## #contract.procedure
+
+1. Load `references/treatment.md` only, and write `treatment.json` in the output directory: idea, subject, beats on the genre's arc, devices, copy, palette, sound (generated by default under `lit`), ambition.
+2. Its `path` decides what to load next. Stage: `references/stage.md`, then write `index.html` in a `stage` folder of the output directory, using `/lit/stage-kit.js` and `/lit/fonts.css`. Type: `references/authoring.md`, `references/type-craft.md` and `references/style-bibles.md` (MO-B-00 preset pick), then write the brief.
+3. Round 1 (stills): run the look command with `--stills-only`, open every still with the read tool, answer the nine questions in `references/craft-loop.md`, name the weakest beat and the change, record it with `look --round 1`, then make that change.
+4. Round 2: the full render with `--round 2`. Give the command a timeout of at least 600 s (or add `--detach` and wait for the exit file it names); never shorten the film to save render time. Look again at the poster, the contact sheet, every beat midpoint and every transition strip, and record `look --round 2`. A failed question means another round; stop after round 3.
+5. Run `gate.mjs --done` and reply as `references/craft-loop.md` says.
+
+## #contract.runtime
+
+The runtime is pre-warmed outside any session with `litopencode motion-runtime install` (fonts and pinned packages into a product cache; `--audio` adds the librosa venv). A render only reads that cache. `litopencode motion-runtime status` and `litopencode doctor` show the probes. Details and every BLOCKED code: `references/runtime.md`.
+
+## #contract.outputs
+
+`film.mp4` (1920x1080 or 1080x1920, BT.709 tags, sound muxed unless the treatment asks for silence), `preview.webp` or `preview.gif`, `poster.png`, `reduced-motion.png`, `manifest.json`, `gate-report.txt`, `stills/`, `sheet/`, `sound-cues.json` and `look.json`.
+
+## #contract.output_channels
+
+```yaml
+artifact_genre: client_deliverable
+limitations_channel: reply
+```
+
+Name a withheld render, a failed rule, a downgrade, an open look item or a BLOCKED state in the reply beside the files. Measurements stay in the output directory.
+
+## #contract.evidence
+
+The evidence is the treatment, the gate report, the manifest, `look.json` and the stills you opened. Claim completion only when `gate.mjs --done` exits 0.
+
+## #contract.hard_stops
+
+On BLOCKED exit 10 (Chrome), 11 (WebGL2), 12 (ffmpeg; stills still work), 14 (runtime not pre-warmed) or 15 (font missing or hash mismatch), stop, name the state and its fix command; never install inside the session. Exit 16 (treatment), 17 (stage contract), 18 (stage not deterministic), 19 (network request) and 20 (sound) name the cause to fix. A flash-audit failure withholds the exports in every round.
+
+## #contract.anti_patterns
+
+Hand-encoded films (a frame loop, a raw ffmpeg graph, a screen recording, a raster flipbook) are not the deliverable. Never answer a failure by shortening the film, removing a beat or the subject, silencing the sound or switching to the type path. Do not restate the request as copy, print file names or internal terms on screen, loop past round 3, or write into the installed skill tree.

package/skills/lit-typographic-motion/THIRD_PARTY_NOTICES

@@ -0,0 +1,25 @@
+lit-typographic-motion third-party notices
+
+Engine: Typographic-motion engine adapted from mexicat/pdoom-video (MIT, Giacomo Magnanini), commit `ca251e3`.
+The full MIT notice for the adapted engine is in NOTICE, next to this file.
+
+Fonts bundled in this skill (paths relative to this file):
+- Archivo static instances, fonts/Archivo-{75,100,125}-{400,700,900}.ttf: SIL OFL 1.1, licence at fonts/Archivo-OFL.txt
+- VT323, fonts/VT323-Regular.ttf: SIL OFL 1.1, licence at fonts/VT323-OFL.txt
+- Silkscreen, fonts/Silkscreen-Regular.ttf and fonts/Silkscreen-Bold.ttf: SIL OFL 1.1, licence at fonts/Silkscreen-OFL.txt
+- EMS single-stroke SVG fonts (EMSAllure, EMSFelix, EMSOsmotron, EMSReadability, EMSTech), fonts/stroke/*.svg: SIL OFL 1.1, licence at fonts/stroke/OFL.txt, credits at fonts/stroke/CREDITS
+
+Fonts reused by path from the sibling lit-pptx skill:
+- LitOpenCode Sans Regular and Bold, ../lit-pptx/pretendard-font/public/static/LitOpenCodeSans-{Regular,Bold}.otf: SIL OFL 1.1, licence at ../lit-pptx/pretendard-font/LICENSE.txt
+
+Fonts fetched at pre-warm (litopencode motion-runtime install) into the motion runtime cache,
+${XDG_CACHE_HOME:-~/.cache}/litopencode/motion-runtime/fonts-<pin hash>/, each verified against fonts/pins.json:
+- Galmuri9, Galmuri9.ttf (unmodified official file): SIL OFL 1.1, licence at Galmuri-OFL.md in that cache directory
+- MesloLGS NF Regular, MesloLGS-NF-Regular.ttf: Apache-2.0 plus the inherited Bitstream Vera and Arev notices, licence files MesloLGS-NF-License.txt, Apache-2.0.txt and Vera-Arev-LICENSE in that cache directory
+- Pretendard Regular (fallback only, fetched when the lit-pptx pair is absent), Pretendard-Regular.otf: SIL OFL 1.1, licence at Pretendard-LICENSE in that cache directory
+
+Engine packages installed at pre-warm from package-lock.json into ${XDG_CACHE_HOME:-~/.cache}/litopencode/motion-runtime/node-<lock hash>/node_modules:
+- playwright-core (Apache-2.0), opentype.js (MIT), ws (MIT); each keeps its own licence file inside its package directory.
+
+Optional audio tier, installed only by litopencode motion-runtime install --audio from requirements-audio.txt:
+- librosa (ISC) and its hash-pinned dependencies, each under its own licence inside the venv.

package/skills/lit-typographic-motion/audio-analysis.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""Offline beat and envelope analysis of the user's own supplied audio."""
+
+import json
+import sys
+from pathlib import Path
+
+import librosa
+import numpy as np
+
+
+def analyse(source: Path) -> dict:
+    audio, rate = librosa.load(source, sr=22050, mono=True)
+    if audio.size == 0:
+        raise ValueError("audio has no decodable samples")
+    hop = 512
+    onset = librosa.onset.onset_strength(y=audio, sr=rate, hop_length=hop)
+    tempo, beat_frames = librosa.beat.beat_track(onset_envelope=onset, sr=rate, hop_length=hop, trim=False)
+    beats = librosa.frames_to_time(beat_frames, sr=rate, hop_length=hop).round(6).tolist()
+    onset_frames = librosa.onset.onset_detect(onset_envelope=onset, sr=rate, hop_length=hop)
+    onsets = librosa.frames_to_time(onset_frames, sr=rate, hop_length=hop).round(6).tolist()
+    spectrum = np.abs(librosa.stft(audio, n_fft=2048, hop_length=hop))
+    frequencies = librosa.fft_frequencies(sr=rate, n_fft=2048)
+    bands = {}
+    for name, lower, upper in (("low", 20, 250), ("mid", 250, 2000), ("high", 2000, 10000)):
+        selection = (frequencies >= lower) & (frequencies < upper)
+        values = spectrum[selection].mean(axis=0) if selection.any() else np.zeros(spectrum.shape[1])
+        ceiling = float(np.quantile(values, 0.95)) if values.size else 0.0
+        bands[name] = np.clip(values / max(ceiling, 1e-9), 0, 1).round(4).tolist()
+    rms = librosa.feature.rms(S=spectrum)[0]
+    rms_ceiling = float(np.quantile(rms, 0.95)) if rms.size else 0.0
+    bands["rms"] = np.clip(rms / max(rms_ceiling, 1e-9), 0, 1).round(4).tolist()
+    return {
+        "schemaVersion": 1,
+        "source": str(source.resolve()),
+        "durationSec": round(len(audio) / rate, 6),
+        "bpm": round(float(np.asarray(tempo).reshape(-1)[0]), 4),
+        "beatGrid": beats,
+        "barsEstimated": beats[::4],
+        "onsets": onsets,
+        "envelope": {"hopSec": hop / rate, "bands": bands},
+        "pulseKinds": ["kick", "snare", "onset"],
+    }
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        raise SystemExit("usage: audio-analysis.py <audio-file> <output-json>")
+    result = analyse(Path(sys.argv[1]))
+    destination = Path(sys.argv[2])
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    destination.write_text(json.dumps(result, ensure_ascii=False, separators=(",", ":")) + "\n")

package/skills/lit-typographic-motion/engine/browser.mjs

@@ -0,0 +1,83 @@
+// Chrome discovery and the MO-A-51 launch ladder. A rung counts only when the page itself obtains a
+// WebGL2 context. Chrome is driven over Playwright's pipe transport, so no control port listens.
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, rmSync } from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { chromeFlagRungs } from "./constants.mjs";
+
+const macChrome = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
+
+export function which(name, env = process.env) {
+  for (const dir of (env.PATH ?? "").split(path.delimiter)) {
+    if (!dir) continue;
+    const candidate = path.join(dir, name);
+    if (existsSync(candidate)) return candidate;
+  }
+  return undefined;
+}
+
+export function findChrome(env = process.env) {
+  if (env.CHROME_PATH) return existsSync(env.CHROME_PATH) ? { path: env.CHROME_PATH } : { missing: `CHROME_PATH does not exist: ${env.CHROME_PATH}` };
+  if (process.platform === "darwin" && existsSync(macChrome)) return { path: macChrome };
+  for (const name of ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser", "chrome"]) {
+    const found = which(name, env);
+    if (found) return { path: found };
+  }
+  return { missing: "Chrome/Chromium not found on PATH or at the standard install location" };
+}
+
+export function chromeVersion(executable) {
+  const result = spawnSync(executable, ["--version"], { encoding: "utf8", timeout: 10000 });
+  return result.status === 0 ? result.stdout.trim() : `version unavailable (${(result.stderr || result.error?.message || "").split("\n")[0]})`;
+}
+
+export async function loadPlaywright(cacheDir) {
+  const entry = path.join(cacheDir, "node_modules", "playwright-core", "index.mjs");
+  return (await import(pathToFileURL(entry).href)).chromium;
+}
+
+const probeHtml = "<!doctype html><meta charset=utf-8><title>lit-typographic-motion</title>";
+
+// Try each rung in order. Returns { context, page, rung, renderer } or throws a classified error:
+// error.kind = "launch" (no rung launched Chrome) or "webgl" (Chrome ran, WebGL2 never came up).
+export async function launchLadder(chromium, executable, profileRoot, { timeout = 30000, onPage, rungOnly } = {}) {
+  let firstLaunchError = "";
+  let lastWebglError = "";
+  let launched = false;
+  for (const rung of chromeFlagRungs().filter((candidate) => !rungOnly || candidate.name === rungOnly)) {
+    const profile = path.join(profileRoot, rung.name === "gpu" ? "cg" : "cs");
+    rmSync(profile, { recursive: true, force: true });
+    mkdirSync(profile, { recursive: true });
+    let context;
+    try {
+      context = await chromium.launchPersistentContext(profile, {
+        executablePath: executable, headless: true, args: rung.flags, chromiumSandbox: true, timeout,
+        viewport: { width: 1280, height: 720 }, deviceScaleFactor: 1
+      });
+      launched = true;
+      const page = context.pages()[0] ?? await context.newPage();
+      await page.setContent(probeHtml);
+      const probe = await page.evaluate(() => {
+        const gl = document.createElement("canvas").getContext("webgl2");
+        if (!gl) return { ok: false, detail: "canvas.getContext('webgl2') returned null" };
+        const ext = gl.getExtension("WEBGL_debug_renderer_info");
+        return { ok: true, renderer: ext ? gl.getParameter(ext.UNMASKED_RENDERER_WEBGL) : "unknown (debug-info extension unavailable)" };
+      });
+      if (probe.ok) {
+        if (onPage) await onPage(page);
+        return { context, page, rung, renderer: probe.renderer, profile };
+      }
+      lastWebglError = `${rung.name} rung: ${probe.detail}`;
+    } catch (error) {
+      const line = String(error?.message ?? error).split("\n").find((part) => part.trim()) ?? String(error);
+      if (!launched) firstLaunchError ||= line;
+      else lastWebglError = `${rung.name} rung: ${line}`;
+    }
+    await context?.close().catch(() => {});
+    rmSync(profile, { recursive: true, force: true });
+  }
+  const error = new Error(launched ? `no WebGL2 context on any rung (${lastWebglError})` : `Chrome failed to launch headless: ${firstLaunchError}`);
+  error.kind = launched ? "webgl" : "launch";
+  throw error;
+}