import path from "node:path";

import { readConfigFileSnapshot, recoverConfigFromJsonRootSuffix } from "../config/io.js";

import { formatConfigIssueLines } from "../config/issue-format.js";

import { findLegacyConfigIssues } from "../config/legacy.js";

import type { LegacyConfigIssue } from "../config/types.js";

import type { OpenClawConfig } from "../config/types.openclaw.js";

import {

collectRelevantDoctorPluginIds,

listPluginDoctorLegacyConfigRules,

} from "../plugins/doctor-contract-registry.js";

import { note } from "../terminal/note.js";

import { resolveHomeDir } from "../utils.js";

import { noteIncludeConfinementWarning } from "./doctor-config-analysis.js";

baseConfig: OpenClawConfig;

};

function collectDoctorLegacyIssues(

snapshot: Awaited<ReturnType<typeof readConfigFileSnapshot>>,

): LegacyConfigIssue[] {

if (!snapshot.exists) {

return [];

}

const resolvedRaw = snapshot.sourceConfig ?? snapshot.config ?? {};

const sourceRaw = snapshot.parsed ?? resolvedRaw;

return findLegacyConfigIssues(

resolvedRaw,

sourceRaw,

listPluginDoctorLegacyConfigRules({

pluginIds: collectRelevantDoctorPluginIds(resolvedRaw),

}),

);

}

function addDoctorLegacyIssues(

snapshot: Awaited<ReturnType<typeof readConfigFileSnapshot>>,

): Awaited<ReturnType<typeof readConfigFileSnapshot>> {

const legacyIssues = collectDoctorLegacyIssues(snapshot);

if (legacyIssues.length === 0) {

return snapshot;

}

return { ...snapshot, legacyIssues };

}

export async function runDoctorConfigPreflight(

options: {

migrateState?: boolean;

}

}

let snapshot = await readConfigFileSnapshot();

let snapshot = addDoctorLegacyIssues(await readConfigFileSnapshot());

if (

options.repairPrefixedConfig === true &&

snapshot.exists &&

!snapshot.valid &&

(await recoverConfigFromJsonRootSuffix(snapshot))

) {

note("Removed non-JSON prefix from openclaw.json; original saved as .clobbered.*.", "Config");

snapshot = await readConfigFileSnapshot();

snapshot = addDoctorLegacyIssues(await readConfigFileSnapshot());

}

const invalidConfigNote =

options.invalidConfigNote ?? "Config invalid; doctor will run with best-effort config.";