mirror of
https://github.com/morluto/rea.git
synced 2026-11-03 21:36:13 +00:00
morluto
a4ba8aecd5
Reject omitted segment bounds, procedure classification and body facts, unresolved-call observations, dossier facets, and Ghidra parameter flow metadata. Providers emit explicit nulls for unsupported facets. Verify those unknowns in the real Hopper workflow. BREAKING CHANGE: Provider analysis outputs must explicitly supply metadata previously repaired with defaults; unsupported nullable facets must be reported as null.
82 lines
2.6 KiB
TypeScript
82 lines
2.6 KiB
TypeScript
import { z } from "zod";
|
|
|
|
/** A decompiler p-code varnode location or literal value. */
|
|
export const nativeVarnodeSchema = z.strictObject({
|
|
kind: z.enum(["constant", "address", "register", "unique", "other"]),
|
|
size_bytes: z.number().int().nonnegative(),
|
|
location: z.string().nullable(),
|
|
constant_hex: z
|
|
.string()
|
|
.regex(/^[0-9a-f]+$/u)
|
|
.nullable(),
|
|
});
|
|
|
|
/** One high-p-code operation recovered for a single function. */
|
|
export const nativePcodeOperationSchema = z.strictObject({
|
|
id: z.string().min(1),
|
|
address: z.string().min(1),
|
|
sequence: z.number().int().nonnegative(),
|
|
opcode: z.string().min(1),
|
|
is_dead: z.boolean(),
|
|
block_membership: z.enum(["member", "detached", "unavailable"]),
|
|
inputs: z.array(nativeVarnodeSchema),
|
|
output: nativeVarnodeSchema.nullable(),
|
|
});
|
|
|
|
/** A def-use relation between operations in one recovered HighFunction. */
|
|
export const nativePcodeDefUseSchema = z.strictObject({
|
|
definition: z.string().min(1),
|
|
use: z.string().min(1),
|
|
input_index: z.number().int().nonnegative(),
|
|
});
|
|
|
|
/** Memory and branch operations as directly named by Ghidra p-code. */
|
|
export const nativePcodeEffectSchema = z.strictObject({
|
|
operation: z.string().min(1),
|
|
kind: z.enum([
|
|
"memory_read",
|
|
"memory_write",
|
|
"conditional_branch",
|
|
"indirect_branch",
|
|
"direct_call",
|
|
"indirect_call",
|
|
]),
|
|
operand_input: z.number().int().nonnegative().nullable(),
|
|
value_input: z.number().int().nonnegative().nullable(),
|
|
});
|
|
|
|
/** Bounded data-flow observations; STORE is not necessarily a persistent/global write. */
|
|
export const nativeValueFlowSchema = z.discriminatedUnion("available", [
|
|
z.strictObject({
|
|
available: z.literal(true),
|
|
provenance: z.literal("ghidra-high-pcode"),
|
|
operations: z.array(nativePcodeOperationSchema),
|
|
def_use: z.array(nativePcodeDefUseSchema),
|
|
effects: z.array(nativePcodeEffectSchema),
|
|
parameters: z.array(
|
|
z.strictObject({
|
|
ordinal: z.number().int().nonnegative(),
|
|
name: z.string(),
|
|
data_type: z.string(),
|
|
}),
|
|
),
|
|
parameter_uses: z.array(
|
|
z.strictObject({
|
|
ordinal: z.number().int().nonnegative(),
|
|
use: z.string(),
|
|
input_index: z.number().int().nonnegative(),
|
|
}),
|
|
),
|
|
truncated: z.boolean(),
|
|
omitted_operations_lower_bound: z.number().int().nonnegative(),
|
|
known_omitted_inputs: z.number().int().nonnegative(),
|
|
known_omitted_edges: z.number().int().nonnegative(),
|
|
limitations: z.array(z.string().min(1)),
|
|
}),
|
|
z.strictObject({
|
|
available: z.literal(false),
|
|
reason: z.string().min(1),
|
|
limitations: z.array(z.string().min(1)),
|
|
}),
|
|
]);
|