Files
hermes-agent/apps/desktop/scripts/audit-bundle-arch.test.mjs
alt-glitch 20c519ec48 fix(desktop): the arch audit reads a .NET AnyCPU helper's CLR flags, not its i386 COFF machine
The Windows HUD helper is compiled /platform:anycpu with the in-box csc. IL-only
assemblies carry COFF machine 0x14c, so audit-bundle-arch flagged it as ia32 on
win32-x64 and win32-arm64. The CLR JITs it to the host arch; only
32BITREQUIRED/32BITPREFERRED pin it to x86, and those still fail the audit.
2026-09-23 02:00:32 -04:00

207 lines
11 KiB
JavaScript

import assert from 'node:assert/strict'
import fs from 'node:fs'
import os from 'node:os'
import path from 'node:path'
import { spawnSync } from 'node:child_process'
import { test } from 'vitest'
import { auditTree, archMatches, classifyHeader, findUnpackedDirs, isExemptPath, peArch } from '../scripts/audit-bundle-arch.mjs'
// ─── header builders: the smallest buffers each format needs ───────────────
function elfHeader(machine) {
const buf = Buffer.alloc(64)
buf.write('\x7fELF', 0, 'latin1')
buf.writeUInt16LE(machine, 18)
return buf
}
function machoThin(cputype, { swapped = false } = {}) {
const buf = Buffer.alloc(64)
if (swapped) {
buf.writeUInt32BE(0xcffaedfe, 0) // magic as stored little-endian on disk
buf.writeUInt32LE(cputype, 4)
} else {
buf.writeUInt32BE(0xfeedfacf, 0)
buf.writeUInt32BE(cputype, 4)
}
return buf
}
function machoFat(cputypes) {
const buf = Buffer.alloc(8 + cputypes.length * 20)
buf.writeUInt32BE(0xcafebabe, 0)
buf.writeUInt32BE(cputypes.length, 4)
cputypes.forEach((t, i) => buf.writeUInt32BE(t, 8 + i * 20))
return buf
}
function mzStub(peOffset) {
const buf = Buffer.alloc(0x40)
buf.write('MZ', 0, 'latin1')
buf.writeUInt32LE(peOffset, 0x3c)
return buf
}
// ─── classifyHeader ─────────────────────────────────────────────────
test('classifyHeader names the arch for each executable format', () => {
assert.deepEqual(classifyHeader(elfHeader(0x3e)).arches, ['x64'])
assert.deepEqual(classifyHeader(elfHeader(0xb7)).arches, ['arm64'])
assert.deepEqual(classifyHeader(machoThin(0x0100000c)).arches, ['arm64'])
assert.deepEqual(classifyHeader(machoThin(0x01000007, { swapped: true })).arches, ['x64'])
assert.deepEqual(classifyHeader(machoFat([0x01000007, 0x0100000c])).arches, ['x64', 'arm64'])
})
test('classifyHeader defers PE to the offset named in the MZ stub', () => {
const sniffed = classifyHeader(mzStub(0x180))
assert.equal(sniffed.format, 'pe')
assert.equal(sniffed.peHeaderOffset, 0x180)
// The machine code itself resolves through peArch.
assert.equal(peArch(0x8664), 'x64')
assert.equal(peArch(0xaa64), 'arm64')
assert.equal(peArch(0xa641), 'arm64ec')
assert.match(peArch(0xbeef), /unknown/)
})
test('classifyHeader skips non-binaries, tiny files, and Java class files', () => {
assert.equal(classifyHeader(Buffer.from('#!/bin/sh\necho hi\n')), null)
assert.equal(classifyHeader(Buffer.from('MZ')), null) // too short to carry a PE offset
assert.equal(classifyHeader(Buffer.alloc(0)), null)
// Java .class: same magic as a fat Mach-O, giant "slice count" (version).
const javaClass = Buffer.alloc(16)
javaClass.writeUInt32BE(0xcafebabe, 0)
javaClass.writeUInt32BE(65, 4)
assert.equal(classifyHeader(javaClass), null)
})
// ─── archMatches ─────────────────────────────────────────────────
test('archMatches: exact match, universal slices, arm64ec, and rejections', () => {
assert.ok(archMatches(['arm64'], 'arm64'))
assert.ok(archMatches(['x64', 'arm64'], 'arm64')) // universal binary covers the target
assert.ok(archMatches(['arm64ec'], 'arm64')) // arm64-ABI by definition
assert.ok(!archMatches(['x64'], 'arm64')) // the shipped-x64-shim bug this audit exists for
assert.ok(!archMatches(['arm64ec'], 'x64')) // arm64ec does not run on x64 hosts
assert.ok(!archMatches(['unknown(0xbeef)'], 'x64')) // unclassifiable ships nowhere
})
// ─── findUnpackedDirs ─────────────────────────────────────────────────
test('findUnpackedDirs matches electron-builder output shapes only', () => {
const dirs = findUnpackedDirs([
'win-unpacked', 'win-arm64-unpacked', 'linux-unpacked', 'linux-arm64-unpacked',
'mac', 'mac-arm64',
'builder-debug.yml', 'Hermes-0.20.0.exe', 'latest.yml', '.icon-ico'
])
assert.deepEqual(dirs, [
'win-unpacked', 'win-arm64-unpacked', 'linux-unpacked', 'linux-arm64-unpacked',
'mac', 'mac-arm64'
])
})
test.each([
['resources/agent-payload/tools/git-2.53.0-win32-x64/mingw64/bin/Avalonia.dll', true],
['resources\\agent-payload\\tools\\git-2.53.0-win32-x64\\mingw64\\libexec\\git-core\\GitHub.dll', true],
['resources\\agent-payload\\tools\\git-2.53.0-win32-x64\\usr\\libexec\\getprocaddr32.exe', true],
['resources/agent-payload/tools/git-2.54.0-win32-arm64/clangarm64/libexec/git-core/msalruntime.dll', true],
['resources/agent-payload/tools/git-2.53.0-linux-x64/bin/git', false],
['resources/agent-payload/tools/git-2.53.0-darwin-arm64/libexec/git-core/git-remote-https', false],
['resources/agent-payload/tools/python-3.11.16+20260814-linux-x64/lib/python3.11/site-packages/pip/_vendor/distlib/t32.exe', true],
['resources/agent-payload/tools/python-3.11.16+20260814-linux-x64/lib/python3.11/site-packages/setuptools/cli.exe', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/setuptools/cli-32.exe', true],
['resources/agent-payload/venv/Lib/site-packages/setuptools/cli.exe', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/discord/bin/libopus-0.x86.dll', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/discord/bin/libopus-0.x64.dll', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/pvporcupine/lib/mac/arm64/libpv_porcupine.dylib', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/pvporcupine/lib/raspberry-pi/arm11/libpv_porcupine.so', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/debugpy/_vendored/pydevd/pydevd_attach_to_process/attach_linux_amd64.so', true],
['resources/agent-payload/venv/lib/python3.11/site-packages/debugpy/_vendored/pydevd/pydevd_attach_to_process/inject_dll_x86.exe', true],
['resources/agent-payload/tools/agent-browser-0.35.1-win32-arm64/bin/agent-browser-win32-x64.exe', true],
['resources\\agent-payload\\tools\\agent-browser-0.26.0-win32-arm64\\bin\\agent-browser-win32-x64.exe', true],
['resources/agent-payload/tools/chromium-1208/chrome-win64/chrome.exe', true],
['resources\\agent-payload\\tools\\chromium-1208\\chrome-win64\\chrome.dll', true],
['resources/agent-payload/tools/chromium-1208/chrome-linux/chrome', false],
['resources/agent-payload/tools/chromium-1208/chrome-mac-arm64/chrome', false],
['resources/agent-payload/tools/chromium_headless_shell-1208/chrome-headless-shell-win64/chrome-headless-shell.exe', false],
['resources/agent-payload/tools/chromium-1208/chrome-headless-shell-win64/chrome-headless-shell.exe', false],
['resources/agent-payload/uv-cache/archive-v0/abc/setuptools/cli.exe', true],
['resources\\agent-payload\\uv-cache\\archive-v0\\abc\\discord\\bin\\libopus-0.x64.dll', true],
['resources/agent-payload/uv-cache/builds-v0/whatever/build.exe', true],
['resources/agent-payload/tools/something-1.0-win32-arm64/bin/thing.exe', false],
['resources/agent-payload/tools/uv-cache-1.0/tool.exe', false],
['resources/agent-payload/hermes-agent/something.exe', false],
])('foreign architecture exemption %s → %s', (file, exempt) => {
assert.equal(isExemptPath(file), exempt)
})
test('tree and CLI audit real second-read PE bytes and fail closed on absent artifacts', () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'arch-tree-'))
const cli = () => spawnSync(process.execPath, [path.resolve(import.meta.dirname, 'audit-bundle-arch.mjs'), '--arch=arm64', `--root=${root}`], { encoding: 'utf8' })
try {
assert.match(cli().stderr, /no unpacked app directory/)
const app = path.join(root, 'win-arm64-unpacked')
fs.mkdirSync(app)
assert.match(cli().stderr, /no native binaries/)
fs.writeFileSync(path.join(app, 'elf'), elfHeader(0xb7))
fs.writeFileSync(path.join(app, 'macho'), machoThin(0x0100000c))
const pe = Buffer.alloc(8198)
mzStub(8192).copy(pe)
pe.writeUInt32LE(0x4550, 8192)
pe.writeUInt16LE(0xa641, 8196)
fs.writeFileSync(path.join(app, 'arm64ec.exe'), pe)
assert.deepEqual(auditTree(app, 'arm64'), { binaries: 3, exempted: 0, mismatches: [] })
assert.equal(cli().status, 0)
pe.writeUInt16LE(0x8664, 8196)
const cache = path.join(app, 'resources/agent-payload/uv-cache/builds-v0')
fs.mkdirSync(cache, { recursive: true })
fs.writeFileSync(path.join(cache, 'cached.exe'), pe)
fs.writeFileSync(path.join(app, 'wrong-arch.dat'), pe)
assert.deepEqual(auditTree(app, 'arm64'), {
binaries: 5, exempted: 1, mismatches: [{ file: 'wrong-arch.dat', format: 'pe', arches: ['x64'] }]
})
const failed = cli()
assert.equal(failed.status, 1)
assert.match(failed.stderr, /wrong-arch.dat/)
} finally { fs.rmSync(root, { recursive: true, force: true }) }
})
// A .NET IL-only assembly: COFF machine 0x14c, CLR header in section .text.
function dotnetPe(corFlags) {
const pe = Buffer.alloc(0x400)
mzStub(0x80).copy(pe)
pe.writeUInt32LE(0x4550, 0x80)
pe.writeUInt16LE(0x014c, 0x84) // machine: i386
pe.writeUInt16LE(1, 0x86) // one section
pe.writeUInt16LE(0xe0, 0x94) // PE32 optional header size
const optional = 0x98
pe.writeUInt16LE(0x10b, optional)
pe.writeUInt32LE(0x2008, optional + 96 + 14 * 8) // CLR runtime header RVA
pe.writeUInt32LE(0x48, optional + 96 + 14 * 8 + 4)
const section = optional + 0xe0
pe.write('.text', section, 'latin1')
pe.writeUInt32LE(0x100, section + 8) // virtual size
pe.writeUInt32LE(0x2000, section + 12) // virtual address
pe.writeUInt32LE(0x100, section + 16) // raw size
pe.writeUInt32LE(0x200, section + 20) // raw pointer
pe.writeUInt32LE(0x48, 0x208) // COR20 cb
pe.writeUInt32LE(corFlags, 0x208 + 16)
return pe
}
test('an IL-only AnyCPU .NET assembly passes every Windows arch; 32-bit-bound IL and native ia32 do not', () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'arch-clr-'))
try {
fs.writeFileSync(path.join(root, 'anycpu.exe'), dotnetPe(0x1))
fs.writeFileSync(path.join(root, 'x86-required.exe'), dotnetPe(0x1 | 0x2))
fs.writeFileSync(path.join(root, 'x86-preferred.exe'), dotnetPe(0x1 | 0x20000))
const native = dotnetPe(0x1)
native.fill(0, 0x98 + 96 + 14 * 8, 0x98 + 96 + 15 * 8) // no CLR header: a native i386 PE
fs.writeFileSync(path.join(root, 'native-ia32.exe'), native)
for (const arch of ['x64', 'arm64']) {
const { mismatches } = auditTree(root, arch)
assert.deepEqual(mismatches.map(m => m.file).sort(), ['native-ia32.exe', 'x86-preferred.exe', 'x86-required.exe'])
}
} finally { fs.rmSync(root, { recursive: true, force: true }) }
})