test(hopper): add semantic runtime conformance

This commit is contained in:
morluto
2026-07-18 04:50:23 +00:00
parent e6cfce3902
commit da1da3bfb8
17 changed files with 1251 additions and 71 deletions
+146
View File
@@ -80,6 +80,151 @@ export const requireFunctionDossier = (
return value;
};
/** Positive semantic facts required from one source-owned Hopper fixture. */
export interface FunctionDossierOracle {
readonly procedure_address: string;
readonly callee_address?: string;
readonly caller_address?: string;
readonly referenced_string?: string;
readonly referenced_name?: string;
readonly comment?: string;
readonly require_cfg_successor?: boolean;
readonly require_assembly?: boolean;
}
/** Reject a structurally valid dossier that omits fixture-proven semantics. */
export const requireFunctionDossierOracle = (
input: unknown,
oracle: FunctionDossierOracle,
): Record<string, unknown> => {
const value = requireFunctionDossier(input, oracle.procedure_address);
if (oracle.callee_address !== undefined) {
const callees = z
.array(identitySchema)
.parse(collectionSchema.parse(value.callees).items);
if (!callees.some(({ address }) => address === oracle.callee_address))
throw new TypeError(
"analyze_function omitted the expected fixture callee",
);
const references = z
.array(
z.object({
source_address: addressSchema,
target_address: addressSchema,
}),
)
.parse(collectionSchema.parse(value.outgoing_references).items);
if (
!references.some(
({ target_address }) => target_address === oracle.callee_address,
)
)
throw new TypeError(
"analyze_function omitted the expected fixture reference",
);
}
if (oracle.caller_address !== undefined) {
const callers = z
.array(identitySchema)
.parse(collectionSchema.parse(value.callers).items);
if (!callers.some(({ address }) => address === oracle.caller_address))
throw new TypeError(
"analyze_function omitted the expected fixture caller",
);
}
if (oracle.referenced_string !== undefined)
requireReferencedValue(
value,
"referenced_strings",
oracle.referenced_string,
(candidate) => candidate,
);
if (oracle.referenced_name !== undefined)
requireReferencedValue(
value,
"referenced_names",
oracle.referenced_name,
(candidate) => candidate.replace(/^_+/u, ""),
);
if (oracle.comment !== undefined) {
const comments = z
.array(
z.object({
address: addressSchema,
kind: z.enum(["comment", "inline"]),
text: z.string(),
}),
)
.parse(collectionSchema.parse(value.comments).items);
if (
!comments.some(
({ address, kind, text }) =>
address === oracle.procedure_address &&
kind === "comment" &&
text === oracle.comment,
)
)
throw new TypeError("analyze_function omitted the verifier comment");
}
if (
oracle.require_assembly === true &&
collectionSchema.parse(value.assembly).items.length === 0
)
throw new TypeError("analyze_function omitted fixture assembly");
if (oracle.require_cfg_successor) {
const blocks = z
.array(z.object({ successors: z.array(addressSchema) }))
.parse(collectionSchema.parse(value.basic_blocks).items);
if (!blocks.some(({ successors }) => successors.length > 0))
throw new TypeError("analyze_function omitted a real CFG successor");
}
return value;
};
const referencedValueSchema = z.object({
address: addressSchema,
value: z.string(),
source_address: addressSchema,
});
const referenceEdgeSchema = z.object({
source_address: addressSchema,
target_address: addressSchema,
});
const requireReferencedValue = (
dossier: Record<string, unknown>,
field: "referenced_strings" | "referenced_names",
expected: string,
normalize: (value: string) => string,
): void => {
const values = z
.array(referencedValueSchema)
.parse(collectionSchema.parse(dossier[field]).items);
const references = z
.array(referenceEdgeSchema)
.parse(collectionSchema.parse(dossier.outgoing_references).items);
const found = values.some(
({ address, value, source_address: sourceAddress }) =>
normalize(value) === expected &&
references.some(
({ source_address, target_address }) =>
source_address === sourceAddress && target_address === address,
),
);
if (!found)
throw new TypeError(
`analyze_function omitted the expected fixture ${field === "referenced_strings" ? "string" : "name"}`,
);
};
/** Require every relationship to be an actual hexadecimal address. */
export const requireAddressArray = (
input: unknown,
@@ -92,6 +237,7 @@ export const requireAddressArray = (
};
const COLLECTION_FIELDS = [
"assembly",
"comments",
"callers",
"callees",