const normalizeStateDirEnv = vi.fn((_env?: NodeJS.ProcessEnv) => undefined);

const pinConfigDir = vi.fn((_env?: NodeJS.ProcessEnv) => undefined);

const pinRuntimePaths = vi.fn((_env?: NodeJS.ProcessEnv) => undefined);

const loadGlobalRuntimeDotEnvFiles = vi.fn((_opts?: unknown) => undefined);

type RuntimeDotEnvLoadResult = {

gatewayEnvAppliedKeys: string[];

stateEnvAppliedKeys: string[];

};

const loadGlobalRuntimeDotEnvFiles = vi.fn<

(_opts?: unknown) => RuntimeDotEnvLoadResult | undefined

>(() => undefined);

const beforeRun = vi.fn(async () => {

callOrder.push("bootstrap");

});

const setVerboseMock = vi.fn();

const emitCliBannerMock = vi.fn();

const ensureConfigReadyMock = vi.fn(async () => {});

type EnsureConfigReadyOptions = {

beforeStateMigrations?: () => Promise<boolean>;

commandPath?: string[];

requireConfig?: boolean;

};

const ensureConfigReadyMock = vi.fn<(_opts: EnsureConfigReadyOptions) => Promise<void>>(

async () => {},

);

const ensurePluginRegistryLoadedMock = vi.fn();

const routeLogsToStderrMock = vi.fn();

const prepareGatewayRunBootstrapMock = vi.fn(async () => true);

vi.fn<(options?: unknown) => Promise<void>>(async () => {}),

);

const commanderParseAsyncMock = vi.hoisted(() => vi.fn(async () => {}));

const addGatewayRunCommandMock = vi.hoisted(() => vi.fn((command: unknown) => command));

const ensureCliExecutionBootstrapMock = vi.hoisted(() => vi.fn(async () => {}));

type GatewayRunCommandHooks = {

beforeRun?: (opts: { reset?: boolean }) => Promise<void>;

};

type CliExecutionBootstrapOptions = {

beforeStateMigrations?: () => Promise<boolean>;

};

const addGatewayRunCommandMock = vi.hoisted(() =>

vi.fn<(command: unknown, hooks?: GatewayRunCommandHooks) => unknown>((command) => command),

);

const ensureCliExecutionBootstrapMock = vi.hoisted(() =>

vi.fn<(_opts: CliExecutionBootstrapOptions) => Promise<void>>(async () => {}),

);

const emitCliBannerMock = vi.hoisted(() => vi.fn());

const enableConsoleCaptureMock = vi.hoisted(() => vi.fn());

const progressDoneMock = vi.hoisted(() => vi.fn());

});

it("runs the startup guard immediately before the first state mutation", async () => {

const beforeStateMigrations = vi.fn(async () => true);

const beforeStateMigrations = vi.fn<(_snapshot?: unknown) => Promise<boolean>>(

async () => true,

);

await runDoctorConfigPreflight({

migrateLegacyConfig: false,

exec: (() =>

Buffer.from(

"OPENAI_API_KEY=openai-shell\0ANTHROPIC_API_KEY=anthropic-shell\0",

)) as Parameters<typeof loadShellEnvFallback>[0]["exec"],

)) as unknown as Parameters<typeof loadShellEnvFallback>[0]["exec"],

});

clearShellEnvAppliedKeys(["OPENAI_API_KEY"]);