@kenkaiiii/gg-editor 0.1.0 → 0.3.0

package/dist/core/doctor-runner.js

@@ -0,0 +1,212 @@
+/**
+ * Interactive doctor runner.
+ *
+ * Used by `ggeditor doctor` and the first-run onboarding flow. Walks
+ * through actionable items one at a time:
+ *
+ *   - If the item carries an `installable` hint → ask "Install X? [Y/n]".
+ *     Yes → spawn the package manager, stream output live, re-run the
+ *     doctor, move on. No → print the manual `fix` text, move on.
+ *   - If the item only has a `fix` string (manual setup, env var, etc.)
+ *     → print it and move on.
+ *
+ * The banner matches `runStatus`'s look ("GG Editor — Doctor", orange-
+ * bold, two-space indent, dim subline) so the three CLI commands
+ * (auth/login/doctor) feel like one product.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import chalk from "chalk";
+import { runDoctor } from "./doctor.js";
+import { renderDoctorReport } from "./doctor-render.js";
+const EDITOR_PRIMARY = "#f97316"; // matches login.ts / runStatus
+const EDITOR_ACCENT = "#ec4899";
+const orange = chalk.hex(EDITOR_PRIMARY);
+const pink = chalk.hex(EDITOR_ACCENT);
+/**
+ * Top-level entry. Renders the orange banner, then either
+ *   - prints the inventory (`all` or `nonInteractive`), OR
+ *   - walks the user through fixable items one at a time.
+ */
+export async function runDoctorInteractive(opts = {}) {
+    printBanner(opts.onboarding === true);
+    // Non-interactive paths: just print and exit.
+    if (opts.all || opts.nonInteractive || !process.stdin.isTTY) {
+        const report = runDoctor();
+        process.stdout.write(renderDoctorReport(report, { all: opts.all, onboarding: opts.onboarding }));
+        return;
+    }
+    await walkActionableItems(opts.onboarding === true);
+}
+// ── Internals ──────────────────────────────────────────────
+function printBanner(onboarding) {
+    const title = onboarding ? "Welcome to GG Editor" : "GG Editor — Doctor";
+    process.stdout.write(orange.bold(`\n  ${title}\n`));
+    process.stdout.write(chalk.dim(onboarding
+        ? "  One-time environment check. Re-run any time with `ggeditor doctor`.\n\n"
+        : "  Environment check. Re-run any time.\n\n"));
+}
+/**
+ * Walk through actionable items in priority order. After each step we
+ * re-run the doctor so that successful installs unblock follow-on
+ * checks (e.g. installing ffmpeg flips both ffmpeg + ffprobe to OK).
+ */
+async function walkActionableItems(onboarding) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    // Track items the user has explicitly skipped this session so we
+    // don't re-ask about them after every successful install.
+    const skipped = new Set();
+    try {
+        for (let step = 0; step < 20; step++) {
+            const report = runDoctor();
+            const next = pickNextActionable(report, skipped);
+            const total = countActionable(report);
+            const done = countDone(report);
+            if (!next) {
+                // Either everything's clean or we've skipped everything we can.
+                const cleanEverything = total === done;
+                if (cleanEverything) {
+                    process.stdout.write("  " +
+                        chalk.green("✓ Nothing to fix. You're all good.") +
+                        chalk.dim(" Run `ggeditor` to start.\n\n"));
+                }
+                else {
+                    process.stdout.write("  " +
+                        chalk.dim(`Skipped the rest. ${done}/${total} ready. Re-run \`ggeditor doctor\` any time.\n\n`));
+                }
+                return;
+            }
+            const proceed = await handleItem(next, rl, onboarding);
+            if (proceed === "skip")
+                skipped.add(next.id);
+            if (proceed === "quit") {
+                process.stdout.write(chalk.dim("  Done. Re-run `ggeditor doctor` any time.\n\n"));
+                return;
+            }
+        }
+        // Safety bound — should never hit this.
+        process.stdout.write(chalk.dim("  Reached step limit. Re-run `ggeditor doctor` to continue.\n\n"));
+    }
+    finally {
+        rl.close();
+    }
+}
+async function handleItem(item, rl, onboarding) {
+    // Header: severity + label + detail.
+    const tag = item.severity === "required" || item.severity === "block"
+        ? chalk.red("required")
+        : item.status === "warn"
+            ? chalk.yellow("needs attention")
+            : chalk.yellow("optional");
+    process.stdout.write(`  ${tag} · ${chalk.bold(item.label)}  ${chalk.dim("— " + item.detail)}\n`);
+    process.stdout.write("  " + chalk.dim(item.unlocks) + "\n\n");
+    if (item.installable) {
+        return await offerInstall(item, item.installable, rl);
+    }
+    // No structured installer — print the manual fix and move on.
+    if (item.fix) {
+        process.stdout.write(chalk.dim("  Fix:\n"));
+        for (const line of item.fix.split("\n")) {
+            process.stdout.write("    " + chalk.cyan(line) + "\n");
+        }
+        process.stdout.write("\n");
+    }
+    // For required items without a structured installer (e.g. auth →
+    // `ggeditor login`) we ask whether to keep going. For optional ones
+    // we just move on.
+    if (item.severity === "required" || item.severity === "block") {
+        const ans = await askYN(rl, "  Continue to the next item?", "y");
+        return ans ? "next" : "quit";
+    }
+    // Onboarding mode: pause briefly so the user reads the fix.
+    if (onboarding) {
+        const ans = await askYN(rl, "  Continue?", "y");
+        return ans ? "next" : "quit";
+    }
+    return "next";
+}
+async function offerInstall(item, hint, rl) {
+    const cmdline = `${hint.command} ${hint.args.join(" ")}`;
+    process.stdout.write(`  ${chalk.bold(hint.label)}\n`);
+    process.stdout.write(`    ${pink(cmdline)}\n`);
+    if (hint.needsSudo) {
+        process.stdout.write(chalk.dim("    (will prompt for your sudo password)\n"));
+    }
+    process.stdout.write("\n");
+    const yes = await askYN(rl, "  Install now?", "y");
+    if (!yes) {
+        if (item.fix) {
+            process.stdout.write(chalk.dim("  Skipping. To install later:\n"));
+            for (const line of item.fix.split("\n")) {
+                process.stdout.write("    " + chalk.cyan(line) + "\n");
+            }
+            process.stdout.write("\n");
+        }
+        return "skip";
+    }
+    const exitCode = await spawnInstall(hint);
+    if (exitCode === 0) {
+        process.stdout.write(chalk.green("  ✓ Installed.\n\n"));
+        return "next";
+    }
+    process.stdout.write(chalk.red(`  ✗ Install failed (exit ${exitCode}).`) + chalk.dim(" You can fix it manually:\n"));
+    if (item.fix) {
+        for (const line of item.fix.split("\n")) {
+            process.stdout.write("    " + chalk.cyan(line) + "\n");
+        }
+    }
+    process.stdout.write("\n");
+    return "skip";
+}
+function spawnInstall(hint) {
+    return new Promise((resolve) => {
+        const child = spawn(hint.command, hint.args, {
+            stdio: "inherit", // user sees + interacts with the manager directly
+        });
+        child.on("close", (code) => resolve(code ?? 1));
+        child.on("error", () => resolve(1));
+    });
+}
+async function askYN(rl, prompt, defaultAns) {
+    const suffix = defaultAns === "y" ? chalk.dim(" [Y/n] ") : chalk.dim(" [y/N] ");
+    const raw = (await rl.question(prompt + suffix)).trim().toLowerCase();
+    if (raw === "")
+        return defaultAns === "y";
+    if (raw === "y" || raw === "yes")
+        return true;
+    if (raw === "n" || raw === "no")
+        return false;
+    // Anything else: re-ask once, then fall through to default.
+    const retry = (await rl.question(chalk.dim('  Please answer "y" or "n": '))).trim().toLowerCase();
+    if (retry === "y" || retry === "yes")
+        return true;
+    if (retry === "n" || retry === "no")
+        return false;
+    return defaultAns === "y";
+}
+/**
+ * Pick the next actionable item (block > required > optional-warn >
+ * optional-missing) that the user hasn't already skipped this session.
+ * Info-severity items are never returned.
+ */
+function pickNextActionable(report, skipped) {
+    const tiers = [
+        { severity: "block", statuses: ["missing", "warn"] },
+        { severity: "required", statuses: ["missing", "warn"] },
+        { severity: "optional", statuses: ["warn"] },
+        { severity: "optional", statuses: ["missing"] },
+    ];
+    for (const tier of tiers) {
+        const hit = report.checks.find((c) => c.severity === tier.severity && tier.statuses.includes(c.status) && !skipped.has(c.id));
+        if (hit)
+            return hit;
+    }
+    return undefined;
+}
+function countActionable(report) {
+    return report.checks.filter((c) => c.severity !== "info").length;
+}
+function countDone(report) {
+    return report.checks.filter((c) => c.severity !== "info" && c.status === "ok").length;
+}
+//# sourceMappingURL=doctor-runner.js.map

