Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
chore: merge main into feat/dylib-resolution
Kaoru08223362dfa31ef5
diff --cc README_ar.mdindex 8ce17c710,328c3b716..36f53fbfb--- a/README_ar.md+++ b/README_ar.md@@@ -213,20 -213,20 +213,20 @@@ rea setu## منصة أدوات التحقيق- | عائلة الأدوات | العدد | الاستخدام |- | -------------------- | ----: | -------------------------------------------------------------------------------------------------------------------------------------------------------- |- | الفحص الأصلي | 41 | الدوال والشيفرة شبه المصدرية والتعليمات والسلاسل والرموز والاستدعاءات والمراجع والتعليقات وقراءة البايتات ومواضع الملفات |- | سير عمل التحقيق | 14 | نظرات عامة على التطبيقات وملفات الدوال وواجهات API الأصلية والتوزيع وفك الترجمة الدفعي وتتبع الميزات ومسارات الاستدعاء ومخططاته واكتشاف Swift وObjective-C |- | أدوات macOS الأصلية | 8 | بيانات Mach-O والتوقيعات وplist والمعماريات واستعادة أسماء Swift ومراقبة الاستدعاءات عبر LLDB دون تشغيل Hopper |- | مخطط المخرجات | 6 | جرد الدلائل والحزم وملفات Interface Builder المترجمة وكتالوجات موارد Apple وحل تحميل مكتبات Mach-O الديناميكية والاستخراج |- | PE/CLI المُدار | 7 | هوية تجميعات .NET وبياناتها الوصفية وتعليمات CIL والاعتماديات الأصلية واستيراد إعادة البناء ومقارنة الإصدارات |- | البرامج الثابتة | 2 | فحص مناطق البرامج الثابتة على Linux واستخراجها الصريح |- | Android APK | 5 | بيانات الحزمة وmanifest والبحث عن الأصناف وقوائم الأعضاء وفك ترجمة الأساليب والمراجع الثابتة |- | مراقبة المتصفح | 12 | بنية الصفحات وبيانات الشبكة والبرامج النصية وخرائط المصدر واكتشاف WebMCP والصور ومقارنة الالتقاط |- | تحليل Electron | 5 | مراقبة العارضين وخريطة التطبيق الثابتة والمواءمة بين نتائج الثبات والتشغيل |- | وقت تشغيل JavaScript | 2 | اكتشاف أهداف Node/Electron Inspector ومواضع البرامج وأحداث سياقات التنفيذ |- | سير عمل التطبيقات | 13 | تصدير النصوص البرمجية الملتقطة، تتبع الميزات عبر الطبقات ومقارنة الإصدارات ومواءمة المصدر التاريخي ومقارنة أشكال القيم المعادة والتحقق من إعادة الإنشاء |- | مساحة العمل والملاحظة | 21 | الجلسات وحزم الأدلة وسياق التنقل ومقارنة العمليات والمخرجات والدوال وتسجيل الأسئلة غير المحسومة |+ | عائلة الأدوات | العدد | الاستخدام |+ | ---------------------- | ----: | -------------------------------------------------------------------------------------------------------------------------------------------------------- |+ | الفحص الأصلي | 41 | الدوال والشيفرة شبه المصدرية والتعليمات والسلاسل والرموز والاستدعاءات والمراجع والتعليقات وقراءة البايتات ومواضع الملفات |+ | سير عمل التحقيق | 14 | نظرات عامة على التطبيقات وملفات الدوال وواجهات API الأصلية والتوزيع وفك الترجمة الدفعي وتتبع الميزات ومسارات الاستدعاء ومخططاته واكتشاف Swift وObjective-C |+ | أدوات الملفات الثنائية | 9 | بيانات Mach-O والتوقيعات وplist والمعماريات وأسماء Swift ومراقبة الاستدعاءات عبر LLDB على macOS؛ تخطيط ELF وأدلة الحماية الثابتة على Linux |-| مخطط المخرجات | 5 | جرد الدلائل والحزم وملفات Interface Builder المترجمة وكتالوجات موارد Apple والاستخراج |++| مخطط المخرجات | 6 | جرد الدلائل والحزم وملفات Interface Builder المترجمة وكتالوجات موارد Apple وحل تحميل مكتبات Mach-O الديناميكية والاستخراج |+ | PE/CLI المُدار | 7 | هوية تجميعات .NET وبياناتها الوصفية وتعليمات CIL والاعتماديات الأصلية واستيراد إعادة البناء ومقارنة الإصدارات |+ | البرامج الثابتة | 2 | فحص مناطق البرامج الثابتة على Linux واستخراجها الصريح |+ | Android APK | 5 | بيانات الحزمة وmanifest والبحث عن الأصناف وقوائم الأعضاء وفك ترجمة الأساليب والمراجع الثابتة |+ | مراقبة المتصفح | 12 | بنية الصفحات وبيانات الشبكة والبرامج النصية وخرائط المصدر واكتشاف WebMCP والصور ومقارنة الالتقاط |+ | تحليل Electron | 5 | مراقبة العارضين وخريطة التطبيق الثابتة والمواءمة بين نتائج الثبات والتشغيل |+ | وقت تشغيل JavaScript | 2 | اكتشاف أهداف Node/Electron Inspector ومواضع البرامج وأحداث سياقات التنفيذ |+ | سير عمل التطبيقات | 13 | تصدير النصوص البرمجية الملتقطة، تتبع الميزات عبر الطبقات ومقارنة الإصدارات ومواءمة المصدر التاريخي ومقارنة أشكال القيم المعادة والتحقق من إعادة الإنشاء |+ | مساحة العمل والملاحظة | 21 | الجلسات وحزم الأدلة وسياق التنقل ومقارنة العمليات والمخرجات والدوال وتسجيل الأسئلة غير المحسومة |## خطة العملdiff --cc README_ja.mdindex 56fc02c46,813e870b2..b64b7f590--- a/README_ja.md+++ b/README_ja.md@@@ -240,8 -240,8 +240,8 @@@ TypeScript と SQLite を使って私�| -------------------- | --: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- || ネイティブ検査 | 41 | 関数、疑似コード、アセンブリ、文字列、シンボル、呼び出し、参照、注釈、バイト読み取り、ファイルオフセット || 調査ワークフロー | 14 | アプリ概要、関数ドシエ、ネイティブ API とディスパッチ、一括逆コンパイル、機能トレース、コールパス、コールグラフ、Swift と Objective-C の検出 |- | macOS ネイティブ | 8 | Hopper を起動せずに扱える Mach-O メタデータ、コード署名、plist、アーキテクチャ、Swift シンボルのデマングル、LLDB による呼び出し観測 |+ | ネイティブバイナリ | 9 | macOS の Mach-O メタデータ、署名、plist、アーキテクチャ、Swift シンボル、LLDB による呼び出し観測;Linux の ELF レイアウトと静的な保護機構の証拠 |-| 成果物グラフ | 5 | ディレクトリとパッケージの目録、コンパイル済み Interface Builder ファイル、Apple アセットカタログ、抽出 |+| 成果物グラフ | 6 | ディレクトリとパッケージの目録、コンパイル済み Interface Builder ファイル、Apple アセットカタログ、Mach-O dylib 読み込みの解決、抽出 || マネージド PE/CLI | 7 | .NET の識別情報、メタデータ、CIL 命令、ネイティブ依存関係、再構築結果のインポート、ビルド比較 || ファームウェア | 2 | Linux ファームウェア領域の検査と明示的な展開 || Android APK | 5 | パッケージと manifest の宣言、クラス検索、メンバー一覧、メソッドの逆コンパイル、静的な被参照 |diff --cc README_ko.mdindex 45a690857,ee9a5fa0c..aac85c4d0--- a/README_ko.md+++ b/README_ko.md@@@ -207,8 -207,8 +207,8 @@@ REA는 1–5단계의 바이너리 분�| ----------------- | --: | ------------------------------------------------------------------------------------------------------------------------- || 네이티브 검사 | 41 | 함수, 의사 코드, 어셈블리, 문자열, 심볼, 호출, 참조, 주석, 바이트 읽기, 파일 오프셋 || 조사 워크플로 | 14 | 앱 개요, 함수 기록서, 네이티브 API와 디스패치, 일괄 디컴파일, 기능 추적, 호출 경로, 호출 그래프, Swift와 Objective-C 탐색 |- | macOS 네이티브 | 8 | Hopper 실행 없이 처리하는 Mach-O 메타데이터, 서명, plist, 아키텍처, Swift 이름 복원, LLDB 호출 관찰 |+ | 네이티브 바이너리 | 9 | macOS의 Mach-O 메타데이터, 서명, plist, 아키텍처, Swift 심볼과 LLDB 호출 관찰; Linux의 ELF 레이아웃과 정적 보호 증거 |-| 아티팩트 그래프 | 5 | 디렉터리와 패키지 목록, 컴파일된 Interface Builder 파일, Apple 애셋 카탈로그, 추출 |+| 아티팩트 그래프 | 6 | 디렉터리와 패키지 목록, 컴파일된 Interface Builder 파일, Apple 애셋 카탈로그, Mach-O dylib 로드 해석, 추출 || 관리 PE/CLI | 7 | .NET 식별, 메타데이터, CIL 명령어, 네이티브 종속성, 재구성 가져오기, 빌드 비교 || 펌웨어 | 2 | Linux 펌웨어 영역 검사 및 명시적 추출 || Android APK | 5 | 패키지와 manifest 선언, 클래스 검색, 멤버 목록, 메서드 디컴파일, 정적 참조 |diff --cc README_zh.mdindex d099657b2,3c0f1d9e8..edfe0f65d--- a/README_zh.md+++ b/README_zh.md@@@ -206,8 -206,8 +206,8 @@@ REA 负责第 1–5 步中的二进制�| ----------------- | ---: | ------------------------------------------------------------------------------------------------------ || 原生检查 | 41 | 函数、伪代码、汇编、字符串、符号、调用、引用、注释、字节读取与文件偏移 || 调查工作流 | 14 | 应用概览、函数档案、原生 API 与分发、批量反编译、功能追踪、调用路径与调用图、Swift 与 Objective-C 发现 |- | macOS 原生工具 | 8 | Mach-O 元数据、代码签名、plist、架构、Swift 符号还原与 LLDB 调用观察,无需启动 Hopper |+ | 原生二进制工具 | 9 | macOS 的 Mach-O 元数据、签名、plist、架构、Swift 符号与 LLDB 调用观察;Linux 的 ELF 布局和静态保护证据 |-| 产物图 | 5 | 目录与软件包清单、编译后的 Interface Builder 文件、Apple 资源目录与提取 |+| 产物图 | 6 | 目录与软件包清单、编译后的 Interface Builder 文件、Apple 资源目录、Mach-O dylib 加载解析与提取 || 托管 PE/CLI | 7 | .NET 程序集身份、元数据、CIL 指令、原生依赖声明、重建导入与构建比较 || 固件 | 2 | Linux 固件区域检查与显式提取 || Android APK | 5 | 包与 manifest 声明、类搜索、成员清单、方法反编译与静态引用 |diff --cc docs/product-catalog.jsonindex 4bd3b2f6d,327a8e352..e9cba6f56--- a/docs/product-catalog.json+++ b/docs/product-catalog.json@@@ -7,10 -7,10 +7,10 @@@"client": "2.3.1","core": "2.3.1"},-- "skill_version": "30"++ "skill_version": "31"},"tools": {-- "total": 136,++ "total": 137,"families": [{"id": "direct",@@@ -587,7 -592,7 +594,7 @@@}],"cli": {-- "primary_count": 91,++ "primary_count": 92,"commands": ["address-to-file-offset","analyze",@@@ -690,15 -695,15 +698,15 @@@},"runtime_catalog": {"counts": {-- "cli_commands": 91,-- "mcp_tools": 136,++ "cli_commands": 92,++ "mcp_tools": 137,"mcp_prompts": 6},"digests": {- "tools_sha256": "6d195c42333ecfa46e9b253f15174876b34ed1fb226047d1327e3be960680f26",- "tools_sha256": "51992818bb03b1f6136a2674517e3d983037dc474cd0ac31a37fe4096211e5e2",++ "tools_sha256": "1f9455a546d76d63e9ceba7bfdc6045f6abde8ead8492c55bd0cdfa726061a91","prompts_sha256": "ef2de8814390b340623c32001610aa2709d90bed51537b6e562ab3abf144ab4d",- "combined_sha256": "047ba77689d22d3b3dac6f51fae06a1a306aaab24fa3be7c2007b396a5fd26f7",- "providers_sha256": "96cfc3247384603286780f35bc403870bbca53a648959cbe36bc28dbb43700e5"- "combined_sha256": "fc75e5d817f64311dacc23ef2bde4223fd12d2d5a9c49e93051ac9f7857b2d8c",- "providers_sha256": "6e0080dea56ee7f3ebdf5ce0d74ea18e5d44ebce80b89c7f4de94e9c69f4d2e5"++ "combined_sha256": "ce23d159fbfc07b338a5e2d51569a71597842f0cf3a3c09986c799512752ab02",++ "providers_sha256": "6a96ebafaa7c9284661db6c2036524dcba0407e85278c6bb5ac12bbad0d85a6f"}}}diff --cc docs/verification/managed-conformance-manifest.jsonindex 4954b5bea,2d1fa5481..c7088bfeb--- a/docs/verification/managed-conformance-manifest.json+++ b/docs/verification/managed-conformance-manifest.json@@@ -1,5 -1,5 +1,5 @@@{- "manifest_id": "ecm_5d2fd13510a46479a522d904504fdf959a0feb9d7773cbffba50d3ae6e3e9a79",- "manifest_id": "ecm_4308b9eca45ac983c4af2da0e6aafe6180b27569f55b3454b508f7c61a1f3fde",++ "manifest_id": "ecm_2821fc2b686037a57ed7e5847a3927cc95b598d222a54983b34d87402e18bd30","verifier": {"id": "rea-managed-conformance","version": "1"@@@ -13,7 -13,7 +13,7 @@@"skill_digests": [{"skill_id": "reverse-engineer-anything",- "sha256": "8d4c905cac2ea90440a072cdfefc6d6830ea33a3688855c745d2e870bc40960f"- "sha256": "3c5b36ca0beb632f003b66e52afc4cd689ee5fe71c965dfa72374467cac9144e"++ "sha256": "21157bdb015b42cf2fafc15fe150605ca89cc564761bb24e87b5bd6a00da7f19"}],"claims": [diff --cc scripts/verify-binary-layout.mjsindex 000000000,feb11b285..8c0c88685mode 000000,100644..100644--- a/scripts/verify-binary-layout.mjs+++ b/scripts/verify-binary-layout.mjs@@@ -1,0 -1,1290 +1,1290 @@@+ #!/usr/bin/env node+ import assert from "node:assert/strict";+ import { execFile } from "node:child_process";+ import { createHash } from "node:crypto";+ import {+ copyFile,+ mkdir,+ readFile,+ readdir,+ writeFile,+ } from "node:fs/promises";+ import { dirname, isAbsolute, join } from "node:path";+ import { fileURLToPath } from "node:url";+ import { promisify } from "node:util";+ import { Client } from "@modelcontextprotocol/client";+ import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";+ import { PrivateRuntimeRoot } from "../dist/process/PrivateRuntimeRoot.js";+ import { parseEvidence } from "../dist/domain/evidence.js";+ import { mcpTextValue } from "./lib/mcp-verifier-results.mjs";+ import { createVerifierRun, completeVerifierRun } from "./lib/verifier-run.mjs";+ import { sectionNameFixtures } from "./lib/elf-section-name-fixtures.mjs";+ import { withLargeResultMcp } from "./lib/large-result-mcp.mjs";++ const verifyLargeMcp = process.env.REA_VERIFY_LARGE_ELF_MCP === "1";+ const python = process.env.REA_PWNTOOLS_PYTHON;+ const strace = process.env.REA_VERIFY_STRACE_COMMAND;+ if (+ process.platform !== "linux" ||+ process.arch !== "x64" ||+ !isAbsolute(python ?? "") ||+ !isAbsolute(strace ?? "")+ )+ throw new Error(+ "verify:binary:layout requires Linux x64, absolute REA_PWNTOOLS_PYTHON (pwntools 4.15.0/pyelftools 0.33/Unicorn 2.1.2) and REA_VERIFY_STRACE_COMMAND. gcc, ld and strip must be available. No target is executed.",+ );+ const run = createVerifierRun();+ const execute = promisify(execFile);+ for (const command of ["gcc", "ld", "strip", "/usr/bin/prlimit", strace]) {+ try {+ await execute(command, [command === strace ? "-V" : "--version"], {+ timeout: 10_000,+ maxBuffer: 1024 * 1024,+ });+ } catch (cause) {+ throw new Error(+ `verify:binary:layout prerequisite unavailable: ${command}`,+ { cause },+ );+ }+ }+ const entrypoint =+ process.argv[2] ?? fileURLToPath(new URL("./rea.mjs", import.meta.url));+ const root = await PrivateRuntimeRoot.create({+ prefix: "rea-layout-verifier-",+ });+ const environment = Object.fromEntries(+ Object.entries(process.env).filter(([, value]) => typeof value === "string"),+ );+ const client = new Client({ name: "binary-layout-verifier", version: "1" });+ const transport = new StdioClientTransport({+ command: process.execPath,+ args: [entrypoint, "mcp"],+ env: environment,+ stderr: "pipe",+ });+ const source = fileURLToPath(+ new URL("./fixtures/binary-layout.c", import.meta.url),+ );+ const highSource = fileURLToPath(+ new URL("./fixtures/binary-layout-high.S", import.meta.url),+ );+ let cases = 0;+ let bootstrapCases = 0;+ const failures = [];+ try {+ const bootstrapRoot = join(root.path, "bootstrap-boundary");+ await mkdir(bootstrapRoot);+ const bootstrapPath = join(bootstrapRoot, "layout.py");+ await copyFile(+ join(dirname(dirname(entrypoint)), "bridge/pwntools/layout.py"),+ bootstrapPath,+ );+ for (const [source, status] of [+ ["raise MemoryError('source-owned initialization failure')", 75],+ ["raise OSError(12, 'source-owned allocation failure')", 75],+ ["raise OSError(27, 'source-owned file write failure')", 76],+ [+ "raise OSError(2, 'MemoryError-like text is not an allocation failure')",+ 1,+ ],+ ]) {+ await writeFile(join(bootstrapRoot, "layout_impl.py"), source);+ const markerPath = join(bootstrapRoot, `failure-${bootstrapCases}`);+ let exitCode = 0;+ try {+ await execute(+ python,+ ["-I", bootstrapPath, markerPath, "unused-request"],+ {+ timeout: 10000,+ maxBuffer: 1024 * 1024,+ },+ );+ } catch (cause) {+ assert.equal(typeof cause.code, "number");+ exitCode = cause.code;+ }+ assert.equal(exitCode, status);+ if (status === 75 || status === 76)+ assert.equal(+ await readFile(markerPath, "ascii"),+ status === 75 ? "M" : "F",+ );+ else await assert.rejects(readFile(markerPath), { code: "ENOENT" });+ bootstrapCases++;+ }+ for (const [name, flags] of [+ [+ "protected",+ [+ "-fPIE",+ "-pie",+ "-fstack-protector-all",+ "-Wl,-z,relro,-z,now",+ "-Wl,-z,noexecstack",+ ],+ ],+ [+ "plain",+ [+ "-fno-pie",+ "-no-pie",+ "-fno-stack-protector",+ "-Wl,-z,norelro",+ "-Wl,-z,execstack",+ ],+ ],+ ["relocatable", ["-c", "-fcommon", "-fPIC"]],+ ["library", ["-shared", "-fPIC", "-fno-stack-protector"]],+ ["packed-relative", ["-shared", "-fPIC", "-Wl,-z,pack-relative-relocs"]],+ ])+ await execute(+ "gcc",+ ["-O1", "-g", ...flags, source, "-o", join(root.path, name)],+ { timeout: 30_000, maxBuffer: 1024 * 1024 },+ );+ const sectionlessBytes = await readFile(join(root.path, "protected"));+ sectionlessBytes.writeBigUInt64LE(0n, 40);+ sectionlessBytes.writeUInt16LE(0, 60);+ sectionlessBytes.writeUInt16LE(0, 62);+ await writeFile(join(root.path, "sectionless"), sectionlessBytes);+ const nullBytes = Buffer.from(await readFile(join(root.path, "protected")));+ const phOffset = Number(nullBytes.readBigUInt64LE(32));+ const phSize = nullBytes.readUInt16LE(54);+ const phCount = nullBytes.readUInt16LE(56);+ const unusedIndex = Array.from({ length: phCount }, (_, index) => index).find(+ (index) => nullBytes.readUInt32LE(phOffset + index * phSize) === 0x6474e551,+ );+ assert.notEqual(+ unusedIndex,+ undefined,+ "Required stack fixture header absent",+ );+ const unusedHeader = phOffset + unusedIndex * phSize;+ nullBytes.writeUInt32LE(0, unusedHeader);+ for (const field of [8, 32, 40])+ nullBytes.writeBigUInt64LE(0xffffffffffffffffn, unusedHeader + field);+ await writeFile(join(root.path, "unused-segment"), nullBytes);+ const emptyBytes = Buffer.from(nullBytes);+ emptyBytes.writeUInt32LE(1, unusedHeader);+ emptyBytes.writeBigUInt64LE(0n, unusedHeader + 32);+ emptyBytes.writeBigUInt64LE(0n, unusedHeader + 40);+ await writeFile(join(root.path, "empty-segment"), emptyBytes);+ await copyFile(join(root.path, "protected"), join(root.path, "stripped"));+ await execute("strip", ["--strip-all", join(root.path, "stripped")], {+ timeout: 10_000,+ });+ await execute("gcc", ["-c", highSource, "-o", join(root.path, "high.o")], {+ timeout: 10_000,+ });+ await execute(+ "ld",+ [+ "-Ttext=0x20000000000001",+ "-o",+ join(root.path, "high"),+ join(root.path, "high.o"),+ ],+ { timeout: 10_000 },+ );+ await client.connect(transport);+ const reports = new Map();+ for (const name of [+ "protected",+ "plain",+ "relocatable",+ "library",+ "packed-relative",+ "stripped",+ "sectionless",+ "unused-segment",+ "empty-segment",+ "high",+ ]) {+ const path = join(root.path, name);+ const bytes = await readFile(path);+ const sha256 = createHash("sha256").update(bytes).digest("hex");+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, path);+ assert.equal(value.artifact.sha256, sha256);+ assert.equal(value.artifact.bytes, bytes.length);+ assert.equal(value.runtime_load_base, null);+ assert.equal(value.linkage.runtime_library_paths, null);+ assert.equal(value.mitigations.evidence_kind, "inferred");+ if (name === "sectionless") {+ assert.equal(value.sections.length, 0);+ assert.equal(value.symbols.length, 0);+ assert.deepEqual(+ value.linkage.needed_libraries,+ reports.get("protected").linkage.needed_libraries,+ );+ assert.ok(+ value.linkage.needed_libraries.every(+ (name) => name.location !== null && name.bytes_base64 !== null,+ ),+ );+ // Preserve the unchanged engine's section-dependent heuristic and its+ // explicit coverage limitation, rather than inventing a stronger label.+ assert.equal(value.mitigations.relro, "Partial");+ assert.ok(+ value.limitations.some((item) =>+ item.includes("RELRO/canary indicators may be incomplete"),+ ),+ );+ } else+ assert.ok(+ value.sections.some((section) => section.file_backing === "none"),+ );+ for (const section of value.sections) {+ assert.ok(typeof section.address === "string");+ if (section.file_backing === "file")+ assert.ok(+ BigInt(section.offset) + BigInt(section.size) <=+ BigInt(bytes.length),+ );+ }+ if (name === "unused-segment" || name === "empty-segment") {+ const segment = value.segments[unusedIndex];+ assert.equal(segment.file_backing, "none");+ assert.equal(segment.offset, "0xffffffffffffffff");+ if (name === "unused-segment") assert.equal(segment.permissions, null);+ else assert.notEqual(segment.permissions, null);+ }+ assert.equal(value.relocation_inventory_completeness, "unknown");+ if (name === "library" || name === "packed-relative") {+ assert.equal(value.entry_point.reported_value, "0x0");+ assert.equal(value.entry_point.meaning, "absent");+ }+ if (name === "packed-relative") {+ assert.ok(value.packed_relative_relocations.length > 0);+ for (const table of value.packed_relative_relocations) {+ assert.equal(table.evidence_kind, "derived");+ assert.equal(table.offset_meaning, "linked-virtual-address");+ assert.equal(table.entry_source_locations, null);+ assert.equal(table.addends, null);+ assert.ok(table.entries.length > 0);+ const start = Number(BigInt(table.location.offset));+ const length = Number(BigInt(table.location.bytes));+ assert.deepEqual(+ Buffer.from(table.encoded_bytes_base64, "base64"),+ bytes.subarray(start, start + length),+ );+ }+ }+ reports.set(name, value);+ assert.deepEqual(await readFile(path), bytes);+ cases++;+ }+ }+ const protectedReport = reports.get("protected");+ const fileSymbols = protectedReport.symbols.filter(+ (symbol) => symbol.type === "STT_FILE",+ );+ assert.ok(fileSymbols.length > 0);+ assert.ok(+ fileSymbols.every((symbol) => symbol.value_meaning === "no-address"),+ );+ const plain = reports.get("plain");+ assert.equal(protectedReport.mitigations.position_independent, true);+ assert.equal(protectedReport.mitigations.nx_indicator, true);+ assert.equal(protectedReport.mitigations.stack_canary_indicator, true);+ assert.equal(protectedReport.mitigations.relro, "Full");+ assert.equal(plain.mitigations.position_independent, false);+ assert.equal(plain.mitigations.nx_indicator, null);+ assert.equal(plain.mitigations.executable_stack_indicator, true);+ assert.equal(protectedReport.mitigations.executable_stack_indicator, false);+ assert.equal(plain.mitigations.stack_canary_indicator, false);+ assert.equal(plain.mitigations.relro, null);+ const relocatable = reports.get("relocatable");+ assert.equal(relocatable.entry_point.meaning, "not-applicable");+ assert.ok(relocatable.relocations.length > 0);+ assert.ok(+ relocatable.relocations.every(+ (item) => item.target.kind === "section-offset",+ ),+ );+ assert.ok(+ relocatable.relocations.some((item) => BigInt(item.addend ?? "0") < 0n),+ );+ assert.equal(+ relocatable.symbols.find((symbol) => symbol.name.display === "common_value")+ .value_meaning,+ "alignment",+ );+ assert.equal(+ reports+ .get("library")+ .symbols.find((symbol) => symbol.name.display === "tls_value")+ .value_meaning,+ "tls-offset",+ );+ assert.equal(+ reports.get("high").entry_point.reported_value,+ "0x20000000000001",+ );+ assert.equal(+ reports+ .get("high")+ .symbols.find((symbol) => symbol.name.display === "absolute_value").value,+ "0x20000000000007",+ );+ assert.equal(+ reports+ .get("high")+ .symbols.find((symbol) => symbol.name.display === "absolute_value")+ .value_meaning,+ "absolute-value",+ );+ assert.ok(+ reports.get("stripped").symbols.length < protectedReport.symbols.length,+ );+ const object = await readFile(join(root.path, "relocatable"));+ const name = relocatable.symbols.find(+ (symbol) => symbol.name.display === "read_values",+ ).name;+ const changed = Buffer.from(object);+ changed[Number(BigInt(name.location.offset))] = 0xff;+ const opaque = join(root.path, "opaque-name.o");+ await writeFile(opaque, changed);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, opaque);+ const symbol = value.symbols.find((item) =>+ item.name.display.endsWith("ead_values"),+ );+ assert.equal(Buffer.from(symbol.name.bytes_base64, "base64")[0], 0xff);+ assert.equal(symbol.name.location.offset, name.location.offset);+ assert.deepEqual(await readFile(opaque), changed);+ cases++;+ }+ const sectionBearingBytes = await readFile(join(root.path, "protected"));+ const dynamicSegment = protectedReport.segments.find(+ (segment) => segment.type === "PT_DYNAMIC",+ );+ const interpreterSegment = protectedReport.segments.find(+ (segment) => segment.type === "PT_INTERP",+ );+ assert.notEqual(dynamicSegment, undefined);+ assert.notEqual(interpreterSegment, undefined);+ const dependency = protectedReport.linkage.needed_libraries[0];+ assert.notEqual(dependency, undefined);+ assert.notEqual(dependency.location, null);+ for (const [profile, original] of [+ ["section-bearing", sectionBearingBytes],+ ["sectionless", sectionlessBytes],+ ]) {+ for (const facet of ["dependency", "interpreter"]) {+ const bytes = Buffer.from(original);+ const reference =+ facet === "dependency"+ ? dependency+ : protectedReport.linkage.interpreters[0];+ assert.notEqual(reference, undefined);+ assert.notEqual(reference.location, null);+ const raw = Buffer.from(reference.bytes_base64, "base64");+ const changedIndex = facet === "dependency" ? 0 : 1;+ raw[changedIndex] = 0xff;+ bytes[Number(BigInt(reference.location.offset)) + changedIndex] = 0xff;+ const path = join(root.path, `opaque-${profile}-${facet}`);+ await writeFile(path, bytes);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, path);+ const actual =+ facet === "dependency"+ ? value.linkage.needed_libraries[0]+ : value.linkage.interpreters[0];+ assert.deepEqual(actual, {+ ...reference,+ display: raw.toString("utf8"),+ bytes_base64: raw.toString("base64"),+ });+ assert.equal(+ value.artifact.sha256,+ createHash("sha256").update(bytes).digest("hex"),+ );+ assert.deepEqual(await readFile(path), bytes);+ cases++;+ }+ }+ }+ for (const fixture of sectionNameFixtures(+ sectionBearingBytes,+ protectedReport,+ )) {+ const path = join(root.path, `section-names-${fixture.name}`);+ await writeFile(path, fixture.bytes);+ for (const mode of ["cli", "mcp"]) {+ if (+ fixture.expectation === "resolved" &&+ mode === "mcp" &&+ !verifyLargeMcp+ )+ continue;+ // Ordinary cases retain the SDK default. Only this complete 65,281-row+ // case selects a larger receive budget; production data is not truncated.+ const value =+ fixture.expectation === "resolved" && mode === "mcp"+ ? await withLargeResultMcp(+ { entrypoint, environment, maxBufferSize: 256 * 1024 * 1024 },+ (largeClient) =>+ inspect(mode, path, undefined, environment, largeClient),+ )+ : await inspect(+ mode,+ path,+ fixture.expectation === "invalid_input"+ ? "invalid_input"+ : undefined,+ );+ if (fixture.expectation === "absent") {+ assert.deepEqual(value.symbols, protectedReport.symbols);+ assert.deepEqual(+ value.sections.map((section) => section.name),+ protectedReport.sections.map(() => ({+ display: "",+ bytes_base64: null,+ location: null,+ unknown_reason:+ "ELF declares no section-name table (SHN_UNDEF index 0).",+ })),+ );+ assert.deepEqual(+ value.sections.map((section) => section.name_offset),+ protectedReport.sections.map((section) => section.name_offset),+ );+ } else if (fixture.expectation === "resolved") {+ assert.equal(value.sections.length, fixture.sectionCount);+ assert.deepEqual(+ value.sections[fixture.tableIndex].name,+ protectedReport.sections[sectionBearingBytes.readUInt16LE(62)].name,+ );+ assert.deepEqual(value.symbols, protectedReport.symbols);+ }+ cases++;+ }+ assert.deepEqual(await readFile(path), fixture.bytes);+ }+ // Malformed references must fail before the decoder reads unrelated bytes.+ const neededTagOffsets = [];+ let stringSizeTagOffset;+ for (+ let offset = Number(BigInt(dynamicSegment.offset));+ offset <+ Number(BigInt(dynamicSegment.offset) + BigInt(dynamicSegment.file_size));+ offset += 16+ ) {+ const tag = sectionBearingBytes.readBigUInt64LE(offset);+ if (tag === 0n) break;+ if (tag === 1n) neededTagOffsets.push(offset + 8);+ if (tag === 10n) stringSizeTagOffset = offset + 8;+ }+ assert.ok(neededTagOffsets.length > 0);+ assert.notEqual(stringSizeTagOffset, undefined);+ for (const [profile, original] of [+ ["section-bearing", sectionBearingBytes],+ ["sectionless", sectionlessBytes],+ ]) {+ for (const problem of ["offset-at-end", "truncated-table"]) {+ const bytes = Buffer.from(original);+ if (problem === "offset-at-end")+ bytes.writeBigUInt64LE(+ bytes.readBigUInt64LE(stringSizeTagOffset),+ neededTagOffsets[0],+ );+ else {+ assert.ok(bytes.readBigUInt64LE(neededTagOffsets[0]) > 0n);+ bytes.writeBigUInt64LE(1n, stringSizeTagOffset);+ }+ const path = join(root.path, `invalid-dependency-${profile}-${problem}`);+ await writeFile(path, bytes);+ for (const mode of ["cli", "mcp"]) {+ await inspect(mode, path, "invalid_input");+ cases++;+ }+ assert.deepEqual(await readFile(path), bytes);+ }+ }+ for (const type of ["SHT_SYMTAB", "SHT_DYNSYM"]) {+ const table = protectedReport.sections.find(+ (section) => section.type === type,+ );+ const other = protectedReport.sections.find(+ (section) => section.type === "SHT_PROGBITS",+ );+ assert.notEqual(table, undefined);+ assert.notEqual(other, undefined);+ const header = Number(BigInt(table.header_location.offset));+ const strings = protectedReport.sections[table.link];+ assert.equal(strings.type, "SHT_STRTAB");+ for (const problem of [+ "out-of-range",+ "null",+ "wrong-type",+ "undeclared-header",+ ]) {+ let bytes = Buffer.from(sectionBearingBytes);+ let link =+ problem === "null"+ ? 0+ : problem === "wrong-type"+ ? other.index+ : protectedReport.sections.length + 100;+ if (problem === "undeclared-header") {+ // Upstream can read an otherwise valid header beyond declared e_shnum.+ const end =+ Number(bytes.readBigUInt64LE(40)) ++ protectedReport.sections.length * bytes.readUInt16LE(58);+ const extended = Buffer.alloc(Math.max(bytes.length, end + 64));+ bytes.copy(extended);+ const start = Number(BigInt(strings.header_location.offset));+ bytes.copy(extended, end, start, start + 64);+ bytes = extended;+ link = protectedReport.sections.length;+ }+ bytes.writeUInt32LE(link, header + 40);+ const path = join(root.path, `invalid-symbol-link-${type}-${problem}`);+ await writeFile(path, bytes);+ for (const mode of ["cli", "mcp"]) {+ await inspect(mode, path, "invalid_input");+ cases++;+ }+ assert.deepEqual(await readFile(path), bytes);+ }+ }+ const shortDynamic = Buffer.from(sectionBearingBytes);+ shortDynamic.writeBigUInt64LE(+ 16n,+ Number(BigInt(dynamicSegment.header_location.offset)) + 32,+ );+ assert.notEqual(+ shortDynamic.readBigUInt64LE(Number(BigInt(dynamicSegment.offset))),+ 0n,+ );+ const paddedInterpreter = Buffer.from(sectionBearingBytes);+ const interpreterStart = Number(BigInt(interpreterSegment.offset));+ paddedInterpreter[interpreterStart + 2] = 0;+ const paddedInterpreterPath = join(root.path, "padded-interpreter");+ await writeFile(paddedInterpreterPath, paddedInterpreter);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, paddedInterpreterPath);+ assert.deepEqual(value.linkage.interpreters, [+ {+ display: "/l",+ bytes_base64: Buffer.from("/l").toString("base64"),+ location: { offset: interpreterSegment.offset, bytes: "0x3" },+ unknown_reason: null,+ },+ ]);+ assert.equal(+ value.segments[interpreterSegment.index].file_size,+ interpreterSegment.file_size,+ );+ assert.deepEqual(await readFile(paddedInterpreterPath), paddedInterpreter);+ cases++;+ }+ const unterminatedInterpreter = Buffer.from(sectionBearingBytes);+ unterminatedInterpreter.fill(+ 0x58,+ interpreterStart,+ interpreterStart + Number(BigInt(interpreterSegment.file_size)),+ );+ const zeroSymbolEntries = ["SHT_SYMTAB", "SHT_DYNSYM"].map((type) => {+ const section = protectedReport.sections.find((item) => item.type === type);+ assert.notEqual(+ section,+ undefined,+ `Required fixture table absent: ${type}`,+ );+ const bytes = Buffer.from(sectionBearingBytes);+ bytes.writeBigUInt64LE(+ 0n,+ Number(BigInt(section.header_location.offset)) + 56,+ );+ return [`zero-entry-${type}`, bytes, "invalid_input"];+ });+ const undersizedSymbolEntries = ["SHT_SYMTAB", "SHT_DYNSYM"].map((type) => {+ const section = protectedReport.sections.find((item) => item.type === type);+ assert.notEqual(section, undefined);+ const bytes = Buffer.from(sectionBearingBytes);+ const header = Number(BigInt(section.header_location.offset));+ bytes.writeBigUInt64LE(8n, header + 32);+ bytes.writeBigUInt64LE(8n, header + 56);+ return [`undersized-entry-${type}`, bytes, "invalid_input"];+ });+ const relocationSection = relocatable.sections.find(+ (item) => item.type === "SHT_RELA",+ );+ assert.notEqual(relocationSection, undefined);+ const undersizedRelocationEntries = [+ ["REL", 9],+ ["RELA", 4],+ ].map(([type, sectionType]) => {+ const bytes = Buffer.from(object);+ const header = Number(BigInt(relocationSection.header_location.offset));+ bytes.writeUInt32LE(sectionType, header + 4);+ bytes.writeBigUInt64LE(8n, header + 32);+ bytes.writeBigUInt64LE(8n, header + 56);+ return [`undersized-entry-${type}`, bytes, "invalid_input"];+ });+ const invalidRelocationReferences = [+ ["missing-symbol-table", relocatable.sections.length + 100],+ ["wrong-symbol-table-kind", 1],+ ["positive-symbol-without-table", 0],+ ["missing-relocation-symbol", null],+ ].map(([name, link]) => {+ const bytes = Buffer.from(object);+ const header = Number(BigInt(relocationSection.header_location.offset));+ if (link === null) {+ const offset = Number(BigInt(relocationSection.offset)) + 8;+ const type = bytes.readBigUInt64LE(offset) & 0xffffffffn;+ bytes.writeBigUInt64LE((0xffffffffn << 32n) | type, offset);+ } else bytes.writeUInt32LE(link, header + 40);+ return [name, bytes, "invalid_input"];+ });+ const inactiveTarget = relocatable.sections.find(+ (section) => section.name.display === ".comment",+ );+ assert.notEqual(+ inactiveTarget,+ undefined,+ "Required inactive-target fixture absent",+ );+ for (const [name, targetIndex, reason] of [+ ["undefined-relocation-target", 0, "undefined-section-reference"],+ [+ "inactive-relocation-target",+ inactiveTarget.index,+ "inactive-section-header",+ ],+ ]) {+ const bytes = Buffer.from(object);+ bytes.writeUInt32LE(+ targetIndex,+ Number(BigInt(relocationSection.header_location.offset)) + 44,+ );+ if (targetIndex !== 0)+ bytes.writeUInt32LE(+ 0,+ Number(BigInt(inactiveTarget.header_location.offset)) + 4,+ );+ const inactiveSymbol = relocatable.symbols.find(+ (symbol) => symbol.name.display === "read_values",+ );+ assert.notEqual(inactiveSymbol, undefined);+ if (targetIndex !== 0)+ bytes.writeUInt16LE(+ targetIndex,+ Number(BigInt(inactiveSymbol.location.offset)) + 6,+ );+ const path = join(root.path, name);+ await writeFile(path, bytes);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, path);+ const rows = value.relocations.filter(+ (item) => item.section_index === relocationSection.index,+ );+ assert.ok(rows.length > 0);+ for (const row of rows)+ assert.deepEqual(row.target, {+ kind: "unknown-section",+ reported_section_index: targetIndex,+ offset: row.reported_offset,+ unknown_reason: reason,+ });+ if (targetIndex !== 0)+ assert.equal(+ value.symbols.find((symbol) => symbol.name.display === "read_values")+ .value_meaning,+ "unknown-section-index",+ );+ assert.deepEqual(await readFile(path), bytes);+ cases++;+ }+ }+ const relative = protectedReport.relocations.find(+ (item) => item.type === 8 && item.symbol_index === 0,+ );+ assert.notEqual(relative, undefined, "Required relative relocation absent");+ const relativeOwner = protectedReport.sections[relative.section_index];+ const noSymbolTable = Buffer.from(sectionBearingBytes);+ const relativeHeader = Number(BigInt(relativeOwner.header_location.offset));+ noSymbolTable.writeBigUInt64LE(+ BigInt(relative.location.offset),+ relativeHeader + 24,+ );+ noSymbolTable.writeBigUInt64LE(+ BigInt(relative.location.bytes),+ relativeHeader + 32,+ );+ noSymbolTable.writeUInt32LE(0, relativeHeader + 40);+ const zeroSymbolPath = join(root.path, "relative-without-symbol-table");+ await writeFile(zeroSymbolPath, noSymbolTable);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, zeroSymbolPath);+ const reported = value.relocations.find(+ (item) => item.section_index === relative.section_index,+ );+ assert.equal(reported.symbol_table_index, 0);+ assert.equal(reported.symbol_index, 0);+ assert.equal(reported.symbol_reference_meaning, "zero-symbol-value");+ assert.deepEqual(await readFile(zeroSymbolPath), noSymbolTable);+ cases++;+ }+ const undersizedProgramHeader = Buffer.from(sectionBearingBytes);+ const missingTargetSection = Buffer.from(object);+ missingTargetSection.writeUInt32LE(+ relocatable.sections.length + 100,+ Number(BigInt(relocationSection.header_location.offset)) + 44,+ );+ undersizedProgramHeader.writeUInt16LE(8, 54);+ undersizedProgramHeader.writeUInt16LE(1, 56);+ const symbolTable = relocatable.sections.find(+ (section) => section.type === "SHT_SYMTAB",+ );+ assert.notEqual(symbolTable, undefined);+ const symbol = relocatable.symbols.find(+ (item) => item.name.display === "read_values",+ );+ assert.notEqual(symbol, undefined);+ const extendedWords = Buffer.alloc(+ Number(BigInt(symbolTable.size) / BigInt(symbolTable.entry_size)) * 4,+ );+ extendedWords.writeUInt32LE(symbol.section_index, symbol.entry_index * 4);+ const headers = Buffer.from(+ object.subarray(+ Number(BigInt(relocatable.sections[0].header_location.offset)),+ Number(+ BigInt(relocatable.sections.at(-1).header_location.offset) ++ BigInt(relocatable.sections.at(-1).header_location.bytes),+ ),+ ),+ );+ const extendedHeader = Buffer.alloc(64);+ extendedHeader.writeUInt32LE(18, 4); // SHT_SYMTAB_SHNDX+ extendedHeader.writeBigUInt64LE(BigInt(object.length), 24);+ extendedHeader.writeBigUInt64LE(BigInt(extendedWords.length), 32);+ extendedHeader.writeUInt32LE(symbolTable.index, 40);+ extendedHeader.writeBigUInt64LE(4n, 48);+ extendedHeader.writeBigUInt64LE(4n, 56);+ const extendedObject = Buffer.concat([+ object,+ extendedWords,+ headers,+ extendedHeader,+ ]);+ extendedObject.writeBigUInt64LE(+ BigInt(object.length + extendedWords.length),+ 40,+ );+ extendedObject.writeUInt16LE(relocatable.sections.length + 1, 60);+ extendedObject.writeUInt16LE(+ 0xffff,+ Number(BigInt(symbol.location.offset)) + 6,+ );+ const extendedPath = join(root.path, "external-symbol-index.o");+ await writeFile(extendedPath, extendedObject);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(mode, extendedPath);+ const reported = value.symbols.find(+ (item) => item.name.display === "read_values",+ );+ assert.equal(reported.section_index, 0xffff);+ assert.equal(reported.value_meaning, "unknown-section-index");+ assert.ok(+ value.sections.some((section) => section.type === "SHT_SYMTAB_SHNDX"),+ );+ assert.deepEqual(await readFile(extendedPath), extendedObject);+ cases++;+ }+ for (const [name, option, expected] of [+ ["address-space", "--as=2147483648", '"address_space_bytes": 2147483648'],+ ["cpu", "--cpu=20", '"cpu_seconds": 20'],+ ["file-size", "--fsize=33554432", '"file_size_bytes": 33554432'],+ ]) {+ const wrapper = join(root.path, `python-limit-${name}`);+ const quotedPython = "'" + python.replaceAll("'", "'\"'\"'") + "'";+ await writeFile(+ wrapper,+ `#!/bin/sh\nexec /usr/bin/prlimit ${option} -- ${quotedPython} "$@"\n`,+ { mode: 0o700 },+ );+ const limitedEnvironment = { ...environment, REA_PWNTOOLS_PYTHON: wrapper };+ const limitedClient = new Client({+ name: "limited-layout-verifier",+ version: "1",+ });+ const limitedTransport = new StdioClientTransport({+ command: process.execPath,+ args: [entrypoint, "mcp"],+ env: limitedEnvironment,+ stderr: "pipe",+ });+ try {+ await limitedClient.connect(limitedTransport);+ for (const mode of ["cli", "mcp"]) {+ const value = await inspect(+ mode,+ join(root.path, "protected"),+ undefined,+ limitedEnvironment,+ limitedClient,+ );+ assert.ok(value.limitations.some((item) => item.includes(expected)));+ cases++;+ }+ } finally {+ try {+ await limitedClient.close();+ } finally {+ await limitedTransport.close();+ }+ }+ }+ const unsupported = Buffer.from(object);+ const originalSectionOffset = Number(object.readBigUInt64LE(40));+ const sectionSize = object.readUInt16LE(58);+ const originalSectionCount = object.readUInt16LE(60);+ const sectionCount = 30000;+ const sectionOffset = Math.ceil(object.length / 8) * 8;+ const sectionHeavy = Buffer.alloc(sectionOffset + sectionCount * sectionSize);+ object.copy(sectionHeavy);+ object.copy(+ sectionHeavy,+ sectionOffset,+ originalSectionOffset,+ originalSectionOffset + originalSectionCount * sectionSize,+ );+ for (let index = originalSectionCount; index < sectionCount; index++) {+ sectionHeavy.writeUInt32LE(1, sectionOffset + index * sectionSize + 4);+ sectionHeavy.writeBigUInt64LE(1n, sectionOffset + index * sectionSize + 48);+ }+ sectionHeavy.writeBigUInt64LE(BigInt(sectionOffset), 40);+ sectionHeavy.writeUInt16LE(sectionCount, 60);+ const sectionHeavyPath = join(root.path, "section-heavy.o");+ await writeFile(sectionHeavyPath, sectionHeavy);+ const memoryWrapper = join(root.path, "python-memory-constraint");+ const quotedPython = "'" + python.replaceAll("'", "'\"'\"'") + "'";+ await writeFile(+ memoryWrapper,+ `#!/bin/sh\nexec /usr/bin/prlimit --as=100663296 -- ${quotedPython} "$@"\n`,+ { mode: 0o700 },+ );+ const memoryEnvironment = {+ ...environment,+ REA_PWNTOOLS_PYTHON: memoryWrapper,+ };+ const memoryClient = new Client({+ name: "memory-layout-verifier",+ version: "1",+ });+ const memoryTransport = new StdioClientTransport({+ command: process.execPath,+ args: [entrypoint, "mcp"],+ env: memoryEnvironment,+ stderr: "pipe",+ });+ try {+ await memoryClient.connect(memoryTransport);+ for (const mode of ["cli", "mcp"]) {+ const error = await inspect(+ mode,+ sectionHeavyPath,+ "resource_constraint",+ memoryEnvironment,+ memoryClient,+ );+ assert.equal(error.code, "resource_constraint");+ assert.equal(error.details.resource, "memory");+ assert.ok(+ error.details.reported_limits === null ||+ error.details.reported_limits.address_space_bytes === 100663296,+ );+ assert.equal(error.details.captured_output.truncated, false);+ assert.ok(error.remediation.action.includes("memory"));+ cases++;+ }+ assert.deepEqual(await readFile(sectionHeavyPath), sectionHeavy);+ } finally {+ try {+ await memoryClient.close();+ } finally {+ await memoryTransport.close();+ }+ }+ // Extended section numbering keeps this valid while providing enough work+ // to reach the one-second CPU limit even on faster CI runners.+ const cpuSectionCount = 300000;+ const cpuHeavy = Buffer.alloc(sectionOffset + cpuSectionCount * sectionSize);+ sectionHeavy.copy(cpuHeavy);+ for (let index = sectionCount; index < cpuSectionCount; index++) {+ cpuHeavy.writeUInt32LE(1, sectionOffset + index * sectionSize + 4);+ cpuHeavy.writeBigUInt64LE(1n, sectionOffset + index * sectionSize + 48);+ }+ cpuHeavy.writeUInt16LE(0, 60);+ cpuHeavy.writeBigUInt64LE(BigInt(cpuSectionCount), sectionOffset + 32);+ const cpuHeavyPath = join(root.path, "cpu-section-heavy.o");+ await writeFile(cpuHeavyPath, cpuHeavy);+ const cpuWrapper = join(root.path, "python-cpu-constraint");+ await writeFile(+ cpuWrapper,+ `#!/bin/sh\nexec /usr/bin/prlimit --cpu=1: --core=0: -- ${quotedPython} "$@"\n`,+ { mode: 0o700 },+ );+ const cpuEnvironment = { ...environment, REA_PWNTOOLS_PYTHON: cpuWrapper };+ const cpuClient = new Client({ name: "cpu-layout-verifier", version: "1" });+ const cpuTransport = new StdioClientTransport({+ command: process.execPath,+ args: [entrypoint, "mcp"],+ env: cpuEnvironment,+ stderr: "pipe",+ });+ try {+ await cpuClient.connect(cpuTransport);+ for (const mode of ["cli", "mcp"]) {+ const error = await inspect(+ mode,+ cpuHeavyPath,+ "resource_constraint",+ cpuEnvironment,+ cpuClient,+ );+ assert.equal(error.details.resource, "cpu");+ assert.equal(error.details.reported_limits.cpu_seconds, 1);+ assert.ok(JSON.stringify(error).includes("SIGXCPU"));+ assert.ok(error.remediation.action.includes("CPU"));+ cases++;+ }+ assert.deepEqual(await readFile(cpuHeavyPath), cpuHeavy);+ } finally {+ try {+ await cpuClient.close();+ } finally {+ await cpuTransport.close();+ }+ }+ for (const limit of [1024, 1]) {+ const wrapper = join(root.path, `python-file-size-${limit}`);+ await writeFile(+ wrapper,+ `#!/bin/sh\nexec /usr/bin/prlimit --fsize=${limit}: --core=0: -- ${quotedPython} "$@"\n`,+ { mode: 0o700 },+ );+ const fileEnvironment = { ...environment, REA_PWNTOOLS_PYTHON: wrapper };+ const fileClient = new Client({+ name: "file-size-layout-verifier",+ version: "1",+ });+ const fileTransport = new StdioClientTransport({+ command: process.execPath,+ args: [entrypoint, "mcp"],+ env: fileEnvironment,+ stderr: "pipe",+ });+ try {+ await fileClient.connect(fileTransport);+ for (const mode of ["cli", "mcp"]) {+ const error = await inspect(+ mode,+ sectionHeavyPath,+ "resource_constraint",+ fileEnvironment,+ fileClient,+ );+ assert.equal(error.details.resource, "file-size");+ if (limit === 1024)+ assert.equal(error.details.reported_limits.file_size_bytes, limit);+ else {+ assert.equal(error.details.reported_limits, null);+ assert.ok(JSON.stringify(error).includes("limit report unavailable"));+ }+ assert.ok(error.remediation.action.includes("file-size"));+ cases++;+ }+ assert.deepEqual(await readFile(sectionHeavyPath), sectionHeavy);+ } finally {+ try {+ await fileClient.close();+ } finally {+ await fileTransport.close();+ }+ }+ }+ unsupported.writeUInt16LE(183, 18);+ const core = Buffer.from(object);+ core.writeUInt16LE(4, 16);+ for (const [name, bytes, category] of [+ ["not-elf", Buffer.from("ordinary local text"), "invalid_input"],+ ["truncated", object.subarray(0, 32), "invalid_input"],+ [+ "truncated-tables",+ object.subarray(0, object.length - 1),+ "invalid_input",+ ],+ ...zeroSymbolEntries,+ ...undersizedSymbolEntries,+ ...undersizedRelocationEntries,+ ...invalidRelocationReferences,+ ["unterminated-dynamic-segment", shortDynamic, "invalid_input"],+ ["unterminated-interpreter", unterminatedInterpreter, "invalid_input"],+ [+ "missing-relocation-target-section",+ missingTargetSection,+ "invalid_input",+ ],+ ["undersized-program-header", undersizedProgramHeader, "invalid_input"],+ ["arm64", unsupported, "unsupported_provider"],+ ["core", core, "unsupported_provider"],+ ]) {+ const path = join(root.path, name);+ await writeFile(path, bytes);+ for (const mode of ["cli", "mcp"]) {+ await inspect(mode, path, category);+ assert.deepEqual(await readFile(path), bytes);+ cases++;+ }+ }+ const packedFile = await readFile(join(root.path, "packed-relative"));+ const packedTable =+ reports.get("packed-relative").packed_relative_relocations[0];+ assert.notEqual(packedTable, undefined);+ packedFile.writeBigUInt64LE(1n, Number(BigInt(packedTable.location.offset)));+ const badPackedPath = join(root.path, "relr-bitmap-without-anchor");+ await writeFile(badPackedPath, packedFile);+ for (const mode of ["cli", "mcp"]) {+ await inspect(mode, badPackedPath, "invalid_input");+ assert.deepEqual(await readFile(badPackedPath), packedFile);+ cases++;+ }+ const brokenPython = join(root.path, "broken-configured-python");+ await writeFile(+ brokenPython,+ "#!/rea-missing-configured-python-interpreter\n",+ { mode: 0o700 },+ );+ const unmarkedLaunchers = [];+ for (const status of [75, 76]) {+ const path = join(root.path, `unmarked-launcher-${status}`);+ await writeFile(+ path,+ `#!/bin/sh\nprintf 'launcher exited ${status}\\n' >&2\nexit ${status}\n`,+ { mode: 0o700 },+ );+ unmarkedLaunchers.push(path);+ }+ for (const [configuredPython, category] of [+ [root.path, "unavailable"],+ [brokenPython, "unavailable"],+ ...unmarkedLaunchers.map((path) => [path, "execution_failure"]),+ ]) {+ const selectedEnvironment = {+ ...environment,+ REA_PWNTOOLS_PYTHON: configuredPython,+ };+ const selectedClient = new Client({+ name: "unavailable-layout-verifier",+ version: "1",+ });+ const selectedTransport = new StdioClientTransport({+ command: process.execPath,+ args: [entrypoint, "mcp"],+ env: selectedEnvironment,+ stderr: "pipe",+ });+ try {+ await selectedClient.connect(selectedTransport);+ for (const mode of ["cli", "mcp"]) {+ const error = await inspect(+ mode,+ join(root.path, "protected"),+ category,+ selectedEnvironment,+ selectedClient,+ );+ if (category === "unavailable") {+ assert.equal(error.code, "provider_unavailable");+ assert.equal(+ error.details.rejections[0].diagnostics.executable_path,+ configuredPython,+ );+ } else {+ assert.equal(error.code, "execution_failure");+ assert.ok(JSON.stringify(error).includes("launcher exited"));+ assert.ok(JSON.stringify(error).includes("resource_failure_marker"));+ }+ cases++;+ }+ } finally {+ try {+ await selectedClient.close();+ } finally {+ await selectedTransport.close();+ }+ }+ }+ for (const mode of ["cli", "mcp"]) {+ await inspect(mode, join(root.path, "absent"), "invalid_input");+ cases++;+ }+ for (const name of ["protected", "sectionless"]) {+ const trace = join(root.path, `exec.trace.${name}`);+ await execute(+ strace,+ [+ "-ff",+ "-e",+ "trace=execve,execveat",+ "-s",+ "4096",+ "-o",+ trace,+ process.execPath,+ entrypoint,+ "inspect-binary-layout",+ join(root.path, name),+ "--json",+ ],+ {+ env: { ...environment, PATH: "/usr/bin:/bin" },+ timeout: 45_000,+ maxBuffer: 256 * 1024 * 1024,+ },+ );+ }+ const executions = [];+ for (const file of await readdir(root.path)) {+ if (!file.startsWith("exec.trace.")) continue;+ for (const line of (await readFile(join(root.path, file), "utf8")).split(+ "\n",+ )) {+ if (!/execve(?:at)?\(/.test(line)) continue;- const match = /^execve\("([^\"]+)"/.exec(line);++ const match = /^execve\("([^"]+)"/.exec(line);+ assert.notEqual(+ match,+ null,+ `Unresolved executable identity in syscall trace: ${line}`,+ );+ assert.ok(+ line.endsWith(" = 0") || / = -1 [A-Z]+/.test(line),+ `Incomplete exec observation: ${line}`,+ );+ const ownershipInspection =+ ["/usr/bin/ps", "/bin/ps"].includes(match[1]) &&+ line.includes('["ps", "-axo", "pid=,ppid=,pgid=,stat=,command="]');+ assert.ok(+ [process.execPath, python].includes(match[1]) || ownershipInspection,+ `Unexpected attempted host execution: ${line}`,+ );+ executions.push(match[1]);+ }+ }+ assert.ok(executions.includes(process.execPath));+ assert.ok(executions.includes(python));+ cases += 2;+ } catch (cause) {+ failures.push(cause);+ } finally {+ for (const close of [+ () => client.close(),+ () => transport.close(),+ () => root.close(),+ ]) {+ try {+ await close();+ } catch (cause) {+ failures.push(cause);+ }+ }+ }+ const verifier = await completeVerifierRun(run);+ try {+ assert.equal(verifier.process_lineage.status, "verified");+ assert.deepEqual(verifier.process_lineage.descendants, []);+ } catch (cause) {+ failures.push(cause);+ }+ if (failures.length > 0) {+ console.error(+ JSON.stringify(+ { status: "failed", public_cases: cases, verifier },+ null,+ 2,+ ),+ );+ throw new AggregateError(+ failures,+ "Offline binary layout verification failed; cleanup failures are retained.",+ );+ }+ console.log(+ JSON.stringify(+ {+ status: "passed",+ public_cases: cases,+ bootstrap_boundary_cases: bootstrapCases,+ large_index_mcp: verifyLargeMcp ? "verified" : "not-requested",+ profile: "pwntools4.15.0/pyelftools0.33/Unicorn2.1.2",+ target_execution: "exec-syscalls-verified-absent",+ verifier,+ },+ null,+ 2,+ ),+ );++ async function inspect(+ mode,+ path,+ category,+ selectedEnvironment = environment,+ selectedClient = client,+ ) {+ let envelope;+ if (mode === "mcp") {+ const response = await selectedClient.callTool(+ {+ name: "inspect_binary_layout",+ arguments: { path },+ },+ { timeout: 300_000 },+ );+ const value = JSON.parse(mcpTextValue(response));+ if (category !== undefined) {+ assert.equal(response.isError, true);+ assert.equal(value.error.category, category, JSON.stringify(value.error));+ return value.error;+ }+ assert.notEqual(response.isError, true, mcpTextValue(response));+ envelope = value.evidence;+ assert.deepEqual(value.result, envelope.normalized_result);+ } else {+ let response;+ try {+ response = await execute(+ process.execPath,+ [entrypoint, "inspect-binary-layout", path, "--json"],+ {+ env: selectedEnvironment,+ timeout: 40_000,+ maxBuffer: 256 * 1024 * 1024,+ },+ );+ } catch (cause) {+ if (category === undefined) throw cause;+ if (typeof cause.code !== "number") throw cause;+ const error = JSON.parse(cause.stdout);+ assert.equal(error.category, category, JSON.stringify(error));+ return error;+ }+ assert.equal(category, undefined, "Expected selected input to fail");+ envelope = JSON.parse(response.stdout);+ }+ const evidence = parseEvidence(envelope);+ assert.equal(evidence.subject.local_path, path);+ assert.equal(+ evidence.provider.version,+ );+ assert.deepEqual(evidence.normalized_result, evidence.raw_result);+ assert.equal(evidence.normalized_result.diagnostics.truncated, false);+ return evidence.normalized_result;+ }diff --cc skills/reverse-engineer-anything/SKILL.mdindex 2f099f295,0657e88eb..83d550ee5--- a/skills/reverse-engineer-anything/SKILL.md+++ b/skills/reverse-engineer-anything/SKILL.md@@@ -2,9 -2,9 +2,9 @@@name: reverse-engineer-anythingdescription: Reverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.metadata:-- version: "30"-- tool_count: 136- catalog_digest: "047ba77689d22d3b3dac6f51fae06a1a306aaab24fa3be7c2007b396a5fd26f7"- catalog_digest: "fc75e5d817f64311dacc23ef2bde4223fd12d2d5a9c49e93051ac9f7857b2d8c"++ version: "31"++ tool_count: 137++ catalog_digest: "ce23d159fbfc07b338a5e2d51569a71597842f0cf3a3c09986c799512752ab02"---# REAdiff --cc src/generatedPackageMetadata.tsindex 3c4aff2ed,3c4aff2ed..fc03cee9f--- a/src/generatedPackageMetadata.ts+++ b/src/generatedPackageMetadata.ts@@@ -5,5 -5,5 +5,5 @@@ export const PACKAGE_METADATA =serverSdkVersion: "2.3.1",clientSdkVersion: "2.3.1",coreSdkVersion: "2.3.1",-- skillVersion: "30",++ skillVersion: "31",} as const;