Files
reverse-engineering-anything/tests/acceptance/dwarfUnitsCli.test.ts
T
Matt Van Hornandgensokyo-dev 637e4cb60c feat(native): inspect DWARF compile units offline
Add bounded offline DWARF compilation-unit inspection with source provenance, explicit coverage, caller-selected controls and shared ELF compression framing.

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

87 lines
2.8 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 {
elfDebugImage,
elfImage,
macho64,
namedUnit,
} from "../../src/native/dwarf/DwarfUnits.fixture.js";
import {
CPU_ARM64,
CPU_X86_64,
universalMacho,
} from "../fixtures/universalMacho.js";
import { createTestTempDirectory } from "../fixtures/temporaryDirectory.js";
import { cliTest } from "../support/cli/cliFixture.js";
const dwarfUnitsContract = contractNamed(
BINARY_DIAGNOSTICS_TOOL_CONTRACTS,
"inspect_dwarf_units",
);
cliTest("reports a compile unit through the public CLI", async ({ cli }) => {
const root = await createTestTempDirectory("rea-dwarf-units-cli-");
const path = join(root, "program");
await writeFile(path, elfDebugImage(namedUnit({ name: "main.c" })));
const result = await cli.run({
arguments: ["inspect-dwarf-units", path, "--json"],
});
expect(result.exitCode, result.stderr).toBe(0);
const evidence = dwarfUnitsContract.outputSchema.parse(result.json);
expect(evidence.normalized_result.units[0]?.name).toEqual({
state: "present",
value: "main.c",
});
expect(evidence.normalized_result.coverage.status).toBe("complete");
expect(evidence.parameters).toEqual({ path });
expect(evidence.subject?.identity).toMatchObject({ format: "elf" });
});
cliTest(
"resolves a relative path against the working directory",
async ({ cli }) => {
const root = await createTestTempDirectory("rea-dwarf-units-cli-rel-");
await writeFile(join(root, "plain"), elfImage());
const result = await cli.run({
arguments: ["inspect-dwarf-units", "plain", "--json"],
cwd: root,
});
expect(result.exitCode, result.stderr).toBe(0);
const evidence = dwarfUnitsContract.outputSchema.parse(result.json);
expect(evidence.normalized_result.debug_info).toBe("absent");
expect(evidence.subject?.local_path).toBe(join(root, "plain"));
},
);
cliTest("requires an architecture for a universal Mach-O", async ({ cli }) => {
const root = await createTestTempDirectory("rea-dwarf-units-cli-fat-");
const path = join(root, "universal");
await writeFile(
path,
universalMacho([
{
bytes: macho64({ cpuType: CPU_X86_64 }),
cpuType: CPU_X86_64,
cpuSubtype: 0,
},
{
bytes: macho64({ cpuType: CPU_ARM64 }),
cpuType: CPU_ARM64,
cpuSubtype: 0,
},
]).bytes,
);
const result = await cli.run({
arguments: ["inspect-dwarf-units", path, "--json"],
});
expect(result.exitCode).toBe(1);
expect(result.json).toMatchObject({
code: "invalid_request",
details: { operation: "inspect_dwarf_units" },
});
});