package/dist/core/doctor-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-runner.js","sourceRoot":"","sources":["../../src/core/doctor-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA6D,SAAS,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,+BAA+B;AACjE,MAAM,aAAa,GAAG,SAAS,CAAC;AAChC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAWtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAyB,EAAE;IACpE,WAAW,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAC3E,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,mBAAmB,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,8DAA8D;AAE9D,SAAS,WAAW,CAAC,UAAmB;IACtC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CACP,UAAU;QACR,CAAC,CAAC,2EAA2E;QAC7E,CAAC,CAAC,2CAA2C,CAChD,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,mBAAmB,CAAC,UAAmB;IACpD,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,iEAAiE;IACjE,0DAA0D;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,IAAI,CAAC;QACH,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,gEAAgE;gBAChE,MAAM,eAAe,GAAG,KAAK,KAAK,IAAI,CAAC;gBACvC,IAAI,eAAe,EAAE,CAAC;oBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI;wBACF,KAAK,CAAC,KAAK,CAAC,oCAAoC,CAAC;wBACjD,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAC7C,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI;wBACF,KAAK,CAAC,GAAG,CACP,qBAAqB,IAAI,IAAI,KAAK,kDAAkD,CACrF,CACJ,CAAC;gBACJ,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;YACvD,IAAI,OAAO,KAAK,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;gBACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC,CAAC;gBAClF,OAAO;YACT,CAAC;QACH,CAAC;QACD,wCAAwC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAC7E,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAID,KAAK,UAAU,UAAU,CACvB,IAAiB,EACjB,EAAsC,EACtC,UAAmB;IAEnB,qCAAqC;IACrC,MAAM,GAAG,GACP,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO;QACvD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QACvB,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM;YACtB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACjC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAE9D,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,iEAAiE;IACjE,oEAAoE;IACpE,mBAAmB;IACnB,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,EAAE,EAAE,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACjE,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,4DAA4D;IAC5D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,IAAiB,EACjB,IAAqB,EACrB,EAAsC;IAEtC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,EAAE,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC;YACnE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,4BAA4B,QAAQ,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAC/F,CAAC;IACF,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,IAAqB;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;YAC3C,KAAK,EAAE,SAAS,EAAE,kDAAkD;SACrE,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,KAAK,CAClB,EAAsC,EACtC,MAAc,EACd,UAAqB;IAErB,MAAM,MAAM,GAAG,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChF,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtE,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,UAAU,KAAK,GAAG,CAAC;IAC1C,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9C,4DAA4D;IAC5D,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,UAAU,KAAK,GAAG,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,MAAoB,EAAE,OAAoB;IACpE,MAAM,KAAK,GAGN;QACH,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;QACpD,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;QACvD,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;QAC5C,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE;KAChD,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC9F,CAAC;QACF,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;AACnE,CAAC;AAED,SAAS,SAAS,CAAC,MAAoB;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;AACxF,CAAC"}

