Ysopwnableandfactory-droid[bot]
7ae3c50a9d
Put setup, developer commands, MCP replies, and investigation recipes before client details and implementation references. Preserve existing guide anchors, examples, provenance, partial-result recovery, and provider restrictions. Correct verified documentation drift, synchronize the Ghidra capability wording, and regenerate metadata for skill version 40. Keep uncertain platform and lifecycle findings unchanged. Refs #2156. Validation: 56 focused tests, check:fast, docs:check, VitePress production build, format and link/example checks. Real isolated CLI/MCP probes cover Ghidra, NativeAOT, HAR, cancellation, Chrome, large ELF delivery, native type limits, and the new JS/managed/process/setup recipes. Heavy work uses two CPUs; a resource-heavy DOM probe was stopped and replaced by a smaller real CDP payload-limit control. Windows, macOS GUI, ADB, and the full CI matrix were not executed. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
36 lines
2.1 KiB
Markdown
36 lines
2.1 KiB
Markdown
# Source-built conformance fixtures
|
|
|
|
These sources are deliberately small semantic oracles for REA providers. Run
|
|
`npm run verify:fixtures` on macOS or Linux to compile them into the ignored
|
|
`build/conformance/` directory, emit a hash-and-toolchain manifest, and verify
|
|
their platform-native symbols and strings with local command-line tools. The
|
|
portable C, version, and large-inventory fixtures build as Mach-O on macOS and
|
|
ELF on Linux; Objective-C, Swift, and N-API-like fixtures remain macOS-only.
|
|
|
|
Only source files are versioned. Generated binaries, generated large-fixture
|
|
source, debug information, and manifests must remain under `build/`.
|
|
|
|
`ghidra/inventory.c` is also compiled into temporary Linux ELF debug and
|
|
stripped variants by `npm run verify:ghidra`. It fixes local functions, external
|
|
`puts` linkage, defined strings, and writable/executable memory needed to prove
|
|
the read-only Ghidra inventory contracts without committing a binary.
|
|
|
|
`scripts/create-ghidra-windows-fixture.mjs` separately emits a deterministic,
|
|
ignored native x86-64 PE application for the controlled Windows Ghidra P0 lane.
|
|
The generator and fixed SHA-256 are versioned; the `.exe` is never committed or
|
|
executed. `npm run verify:ghidra:windows` uses it to verify the admitted read-only operation inventory,
|
|
digest linkage, transport, and cleanup on the self-hosted real-Ghidra runner.
|
|
|
|
The C fixture fixes a known call chain and strings. The version pair fixes an
|
|
added symbol, changed string, and changed call relationship. The generated
|
|
large fixture contains 1,205 uniquely named functions and strings to verify that
|
|
providers return complete inventories. Objective-C, Swift, and N-API-like
|
|
fixtures provide metadata-oriented inputs without package
|
|
or network dependencies.
|
|
|
|
`readiness/` adds source-only generated JavaScript CLI and Electron fixtures for
|
|
the repository's reconstruction-readiness verifier. `npm run verify:readiness`
|
|
combines them with the compiled native fixtures, exercises CLI and MCP parity
|
|
for real analysis operations, and checks the internal machine-readable report
|
|
documented in `docs/reconstruction-readiness.md`.
|