Files
rea/src/javascript/recovery/WakaruRelease.ts
T
ded59689ce fix(javascript): accept the Wakaru 1.x release line and verify 1.14.0 (#1540)
* fix(javascript): accept the Wakaru 1.x release line and verify 1.14.0

Exact --version equality rejected every Wakaru build except 1.13.0, and
strict report schemas rejected any added field, so each upstream release
broke recovery until REA re-pinned. Wakaru now documents that --version,
--json and provenance.json change only by addition within a major version.

Admit ^1.13.0 with the verified/compatible split used for Binwalk and
Unblob, report the observed version instead of the pinned constant, and
add a limitation for unverified releases. Parse reports with loose
objects and keep the reported module status as a string; path, identity,
range and file-set checks stay exact.

Move the audited pin, submodule, CI binary and verifier to 1.14.0, and
document where to get the binary from the refusal message.

* fix(javascript): project known Wakaru warning fields

---------

Co-authored-by: morluto <76467478+morluto@users.noreply.github.com>
2026-10-10 23:02:15 +08:00

41 lines
1.9 KiB
TypeScript

/** Unchanged upstream source pin; executed bytes are identified separately. */
export const WAKARU_RELEASE = {
version: "1.14.0",
revision: "8219bf5016a063d7fb215101a8c45d5959ec733f",
repository: "https://github.com/pionxzh/wakaru",
} as const;
/**
* Releases the report parser accepts. Wakaru changes `--version`, `--json`
* and `provenance.json` only by addition within a major version
* (https://github.com/pionxzh/wakaru/blob/v1.14.0/docs/cli.md#machine-readable-output-compatibility);
* 1.13.0 is the first release this adapter verified.
*/
export const WAKARU_ACCEPTED_RANGE = "^1.13.0";
/** Catalog identity for the verified Wakaru release. Evidence replaces version with the observed banner. */
export const WAKARU_PROVIDER_IDENTITY = {
id: "wakaru",
name: "Wakaru",
version: WAKARU_RELEASE.version,
} as const;
/** Per-operation resource bounds for the verified Linux adapter. */
export const RECOVERY_LIMITS = {
inputBytes: 64 * 1024 * 1024,
outputBytes: 128 * 1024 * 1024,
outputEntries: 10000,
reportBytes: 8 * 1024 * 1024,
addressSpaceBytes: 1024 * 1024 * 1024,
timeoutMs: 120000,
} as const;
/** Public limitations for transformations and extraction provenance. */
export const RECOVERY_LIMITATIONS = [
"Recovered sources are derived artifacts; original variable names and runtime equivalence are not established.",
"Extraction ranges refer to half-open UTF-8 byte offsets in the original input, not rewritten line positions or whole-bundle coverage.",
"Emitted source maps are preserved as reported by the engine; their mapping accuracy is not independently established.",
"Inspection mode may produce non-executable regions. No input or recovered application code is executed.",
"Linux adapter: one worker, 1 GiB address-space ceiling, 120-second deadline, 64 MiB input, 128 MiB output, 10000 output entries and 8 MiB per diagnostic/report stream. Resource limits are per operation, not aggregate host containment.",
] as const;