package/dist/core/doctor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * First-run doctor — environment probes + actionable install hints.
+ *
+ * The CLI runs onboarding on first launch (no `~/.gg/auth.json` and no
+ * `~/.gg/onboarded-ggeditor` marker). The same checks are exposed via
+ * `ggeditor doctor` so users can re-run it any time.
+ *
+ * Design rules:
+ *   - Probes only. We never auto-install anything — surprise sudo
+ *     prompts are worse than a missing dep.
+ *   - Each check carries `severity`:
+ *       block    — nothing meaningful works without it (none currently;
+ *                  the agent can run with zero deps)
+ *       required — most tools need it (ffmpeg / ffprobe)
+ *       optional — unlocks a feature group (openai-key, resolve,
+ *                  premiere, whisper-cpp, whisperx)
+ *       info     — purely informational (auth status)
+ *   - Each check tells the user EXACTLY what to do to fix it, including
+ *     the platform-appropriate install command.
+ *   - Pure module — no I/O writes, no side effects beyond `spawnSync` /
+ *     `existsSync` probes.
+ */
+export type CheckSeverity = "block" | "required" | "optional" | "info";
+export type CheckStatus = "ok" | "missing" | "warn";
+/**
+ * Structured install hint. When present, the doctor's interactive flow
+ * can offer to spawn this command after a Y/N confirmation — no copy-
+ * paste, no shell injection (we never run a string through `sh -c`).
+ *
+ * Only attached to checks where the install is a single packaged step
+ * (Homebrew formula, winget id, apt package). Items that need manual
+ * sign-up (API keys), license acceptance (Resolve installer), or
+ * multi-step setup (whisperx + HF_TOKEN) carry a `fix` string instead.
+ */
+export interface InstallableHint {
+    /** Human label shown in the prompt: "Install ffmpeg via Homebrew". */
+    label: string;
+    /** Executable on PATH. */
+    command: string;
+    /** Argument vector — NEVER a shell string. */
+    args: string[];
+    /**
+     * What managed manager this uses. Used by the renderer to decide
+     * whether to show "requires sudo" copy.
+     */
+    manager: "homebrew" | "winget" | "apt" | "pip" | "npm";
+    /** True when the command requires elevated privileges (sudo / admin). */
+    needsSudo?: boolean;
+}
+export interface DoctorCheck {
+    /** Stable id (also the check key). */
+    id: string;
+    /** ≤30 char display label. */
+    label: string;
+    status: CheckStatus;
+    severity: CheckSeverity;
+    /** One-line current state ("v6.1.1 found", "not on PATH", …). */
+    detail: string;
+    /**
+     * What this check unlocks for the user. Always present, even when
+     * status=ok — gives the user the mental model.
+     */
+    unlocks: string;
+    /**
+     * Fix instruction. Multi-line ok. Empty when status=ok.
+     * Platform-appropriate (macOS / linux / win32).
+     */
+    fix?: string;
+    /**
+     * Optional structured install command for items where a single
+     * package-manager invocation does the job. The CLI offers Y/N
+     * confirmation and spawns it directly.
+     */
+    installable?: InstallableHint;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    /** True when no `severity=required` check is missing. */
+    ready: boolean;
+    /** Where the marker file was/should be written. */
+    markerPath: string;
+    /** Whether onboarding has been completed before. */
+    onboarded: boolean;
+}
+export declare function onboardedMarkerPath(home?: string): string;
+export declare function isOnboarded(home?: string): boolean;
+/**
+ * Run every check. Synchronous and quick — only spawns short-lived
+ * `--version` style probes.
+ */
+export declare function runDoctor(home?: string): DoctorReport;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/core/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/core/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IACvD,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAM7D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAkB,GAAG,YAAY,CAqBhE"}