@kenkaiiii/gg-editor 0.1.0 → 0.3.0

package/dist/core/doctor.js

@@ -0,0 +1,429 @@
+/**
+ * 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.
+ */
+import { existsSync, statSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { detectHost } from "./hosts/detect.js";
+import { checkFfmpeg, checkFfprobe } from "./media/ffmpeg.js";
+const ONBOARDED_MARKER = "onboarded-ggeditor";
+export function onboardedMarkerPath(home = homedir()) {
+    return join(home, ".gg", ONBOARDED_MARKER);
+}
+export function isOnboarded(home = homedir()) {
+    try {
+        return statSync(onboardedMarkerPath(home)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run every check. Synchronous and quick — only spawns short-lived
+ * `--version` style probes.
+ */
+export function runDoctor(home = homedir()) {
+    const checks = [
+        checkFfmpegProbe(),
+        checkFfprobeProbe(),
+        checkOpenAIKey(),
+        checkAnthropicKey(),
+        checkPython(),
+        checkResolve(),
+        checkPremiere(),
+        checkWhisperCpp(),
+        checkWhisperX(),
+        checkAuthFile(home),
+    ];
+    const ready = checks.every((c) => c.severity !== "required" || c.status === "ok");
+    return {
+        checks,
+        ready,
+        markerPath: onboardedMarkerPath(home),
+        onboarded: isOnboarded(home),
+    };
+}
+// ── Individual probes ──────────────────────────────────────
+function checkFfmpegProbe() {
+    const ok = checkFfmpeg();
+    return {
+        id: "ffmpeg",
+        label: "ffmpeg",
+        status: ok ? "ok" : "missing",
+        severity: "required",
+        detail: ok ? versionLine("ffmpeg") : "not on PATH",
+        unlocks: "Most tools (transcoding, captions, color grading, silence/filler cuts, transitions, " +
+            "audio mixing, GIF/thumbnail generation). ~70% of the toolkit.",
+        fix: ok ? undefined : ffmpegInstallHint(),
+        installable: ok
+            ? undefined
+            : buildInstallable({
+                pkg: { darwin: "ffmpeg", linux: "ffmpeg", win32: "Gyan.FFmpeg" },
+                label: "Install ffmpeg",
+            }),
+    };
+}
+function checkFfprobeProbe() {
+    const ok = checkFfprobe();
+    return {
+        id: "ffprobe",
+        label: "ffprobe",
+        status: ok ? "ok" : "missing",
+        severity: "required",
+        detail: ok ? versionLine("ffprobe") : "not on PATH",
+        unlocks: "probe_media (fps / duration / codec detection — runs on every input file).",
+        fix: ok ? undefined : ffmpegInstallHint(),
+        // ffprobe ships in the same Homebrew/winget/apt package as ffmpeg.
+        installable: ok
+            ? undefined
+            : buildInstallable({
+                pkg: { darwin: "ffmpeg", linux: "ffmpeg", win32: "Gyan.FFmpeg" },
+                label: "Install ffmpeg (includes ffprobe)",
+            }),
+    };
+}
+function checkOpenAIKey() {
+    const present = !!process.env.OPENAI_API_KEY;
+    return {
+        id: "openai-key",
+        label: "OPENAI_API_KEY",
+        status: present ? "ok" : "missing",
+        severity: "optional",
+        detail: present ? "set in environment" : "not set",
+        unlocks: "Vision tools: analyze_hook (retention scoring), score_shot, color_match, " +
+            "grade_skin_tones, match_clip_color, and the OpenAI transcription backend.",
+        fix: present
+            ? undefined
+            : "Get a key at https://platform.openai.com/api-keys, then:\n" +
+                "  export OPENAI_API_KEY=sk-...\n" +
+                "  # add to ~/.zshrc / ~/.bashrc to persist",
+    };
+}
+function checkAnthropicKey() {
+    // Anthropic auth normally goes through OAuth (~/.gg/auth.json). The env
+    // var only matters for users who prefer raw API keys. We mark it as
+    // info — auth status is what really matters.
+    const present = !!process.env.ANTHROPIC_API_KEY;
+    return {
+        id: "anthropic-key",
+        label: "ANTHROPIC_API_KEY",
+        status: present ? "ok" : "missing",
+        severity: "info",
+        detail: present
+            ? "set in environment (overrides OAuth token if present)"
+            : "not set (OAuth is the recommended path)",
+        unlocks: "Direct Anthropic API auth without OAuth. Most users should `ggeditor login` instead.",
+        fix: undefined,
+    };
+}
+function checkPython() {
+    const candidates = platform() === "win32" ? ["py", "python", "python3"] : ["python3", "python"];
+    for (const cmd of candidates) {
+        const r = spawnSync(cmd, cmd === "py" ? ["-3", "--version"] : ["--version"], {
+            encoding: "utf8",
+        });
+        if (r.status === 0) {
+            const out = (r.stdout || r.stderr).trim();
+            return {
+                id: "python",
+                label: "Python 3",
+                status: "ok",
+                severity: "optional",
+                detail: `${cmd}: ${out}`,
+                unlocks: "DaVinci Resolve scripting bridge (host integration). Without Python, file-only " +
+                    "mode still works.",
+            };
+        }
+    }
+    return {
+        id: "python",
+        label: "Python 3",
+        status: "missing",
+        severity: "optional",
+        detail: "no python3 / python / py interpreter found",
+        unlocks: "DaVinci Resolve scripting bridge (host integration). File-only mode works without it.",
+        fix: platform() === "darwin"
+            ? "brew install python@3.12   # or use python.org installer"
+            : platform() === "linux"
+                ? "sudo apt install python3   # debian/ubuntu — your distro's package manager otherwise"
+                : "winget install Python.Python.3   # or python.org installer",
+        installable: buildInstallable({
+            pkg: { darwin: "python@3.12", linux: "python3", win32: "Python.Python.3" },
+            label: "Install Python 3",
+        }),
+    };
+}
+function checkResolve() {
+    const detected = detectHost();
+    if (detected.name === "resolve") {
+        return {
+            id: "resolve",
+            label: "DaVinci Resolve",
+            status: "ok",
+            severity: "optional",
+            detail: "running",
+            unlocks: "Live timeline editing on Resolve: cut, marker, append, color grade, smart reframe, render.",
+        };
+    }
+    // Resolve isn't running — but is it INSTALLED? Check the canonical
+    // install path so the message is precise.
+    const installed = isResolveInstalled();
+    return {
+        id: "resolve",
+        label: "DaVinci Resolve",
+        status: "missing",
+        severity: "optional",
+        detail: installed ? "installed but not running" : "not installed",
+        unlocks: "Live timeline editing on Resolve. Open Resolve before launching ggeditor (or " +
+            "mid-session — the agent re-detects every 2s).",
+        fix: installed
+            ? "Open DaVinci Resolve, then re-run ggeditor (or just keep going — ggeditor will pick " +
+                "it up automatically within a few seconds)."
+            : "Install the free version from https://www.blackmagicdesign.com/products/davinciresolve",
+    };
+}
+function checkPremiere() {
+    const detected = detectHost();
+    if (detected.name === "premiere") {
+        return {
+            id: "premiere",
+            label: "Adobe Premiere Pro",
+            status: "ok",
+            severity: "optional",
+            detail: "running",
+            unlocks: "Live timeline editing on Premiere via the gg-editor UXP panel (insert / cut / marker " +
+                "/ render). Requires the panel installed (`ggeditor-premiere-panel install`).",
+        };
+    }
+    // Premiere is paid; we don't try to detect installation. Just note it.
+    return {
+        id: "premiere",
+        label: "Adobe Premiere Pro",
+        status: "missing",
+        severity: "optional",
+        detail: "not running",
+        unlocks: "Live timeline editing on Premiere. Open Premiere + install the gg-editor panel.",
+        fix: "Open Premiere Pro, then install the panel:\n  npx @kenkaiiii/gg-editor-premiere-panel install",
+    };
+}
+function checkWhisperCpp() {
+    for (const cmd of ["whisper-cli", "whisper", "main"]) {
+        const r = spawnSync(cmd, ["--help"], { encoding: "utf8" });
+        if (r.status === 0 && (r.stdout + r.stderr).toLowerCase().includes("whisper")) {
+            return {
+                id: "whisper-cpp",
+                label: "whisper.cpp",
+                status: "ok",
+                severity: "optional",
+                detail: `${cmd} on PATH`,
+                unlocks: "Local transcription (free, fast, private). Without it, transcribe falls back to " +
+                    "the OpenAI API (requires OPENAI_API_KEY).",
+            };
+        }
+    }
+    return {
+        id: "whisper-cpp",
+        label: "whisper.cpp",
+        status: "missing",
+        severity: "optional",
+        detail: "not on PATH",
+        unlocks: "Local transcription. Without it, transcribe uses the OpenAI API (requires OPENAI_API_KEY).",
+        fix: platform() === "darwin"
+            ? "brew install whisper-cpp   # then download a model from https://huggingface.co/ggerganov/whisper.cpp"
+            : "Build from source: https://github.com/ggml-org/whisper.cpp",
+        // Only Homebrew packages whisper.cpp cleanly. Linux / Windows users
+        // need to build from source — we leave them with the `fix` string.
+        installable: buildInstallable({
+            pkg: { darwin: "whisper-cpp" },
+            label: "Install whisper.cpp (you'll still need to download a model)",
+        }),
+    };
+}
+function checkWhisperX() {
+    const r = spawnSync("whisperx", ["--help"], { encoding: "utf8" });
+    const ok = r.status === 0;
+    const hfToken = !!process.env.HF_TOKEN;
+    if (ok && hfToken) {
+        return {
+            id: "whisperx",
+            label: "whisperx + HF_TOKEN",
+            status: "ok",
+            severity: "optional",
+            detail: "whisperx on PATH, HF_TOKEN set",
+            unlocks: "Speaker diarization (transcribe with diarize=true). Required for read_transcript with " +
+                "speaker filters.",
+        };
+    }
+    if (ok && !hfToken) {
+        return {
+            id: "whisperx",
+            label: "whisperx + HF_TOKEN",
+            status: "warn",
+            severity: "optional",
+            detail: "whisperx on PATH but HF_TOKEN not set",
+            unlocks: "Speaker diarization (transcribe with diarize=true).",
+            fix: "Get a token at https://huggingface.co/settings/tokens (free), then:\n" +
+                "  export HF_TOKEN=hf_...\n" +
+                "Also accept the pyannote model terms: https://huggingface.co/pyannote/speaker-diarization-3.1",
+        };
+    }
+    return {
+        id: "whisperx",
+        label: "whisperx + HF_TOKEN",
+        status: "missing",
+        severity: "optional",
+        detail: "whisperx not on PATH",
+        unlocks: "Speaker diarization (transcribe with diarize=true).",
+        fix: "pip install whisperx\n" +
+            "export HF_TOKEN=hf_...   # https://huggingface.co/settings/tokens\n" +
+            "Then accept https://huggingface.co/pyannote/speaker-diarization-3.1 model terms.",
+        // pip install handles the package; HF_TOKEN + license acceptance
+        // remain manual (handled via the `fix` text on the post-install run).
+        installable: hasManager("pip3")
+            ? {
+                label: "Install whisperx (you'll still need HF_TOKEN + accept model terms)",
+                command: "pip3",
+                args: ["install", "--user", "whisperx"],
+                manager: "pip",
+            }
+            : hasManager("pip")
+                ? {
+                    label: "Install whisperx (you'll still need HF_TOKEN + accept model terms)",
+                    command: "pip",
+                    args: ["install", "--user", "whisperx"],
+                    manager: "pip",
+                }
+                : undefined,
+    };
+}
+function checkAuthFile(home) {
+    const path = join(home, ".gg", "auth.json");
+    const exists = (() => {
+        try {
+            return statSync(path).isFile();
+        }
+        catch {
+            return false;
+        }
+    })();
+    return {
+        id: "auth",
+        label: "Auth (~/.gg/auth.json)",
+        status: exists ? "ok" : "missing",
+        severity: "required",
+        detail: exists ? `present at ${path}` : "not configured",
+        unlocks: "The agent itself. Without auth, ggeditor can't talk to a model provider.",
+        fix: exists
+            ? undefined
+            : "Run `ggeditor login` and pick a provider (Anthropic OAuth recommended; OpenAI / GLM / " +
+                "Moonshot also supported). Auth is shared with ggcoder via ~/.gg/auth.json — log in once.",
+    };
+}
+// ── Helpers ────────────────────────────────────────────────
+function versionLine(cmd) {
+    const r = spawnSync(cmd, ["-version"], { encoding: "utf8" });
+    if (r.status !== 0)
+        return "found";
+    const first = (r.stdout.split(/\r?\n/)[0] || "").trim();
+    return first || "found";
+}
+function ffmpegInstallHint() {
+    switch (platform()) {
+        case "darwin":
+            return "brew install ffmpeg";
+        case "linux":
+            return "sudo apt install ffmpeg   # debian/ubuntu — your distro's package manager otherwise";
+        case "win32":
+            return "winget install ffmpeg   # or scoop install ffmpeg";
+        default:
+            return "Install ffmpeg from https://ffmpeg.org/download.html";
+    }
+}
+/**
+ * True when `cmd --version` (or `--help` for managers that don't have
+ * a version flag) exits 0. Cached for the lifetime of the process so we
+ * don't re-spawn the same probe across multiple checks.
+ */
+const _managerCache = new Map();
+function hasManager(cmd) {
+    const cached = _managerCache.get(cmd);
+    if (cached !== undefined)
+        return cached;
+    const r = spawnSync(cmd, ["--version"], { encoding: "utf8" });
+    const ok = r.status === 0;
+    _managerCache.set(cmd, ok);
+    return ok;
+}
+/**
+ * Build an InstallableHint for a package whose name matches across the
+ * common managers we support. Returns undefined when no supported
+ * manager is available on this platform — in which case the check just
+ * surfaces a `fix` string instead.
+ */
+function buildInstallable(opts) {
+    const p = platform();
+    if (p === "darwin" && opts.pkg.darwin && hasManager("brew")) {
+        return {
+            label: opts.label,
+            command: "brew",
+            args: ["install", opts.pkg.darwin],
+            manager: "homebrew",
+        };
+    }
+    if (p === "linux" && opts.pkg.linux && hasManager("apt")) {
+        return {
+            label: opts.label,
+            command: "sudo",
+            args: ["apt", "install", "-y", opts.pkg.linux],
+            manager: "apt",
+            needsSudo: true,
+        };
+    }
+    if (p === "win32" && opts.pkg.win32 && hasManager("winget")) {
+        return {
+            label: opts.label,
+            command: "winget",
+            args: [
+                "install",
+                "--id",
+                opts.pkg.win32,
+                "-e",
+                "--accept-source-agreements",
+                "--accept-package-agreements",
+            ],
+            manager: "winget",
+        };
+    }
+    return undefined;
+}
+function isResolveInstalled() {
+    if (platform() === "darwin") {
+        return existsSync("/Applications/DaVinci Resolve/DaVinci Resolve.app");
+    }
+    if (platform() === "win32") {
+        return existsSync("C:\\Program Files\\Blackmagic Design\\DaVinci Resolve\\Resolve.exe");
+    }
+    // Linux: Resolve installs into /opt/resolve by default.
+    return existsSync("/opt/resolve/bin/resolve");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/core/doctor.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doctor.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.d.ts","sourceRoot":"","sources":["../../src/core/doctor.test.ts"],"names":[],"mappings":""}

package/dist/core/doctor.test.js

@@ -0,0 +1,143 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { isOnboarded, onboardedMarkerPath, runDoctor } from "./doctor.js";
+/**
+ * The doctor module is mostly env probes; we don't try to mock spawn.
+ * What we DO test is:
+ *   - Every check is present and well-formed.
+ *   - severity / status semantics are consistent.
+ *   - The marker file plumbing works against a synthetic home dir.
+ *   - `ready` reflects required-check status correctly.
+ */
+describe("runDoctor", () => {
+    it("returns a check for every documented id", () => {
+        const r = runDoctor();
+        const ids = r.checks.map((c) => c.id).sort();
+        expect(ids).toEqual([
+            "anthropic-key",
+            "auth",
+            "ffmpeg",
+            "ffprobe",
+            "openai-key",
+            "premiere",
+            "python",
+            "resolve",
+            "whisper-cpp",
+            "whisperx",
+        ].sort());
+    });
+    it("every check has label / detail / unlocks populated", () => {
+        const r = runDoctor();
+        for (const c of r.checks) {
+            expect(c.label.length).toBeGreaterThan(0);
+            expect(c.label.length).toBeLessThanOrEqual(40);
+            expect(c.detail.length).toBeGreaterThan(0);
+            expect(c.unlocks.length).toBeGreaterThan(0);
+        }
+    });
+    it("only checks with status='missing' or 'warn' carry a fix message", () => {
+        const r = runDoctor();
+        for (const c of r.checks) {
+            if (c.status === "ok") {
+                expect(c.fix).toBeUndefined();
+            }
+        }
+    });
+    it("ready === true only when every required check is ok", () => {
+        const r = runDoctor();
+        const requiredOk = r.checks
+            .filter((c) => c.severity === "required")
+            .every((c) => c.status === "ok");
+        expect(r.ready).toBe(requiredOk);
+    });
+    it("returns a markerPath inside the user's home", () => {
+        const r = runDoctor();
+        expect(r.markerPath).toContain(".gg");
+        expect(r.markerPath).toContain("onboarded-ggeditor");
+    });
+});
+describe("isOnboarded / onboardedMarkerPath", () => {
+    it("returns false when the marker is absent", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        expect(isOnboarded(home)).toBe(false);
+    });
+    it("returns true once the marker file exists", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        const path = onboardedMarkerPath(home);
+        mkdirSync(join(home, ".gg"), { recursive: true });
+        writeFileSync(path, "2026-04-30T00:00:00.000Z\n", "utf8");
+        expect(isOnboarded(home)).toBe(true);
+    });
+    it("returns false when the marker path exists but isn't a regular file", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        // Create a directory at the marker path instead of a file.
+        mkdirSync(onboardedMarkerPath(home), { recursive: true });
+        expect(isOnboarded(home)).toBe(false);
+    });
+    it("auth check sees a present auth.json under the synthetic home", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        mkdirSync(join(home, ".gg"), { recursive: true });
+        writeFileSync(join(home, ".gg", "auth.json"), "{}", "utf8");
+        const r = runDoctor(home);
+        const auth = r.checks.find((c) => c.id === "auth");
+        expect(auth.status).toBe("ok");
+        expect(auth.detail).toContain("auth.json");
+    });
+    it("auth check reports missing on a fresh home", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        const r = runDoctor(home);
+        const auth = r.checks.find((c) => c.id === "auth");
+        expect(auth.status).toBe("missing");
+        expect(auth.fix).toContain("ggeditor login");
+    });
+});
+describe("doctor severity / status invariants", () => {
+    it("OPENAI_API_KEY status follows the env var", () => {
+        const prev = process.env.OPENAI_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        try {
+            const r = runDoctor();
+            const k = r.checks.find((c) => c.id === "openai-key");
+            expect(k.status).toBe("missing");
+            expect(k.severity).toBe("optional");
+            expect(k.fix).toContain("OPENAI_API_KEY");
+        }
+        finally {
+            if (prev !== undefined)
+                process.env.OPENAI_API_KEY = prev;
+        }
+        process.env.OPENAI_API_KEY = "test-fake-key";
+        try {
+            const r = runDoctor();
+            const k = r.checks.find((c) => c.id === "openai-key");
+            expect(k.status).toBe("ok");
+            expect(k.fix).toBeUndefined();
+        }
+        finally {
+            if (prev === undefined)
+                delete process.env.OPENAI_API_KEY;
+            else
+                process.env.OPENAI_API_KEY = prev;
+        }
+    });
+    it("ANTHROPIC_API_KEY check is informational (never blocks)", () => {
+        const r = runDoctor();
+        const k = r.checks.find((c) => c.id === "anthropic-key");
+        expect(k.severity).toBe("info");
+    });
+    it("ffmpeg / ffprobe checks are required", () => {
+        const r = runDoctor();
+        const ff = r.checks.find((c) => c.id === "ffmpeg");
+        const fp = r.checks.find((c) => c.id === "ffprobe");
+        expect(ff.severity).toBe("required");
+        expect(fp.severity).toBe("required");
+    });
+    it("host probes (resolve/premiere) are optional", () => {
+        const r = runDoctor();
+        expect(r.checks.find((c) => c.id === "resolve").severity).toBe("optional");
+        expect(r.checks.find((c) => c.id === "premiere").severity).toBe("optional");
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

package/dist/core/doctor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.js","sourceRoot":"","sources":["../../src/core/doctor.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,6 +6,11 @@ export { createLazyHost } from "./core/hosts/lazy.js";
 export type { LazyHost, LazyHostOptions } from "./core/hosts/lazy.js";
 export { checkFfmpeg, checkFfprobe, probeMedia, runFfmpeg } from "./core/media/ffmpeg.js";
 export type { FfmpegResult, MediaProbe } from "./core/media/ffmpeg.js";
+export { isOnboarded, onboardedMarkerPath, runDoctor } from "./core/doctor.js";
+export type { CheckSeverity, CheckStatus, DoctorCheck, DoctorReport, InstallableHint, } from "./core/doctor.js";
+export { renderDoctorReport } from "./core/doctor-render.js";
+export { runDoctorInteractive } from "./core/doctor-runner.js";
+export type { DoctorRunOptions } from "./core/doctor-runner.js";
 export { buildEditorSystemPrompt, buildEditorStaticBody, buildEditorHostBlock, spliceHostBlock, } from "./system-prompt.js";
 export type { StaticPromptOptions } from "./system-prompt.js";
 export { AuthStorage, AUTH_FILE, NotLoggedInError, generatePKCE, loginAnthropic, loginOpenAI, refreshAnthropicToken, refreshOpenAIToken, runLogin, runLogout, runStatus, } from "./core/auth/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -5,6 +5,10 @@ export { createHost, detectHost, HostUnreachableError, HostUnsupportedError, Non
 export { createLazyHost } from "./core/hosts/lazy.js";
 // Media
 export { checkFfmpeg, checkFfprobe, probeMedia, runFfmpeg } from "./core/media/ffmpeg.js";
+// Doctor / first-run onboarding
+export { isOnboarded, onboardedMarkerPath, runDoctor } from "./core/doctor.js";
+export { renderDoctorReport } from "./core/doctor-render.js";
+export { runDoctorInteractive } from "./core/doctor-runner.js";
 // System prompt
 export { buildEditorSystemPrompt, buildEditorStaticBody, buildEditorHostBlock, spliceHostBlock, } from "./system-prompt.js";
 // Auth (shared with ggcoder via ~/.gg/auth.json)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,QAAQ;AACR,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG1F,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,iDAAiD;AACjD,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,QAAQ;AACR,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG1F,gCAAgC;AAChC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQ/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,iDAAiD;AACjD,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC"}