Files
reverse-engineering-anything/src/cli/cliLoader.ts
T
morluto 5257a3d912 refactor(cli): read global arguments once with one REA owner (#11687)
parseCliGlobalArguments replaces normalizeCliArguments, splitIncurBuiltinArguments and splitCliTimingArguments: it normalizes spaced output forms, routes the root --update alias, splits builtin switches and output values, and reads the timing global in one pass. The output-argument reader, the launcher's doctor path, lazy registration, the Amp scope guard, completions, mcp add, strict positionals and sensitive-value redaction read that record instead of scanning argv again. Only the incur hand-off adapter remains until dispatch moves to REA. Output is unchanged; the CLI parity goldens pass as recorded.
2026-11-16 12:23:51 +08:00

101 lines
3.6 KiB
TypeScript

import type { CliGlobalArguments } from "../cliBuiltinArguments.js";
import { RECORDED_CLI_COMMAND_REGISTRATIONS } from "../recordedCliCommandRegistrations.js";
import {
CLI_COMMAND_REGISTRATIONS,
type CliCommandRegistrationId,
} from "./cliCommandRegistrations.js";
import type { CliResultOutput } from "./cliResultOutput.js";
import type { CliInstance } from "./types.js";
/** Global switches that change only how a command's result is written. */
const COMMAND_OUTPUT_FLAGS: ReadonlySet<string> = new Set([
"--json",
"--full-output",
"--token-count",
"--timings",
"--no-timings",
]);
const isRegistrationId = (id: string): id is CliCommandRegistrationId =>
Object.hasOwn(CLI_COMMAND_REGISTRATIONS, id);
/**
* The registrars the command these arguments run needs, or undefined when the
* complete CLI must answer, as it does for shell completion, which has no
* global arguments. A standalone `--version` needs none: Incur answers
* it from the CLI identity alone. Help, schemas, `--llms`, completions, other
* Incur builtins, unknown names ("did you mean"), and a missing or unusable
* recording all describe or search every command.
*/
export const selectCliRegistrations = (
global: CliGlobalArguments | undefined,
recorded: Readonly<Record<string, string>> | undefined,
): readonly CliCommandRegistrationId[] | undefined => {
if (global === undefined) return undefined;
const { command, flags } = global;
if (command.length === 0 && flags.size === 1 && flags.has("--version"))
return [];
if (recorded === undefined) return undefined;
for (const flag of flags)
if (!COMMAND_OUTPUT_FLAGS.has(flag) && !flag.startsWith("--timings="))
return undefined;
const name = command[0];
if (name === undefined || !Object.hasOwn(recorded, name)) return undefined;
const id = recorded[name]!;
return isRegistrationId(id) ? [id] : undefined;
};
/** The command runtime one invocation loaded, before its CLI is built. */
export interface CliRuntime {
createCli(resultOutput: CliResultOutput | undefined): CliInstance;
/** Closes the process-owned resources of this runtime's commands. */
closeCliResources(): Promise<void>;
}
/**
* Load the command runtime for one invocation. A recorded top-level command
* loads only its registrar's module graph, a standalone version query loads
* none, and anything else loads the complete CLI.
*/
export const loadCliRuntime = async (
global: CliGlobalArguments | undefined,
environment: NodeJS.ProcessEnv,
): Promise<CliRuntime> => {
const ids = selectCliRegistrations(
global,
RECORDED_CLI_COMMAND_REGISTRATIONS,
);
if (ids === undefined) {
const { createCli, closeCliResources } = await import("../cli.js");
return {
createCli: (resultOutput) => createCli(environment, resultOutput),
closeCliResources,
};
}
const selected = ids.map((id) => CLI_COMMAND_REGISTRATIONS[id]);
const [modules, { createCliShell }, { closeCliResources }, analysis] =
await Promise.all([
Promise.all(selected.map((registration) => registration.load())),
import("./cliShell.js"),
import("./cliResources.js"),
selected.some((registration) => registration.analysis)
? import("../composition/directAnalysis.js")
: undefined,
]);
return {
createCli: (resultOutput) =>
createCliShell({
selectedEnvironment: environment,
resultOutput,
registrations: selected.map((registration, index) => ({
registration,
module: modules[index],
})),
...(analysis === undefined
? {}
: { createAnalysis: analysis.createDirectAnalysis }),
}),
closeCliResources,
};
};