| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177 |
- #!/usr/bin/env node
- /**
- * Preflight. Run this BEFORE the interview, not after the first failure.
- *
- * node scripts/doctor.mjs check everything
- * node scripts/doctor.mjs --probe also spend one API call to read the balance
- *
- * Every check that can fail deep inside a build with a misleading message is
- * checked here with an honest one. The three that actually bite:
- *
- * - a STRIPPED ffmpeg on PATH. It carries ~50 filters and silently lacks
- * scale, fps, psnr and the webp muxer, then fails with "No option name
- * near ..." or "Unable to choose an output format", both of which read as
- * a mistake in your command rather than a missing feature.
- * - no KIE_AI_API_KEY, which only matters if you are generating assets.
- * - playwright-core resolving from the wrong directory. It is required from
- * the BUILD folder, not from the skill.
- */
- import fs from "node:fs";
- import path from "node:path";
- import { execFileSync } from "node:child_process";
- import { createRequire } from "node:module";
- import { fileURLToPath } from "node:url";
- import { paths } from "./workspace.mjs";
- const HERE = path.dirname(fileURLToPath(import.meta.url));
- const rows = [];
- const add = (sev, name, ok, detail, fix) => rows.push({ sev, name, ok, detail, fix });
- const run = (cmd, args) => {
- try {
- return execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
- } catch {
- return null;
- }
- };
- // ---------------------------------------------------------------- node ----
- const major = Number(process.versions.node.split(".")[0]);
- add("required", "node", major >= 18, `v${process.versions.node}`,
- "Install Node 18 or newer.");
- // -------------------------------------------------------------- ffmpeg ----
- function globWinGet() {
- const home = process.env.USERPROFILE || process.env.HOME || "";
- const base = path.join(home, "AppData/Local/Microsoft/WinGet/Packages");
- if (!fs.existsSync(base)) return [];
- const out = [];
- for (const d of fs.readdirSync(base)) {
- if (!/^Gyan\.FFmpeg/i.test(d)) continue;
- const inner = path.join(base, d);
- for (const e of fs.readdirSync(inner)) {
- const p = path.join(inner, e, "bin/ffmpeg.exe");
- if (fs.existsSync(p)) out.push(p);
- }
- }
- return out;
- }
- const candidates = [
- process.env.SCROLLCRAFT_FFMPEG,
- "ffmpeg",
- ...globWinGet(),
- "/usr/local/bin/ffmpeg",
- "/opt/homebrew/bin/ffmpeg",
- "/usr/bin/ffmpeg",
- "/snap/bin/ffmpeg",
- ].filter(Boolean);
- let ffmpeg = null, filterCount = 0;
- for (const c of candidates) {
- const out = run(c, ["-hide_banner", "-filters"]);
- if (!out) continue;
- const n = out.split("\n").length;
- if (n > filterCount) { filterCount = n; ffmpeg = c; }
- if (n > 200) break;
- }
- add("required", "ffmpeg (full build)", filterCount > 200,
- ffmpeg ? `${ffmpeg} (${filterCount} filters)` : "not found",
- "A stripped ffmpeg lacks scale/fps/psnr and the webp muxer. Install a full build (Windows: winget install Gyan.FFmpeg) or set SCROLLCRAFT_FFMPEG to one.");
- if (ffmpeg && filterCount > 200) {
- const enc = run(ffmpeg, ["-hide_banner", "-encoders"]) || "";
- add("optional", " └ libwebp encoder", /libwebp/.test(enc),
- /libwebp/.test(enc) ? "present" : "missing",
- "Posters fall back to JPEG. Not fatal, just heavier.");
- }
- // ---------------------------------------------------------- playwright ----
- let pw = false, pwWhere = "";
- try {
- createRequire(path.join(process.cwd(), "package.json"))("playwright-core");
- pw = true; pwWhere = "resolves from cwd";
- } catch {
- try {
- createRequire(path.join(HERE, "package.json"))("playwright-core");
- pw = true; pwWhere = "resolves from the skill, but NOT from cwd";
- } catch { pwWhere = "not installed"; }
- }
- add("verify", "playwright-core", pw, pwWhere,
- "Run `npm i playwright-core` inside the build folder. Only needed for the verification pass.");
- const chrome = [
- process.env.SCROLLCRAFT_CHROME,
- // Windows
- "C:/Program Files/Google/Chrome/Application/chrome.exe",
- "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe",
- "C:/Program Files/Microsoft/Edge/Application/msedge.exe",
- // macOS
- "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
- "/Applications/Chromium.app/Contents/MacOS/Chromium",
- "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
- // Linux
- "/usr/bin/google-chrome",
- "/usr/bin/google-chrome-stable",
- "/usr/bin/chromium",
- "/usr/bin/chromium-browser",
- "/snap/bin/chromium",
- ].find((p) => p && fs.existsSync(p));
- add("verify", "Chrome", Boolean(chrome), chrome || "not found",
- "Install Chrome, or set SCROLLCRAFT_CHROME to an executable.");
- // ------------------------------------------------------------- kie key ----
- function findKey() {
- if (process.env.KIE_AI_API_KEY) return "env";
- let dir = process.cwd();
- for (let i = 0; i < 8; i++) {
- const p = path.join(dir, ".env");
- if (fs.existsSync(p) && /^\s*KIE_AI_API_KEY\s*=\s*\S+/m.test(fs.readFileSync(p, "utf8"))) return p;
- const up = path.dirname(dir);
- if (up === dir) break;
- dir = up;
- }
- return null;
- }
- const keyWhere = findKey();
- add("optional", "KIE_AI_API_KEY", Boolean(keyWhere), keyWhere || "not set",
- "Only needed to GENERATE imagery. Building from your own photos and footage needs no key and no spend. Copy .env.example to .env to set one.");
- // ----------------------------------------------------------- workspace ----
- let ws = null;
- try {
- ws = paths();
- add("required", "workspace", true, `${ws.workspace}\n via ${ws.via}`, "");
- add("optional", " └ registry", fs.existsSync(ws.fingerprints),
- fs.existsSync(ws.fingerprints) ? "present" : "not created yet",
- "Run `node scripts/workspace.mjs --ensure` to create it.");
- } catch (e) {
- add("required", "workspace", false, e.message, "Fix or delete the offending .scrollcraft.json.");
- }
- // -------------------------------------------------------------- report ----
- const mark = (r) => (r.ok ? "\u001b[32m ok \u001b[0m" : r.sev === "required" ? "\u001b[31mFAIL\u001b[0m" : "\u001b[33mwarn\u001b[0m");
- console.log("\nscrollcraft preflight\n");
- for (const r of rows) {
- console.log(` [${mark(r)}] ${r.name.padEnd(22)} ${r.detail}`);
- if (!r.ok && r.fix) console.log(` ${"\u001b[2m"}${r.fix}${"\u001b[0m"}`);
- }
- const hardFails = rows.filter((r) => !r.ok && r.sev === "required");
- const softFails = rows.filter((r) => !r.ok && r.sev !== "required");
- console.log("");
- if (hardFails.length) {
- console.log(`\u001b[31m${hardFails.length} required check(s) failed. Fix these before building.\u001b[0m\n`);
- process.exit(1);
- }
- console.log(softFails.length
- ? `\u001b[33mReady, with ${softFails.length} optional item(s) missing (see above).\u001b[0m\n`
- : "\u001b[32mReady.\u001b[0m\n");
- if (process.argv.includes("--probe") && keyWhere) {
- const { execFileSync: x } = await import("node:child_process");
- try {
- console.log("credit: " + x(process.execPath, [path.join(HERE, "kie.mjs"), "probe"], { encoding: "utf8" }).trim().replace(/^credit:\s*/, ""));
- } catch (e) { console.log("balance probe failed: " + e.message); }
- }
|