playrig 0.0.0-stage → 0.1.0

package/editions/ae/panel/core.jsx

@@ -0,0 +1,1026 @@
+// Playrig (core): runs ExtendScript jobs dropped into <root>/inbox and writes results to <root>/out/<id>/.
+// ES3 only. Loaded by the stub (Playrig.jsx), which owns #targetengine "playrig" and passes in the panel and this folder.
+// The only network use is the updater (lib/updater.jsxinc): it runs curl for the update check and downloads. See README.md.
+
+(function (thisObj) {
+    var G = $.global;
+    var ID_RE = /^[A-Za-z0-9_\-]{1,64}$/;
+    var MAX_BYTES = 2 * 1024 * 1024;
+    var SETTINGS = "Playrig";
+    thisObj = G.__PLAYRIG_PANEL || thisObj;
+    var HERE = G.__PLAYRIG_HERE || new File($.fileName).parent.fsName;
+
+    // State survives panel reloads because of the persistent engine.
+    var VERSION = (function () { // from version.json beside this file (written by the payload builder)
+        var f = new File(HERE + "/version.json"), t, m;
+        try { if (f.exists) { f.encoding = "UTF-8"; f.open("r"); t = f.read(); f.close(); m = /"version"\s*:\s*"([^"]+)"/.exec(t); if (m) { return m[1]; } } } catch (e) { }
+        return "dev";
+    })();
+    var HISTORY_LIMIT = 50;
+    var S = G.__PLAYRIG_STATE;
+    if (!S) {
+        S = G.__PLAYRIG_STATE = { on: false, busy: false, taskId: null, watchId: null, session: [], ui: null, status: "Idle", seq: 0, loaded: false, projPath: null };
+    }
+    if (!S.session) { S.session = []; }
+    S.here = HERE;
+
+    // ------------------------------------------------------------ settings
+    // Settings saved under the panel's former names ("Playpilot", "AE Bridge") are still read, so an upgrade keeps its folder, lib path and options.
+    var LEGACY_SETTINGS = ["Playpilot", "AEBridge"];
+    function getSet(k, d) {
+        var i;
+        try { if (app.settings.haveSetting(SETTINGS, k)) { return app.settings.getSetting(SETTINGS, k); } } catch (e) { }
+        for (i = 0; i < LEGACY_SETTINGS.length; i++) {
+            try { if (app.settings.haveSetting(LEGACY_SETTINGS[i], k)) { return app.settings.getSetting(LEGACY_SETTINGS[i], k); } } catch (e2) { }
+        }
+        return d;
+    }
+    function setSet(k, v) { try { app.settings.saveSetting(SETTINGS, k, String(v)); } catch (e) { } }
+
+    function getRoot() {
+        var p = getSet("root", ""), docs, fresh, legacy;
+        if (p) { return new Folder(p); }
+        // Default <Documents>/Playrig/ae; an existing <Documents>/AE Bridge keeps being used until the new folder exists.
+        docs = Folder.myDocuments.fsName;
+        fresh = new Folder(docs + "/Playrig/ae");
+        legacy = new Folder(docs + "/AE Bridge");
+        return (!new Folder(fresh.fsName + "/inbox").exists && new Folder(legacy.fsName + "/inbox").exists) ? legacy : fresh;
+    }
+
+    function sub(name) { return new Folder(getRoot().fsName + "/" + name); }
+
+    function ensureDirs() {
+        var names = ["inbox", "running", "done", "out", "backups", "rejected"], i, f;
+        for (i = 0; i < names.length; i++) {
+            f = sub(names[i]);
+            if (!f.exists && !f.create()) {
+                throw new Error("Cannot create " + f.fsName + ". Enable Preferences > Scripting & Expressions > Allow Scripts to Write Files and Access Network.");
+            }
+        }
+    }
+
+    // ------------------------------------------------------------ files
+    function readText(f) {
+        var s;
+        f.encoding = "UTF-8";
+        if (!f.open("r")) { throw new Error("Cannot open " + f.fsName); }
+        s = f.read();
+        f.close();
+        return s;
+    }
+    function writeText(f, s) {
+        f.encoding = "UTF-8";
+        f.lineFeed = "Unix";
+        if (!f.open("w")) { throw new Error("Cannot write " + f.fsName); }
+        f.write(s);
+        f.close();
+    }
+    function writeAtomic(f, s) {
+        var tmp = new File(f.fsName + ".tmp");
+        writeText(tmp, s);
+        if (f.exists) { f.remove(); }
+        if (!tmp.rename(f.name)) { throw new Error("Cannot rename " + tmp.fsName); }
+    }
+    function moveFile(f, folder) {
+        var d = new File(folder.fsName + "/" + f.displayName);
+        if (d.exists) { d.remove(); }
+        if (!f.copy(d)) { throw new Error("Cannot move " + f.fsName + " to " + folder.fsName); }
+        f.remove();
+        return d;
+    }
+    function quote(s) {
+        return '"' + String(s).replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/[\r\n\t]/g, " ").replace(/[^\x20-\x7e]/g, "?") + '"';
+    }
+    function stamp() {
+        var d = new Date();
+        function p(n) { return (n < 10 ? "0" : "") + n; }
+        return d.getFullYear() + p(d.getMonth() + 1) + p(d.getDate()) + "-" + p(d.getHours()) + p(d.getMinutes()) + p(d.getSeconds());
+    }
+    function isoNow(d) {
+        var off = -d.getTimezoneOffset(), sign = off < 0 ? "-" : "+";
+        function p(n) { return (n < 10 ? "0" : "") + n; }
+        off = Math.abs(off);
+        return d.getFullYear() + "-" + p(d.getMonth() + 1) + "-" + p(d.getDate()) + "T" + p(d.getHours()) + ":" +
+            p(d.getMinutes()) + ":" + p(d.getSeconds()) + sign + p(Math.floor(off / 60)) + ":" + p(off % 60);
+    }
+
+    // Folders that may hold the lib files (bridge-api.jsxinc, panel-core.jsxinc, actions.json, dev.jsxinc, icons/).
+    function libDirs() {
+        var out = [getSet("lib", ""), HERE, HERE + "/Playrig lib", HERE + "/Playpilot lib", HERE + "/AE Bridge lib", HERE + "/lib", new Folder(HERE).parent.fsName + "/lib", getRoot().fsName + "/lib"], i, r = [], f;
+        for (i = 0; i < out.length; i++) {
+            if (!out[i]) { continue; }
+            f = new File(out[i]);
+            // the saved "lib" setting is the path of bridge-api.jsxinc; the others are folders
+            r.push(f instanceof File && /\.jsxinc$/i.test(out[i]) ? f.parent.fsName : out[i]);
+        }
+        return r;
+    }
+    function findLibFile(name) {
+        var d = libDirs(), i, f;
+        for (i = 0; i < d.length; i++) {
+            f = new File(d[i] + "/" + name);
+            if (f.exists) { return f; }
+        }
+        return null;
+    }
+    function findLib() { return findLibFile("bridge-api.jsxinc"); }
+
+    // Loads the UI-free core (actions, history reader) once. bridge-api is evaluated first: its JSON parser is used for results.
+    function ensureCore() {
+        var lib, core;
+        if (G.PlayrigCore && S.coreOk) { return true; }
+        lib = findLib();
+        if (!lib) { return false; }
+        try { if (!G.PLAYRIG) { $.evalFile(lib); } } catch (e) { return false; }
+        core = findLibFile("panel-core.jsxinc");
+        if (!core) { return false; }
+        try { $.evalFile(core); G.PlayrigCore.init(core.parent.fsName); S.coreOk = true; } catch (e2) { return false; }
+        try {
+            if (!G.PlayrigDev) { core = findLibFile("dev.jsxinc"); if (core) { $.evalFile(core); } }
+        } catch (e3) { }
+        try { core = findLibFile("updater.jsxinc"); if (core) { $.evalFile(core); } } catch (e4) { }
+        return true;
+    }
+
+    function iconFile(name) {
+        var f = findLibFile("icons/png/" + name + ".png");
+        return f;
+    }
+    var imgCache = {};
+    function icon(name) {
+        var f;
+        if (imgCache[name]) { return imgCache[name]; }
+        f = iconFile(name);
+        try { imgCache[name] = f ? ScriptUI.newImage(f) : null; } catch (e) { imgCache[name] = null; }
+        return imgCache[name];
+    }
+
+    // ------------------------------------------------------------ UI helpers
+    function ui(fn) {
+        // Panel widgets become invalid when the panel is closed; report that as false.
+        if (!S.ui) { return false; }
+        try { fn(S.ui); return true; } catch (e) { return false; }
+    }
+
+    function colorPen(g, rgb) { return g.newPen(g.PenType.SOLID_COLOR, rgb, 1); }
+
+    function setStatus(text) {
+        var dot;
+        S.status = text;
+        dot = /^Error/.test(text) ? "dot-error" : ((/^Stopped/.test(text) || !S.on) && !S.busy ? "dot-idle" : "dot-running");
+        ui(function (u) {
+            u.status.text = text;
+            if (icon(dot)) { u.dot.image = icon(dot); }
+        });
+    }
+
+    // One info line under the list. Info fades after 12 s; problems (sticky) stay until replaced.
+    function say(text, sticky) {
+        var n = (S.msgSeq = (S.msgSeq || 0) + 1);
+        S.msgSticky = !!sticky;
+        ui(function (u) { u.msg.text = text || ""; });
+        if (text && !sticky) { try { app.scheduleTask("Playrig.clearMsg(" + n + ")", 12000, false); } catch (e) { } }
+    }
+
+    function projectName() {
+        var f = null;
+        try { f = app.project.file; } catch (e) { }
+        return f ? f.displayName.replace(/\.aepx?$/i, "") : "Untitled project (not saved)";
+    }
+    function projectFile() { try { return app.project.file; } catch (e) { return null; } }
+
+    // Rows shown in the table: the open project's history from its log, plus this session's jobs of that project that are not in it yet
+    // (an unsaved project, a rejected job). Newest first.
+    function currentRows() {
+        var pf = projectFile(), h = { rows: [], total: 0 }, rows, seen = {}, i, s, path = pf ? pf.fsName : null;
+        if (!ensureCore()) { return { rows: [], total: 0, core: false }; }
+        if (pf) { try { h = G.PlayrigCore.loadHistory(pf, HISTORY_LIMIT); } catch (e) { h = { rows: [], total: 0 }; } }
+        rows = h.rows.slice(0);
+        for (i = 0; i < rows.length; i++) { seen[rows[i].id] = true; }
+        for (i = 0; i < S.session.length; i++) {
+            s = S.session[i];
+            if (!seen[s.id] && (s.projectPath || null) === path) { rows.push(s); seen[s.id] = true; }
+        }
+        rows.sort(function (a, b) { return a.startedAt < b.startedAt ? 1 : (a.startedAt > b.startedAt ? -1 : 0); });
+        return { rows: rows.slice(0, HISTORY_LIMIT), total: Math.max(h.total, rows.length), core: true, saved: !!pf };
+    }
+
+    function refreshHistory() {
+        var cur = currentRows();
+        S.rows = cur.rows;
+        ui(function (u) {
+            var i, r, item, h, n = cur.rows.length;
+            u.list.removeAll();
+            for (i = 0; i < n; i++) {
+                r = cur.rows[i];
+                // Row icons did not render in AE's multi-column listbox, so the status is a glyph plus the word.
+                item = u.list.add("item", G.PlayrigCore.statusGlyph(r.status) + " " + r.status);
+                item.subItems[0].text = G.PlayrigCore.actionLabel(r.action, r.actionLabel) + (r.actionSource === "inferred" ? " *" : "");
+                item.subItems[1].text = G.PlayrigCore.formatTime(r.startedAt);
+            }
+            u.count.text = n ? (cur.total > n ? "latest " + n + " of " + cur.total : n + (n === 1 ? " job" : " jobs")) : "";
+            // The list is only as tall as its rows (header + rows), never a blank block.
+            h = 44 + Math.max(1, Math.min(n, 12)) * 21;
+            u.list.preferredSize.height = h;
+            u.list.minimumSize.height = h;
+            u.summary.text = n ? "Select a job to see what it did. Double-click for details." : (cur.core ? "No jobs yet for this project." : "Panel files missing (lib folder not found). See README, Install.");
+            u.details.enabled = false;
+            u.win.layout.layout(true);
+        });
+        if (cur.core && !cur.saved) {
+            if (!S.unsavedMsg) { S.unsavedMsg = true; say("Save the project to keep its job history with it.", true); }
+        } else if (S.unsavedMsg) { S.unsavedMsg = false; say(""); }
+    }
+
+    function showProject() {
+        var pf = projectFile();
+        S.projPath = pf ? pf.fsName : null;
+        ui(function (u) { u.project.text = projectName(); });
+    }
+
+    function sessionPush(r, resultPath) {
+        S.session.unshift(G.PlayrigCore.rowFromResult(r, resultPath));
+        if (S.session.length > HISTORY_LIMIT) { S.session.length = HISTORY_LIMIT; }
+    }
+
+    function selectedRow() {
+        var out = null;
+        ui(function (u) { if (u.list.selection && S.rows) { out = S.rows[u.list.selection.index]; } });
+        return out;
+    }
+
+    // ------------------------------------------------------------ polling
+    function startPolling() {
+        if (S.on) { return; }
+        try { ensureDirs(); } catch (e) { setStatus("Error"); say("Playrig: " + e.message, true); return; }
+        if (!findLib()) {
+            var picked = File.openDialog("Locate bridge-api.jsxinc");
+            if (!picked) { setStatus("Error"); say("bridge-api.jsxinc not found. See README, Install.", true); return; }
+            setSet("lib", picked.fsName);
+        }
+        ensureCore();
+        S.on = true;
+        S.taskId = app.scheduleTask("Playrig.tick()", 1000, true);
+        setStatus("Idle");
+        ui(function (u) { u.power.image = icon("power-on"); u.power.helpTip = "Stop the bridge"; });
+    }
+
+    function stopPolling() {
+        if (S.taskId !== null) { try { app.cancelTask(S.taskId); } catch (e) { } }
+        S.taskId = null;
+        S.on = false;
+        setStatus(S.busy ? S.status : "Stopped");
+        ui(function (u) { u.power.image = icon("power-off"); u.power.helpTip = "Start the bridge"; });
+    }
+
+    // ------------------------------------------------------------ rejection
+    function simpleResult(id, status, message, extra) {
+        var f = new Folder(sub("out").fsName + "/" + id), p = projInfo(), file;
+        if (!f.exists) { f.create(); }
+        file = new File(f.fsName + "/result.json");
+        writeAtomic(file,
+            '{\n  "id": ' + quote(id) + ',\n  "status": ' + quote(status) + ',\n  "startedAt": ' + quote(isoNow(new Date())) +
+            ',\n  "project": {"path": ' + (p.path ? quote(p.path) : "null") + ', "dirty": ' + (p.dirty === null ? "null" : String(p.dirty)) + '}' +
+            ',\n  "action": ' + quote(status === "rejected" ? "job.rejected" : "custom") + ',\n  "actionSource": "declared"' +
+            ',\n  "error": {"message": ' + quote(message) + '}' + (extra || "") + ',\n  "log": [],\n  "snapshots": []\n}\n');
+        return file;
+    }
+
+    function reject(f, reason) {
+        var base = f.displayName.replace(/\.jsx$/i, ""), id, dest, rf;
+        if (ID_RE.test(base)) { id = base; }
+        else { S.seq++; id = "rejected-" + stamp() + "-" + S.seq; }
+        rf = simpleResult(id, "rejected", reason, ',\n  "originalName": ' + quote(f.displayName));
+        dest = sub("rejected");
+        try {
+            if (id !== base) { f.rename(id + ".jsx"); f = new File(f.parent.fsName + "/" + id + ".jsx"); }
+            moveFile(f, dest);
+        } catch (e) { try { f.remove(); } catch (e2) { } }
+        if (ensureCore()) {
+            sessionPush({ id: id, status: "rejected", startedAt: isoNow(new Date()), action: "job.rejected", actionSource: "declared", description: null,
+                error: { message: reason }, project: projInfo() }, rf.fsName);
+            refreshHistory();
+        }
+    }
+
+    // ------------------------------------------------------------ job pick
+    function pickJob() {
+        var files = sub("inbox").getFiles("*.jsx"), valid = [], i, f, base;
+        for (i = 0; i < files.length; i++) {
+            f = files[i];
+            if (!(f instanceof File)) { continue; }
+            base = f.displayName.replace(/\.jsx$/i, "");
+            if (!ID_RE.test(base)) { reject(f, "File name must match ^[A-Za-z0-9_-]{1,64}$"); continue; }
+            if (f.length > MAX_BYTES) { reject(f, "Job file is larger than 2 MB"); continue; }
+            valid.push(f);
+        }
+        if (!valid.length) { return null; }
+        valid.sort(function (a, b) { return a.modified.getTime() - b.modified.getTime(); });
+        return valid[0];
+    }
+
+    // ------------------------------------------------------------ run
+    function errInfo(e, file) {
+        var info = { message: e && e.message ? e.message : String(e), line: e && e.line ? Number(e.line) : null,
+            fileName: e && e.fileName ? String(e.fileName) : null, source: null }, lines;
+        if (file) { info.fileName = file.fsName; }
+        try {
+            if (file && info.line) {
+                lines = readText(file).split(/\r\n|\r|\n/);
+                info.source = lines[info.line - 1] !== undefined ? lines[info.line - 1] : null;
+            }
+        } catch (e2) { }
+        return info;
+    }
+
+    function projInfo() {
+        var p = { path: null, dirty: null };
+        try { if (app.project.file) { p.path = app.project.file.fsName; } } catch (e) { }
+        try { if (app.project.dirty !== undefined) { p.dirty = app.project.dirty; } } catch (e2) { }
+        return p;
+    }
+
+    // Copies the project file on disk. app.project.save(File) is "Save As" and would re-point the open project
+    // at the backup, so a plain file copy of the last-saved state is used instead.
+    function backupProject(id, result) {
+        var src = app.project.file, dest;
+        if (!src || !src.exists) { result.backup = { ok: false, reason: "project has never been saved" }; return; }
+        try {
+            dest = new File(sub("backups").fsName + "/" + src.displayName.replace(/\.aepx?$/i, "") + "-" + id + ".aep");
+            result.backup = { ok: src.copy(dest), file: dest.fsName, reflectsUnsavedChanges: false };
+        } catch (e) { result.backup = { ok: false, reason: e.message }; }
+    }
+
+    // ------------------------------------------------------------ project-folder sync
+    // Everything a job produces is mirrored into <project folder>/EDIT_LOGS/ (same folder name as Playrig for Premiere Pro; an older
+    // AE-BRIDGE/ folder is renamed to it on the first job) so the project can move to another machine and the next session can
+    // read what was done and which assets exist.
+    var WS_README = "# EDIT_LOGS\n\n" +
+        "Written automatically by Playrig for After Effects next to the .aep. Move this folder together with the project.\n\n" +
+        "- `JOURNAL.md`: chronological record of every job (newest last): what ran, status, errors, log, snapshots.\n" +
+        "- `jobs/<id>.jsx` (+ `<id>.json` options): the exact scripts that were run on this project.\n" +
+        "- `results/<id>/`: `result.json` and the PNG snapshots of each job.\n" +
+        "- `assets.ae.md` / `assets.ae.json`: footage, comps and fonts in the project as of the last job (paths relative to the project folder). " +
+        "(Named `.ae` so they do not overwrite Playrig for Premiere Pro's `assets.md` when both projects share a folder.)\n\n" +
+        "To continue on another system: open the .aep, read `JOURNAL.md` and `assets.ae.md`, re-link any footage marked MISSING, " +
+        "install the listed fonts, then submit new jobs with Playrig as usual. Re-running `jobs/*.jsx` in order rebuilds the scripted work.\n";
+
+    function projectDir() {
+        var f = null;
+        try { f = app.project.file; } catch (e) { }
+        return f ? f.parent : null;
+    }
+
+    function copyInto(src, folder) {
+        var d;
+        if (!folder.exists) { folder.create(); }
+        d = new File(folder.fsName + "/" + src.displayName);
+        if (d.exists) { d.remove(); }
+        return src.copy(d);
+    }
+
+    function appendText(f, s) {
+        f.encoding = "UTF-8";
+        f.lineFeed = "Unix";
+        if (!f.open("a")) { throw new Error("Cannot append to " + f.fsName); }
+        f.write(s);
+        f.close();
+    }
+
+    function assetsMarkdown(a) {
+        var s = "# Project assets\n\nGenerated " + a.generatedAt + " by Playrig. Paths are relative to the project folder unless marked external.\n\n", i, x;
+        s += "## Footage (" + a.footage.length + ")\n\n";
+        for (i = 0; i < a.footage.length; i++) {
+            x = a.footage[i];
+            s += "- " + x.name + (x.type === "solid" ? " (solid)" : "") + (x.file ? ": `" + x.file + "`" : "") +
+                (x.external ? " **EXTERNAL, will not move with the project**" : "") + (x.missing ? " **MISSING**" : "") + "\n";
+        }
+        s += "\n## Comps (" + a.comps.length + ")\n\n";
+        for (i = 0; i < a.comps.length; i++) {
+            x = a.comps[i];
+            s += "- " + x.name + ": " + x.width + "x" + x.height + ", " + x.fps + " fps, " + x.duration + " s, " + x.numLayers + " layers\n";
+        }
+        s += "\n## Fonts used by text layers\n\n";
+        for (i = 0; i < a.fonts.length; i++) { s += "- " + a.fonts[i] + "\n"; }
+        return s;
+    }
+
+    function journalEntry(result, jobFile) {
+        var s = "\n## " + result.id + " [" + result.status + "]\n\n" + (result.description ? "- what: " + result.description + "\n" : "") +
+            (result.action ? "- action: " + result.action + (result.actionSource === "inferred" ? " (inferred)" : "") + "\n" : "") + "- started: " + result.startedAt + " (" + result.durationMs + " ms), AE " + result.aeVersion + "\n", i, sn;
+        if (jobFile) { s += "- script: `jobs/" + jobFile + "`\n"; }
+        if (result.error) { s += "- error: " + result.error.message + (result.error.line ? " (line " + result.error.line + ")" : "") + "\n"; }
+        if (result.returnValue !== null && result.returnValue !== undefined) { s += "- return: `" + PLAYRIG.json.stringify(result.returnValue).substr(0, 500) + "`\n"; }
+        if (result.log && result.log.length) {
+            s += "- log:\n";
+            for (i = 0; i < result.log.length && i < 100; i++) { s += "    " + String(result.log[i]).replace(/[\r\n]+/g, " ") + "\n"; }
+        }
+        for (i = 0; result.snapshots && i < result.snapshots.length; i++) {
+            sn = result.snapshots[i];
+            if (sn.ok) { s += "- snapshot: `results/" + result.id + "/" + sn.file + "` (" + sn.comp + " @ " + sn.time + ")\n"; }
+        }
+        return s;
+    }
+
+    function syncOne(ws, id, runFile, optFile, outDir) {
+        var res = new Folder(ws.fsName + "/results/" + id), files, i, f;
+        if (runFile && runFile.exists) { copyInto(runFile, new Folder(ws.fsName + "/jobs")); }
+        if (optFile && optFile.exists) { copyInto(optFile, new Folder(ws.fsName + "/jobs")); }
+        if (!res.exists) { res.create(); }
+        files = outDir.getFiles();
+        for (i = 0; i < files.length; i++) {
+            f = files[i];
+            if (f instanceof File && !/\.tmp$/i.test(f.name)) { copyInto(f, res); }
+        }
+    }
+
+    // Returns {ok, dir} or {ok:false, reason}. Never throws: a sync problem must not fail the job.
+    function syncToProject(id, result, runFile, optFile, outDir) {
+        var dir = projectDir(), ws, readme, assets, i, pend, p, legacy, migrated;
+        if (!dir) {
+            S.unsynced = S.unsynced || [];
+            S.unsynced.push(id);
+            return { ok: false, reason: "project has never been saved, so it has no folder; will sync after the next job once it is saved" };
+        }
+        try {
+            ws = new Folder(dir.fsName + "/" + G.PlayrigCore.logFolder());
+            legacy = new Folder(dir.fsName + "/" + G.PlayrigCore.legacyLogFolder());
+            migrated = false;
+            if (!ws.exists && legacy.exists) {
+                // One-time migration of the old AE-BRIDGE/ log folder; if the rename is refused, keep using the old folder.
+                if (legacy.rename(ws.name)) { migrated = true; ws = new Folder(dir.fsName + "/" + G.PlayrigCore.logFolder()); }
+                else { ws = legacy; }
+            }
+            if (!ws.exists && !ws.create()) { return { ok: false, reason: "cannot create " + ws.fsName }; }
+            readme = new File(ws.fsName + "/README.md");
+            if (!readme.exists || migrated) { writeText(readme, WS_README); }
+
+            // Jobs that ran before the project was first saved.
+            pend = S.unsynced || [];
+            S.unsynced = [];
+            for (i = 0; i < pend.length; i++) {
+                try {
+                    p = new Folder(sub("out").fsName + "/" + pend[i]);
+                    syncOne(ws, pend[i], new File(sub("done").fsName + "/" + pend[i] + ".jsx"), new File(sub("done").fsName + "/" + pend[i] + ".json"), p);
+                    appendText(new File(ws.fsName + "/JOURNAL.md"), "\n## " + pend[i] + " (ran before the project was first saved; see results/" + pend[i] + "/result.json)\n");
+                } catch (e0) { }
+            }
+
+            result.sync = { ok: true, dir: ws.fsName };
+            if (migrated) { result.sync.migratedFrom = G.PlayrigCore.legacyLogFolder(); }
+            // result.json in the workspace must include the sync block, so rewrite it before copying.
+            writeAtomic(new File(outDir.fsName + "/result.json"), PLAYRIG.json.stringify(result, 2) + "\n");
+            syncOne(ws, id, runFile, optFile, outDir);
+
+            if (!new File(ws.fsName + "/JOURNAL.md").exists) { writeText(new File(ws.fsName + "/JOURNAL.md"), "# Playrig journal\n\nProject: " + app.project.file.displayName + "\n"); }
+            appendText(new File(ws.fsName + "/JOURNAL.md"), journalEntry(result, runFile ? runFile.displayName : null));
+
+            assets = PLAYRIG._assets(dir.fsName);
+            writeText(new File(ws.fsName + "/assets.ae.json"), PLAYRIG.json.stringify(assets, 2) + "\n");
+            writeText(new File(ws.fsName + "/assets.ae.md"), assetsMarkdown(assets));
+            if (migrated) { try { new File(ws.fsName + "/assets.json").remove(); new File(ws.fsName + "/assets.md").remove(); } catch (e11) { } }   // the old names; this app regenerates them as assets.ae.*
+            return result.sync;
+        } catch (e) {
+            return { ok: false, reason: e.message };
+        }
+    }
+
+    function runJob(inboxFile) {
+        var id = inboxFile.displayName.replace(/\.jsx$/i, "");
+        var root = getRoot(), t0 = new Date().getTime(), opts = {}, result, runFile, optInbox, optFile, outDir, lib;
+        var suppressed = false, undoOpen = false, ready = false, rf;
+        var elapsed, list, i, j, o, sn, jobSrc = "", cls;
+
+        S.busy = true;
+        setStatus("Running " + id);
+        ensureCore();
+        try {
+            runFile = moveFile(inboxFile, sub("running"));
+            optInbox = new File(sub("inbox").fsName + "/" + id + ".json");
+            optFile = optInbox.exists ? moveFile(optInbox, sub("running")) : null;
+            outDir = new Folder(sub("out").fsName + "/" + id);
+            if (!outDir.exists) { outDir.create(); }
+            // Clear a stale result from an earlier job with the same id.
+            if (new File(outDir.fsName + "/result.json").exists) { new File(outDir.fsName + "/result.json").remove(); }
+
+            result = { id: id, status: "ok", startedAt: isoNow(new Date(t0)), durationMs: 0, aeVersion: String(app.version),
+                project: projInfo(), action: "custom", actionSource: "inferred", description: null, error: null, log: [], snapshots: [], inspect: null, returnValue: null };
+
+            G.__PLAYRIG_CTX = { root: root.fsName, outDir: outDir.fsName, id: id };
+            try {
+                lib = findLib();
+                if (!lib) { throw new Error("bridge-api.jsxinc not found"); }
+                $.evalFile(lib);
+                if (optFile) { opts = PLAYRIG.json.parse(readText(optFile)); }
+                jobSrc = readText(runFile);
+                if (jobSrc.charCodeAt(0) === 0xFEFF) { jobSrc = jobSrc.substr(1); }
+                try { cls = G.PlayrigCore.classify(opts, jobSrc, id); } catch (eC) { cls = { action: "custom", actionSource: "inferred", actionLabel: null, description: null }; }
+                result.action = cls.action;
+                result.actionSource = cls.actionSource;
+                if (cls.actionLabel) { result.actionLabel = cls.actionLabel; }
+                result.description = cls.description;
+                ready = true;
+            } catch (e0) {
+                result.status = optFile && G.PLAYRIG ? "rejected" : "error";
+                if (result.status === "rejected") { result.action = "job.rejected"; result.actionSource = "declared"; }
+                result.error = errInfo(e0, null);
+            }
+
+            if (ready) {
+                if (getSet("backup", "1") === "1") { backupProject(id, result); }
+                try {
+                    app.beginSuppressDialogs();
+                    suppressed = true;
+                    if (opts.undoGroup !== false) { app.beginUndoGroup("Playrig: " + id); undoOpen = true; }
+                    // Overriding $.global.alert has no effect on the job, so the job runs inside a function that
+                    // shadows alert/confirm. The prefix has no newline, so reported line numbers match the file.
+                    // ExtendScript's eval treats a comment such as "// @action x" as a preprocessor directive and throws a syntax error, so
+                    // the comment marker is defused in the evaluated copy only (one extra character on the same line, so line numbers still match).
+                    eval("(function (alert, confirm) {" + jobSrc.replace(/^([ \t]*\/\/)([ \t]*)@/gm, "$1$2~@") + "\n})(" +
+                        "function (m) { PLAYRIG.log('[alert] ' + m); }, " +
+                        "function (m) { PLAYRIG.log('[confirm -> false] ' + m); return false; });");
+                } catch (e1) {
+                    result.status = "error";
+                    result.error = errInfo(e1, runFile);
+                } finally {
+                    if (undoOpen) { try { app.endUndoGroup(); } catch (e2) { } }
+                    if (suppressed) { try { app.endSuppressDialogs(false); } catch (e3) { } }
+                }
+
+                elapsed = new Date().getTime() - t0;
+                // ExtendScript cannot be interrupted, so a timeout is only detected after the job returns.
+                if (result.status === "ok" && opts.timeoutSec && elapsed > opts.timeoutSec * 1000) {
+                    result.status = "timeout";
+                    result.error = { message: "Job ran " + Math.round(elapsed / 1000) + " s, past timeoutSec=" + opts.timeoutSec + " (not interrupted)", line: null, fileName: null, source: null };
+                }
+
+                // Snapshots: requested in options, plus any queued by the job.
+                list = [];
+                if (opts.snapshots) {
+                    for (i = 0; i < opts.snapshots.length; i++) {
+                        sn = opts.snapshots[i];
+                        for (j = 0; j < (sn.times ? sn.times.length : 0); j++) { list.push({ comp: sn.comp, time: sn.times[j] }); }
+                    }
+                }
+                o = PLAYRIG._snapQueue();
+                for (i = 0; i < o.length; i++) { list.push(o[i]); }
+                try { result.snapshots = PLAYRIG._takeSnapshots(list, outDir); }
+                catch (e4) { result.snapshots = [{ ok: false, error: e4.message }]; }
+
+                if (opts.inspect && opts.inspect.comp) {
+                    try { result.inspect = PLAYRIG.inspect(opts.inspect.comp, opts.inspect.depth, opts.inspect.time); }
+                    catch (e5) { result.inspect = { error: e5.message }; }
+                }
+
+                result.log = PLAYRIG._log();
+                result.returnValue = PLAYRIG._ret();
+                result.project = projInfo();
+            }
+
+            result.durationMs = new Date().getTime() - t0;
+            try {
+                writeAtomic(new File(outDir.fsName + "/result.json"), PLAYRIG.json.stringify(result, 2) + "\n");
+            } catch (e6) {
+                result.returnValue = "(not serialisable: " + e6.message + ")";
+                result.inspect = null;
+                writeAtomic(new File(outDir.fsName + "/result.json"), PLAYRIG.json.stringify(result, 2) + "\n");
+            }
+            // Mirror into the project folder (journal, job script, results, asset manifest) while the job files are
+            // still in running/, then rewrite result.json with the outcome so the root copy carries it too.
+            if (ready) {
+                result.sync = syncToProject(id, result, runFile, optFile, outDir);
+                try { writeAtomic(new File(outDir.fsName + "/result.json"), PLAYRIG.json.stringify(result, 2) + "\n"); } catch (e9) { }
+                if (result.sync.ok) {
+                    try { copyInto(new File(outDir.fsName + "/result.json"), new Folder(result.sync.dir + "/results/" + id)); } catch (e10) { }
+                }
+            }
+            try { moveFile(runFile, sub("done")); if (optFile) { moveFile(optFile, sub("done")); } } catch (e7) { }
+            sessionPush(result, outDir.fsName + "/result.json");
+            refreshHistory();
+            setStatus(result.status === "error" ? "Error (" + id + ")" : "Idle");
+        } catch (fatal) {
+            try {
+                rf = simpleResult(id, "error", "Playrig failure: " + fatal.message);
+                sessionPush({ id: id, status: "error", startedAt: isoNow(new Date()), action: "custom", actionSource: "declared", error: { message: "Playrig failure: " + fatal.message }, project: projInfo() }, rf.fsName);
+                refreshHistory();
+            } catch (e8) { }
+            setStatus("Error");
+        } finally {
+            S.busy = false;
+        }
+    }
+
+    // ------------------------------------------------------------ public engine API
+    G.Playrig = {
+        tick: function () {
+            var job;
+            if (!S.on || S.busy) { return; }
+            // Panel closed: its widgets are invalid, so stop polling.
+            if (!ui(function (u) { var t = u.status.text; })) { stopPolling(); return; }
+            try {
+                job = pickJob();
+                if (job) { runJob(job); }
+            } catch (e) {
+                S.busy = false;
+                setStatus("Error");
+            }
+        },
+        // Runs even when the bridge is stopped (own task): follows the open project so the table always shows ITS jobs.
+        watch: function () {
+            var pf, p;
+            if (S.busy) { return; }
+            if (!ui(function (u) { var t = u.status.text; })) { stopWatching(); return; }
+            pf = projectFile();
+            p = pf ? pf.fsName : null;
+            if (p !== S.projPath) { showProject(); refreshHistory(); }
+        },
+        clearMsg: function (n) { if (n === S.msgSeq && !S.msgSticky) { ui(function (u) { u.msg.text = ""; }); } },
+        start: startPolling,
+        stop: stopPolling
+    };
+
+    function startWatching() {
+        if (S.watchId !== null && S.watchId !== undefined) { try { app.cancelTask(S.watchId); } catch (e) { } }
+        S.watchId = app.scheduleTask("Playrig.watch()", 1500, true);
+    }
+    function stopWatching() {
+        if (S.watchId !== null && S.watchId !== undefined) { try { app.cancelTask(S.watchId); } catch (e) { } }
+        S.watchId = null;
+    }
+
+    // ------------------------------------------------------------ links
+    function openUrl(url) {
+        try {
+            if ($.os.indexOf("Windows") >= 0) { system.callSystem('cmd /c start "" "' + url + '"'); }
+            else { system.callSystem('open "' + url + '"'); }
+        } catch (e) { say("Cannot open " + url, true); }
+    }
+
+    // ------------------------------------------------------------ job details window
+    function openDetails(row) {
+        var r = null, secs, dev = [], dlg, head, body, i, s, g, lines, et, w = 460, logDir = null, pf = projectFile();
+        if (!row || !ensureCore()) { return; }
+        try { r = G.PlayrigCore.readResult(row); } catch (e) { r = null; }
+        if (!r) {
+            // The live row of an unsaved project may only exist in memory.
+            r = { id: row.id, status: row.status, startedAt: row.startedAt, durationMs: row.durationMs, action: row.action, actionSource: row.actionSource,
+                actionLabel: row.actionLabel, description: row.description, error: row.error ? { message: row.error } : null, log: [], snapshots: [], project: { path: row.projectPath } };
+        }
+        secs = G.PlayrigCore.detail(r, row);
+        if (G.PlayrigDev && G.PlayrigDev.jobDetail) {
+            try {
+                logDir = G.PlayrigCore.logDir(pf);
+                dev = G.PlayrigDev.jobDetail({ logDir: logDir, id: row.id, readText: readText }) || [];
+            } catch (e2) { dev = []; }
+        }
+        secs = secs.concat(dev);
+
+        dlg = new Window("dialog", "Job details");
+        dlg.orientation = "column";
+        dlg.alignChildren = ["fill", "top"];
+        dlg.margins = 16;
+        dlg.spacing = 8;
+        head = dlg.add("group");
+        head.orientation = "row";
+        head.alignChildren = ["left", "center"];
+        head.spacing = 8;
+        if (icon(G.PlayrigCore.statusIconName(r.status))) { head.add("image", undefined, icon(G.PlayrigCore.statusIconName(r.status))); }
+        s = head.add("statictext", undefined, G.PlayrigCore.actionLabel(r.action || row.action, r.actionLabel || row.actionLabel));
+        try { s.graphics.font = ScriptUI.newFont("dialog", "BOLD", 13); } catch (e3) { }
+        head.add("statictext", undefined, "   " + r.status);
+
+        body = dlg.add("group");
+        body.orientation = "column";
+        body.alignChildren = ["fill", "top"];
+        body.spacing = 6;
+        for (i = 0; i < secs.length; i++) {
+            g = body.add("group");
+            if (secs[i].multi) {
+                g.orientation = "column";
+                g.alignChildren = ["fill", "top"];
+                g.spacing = 2;
+                g.add("statictext", undefined, secs[i].title);
+                lines = String(secs[i].text).split(/\r\n|\r|\n/).length;
+                et = g.add("edittext", undefined, String(secs[i].text), { multiline: true, readonly: true, scrollable: true });
+                et.preferredSize = [w, Math.min(Math.max(lines, 1), 10) * 15 + 8];
+            } else {
+                g.orientation = "row";
+                g.alignChildren = ["left", "top"];
+                g.spacing = 8;
+                s = g.add("statictext", undefined, secs[i].title);
+                s.preferredSize.width = 96;
+                try { s.graphics.foregroundColor = colorPen(s.graphics, [0.55, 0.55, 0.55, 1]); } catch (e4) { }
+                s = g.add("statictext", undefined, String(secs[i].text), { multiline: true });
+                s.preferredSize.width = w - 104;
+            }
+        }
+        g = dlg.add("group");
+        g.alignment = ["right", "top"];
+        g.margins = [0, 8, 0, 0];
+        g.add("button", undefined, "Done", { name: "ok" });
+        dlg.show();
+    }
+
+    // ------------------------------------------------------------ updates
+    // Check: once a day while "Check for updates automatically" is on (default), or when the user presses the button.
+    // Install: only on consent (the banner / About button), unless "Install updates automatically" is on (default off).
+    var updCfg = false;
+    function updater() {
+        if (!ensureCore() || !G.PlayrigUpdater) { return null; }
+        if (!updCfg) {
+            G.PlayrigUpdater.configure({ here: HERE, getSet: getSet, setSet: setSet, libFile: findLibFile, parse: function (t) { return G.PLAYRIG.json.parse(t); } });
+            updCfg = true;
+        }
+        return G.PlayrigUpdater;
+    }
+    function showBanner(text, canInstall) {
+        S.updText = text;
+        S.updCanInstall = !!canInstall;
+        if (S.ui && S.ui.updRow) {
+            S.ui.updText.text = text || "";
+            S.ui.updBtn.visible = !!canInstall;
+            S.ui.updRow.visible = !!text;
+            try { S.ui.win.layout.layout(true); } catch (e) { }
+        }
+    }
+    // Returns { ok, text, info, canInstall }. Never throws.
+    function runUpdateCheck() {
+        var U = updater(), r, can;
+        if (!U) { return { ok: false, text: "The updater is not installed with this panel." }; }
+        try { r = U.check(15); } catch (e) { return { ok: false, text: "Update check failed: " + e.message }; }
+        if (!r.ok) { return { ok: false, text: r.error }; }
+        S.updInfo = r;
+        if (!r.newer) { return { ok: true, text: r.error || ("You are up to date (version " + r.current + ")."), info: r }; }
+        can = U.canVerify();
+        return { ok: true, info: r, canInstall: can, text: "Version " + r.latest + " is available (you have " + r.current + ")." + (r.notes ? " " + r.notes : "") + (can ? "" : " Run `playrig update ae` in a terminal to install it.") };
+    }
+    function runInstall() {
+        var U = updater(), r;
+        if (!U || !S.updInfo || !S.updInfo.entry) { return { ok: false, text: "Check for updates first." }; }
+        r = U.install(S.updInfo.entry);
+        if (!r.ok) { return { ok: false, text: r.error }; }
+        S.updInfo = null;
+        showBanner("Updated to " + r.version + ". Restart After Effects to use it.", false);
+        return { ok: true, text: "Updated to " + r.version + ". Restart After Effects to use it." };
+    }
+    function autoUpdateCheck() {
+        var U, r;
+        if (getSet("updateAutoCheck", "1") !== "1") { return; }
+        U = updater();
+        if (!U || !U.due()) { return; }
+        r = runUpdateCheck();
+        if (!r.ok || !r.info || !r.info.newer) { return; }
+        if (getSet("updateAutoInstall", "0") === "1" && r.canInstall) { r = runInstall(); showBanner(r.text, false); return; }
+        showBanner(r.text, r.canInstall);
+    }
+
+    // ------------------------------------------------------------ settings window
+    function isAbsPath(p) { return /^(\/|[A-Za-z]:[\\\/]|\\\\)/.test(p); }
+
+    function openSettings() {
+        var dlg = new Window("dialog", "Playrig Settings"), nav, stack, panes = [], p, g, row, rootEdit, browse, hint, cbBackup, cbAuto, msg, i, t, done, prev, updBtn, updInstall, updMsg, cbUpdCheck, cbUpdAuto;
+        dlg.orientation = "column";
+        dlg.alignChildren = ["fill", "top"];
+        dlg.margins = 16;
+        dlg.spacing = 12;
+
+        row = dlg.add("group");
+        row.orientation = "row";
+        row.alignChildren = ["fill", "top"];
+        row.spacing = 16;
+        nav = row.add("listbox", undefined, ["General", "About"]);
+        nav.preferredSize = [110, 70];
+        nav.alignment = ["left", "top"];
+        stack = row.add("group");
+        stack.orientation = "stack";
+        stack.alignment = ["fill", "top"];
+        stack.alignChildren = ["fill", "top"];
+
+        // General
+        p = stack.add("group");
+        p.orientation = "column";
+        p.alignChildren = ["fill", "top"];
+        p.spacing = 6;
+        p.add("statictext", undefined, "Playrig folder");
+        g = p.add("group");
+        g.orientation = "row";
+        g.alignChildren = ["fill", "center"];
+        g.spacing = 6;
+        rootEdit = g.add("edittext", undefined, getRoot().fsName);
+        rootEdit.alignment = ["fill", "center"];
+        rootEdit.preferredSize.width = 270;
+        browse = g.add("button", undefined, "Browse...");
+        browse.alignment = ["right", "center"];
+        hint = p.add("statictext", undefined, "Where jobs and results are exchanged: inbox, out, done, backups. Not your project folder. Keep it private: anything that can write to inbox can run code in the app.", { multiline: true });
+        hint.preferredSize = [380, 48];
+        try { hint.graphics.foregroundColor = colorPen(hint.graphics, [0.55, 0.55, 0.55, 1]); } catch (e0) { }
+        cbAuto = p.add("checkbox", undefined, "Start automatically");
+        cbBackup = p.add("checkbox", undefined, "Back up the project file before each job");
+        cbAuto.value = getSet("auto", "0") === "1";
+        cbBackup.value = getSet("backup", "1") === "1";
+        panes.push(p);
+
+        // About
+        p = stack.add("group");
+        p.orientation = "column";
+        p.alignChildren = ["left", "top"];
+        p.spacing = 6;
+        t = p.add("statictext", undefined, "Playrig");
+        try { t.graphics.font = ScriptUI.newFont("dialog", "BOLD", 13); } catch (e1) { }
+        p.add("statictext", undefined, "Version " + VERSION);
+        p.add("statictext", undefined, "Developed by Vivek Nigam");
+        g = p.add("group");
+        g.orientation = "row";
+        g.spacing = 6;
+        g.margins = [0, 8, 0, 0];
+        g.add("statictext", undefined, "Twitter");
+        g.add("button", undefined, "@viveknigam_").onClick = function () { openUrl("https://twitter.com/viveknigam_"); };
+        g = p.add("group");
+        g.orientation = "row";
+        g.spacing = 6;
+        g.add("statictext", undefined, "Instagram");
+        g.add("button", undefined, "@viveknigam3003").onClick = function () { openUrl("https://www.instagram.com/viveknigam3003/"); };
+        g = p.add("group");
+        g.orientation = "row";
+        g.spacing = 6;
+        g.margins = [0, 8, 0, 0];
+        updBtn = g.add("button", undefined, "Check for Updates");
+        updInstall = g.add("button", undefined, "Install update");
+        updInstall.visible = false;
+        updMsg = p.add("statictext", undefined, S.updText || "", { multiline: true });
+        updMsg.preferredSize = [330, 44];
+        cbUpdCheck = p.add("checkbox", undefined, "Check for updates automatically (once a day)");
+        cbUpdAuto = p.add("checkbox", undefined, "Install updates automatically");
+        cbUpdCheck.value = getSet("updateAutoCheck", "1") === "1";
+        cbUpdAuto.value = getSet("updateAutoInstall", "0") === "1";
+        t = p.add("statictext", undefined, "© 2026 Vivek Nigam. All rights reserved.");
+        t = p.add("statictext", undefined, "Icons by Tabler Icons (MIT License)");
+        panes.push(p);
+
+        function showPane(n) { var k; for (k = 0; k < panes.length; k++) { panes[k].visible = (k === n); } }
+        nav.onChange = function () { if (nav.selection) { showPane(nav.selection.index); } };
+        nav.selection = 0;
+        showPane(0);
+
+        // The modal gets its own message line: messages in the panel are not visible behind it.
+        msg = dlg.add("statictext", undefined, "", { truncate: "end" });
+        try { msg.graphics.foregroundColor = colorPen(msg.graphics, [0.9, 0.75, 0.2, 1]); } catch (e2) { }
+
+        function applyRoot(text) {
+            var v = text.replace(/^\s+|\s+$/g, ""), f, old = getRoot().fsName;
+            if (v === old) { msg.text = ""; return true; }
+            if (!isAbsPath(v)) { msg.text = "The bridge folder must be an absolute path."; rootEdit.text = old; return false; }
+            f = new Folder(v);
+            try {
+                if (!f.exists && !f.create()) { throw new Error("Cannot create " + f.fsName); }
+            } catch (e) { msg.text = "Cannot use that folder: " + e.message; rootEdit.text = old; return false; }
+            setSet("root", f.fsName);
+            rootEdit.text = f.fsName;
+            try { ensureDirs(); msg.text = ""; } catch (e5) { msg.text = e5.message; setSet("root", old); rootEdit.text = old; return false; }
+            return true;
+        }
+        rootEdit.onChange = function () { applyRoot(rootEdit.text); };
+        browse.onClick = function () {
+            var f = Folder.selectDialog("Choose the Playrig folder", getRoot());
+            if (f) { rootEdit.text = f.fsName; applyRoot(f.fsName); }
+        };
+        cbAuto.onClick = function () { setSet("auto", cbAuto.value ? "1" : "0"); };
+        cbBackup.onClick = function () { setSet("backup", cbBackup.value ? "1" : "0"); };
+        cbUpdCheck.onClick = function () { setSet("updateAutoCheck", cbUpdCheck.value ? "1" : "0"); };
+        cbUpdAuto.onClick = function () { setSet("updateAutoInstall", cbUpdAuto.value ? "1" : "0"); };
+        updBtn.onClick = function () {
+            var r;
+            updBtn.enabled = false; updMsg.text = "Checking..."; try { dlg.update(); } catch (eU) { }
+            r = runUpdateCheck();
+            updMsg.text = r.text || "";
+            updInstall.visible = !!(r.ok && r.canInstall);
+            if (r.ok && r.info && r.info.newer) { showBanner(r.text, r.canInstall); }
+            updBtn.enabled = true;
+        };
+        updInstall.onClick = function () {
+            var r;
+            updInstall.enabled = false; updMsg.text = "Downloading and verifying..."; try { dlg.update(); } catch (eU2) { }
+            r = runInstall();
+            updMsg.text = r.text;
+            updInstall.visible = false; updInstall.enabled = true;
+        };
+
+        g = dlg.add("group");
+        g.alignment = ["right", "top"];
+        done = g.add("button", undefined, "Done", { name: "ok" });
+        dlg.onClose = function () { if (rootEdit.text !== getRoot().fsName) { applyRoot(rootEdit.text); } return true; };
+        dlg.show();
+    }
+
+    // ------------------------------------------------------------ UI
+    var win = (thisObj instanceof Panel) ? thisObj : new Window("palette", "Playrig", undefined, { resizeable: true });
+    win.orientation = "column";
+    win.alignChildren = ["fill", "top"];
+    win.spacing = 6;
+    win.margins = 10;
+
+    // Header: title + project name (4 px apart) on the left; status dot, power and settings on the right.
+    var header = win.add("group");
+    header.orientation = "row";
+    header.alignChildren = ["fill", "top"];
+    header.spacing = 8;
+    var titleCol = header.add("group");
+    titleCol.orientation = "column";
+    titleCol.alignChildren = ["left", "top"];
+    titleCol.alignment = ["fill", "top"];
+    titleCol.spacing = 4;
+    var title = titleCol.add("statictext", undefined, "Playrig");
+    try { title.graphics.font = ScriptUI.newFont("dialog", "BOLD", 14); } catch (eT) { }
+    var projectText = titleCol.add("statictext", undefined, projectName(), { truncate: "middle" });
+    projectText.alignment = ["fill", "top"];
+    try { projectText.graphics.foregroundColor = colorPen(projectText.graphics, [0.55, 0.55, 0.55, 1]); } catch (eP) { }
+
+    var ctl = header.add("group");
+    ctl.orientation = "row";
+    ctl.alignChildren = ["right", "center"];
+    ctl.alignment = ["right", "top"];
+    ctl.spacing = 6;
+    var dotImg = ctl.add("image", undefined, icon("dot-idle"));
+    var status = ctl.add("statictext", undefined, "Idle", { truncate: "end" });
+    status.preferredSize.width = 60;
+    var power = ctl.add("iconbutton", undefined, icon(S.on ? "power-on" : "power-off"), { style: "toolbutton" });
+    power.preferredSize = [24, 24];
+    power.helpTip = S.on ? "Stop the bridge" : "Start the bridge";
+    var gear = ctl.add("iconbutton", undefined, icon("settings"), { style: "toolbutton" });
+    gear.preferredSize = [24, 24];
+    gear.helpTip = "Playrig Settings";
+
+    var listHead = win.add("group");
+    listHead.orientation = "row";
+    listHead.alignChildren = ["fill", "center"];
+    listHead.margins = [0, 10, 0, 0];   // + the window spacing = a 16 px gap under the project name
+    var listTitle = listHead.add("statictext", undefined, "Recent jobs");
+    listTitle.alignment = ["left", "center"];
+    var countText = listHead.add("statictext", undefined, "", { truncate: "end" });
+    countText.alignment = ["fill", "center"];
+    countText.justify = "right";
+    try { countText.graphics.foregroundColor = colorPen(countText.graphics, [0.55, 0.55, 0.55, 1]); } catch (eC) { }
+
+    var list = win.add("listbox", undefined, [], { numberOfColumns: 3, showHeaders: true, columnTitles: ["Status", "Action", "Time"], columnWidths: [74, 128, 98], multiselect: false });
+    list.preferredSize = [300, 47];
+    list.alignment = ["fill", "top"];
+
+    var sumRow = win.add("group");
+    sumRow.orientation = "row";
+    sumRow.alignChildren = ["fill", "top"];
+    sumRow.spacing = 6;
+    var summary = sumRow.add("statictext", undefined, "", { multiline: true });
+    summary.alignment = ["fill", "top"];
+    summary.preferredSize = [210, 44];
+    var detailsBtn = sumRow.add("button", undefined, "Details...");
+    detailsBtn.alignment = ["right", "top"];
+    detailsBtn.enabled = false;
+
+    var updRow = win.add("group");
+    updRow.orientation = "row";
+    updRow.alignChildren = ["fill", "center"];
+    updRow.spacing = 6;
+    var updText = updRow.add("statictext", undefined, "", { truncate: "end" });
+    updText.alignment = ["fill", "center"];
+    var updBtn = updRow.add("button", undefined, "Install");
+    updBtn.alignment = ["right", "center"];
+    updBtn.visible = false;
+    updRow.visible = false;
+    updBtn.onClick = function () { var r = runInstall(); showBanner(r.text, false); };
+
+    var msgText = win.add("statictext", undefined, "", { truncate: "end" });
+    msgText.alignment = ["fill", "top"];
+    try { msgText.graphics.foregroundColor = colorPen(msgText.graphics, [0.9, 0.75, 0.2, 1]); } catch (eM) { }
+
+    S.ui = { updRow: updRow, updText: updText, updBtn: updBtn, win: win, status: status, dot: dotImg, power: power, list: list, project: projectText, count: countText, summary: summary, details: detailsBtn, msg: msgText };
+    status.text = S.status;
+
+    power.onClick = function () { if (S.on) { stopPolling(); } else { startPolling(); } };
+    gear.onClick = function () { openSettings(); };
+    list.onChange = function () {
+        var r = selectedRow();
+        summary.text = r ? G.PlayrigCore.summaryText(r) : "Select a job to see what it did. Double-click for details.";
+        detailsBtn.enabled = !!r;
+    };
+    list.onDoubleClick = function () { var r = selectedRow(); if (r) { openDetails(r); } };
+    detailsBtn.onClick = function () { var r = selectedRow(); if (r) { openDetails(r); } };
+
+    win.onResizing = win.onResize = function () { this.layout.resize(); };
+    win.onClose = function () { stopPolling(); stopWatching(); S.ui = null; };
+
+    if (win instanceof Window) { win.center(); win.show(); } else { win.layout.layout(true); }
+
+    S.unsavedMsg = false;
+    ensureCore();
+    showProject();
+    refreshHistory();
+    setStatus(S.status);
+    startWatching();
+    if (!S.loaded) {
+        S.loaded = true;
+        if (getSet("auto", "0") === "1") { startPolling(); }
+        try { autoUpdateCheck(); } catch (eAU) { }
+    } else if (S.updText) {
+        showBanner(S.updText, S.updCanInstall);
+    }
+})(this);