opencandle 0.7.0 → 0.8.0

package/dist/doctor/cli-command.js

@@ -0,0 +1,69 @@
+import { AuthStorage, ModelRegistry, SettingsManager } from "@earendil-works/pi-coding-agent";
+import { getProvider } from "../onboarding/providers.js";
+import { clearProviderOnboardingEntry, loadOnboardingState, saveOnboardingState, } from "../onboarding/state.js";
+import { renderDoctorReport } from "./render.js";
+import { buildDoctorReport } from "./report.js";
+export async function handleDoctorCommand(args, cwd, agentDir) {
+    if (args[0] !== "doctor")
+        return false;
+    const json = args.includes("--json");
+    const enableFlag = args.findIndex((arg) => arg === "--enable" || arg === "--reenable");
+    if (enableFlag >= 0) {
+        const providerId = args[enableFlag + 1];
+        if (!providerId) {
+            console.error("Usage: opencandle doctor --enable <provider>");
+            process.exitCode = 1;
+            return true;
+        }
+        try {
+            getProvider(providerId);
+        }
+        catch {
+            console.error(`Unknown provider: ${providerId}`);
+            process.exitCode = 1;
+            return true;
+        }
+        saveOnboardingState(clearProviderOnboardingEntry(loadOnboardingState(), providerId));
+        if (!json)
+            console.log(`Re-enabled ${providerId}.`);
+    }
+    const authStorage = AuthStorage.create();
+    const modelRegistry = ModelRegistry.create(authStorage);
+    const settingsManager = SettingsManager.create(cwd, agentDir);
+    const includeSessions = args.includes("--sessions");
+    if (includeSessions) {
+        console.error("Session checks may read browser cookies or trigger platform permission prompts for Reddit and X/Twitter.");
+    }
+    const report = await buildDoctorReport({
+        cwd,
+        agentDir,
+        includeSessions,
+        includeGui: args.includes("--full"),
+        modelSetup: buildCliModelSetupState(modelRegistry, settingsManager),
+    });
+    console.log(json ? JSON.stringify(report, null, 2) : renderDoctorReport(report));
+    return true;
+}
+function buildCliModelSetupState(modelRegistry, settingsManager) {
+    modelRegistry.refresh();
+    const provider = settingsManager.getDefaultProvider();
+    const modelId = settingsManager.getDefaultModel();
+    const activeModel = provider && modelId ? modelRegistry.find(provider, modelId) : undefined;
+    if (activeModel && modelRegistry.hasConfiguredAuth(activeModel)) {
+        return {
+            requirement: "ready",
+            currentModel: `${activeModel.provider}/${activeModel.id}`,
+        };
+    }
+    const availableModels = modelRegistry.getAvailable().map((model) => ({
+        provider: model.provider,
+        id: model.id,
+        label: `${model.provider}/${model.id}`,
+    }));
+    return {
+        requirement: availableModels.length > 0 ? "select_model" : "connect_auth",
+        currentModel: activeModel ? `${activeModel.provider}/${activeModel.id}` : undefined,
+        availableModels,
+    };
+}
+//# sourceMappingURL=cli-command.js.map

package/dist/doctor/cli-command.js.map

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

package/dist/doctor/render.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorReport } from "./report.js";
+export declare function renderDoctorReport(report: DoctorReport): string;

package/dist/doctor/render.js

