openclaw/dist/doctor-lint-flow-ImPAIMVU.mjs

Multi-channel AI gateway with extensible messaging integrations

import { t as formatCliCommand } from "./command-format-DwEdrDKL.mjs";
import "./openclaw-state-db-contract-BYv0nUQr.mjs";
import { t as OpenClawStateLeaseAcquisitionError } from "./openclaw-state-lease-error-Ds9BTWol.mjs";
import { r as readStateSchemaContentVersion } from "./openclaw-state-db-schema-version-DZI_59qS.mjs";
import { u as withExistingOpenClawStateDatabaseReadOnly } from "./openclaw-state-db-readonly-ywwvuxdQ.mjs";
import { t as scrubDoctorErrorMessage } from "./doctor-error-message-CBAGGfGW.mjs";
import { r as listHealthChecks } from "./health-check-registry-Lw8LGAUO.mjs";
import { n as healthFindingMeetsSeverity, r as isHealthCheckEnabledByDefault, t as HEALTH_FINDING_SEVERITY_RANK } from "./health-checks-_h8bcnIK.mjs";
//#region src/flows/doctor-lint-flow.ts
const stateSchemaHealthCheck = {
	id: "core/doctor/state-schema",
	kind: "core",
	description: "Shared state migrations require explicit repair.",
	async detect(ctx) {
		const state = withExistingOpenClawStateDatabaseReadOnly(({ db, path }) => ({
			version: readStateSchemaContentVersion(db),
			path
		}), { env: ctx.env });
		if (!state || state.version >= 20) return [];
		const command = formatCliCommand("openclaw doctor --fix", ctx.env);
		return [{
			checkId: "core/doctor/state-schema",
			severity: "warning",
			path: state.path,
			requirement: "state-schema-migration-pending",
			message: `Shared state schema migration pending (${state.version} → 20); run ${command}.`,
			fixHint: `Run \`${command}\` to migrate the shared state database.`
		}];
	}
};
/** Runs selected health checks in lint mode and returns sorted findings. */
async function runDoctorLintChecks(ctx, opts = {}) {
	const all = opts.checks ?? listHealthChecks();
	const skip = opts.skipIds instanceof Set ? opts.skipIds : new Set(opts.skipIds ?? []);
	const only = opts.onlyIds instanceof Set ? opts.onlyIds : new Set(opts.onlyIds ?? []);
	const allIds = new Set(all.map((check) => check.id));
	const includeDefaultDisabled = opts.includeAllChecks === true;
	const selected = all.filter((c) => {
		if (only.size > 0 && !only.has(c.id)) return false;
		if (only.size === 0 && !includeDefaultDisabled && !isHealthCheckEnabledByDefault(c)) return false;
		return !skip.has(c.id);
	});
	const findings = [];
	for (const id of only) {
		let message;
		if (!allIds.has(id)) message = `Unknown health check id selected by --only: ${id}.`;
		else if (selected.length === 0 && skip.has(id)) message = `Health check ${id} cannot be selected by --only and excluded by --skip.`;
		else continue;
		findings.push({
			checkId: "core/doctor/lint-selection",
			severity: "error",
			message,
			path: id
		});
	}
	for (const check of selected) try {
		const out = await check.detect(ctx);
		for (const f of out) findings.push(f);
	} catch (err) {
		const aborted = err instanceof OpenClawStateLeaseAcquisitionError && err.outcome.kind === "aborted" ? err.outcome : void 0;
		findings.push({
			checkId: check.id,
			severity: aborted ? "info" : "error",
			...aborted ? { errorCode: "OPENCLAW_STATE_LEASE_ABORTED" } : {},
			message: aborted ? `state lease inspection not performed: aborted after ${aborted.elapsedMs} ms by the caller's signal` : `health check threw: ${scrubDoctorErrorMessage(err)}`
		});
	}
	findings.sort(compareFindings);
	return {
		findings,
		checksRun: selected.length,
		checksSkipped: all.length - selected.length
	};
}
/** Internal update gate selection; public Doctor lint remains selector-driven. */
function selectUpdateReadinessChecks(checks, phase) {
	return checks.filter((check) => "updateReadiness" in check && check.updateReadiness === phase);
}
function compareFindings(a, b) {
	const sevDelta = HEALTH_FINDING_SEVERITY_RANK[b.severity] - HEALTH_FINDING_SEVERITY_RANK[a.severity];
	if (sevDelta !== 0) return sevDelta;
	const idDelta = a.checkId.localeCompare(b.checkId);
	if (idDelta !== 0) return idDelta;
	return (a.path ?? "").localeCompare(b.path ?? "");
}
/** Converts findings to a process exit code using the requested minimum severity. */
function exitCodeFromFindings(findings, severityMin = "warning") {
	return findings.some((f) => healthFindingMeetsSeverity(f, severityMin)) ? 1 : 0;
}
//#endregion
export { stateSchemaHealthCheck as i, runDoctorLintChecks as n, selectUpdateReadinessChecks as r, exitCodeFromFindings as t };