Files
reverse-engineering-anything/tests/acceptance/elfDependenciesCli.test.ts
T
Matt Van Hornandgensokyo-dev e9c72dbd1f feat(elf): inspect dynamic dependencies and required symbol versions
Add offline ELF dependency, search-path, symbol-version and import inspection with retained Evidence summaries and pages. Bound GNU-hash work and preserve cancellation, stable identity and caller-selected parameters across CLI/MCP.

Assisted-by: Suika (gensokyo-skills:suika-scatter-gather-planning)
Co-authored-by: gensokyo-dev <342580529+gensokyo-dev@users.noreply.github.com>
2026-11-17 08:19:52 +00:00

119 lines
4.2 KiB
TypeScript

import { writeFile } from "node:fs/promises";
import { join } from "node:path";
import { expect } from "vitest";
import { contractNamed } from "../../src/cli/contractCliDescription.js";
import { BINARY_DIAGNOSTICS_TOOL_CONTRACTS } from "../../src/contracts/native/binaryDiagnosticsToolContracts.js";
import { elfDependencyFixture } from "../../src/native/elf/ElfDependencies.fixture.js";
import { createTestTempDirectory } from "../fixtures/temporaryDirectory.js";
import { cliTest } from "../support/cli/cliFixture.js";
const dependenciesContract = contractNamed(
BINARY_DIAGNOSTICS_TOOL_CONTRACTS,
"inspect_elf_dependencies",
);
cliTest(
"reports needed libraries, RUNPATH tokens, and versioned imports through the public CLI",
async ({ cli }) => {
const root = await createTestTempDirectory("rea-elf-dependencies-cli-");
const path = join(root, "program");
await writeFile(path, elfDependencyFixture());
const result = await cli.run({
arguments: ["inspect-elf-dependencies", path, "--json"],
});
expect(result.exitCode, result.stderr).toBe(0);
const evidence = dependenciesContract.outputSchema.parse(result.json);
expect(evidence.parameters).toEqual({ path });
const selected = await cli.run({
arguments: [
"inspect-elf-dependencies",
path,
"--max-needed",
"1024",
"--json",
],
});
expect(selected.exitCode, selected.stderr).toBe(0);
const explicitlySelected = dependenciesContract.outputSchema.parse(
selected.json,
);
expect(explicitlySelected.parameters).toEqual({ path, max_needed: 1024 });
expect(explicitlySelected.evidence_id).not.toBe(evidence.evidence_id);
expect(evidence.normalized_result).toMatchObject({
type_name: "shared",
needed: [
{ name: "libstdc++.so.6" },
{ name: "libm.so.6" },
{ name: "libc.so.6" },
],
dynamic: {
soname: { name: "libdemo.so.1" },
runpath: { raw: "$ORIGIN/../lib", tokens: ["$ORIGIN"] },
},
derived_version_maxima: expect.arrayContaining([
{ namespace: "GLIBC", maximum: "GLIBC_2.34", evidence_kind: "derived" },
]),
coverage: { status: "complete" },
});
expect(
(
evidence.normalized_result as { imports: { name: string | null }[] }
).imports.map((entry) => entry.name),
).toEqual(["printf", "memcpy", "_ZSt4cout", "abort", "_exit"]);
},
);
cliTest(
"resolves a relative ELF path against the working directory",
async ({ cli }) => {
const root = await createTestTempDirectory("rea-elf-dependencies-cli-rel-");
await writeFile(
join(root, "program"),
elfDependencyFixture({ omitDynamic: true, interpreter: null }),
);
const result = await cli.run({
arguments: ["inspect-elf-dependencies", "program", "--json"],
cwd: root,
});
expect(result.exitCode, result.stderr).toBe(0);
const evidence = dependenciesContract.outputSchema.parse(result.json);
expect(evidence.normalized_result).toMatchObject({
dynamic: { status: "absent" },
needed: [],
coverage: { status: "complete" },
});
expect(evidence.subject?.local_path).toBe(join(root, "program"));
expect(evidence.caller_input_path).toBe("program");
},
);
cliTest("reports a non-ELF file as invalid input", async ({ cli }) => {
const root = await createTestTempDirectory("rea-elf-dependencies-cli-bad-");
const path = join(root, "broken");
await writeFile(path, Buffer.from("not an elf"));
const result = await cli.run({
arguments: ["inspect-elf-dependencies", path, "--json"],
});
expect(result.exitCode).toBe(1);
expect(result.json).toMatchObject({
code: "invalid_request",
details: { operation: "inspect_elf_dependencies" },
});
});
cliTest(
"reports a relocatable object as invalid input for this workflow",
async ({ cli }) => {
const root = await createTestTempDirectory(
"rea-elf-dependencies-cli-relobj-",
);
const path = join(root, "module.o");
await writeFile(path, elfDependencyFixture({ type: 1 }));
const result = await cli.run({
arguments: ["inspect-elf-dependencies", path, "--json"],
});
expect(result.exitCode).toBe(1);
expect(JSON.stringify(result.json)).toContain("inspect_kernel_module");
},
);