@@ -0,0 +1,32 @@
+const STATUS_SYMBOLS = {
+    pass: "PASS",
+    warn: "WARN",
+    fail: "FAIL",
+    skip: "SKIP",
+    unknown: "INFO",
+};
+export function renderDoctorReport(report) {
+    const lines = [
+        `OpenCandle health: ${report.status.toUpperCase()}`,
+        report.summary,
+        `Generated: ${report.generatedAt}`,
+        `OC home: ${report.metadata.opencandleHome} (${report.metadata.opencandleHomeSource})`,
+        `CWD: ${report.metadata.cwd}`,
+        "",
+    ];
+    for (const section of report.sections) {
+        lines.push(`${section.label} - ${section.status.toUpperCase()}`);
+        for (const check of section.checks) {
+            lines.push(`  [${STATUS_SYMBOLS[check.status]}] ${check.label}: ${check.summary}`);
+            if (isActionable(check)) {
+                lines.push(`      Fix: ${check.remediation}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+function isActionable(check) {
+    return check.status !== "pass" && Boolean(check.remediation);
+}
+//# sourceMappingURL=render.js.map

package/dist/doctor/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/doctor/render.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAsC;IACxD,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,KAAK,GAAG;QACZ,sBAAsB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE;QACnD,MAAM,CAAC,OAAO;QACd,cAAc,MAAM,CAAC,WAAW,EAAE;QAClC,YAAY,MAAM,CAAC,QAAQ,CAAC,cAAc,KAAK,MAAM,CAAC,QAAQ,CAAC,oBAAoB,GAAG;QACtF,QAAQ,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;QAC7B,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,YAAY,CAAC,KAAkB;IACtC,OAAO,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC/D,CAAC"}

package/dist/doctor/report.d.ts

@@ -0,0 +1,63 @@
+import { type CommandRunner, type ProviderStatus } from "../onboarding/provider-status.js";
+export declare const DOCTOR_REPORT_SCHEMA_VERSION = 1;
+export type DoctorCheckStatus = "pass" | "warn" | "fail" | "skip" | "unknown";
+export type DoctorCapabilityImpact = "core" | "optional";
+export type DoctorOverallStatus = "ready" | "degraded" | "blocked";
+export interface DoctorCheck {
+    readonly id: string;
+    readonly label: string;
+    readonly status: DoctorCheckStatus;
+    readonly capability: DoctorCapabilityImpact;
+    readonly summary: string;
+    readonly remediation?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface DoctorSection {
+    readonly id: string;
+    readonly label: string;
+    readonly status: DoctorOverallStatus;
+    readonly checks: DoctorCheck[];
+}
+export interface DoctorModelSetupState {
+    readonly requirement: "ready" | "select_model" | "connect_auth" | "unknown";
+    readonly currentModel?: string;
+    readonly availableModels?: readonly {
+        provider: string;
+        id: string;
+        label?: string;
+    }[];
+}
+export interface DoctorGuiStatusInput {
+    readonly host: string;
+    readonly port: number;
+    readonly role?: string;
+    readonly reachable?: boolean;
+    readonly healthEndpoint?: string;
+}
+export interface BuildDoctorReportOptions {
+    readonly cwd?: string;
+    readonly agentDir?: string;
+    readonly now?: Date;
+    readonly includeSessions?: boolean;
+    readonly includeGui?: boolean;
+    readonly gui?: DoctorGuiStatusInput;
+    readonly modelSetup?: DoctorModelSetupState;
+    readonly commandRunner?: CommandRunner;
+    readonly fetchImpl?: typeof fetch;
+    readonly providerStatuses?: readonly ProviderStatus[];
+}
+export interface DoctorReport {
+    readonly schemaVersion: number;
+    readonly generatedAt: string;
+    readonly status: DoctorOverallStatus;
+    readonly summary: string;
+    readonly sections: DoctorSection[];
+    readonly metadata: {
+        readonly cwd: string;
+        readonly agentDir?: string;
+        readonly opencandleHome: string;
+        readonly opencandleHomeSource: "default" | "env";
+    };
+}
+export declare function buildDoctorReport(options?: BuildDoctorReportOptions): Promise<DoctorReport>;
+export declare function deriveDoctorStatus(checks: readonly DoctorCheck[]): DoctorOverallStatus;

package/dist/doctor/report.js

@@ -0,0 +1,500 @@
+import { accessSync, constants, existsSync, readFileSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getUnsupportedNodeVersionMessage } from "../infra/node-version.js";
+import { getConfigPath, getOnboardingPath, getOpenCandleHomeDir, getStateDbPath, resolveOpenCandlePath, } from "../infra/opencandle-paths.js";
+import { probeAllProviderStatuses, probeProviderStatus, } from "../onboarding/provider-status.js";
+import { getProvider, isExternalToolProvider, listAllProviders, } from "../onboarding/providers.js";
+export const DOCTOR_REPORT_SCHEMA_VERSION = 1;
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const require = createRequire(import.meta.url);
+export async function buildDoctorReport(options = {}) {
+    const now = options.now ?? new Date();
+    const cwd = options.cwd ?? process.cwd();
+    const home = getOpenCandleHomeDir();
+    const runtimeChecks = buildRuntimeChecks(cwd);
+    const stateChecks = buildStateChecks(home, options.agentDir);
+    const providerChecks = stateChecks.some((check) => check.id === "state.config" && check.status === "fail")
+        ? [providerChecksSkippedForInvalidConfig()]
+        : await buildProviderChecks(options);
+    const sections = [
+        section("runtime", "Runtime", runtimeChecks),
+        section("state", "Local state", stateChecks),
+        section("model", "Model", [buildModelCheck(options.modelSetup)]),
+        section("providers", "Providers", providerChecks),
+    ];
+    if (options.includeGui || options.gui) {
+        sections.push(section("gui", "GUI", await buildGuiChecks(options)));
+    }
+    const allChecks = sections.flatMap((candidate) => candidate.checks);
+    const status = deriveDoctorStatus(allChecks);
+    return {
+        schemaVersion: DOCTOR_REPORT_SCHEMA_VERSION,
+        generatedAt: now.toISOString(),
+        status,
+        summary: buildSummary(status, allChecks),
+        sections,
+        metadata: {
+            cwd,
+            agentDir: options.agentDir,
+            opencandleHome: home,
+            opencandleHomeSource: process.env.OPENCANDLE_HOME ? "env" : "default",
+        },
+    };
+}
+export function deriveDoctorStatus(checks) {
+    if (checks.some((candidate) => candidate.capability === "core" && candidate.status === "fail")) {
+        return "blocked";
+    }
+    if (checks.some((candidate) => candidate.status === "warn" ||
+        candidate.status === "unknown" ||
+        (candidate.capability === "optional" && candidate.status === "fail"))) {
+        return "degraded";
+    }
+    return "ready";
+}
+function section(id, label, checks) {
+    return {
+        id,
+        label,
+        status: deriveDoctorStatus(checks),
+        checks,
+    };
+}
+function buildRuntimeChecks(cwd) {
+    const packageJson = readPackageJson();
+    const nodeMessage = getUnsupportedNodeVersionMessage();
+    const sqliteLoads = canLoadBetterSqlite();
+    return [
+        {
+            id: "runtime.opencandle_version",
+            label: "OpenCandle version",
+            status: "pass",
+            capability: "core",
+            summary: packageJson.version ? `OpenCandle ${packageJson.version}` : "Version unavailable",
+            metadata: { version: packageJson.version ?? null },
+        },
+        {
+            id: "runtime.node",
+            label: "Node.js",
+            status: nodeMessage ? "fail" : "pass",
+            capability: "core",
+            summary: nodeMessage
+                ? `Unsupported Node ${process.versions.node}`
+                : `Node ${process.version}`,
+            remediation: nodeMessage ?? undefined,
+            metadata: { version: process.versions.node, supportedRange: packageJson.engines?.node },
+        },
+        {
+            id: "runtime.better_sqlite3",
+            label: "better-sqlite3",
+            status: sqliteLoads ? "pass" : "fail",
+            capability: "core",
+            summary: sqliteLoads ? "Native SQLite binding loads" : "Native SQLite binding failed to load",
+            remediation: sqliteLoads
+                ? undefined
+                : "Run `npm rebuild better-sqlite3` or reinstall dependencies under the active Node with `npm install`.",
+        },
+        {
+            id: "runtime.cwd",
+            label: "Working directory",
+            status: "pass",
+            capability: "core",
+            summary: cwd,
+            metadata: { cwd },
+        },
+    ];
+}
+function buildStateChecks(home, agentDir) {
+    return [
+        {
+            id: "state.opencandle_home",
+            label: "OpenCandle home",
+            status: directoryUsable(home) ? "pass" : existsSync(home) ? "warn" : "skip",
+            capability: "core",
+            summary: `${home} (${process.env.OPENCANDLE_HOME ? "environment override" : "default"})`,
+            remediation: existsSync(home)
+                ? "Ensure the OpenCandle home directory is readable and writable."
+                : "OpenCandle will create this directory when state is first written.",
+            metadata: { path: home, source: process.env.OPENCANDLE_HOME ? "env" : "default" },
+        },
+        piAgentDirCheck(agentDir),
+        configCheck(),
+        fileStateCheck("state.onboarding", "Onboarding state", getOnboardingPath()),
+        fileStateCheck("state.sqlite", "State database", getStateDbPath()),
+        fileStateCheck("state.sentiment", "Sentiment history store", resolveOpenCandlePath("sentinel.db")),
+    ];
+}
+function configCheck() {
+    const path = getConfigPath();
+    if (!existsSync(path)) {
+        return {
+            id: "state.config",
+            label: "Config file",
+            status: "skip",
+            capability: "core",
+            summary: "No config file yet",
+            remediation: "No action required. OpenCandle will create config.json when settings are saved.",
+            metadata: { path },
+        };
+    }
+    try {
+        JSON.parse(readFileSync(path, "utf-8"));
+        return {
+            id: "state.config",
+            label: "Config file",
+            status: "pass",
+            capability: "core",
+            summary: "config.json parses",
+            metadata: { path },
+        };
+    }
+    catch (error) {
+        return {
+            id: "state.config",
+            label: "Config file",
+            status: "fail",
+            capability: "core",
+            summary: "config.json is invalid JSON",
+            remediation: `Repair or remove ${path}. ${error instanceof Error ? error.message : String(error)}`,
+            metadata: { path },
+        };
+    }
+}
+function piAgentDirCheck(agentDir) {
+    if (!agentDir) {
+        return {
+            id: "state.pi_agent_dir",
+            label: "Pi agent directory",
+            status: "unknown",
+            capability: "core",
+            summary: "Pi agent directory was not checked",
+            remediation: "Run doctor from an initialized OpenCandle CLI or GUI session.",
+        };
+    }
+    return {
+        id: "state.pi_agent_dir",
+        label: "Pi agent directory",
+        status: directoryUsable(agentDir) ? "pass" : existsSync(agentDir) ? "warn" : "skip",
+        capability: "core",
+        summary: agentDir,
+        remediation: existsSync(agentDir)
+            ? "Ensure the Pi agent directory is readable and writable."
+            : "Pi will create this directory when model/auth state is first written.",
+        metadata: { path: agentDir },
+    };
+}
+function fileStateCheck(id, label, path) {
+    if (!existsSync(path)) {
+        return {
+            id,
+            label,
+            status: "skip",
+            capability: "core",
+            summary: "Not created yet",
+            remediation: "No action required for a new install.",
+            metadata: { path },
+        };
+    }
+    return {
+        id,
+        label,
+        status: canAccess(path) ? "pass" : "warn",
+        capability: "core",
+        summary: canAccess(path) ? "Readable and writable" : "Access may be limited",
+        remediation: canAccess(path) ? undefined : `Ensure ${path} is readable and writable.`,
+        metadata: { path },
+    };
+}
+function buildModelCheck(modelSetup) {
+    const state = modelSetup ?? { requirement: "unknown" };
+    if (state.requirement === "ready") {
+        return {
+            id: "model.readiness",
+            label: "Model readiness",
+            status: "pass",
+            capability: "core",
+            summary: state.currentModel ? `Ready with ${state.currentModel}` : "Model is ready",
+            metadata: { currentModel: state.currentModel ?? null },
+        };
+    }
+    if (state.requirement === "select_model") {
+        return {
+            id: "model.readiness",
+            label: "Model readiness",
+            status: "fail",
+            capability: "core",
+            summary: "Model credentials exist but no active model is selected",
+            remediation: "Run `/setup` in the CLI or choose an available model in the GUI model setup panel.",
+            metadata: { requirement: state.requirement, availableModels: state.availableModels ?? [] },
+        };
+    }
+    if (state.requirement === "connect_auth") {
+        return {
+            id: "model.readiness",
+            label: "Model readiness",
+            status: "fail",
+            capability: "core",
+            summary: "No usable model credentials are configured",
+            remediation: "Run `/setup` in the CLI or paste a model API key in the GUI model setup panel.",
+            metadata: { requirement: state.requirement },
+        };
+    }
+    return {
+        id: "model.readiness",
+        label: "Model readiness",
+        status: "unknown",
+        capability: "core",
+        summary: "Model readiness was not checked",
+        remediation: "Run the doctor command from an initialized OpenCandle session for model setup state.",
+        metadata: { requirement: "unknown" },
+    };
+}
+async function buildProviderChecks(options) {
+    const providers = listAllProviders();
+    const statuses = options.providerStatuses ??
+        (await probeAllProviderStatuses({
+            commandRunner: options.commandRunner,
+            fetchImpl: options.fetchImpl,
+            force: true,
+            respectSkipped: true,
+        }));
+    const checks = statuses.map((status) => providerStatusCheck(status));
+    for (const provider of providers.filter(isExternalToolProvider)) {
+        const installStatus = statuses.find((status) => status.providerId === provider.id && status.kind === "external-tool");
+        if (installStatus?.state === "skipped")
+            continue;
+        if (installStatus?.state !== "installed")
+            continue;
+        if (options.includeSessions) {
+            const status = await probeProviderStatus(provider.id, {
+                mode: "session",
+                force: true,
+                respectSkipped: true,
+                commandRunner: options.commandRunner,
+            });
+            checks.push(providerStatusCheck(status, "session"));
+        }
+        else {
+            checks.push(sessionNotCheckedCheck(provider));
+        }
+    }
+    return checks;
+}
+function providerChecksSkippedForInvalidConfig() {
+    return {
+        id: "providers.config_blocked",
+        label: "Provider checks",
+        status: "skip",
+        capability: "optional",
+        summary: "Skipped because config.json is invalid",
+        remediation: "Repair the config file, then rerun doctor to check provider readiness.",
+    };
+}
+function providerStatusCheck(status, modeOverride) {
+    const provider = getProvider(status.providerId);
+    const capability = provider.tier === "hard" ? "core" : "optional";
+    const metadata = {
+        providerId: status.providerId,
+        category: provider.category,
+        tier: provider.tier,
+        kind: status.kind,
+        state: status.state,
+    };
+    if (status.kind === "api-key") {
+        return {
+            id: `provider.${status.providerId}.credential`,
+            label: provider.displayName,
+            status: status.state === "configured" ? "pass" : "warn",
+            capability,
+            summary: status.state === "configured"
+                ? `Configured via ${status.credentialSource}`
+                : "Credential is missing",
+            remediation: status.state === "configured"
+                ? undefined
+                : `${provider.instructionsHint}. Run /connect ${provider.id}.`,
+            metadata: { ...metadata, credentialSource: status.credentialSource },
+        };
+    }
+    if (status.kind === "public-http") {
+        const ok = status.state === "reachable";
+        return {
+            id: `provider.${status.providerId}.reachability`,
+            label: provider.displayName,
+            status: ok ? "pass" : "fail",
+            capability,
+            summary: ok ? "Reachable" : `Not reachable (${status.state})`,
+            remediation: ok
+                ? undefined
+                : "Check network connectivity and retry. Core quote and market-data workflows depend on Yahoo Finance reachability.",
+            metadata: { ...metadata, statusCode: status.statusCode ?? null },
+        };
+    }
+    if (modeOverride === "session" || status.mode === "session") {
+        const ok = status.state === "session_ok";
+        return {
+            id: `provider.${status.providerId}.session`,
+            label: `${provider.displayName} browser session`,
+            status: ok ? "pass" : "warn",
+            capability: "optional",
+            summary: ok ? "Browser session is usable" : (status.message ?? `Session ${status.state}`),
+            remediation: ok ? undefined : sessionRemediation(status.providerId, status.installCmd),
+            metadata,
+        };
+    }
+    const installed = status.state === "installed";
+    return {
+        id: `provider.${status.providerId}.binary`,
+        label: `${provider.displayName} CLI`,
+        status: installed
+            ? "pass"
+            : status.state === "skipped"
+                ? "skip"
+                : status.state === "missing"
+                    ? "warn"
+                    : "unknown",
+        capability: "optional",
+        summary: installed ? "Installed" : (status.message ?? `CLI ${status.state}`),
+        remediation: installed
+            ? undefined
+            : status.state === "skipped"
+                ? `Run \`opencandle doctor --enable ${status.providerId}\` to re-enable this provider.`
+                : status.installCmd,
+        metadata,
+    };
+}
+function sessionNotCheckedCheck(provider) {
+    return {
+        id: `provider.${provider.id}.session`,
+        label: `${provider.displayName} browser session`,
+        status: "unknown",
+        capability: "optional",
+        summary: "Not checked",
+        remediation: "Run `opencandle doctor --sessions` to check browser-cookie session readiness.",
+        metadata: { providerId: provider.id, category: provider.category, tier: provider.tier },
+    };
+}
+async function buildGuiChecks(options) {
+    if (options.gui?.reachable !== undefined || options.gui?.role) {
+        const role = options.gui.role ?? "unknown";
+        const reachable = options.gui.reachable ?? true;
+        return [
+            {
+                id: "gui.server",
+                label: "GUI server",
+                status: reachable ? (role === "follower" ? "warn" : "pass") : "skip",
+                capability: "optional",
+                summary: reachable ? `GUI server is ${role}` : "GUI server is not running",
+                remediation: role === "follower"
+                    ? "Open the writer GUI process to perform setup mutations."
+                    : reachable
+                        ? undefined
+                        : "Run `opencandle gui` to start the browser workbench.",
+                metadata: { ...options.gui },
+            },
+        ];
+    }
+    const host = options.gui?.host ?? process.env.OPENCANDLE_GUI_HOST ?? "127.0.0.1";
+    const port = options.gui?.port ?? Number(process.env.OPENCANDLE_GUI_PORT ?? 14567);
+    const endpoint = options.gui?.healthEndpoint ?? `http://${host}:${port}/health`;
+    try {
+        const response = await (options.fetchImpl ?? fetch)(endpoint, {
+            signal: AbortSignal.timeout(1_500),
+        });
+        const body = await response.json().catch(() => null);
+        const role = isRecord(body) && typeof body.role === "string" ? body.role : "unknown";
+        const verified = response.ok &&
+            isRecord(body) &&
+            body.ok === true &&
+            (role === "writer" || role === "follower");
+        return [
+            {
+                id: "gui.server",
+                label: "GUI server",
+                status: verified ? (role === "follower" ? "warn" : "pass") : "warn",
+                capability: "optional",
+                summary: verified
+                    ? `GUI server is ${role}`
+                    : response.ok
+                        ? "OpenCandle GUI health payload was not verified"
+                        : `GUI health returned HTTP ${response.status}`,
+                remediation: verified && role === "follower"
+                    ? "Open the writer GUI process to perform setup mutations."
+                    : undefined,
+                metadata: { host, port, role, endpoint, statusCode: response.status },
+            },
+        ];
+    }
+    catch {
+        return [
+            {
+                id: "gui.server",
+                label: "GUI server",
+                status: "skip",
+                capability: "optional",
+                summary: "GUI server is not running",
+                remediation: "Run `opencandle gui` to start the browser workbench.",
+                metadata: { host, port, endpoint },
+            },
+        ];
+    }
+}
+function sessionRemediation(providerId, installCmd) {
+    if (providerId === "reddit")
+        return "Run `rdt login` and retry `opencandle doctor --sessions`.";
+    if (providerId === "twitter") {
+        return "Stay logged into x.com in a supported browser and retry `opencandle doctor --sessions`.";
+    }
+    return installCmd ?? "Install and authenticate the external tool.";
+}
+function buildSummary(status, checks) {
+    if (status === "ready")
+        return "OpenCandle core health is ready.";
+    const firstBlocking = checks.find((candidate) => candidate.capability === "core" && candidate.status === "fail");
+    if (firstBlocking)
+        return `OpenCandle is blocked: ${firstBlocking.summary}.`;
+    const issueCount = checks.filter((candidate) => ["warn", "fail", "unknown"].includes(candidate.status)).length;
+    return `OpenCandle is usable with ${issueCount} degraded or unchecked ${issueCount === 1 ? "capability" : "capabilities"}.`;
+}
+function readPackageJson() {
+    try {
+        return JSON.parse(readFileSync(resolve(PACKAGE_ROOT, "package.json"), "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function canLoadBetterSqlite() {
+    try {
+        const Database = require("better-sqlite3");
+        const db = new Database(":memory:");
+        db.close();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function directoryUsable(path) {
+    try {
+        return (statSync(path).isDirectory() &&
+            canAccess(path, constants.R_OK | constants.W_OK | constants.X_OK));
+    }
+    catch {
+        return false;
+    }
+}
+function canAccess(path, mode = constants.R_OK | constants.W_OK) {
+    try {
+        accessSync(path, mode);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=report.js.map