mirror of
https://github.com/morluto/rea
synced 2026-10-28 06:46:47 -04:00
morluto
90 lines
3.0 KiB
TypeScript
90 lines
3.0 KiB
TypeScript
import { z } from "incur";
|
|
|
|
import {
|
|
executableFormatHintSchema,
|
|
type ExecutableFormatHint,
|
|
} from "../domain/dosCom.js";
|
|
import type { BinaryArchitecture } from "../domain/binaryTargetTypes.js";
|
|
import {
|
|
binaryArchitectureSchema,
|
|
rawBinaryEntryPointSchema,
|
|
} from "../domain/rawBinary.js";
|
|
import { analysisProviderSelectorSchema } from "../contracts/providerSelection.js";
|
|
import type { AnalysisProviderSelector } from "../contracts/providerSelection.js";
|
|
import type { Logger } from "pino";
|
|
|
|
/** Parse decimal integer tokens before Number coercion can erase their syntax. */
|
|
export const cliIntegerArgument = (min: number) =>
|
|
z
|
|
.string()
|
|
.regex(/^[0-9]+$/u, "Expected a decimal integer")
|
|
.pipe(z.coerce.number<string>().safe().min(min));
|
|
|
|
export const providerSelectionOption = analysisProviderSelectorSchema
|
|
.optional()
|
|
.describe(
|
|
"Bind deep analysis to a provider ID or use deterministic auto selection",
|
|
);
|
|
|
|
/** Optional path to the local analysis snapshot loaded or updated by a command. */
|
|
export const snapshotSelectionOption = z
|
|
.string()
|
|
.min(1)
|
|
.optional()
|
|
.describe("Load and update a local analysis snapshot");
|
|
|
|
/** Explicit interpretation for headerless native executable formats. */
|
|
export const formatSelectionOption = executableFormatHintSchema
|
|
.optional()
|
|
.describe(
|
|
"Explicit headerless interpretation (dos-com or raw-binary); omission preserves header-based detection",
|
|
);
|
|
|
|
export const architectureSelectionOption = binaryArchitectureSchema
|
|
.optional()
|
|
.describe(
|
|
"Caller-supplied CPU family; required with --target-format raw-binary",
|
|
);
|
|
|
|
export const entryPointSelectionOption = rawBinaryEntryPointSchema
|
|
.optional()
|
|
.describe(
|
|
"Caller-supplied load and entry address (0xhex); required with --target-format raw-binary",
|
|
);
|
|
|
|
/** Shared CLI flags that bind a native target interpretation. */
|
|
export const nativeOpenOptionFields = {
|
|
"target-format": formatSelectionOption,
|
|
architecture: architectureSelectionOption,
|
|
"entry-point": entryPointSelectionOption,
|
|
provider: providerSelectionOption,
|
|
};
|
|
|
|
/** Native CLI flags consumed when opening a target for one-shot analysis. */
|
|
export interface NativeOpenCliFlags {
|
|
readonly snapshot?: string | undefined;
|
|
readonly provider?: AnalysisProviderSelector | undefined;
|
|
readonly "target-format"?: ExecutableFormatHint | undefined;
|
|
readonly architecture?: BinaryArchitecture | undefined;
|
|
readonly "entry-point"?: string | undefined;
|
|
}
|
|
|
|
/** Map native CLI flags onto the shared one-shot analysis options. */
|
|
export const directAnalysisOptionsFromCli = (
|
|
logger: Logger,
|
|
options: NativeOpenCliFlags,
|
|
) => ({
|
|
logger,
|
|
snapshotPath: options.snapshot,
|
|
...(options["target-format"] === undefined
|
|
? {}
|
|
: { formatHint: options["target-format"] }),
|
|
...(options.architecture === undefined
|
|
? {}
|
|
: { architecture: options.architecture }),
|
|
...(options["entry-point"] === undefined
|
|
? {}
|
|
: { entryPoint: options["entry-point"] }),
|
|
...(options.provider === undefined ? {} : { providerId: options.provider }),
|
|
});
|