nenadzaric/skills-android-retrace-stacktrace repository overview

⁠retrace-stacktrace

Recover Java stack frames from a supplied matching-build R8 mapping and local stack trace.

Pinned R8 Retrace9.5.26, source e3b702721f5dfe78fc536316df4741ff6f32916a. Linux amd64 tested. No APK execution, native tombstone translation, device, provider or runtime network request.

⁠Immutable image

docker pull --platform linux/amd64 docker.io/nenadzaric/skills-android-retrace-stacktrace@sha256:4d96089fd463ec071fef7ae4591668f38c2768b2183ada24ca971097cd80ce08

Image index: sha256:372a2236d06b5cbbee5ab058b8ad9ce213cbb6395bac7edf774f4cf11e83f437. Tested Google Maven binary is byte-identical to the official release r8lib.jar.

⁠Actual adapter source and original notices

Retrieve the immutable companion artifact below. It contains retrace-stacktrace/build-source/ with the actual custom adapter, Dockerfile, owned text fixtures, native tests, independent verifier and safe platform definitions. Native upstream alone does not contain this custom entrypoint. notices/primary-source/ retains official R8 sourceJAR and release SPDX; notices/pinned-build-source/ retains matching build definitions; notices/dependency-payloads/ retains exact dependency sources/POMs; notices/installed-image/ retains original runtime notices; notices/openjdk-corresponding-source/ retains exact OpenJDK source, Debian patches and descriptor.

oras pull docker.io/nenadzaric/skills-android-retrace-stacktrace@sha256:8bb2def87ebd48040c7b2af28a083dd00cd9bdf7bec3144d09b3abbaa4291877
sha256sum retrace-stacktrace-source-notices.tar.gz

Expected bundle SHA256: c706d2a122c7bcc579f8b5345f354762cad97616de69414ca8f7907de6bda38d. Extract and read retrace-stacktrace/SOURCE-DELIVERY.txt and retrace-stacktrace/notices/SOURCE-AND-NOTICES.json for source/image/proof hashes. This preserves the build-source snapshot; later recipe/catalog delivery or publication metadata can change without runtime changes.

Pinned native source: https://r8.googlesource.com/r8/+/e3b702721f5dfe78fc536316df4741ff6f32916a⁠

⁠Verification and limits

Eight owned-fixture native cases passed on the notice-bearing image: recovered exactFixture.java42 frame, valid empty trace, unchanged unmatched mapping, malformed mapping, missing mapping, oversized trace, non-UTF8 and existing-output preservation. The real private fixture-mapping/fixture-trace/tool/verifier workflow passed all4nodes on at most1machine; actual downloaded fixture/native/verifier hashes and completion registry index were checked. These checks do not prove arbitrary mapping correctness or production crash compatibility.

Inputs are local UTF-8 without NUL: mapping nonempty/up to20MiB, trace up to1MiB including empty. Native process timeout90s, JVM heap256MiB, output/stderr4MiB caps checked after exit. These are not peak disk/process-memory containment guarantees. Unmatched mappings can return exit0/unchanged obfuscated frames; empty trace can validly yield empty output. Native errors become adapter2; existing nonempty output is preserved.

⁠Reproduce owned checks

cd retrace-stacktrace/build-source
IMAGE=docker.io/nenadzaric/skills-android-retrace-stacktrace@sha256:4d96089fd463ec071fef7ae4591668f38c2768b2183ada24ca971097cd80ce08 python3 test_native.py

The driver runs network-none containers over owned inert text. Build-time downloads are pinned; runtime performs no downloads.

⁠License scope

BSD-3-Clause native core and original bundled dependency/runtime terms are retained. The custom first-party adapter follows existing workflows Proprietary policy; no new grant/relicense. Official release SPDX identifies30build dependency records, all binarySHA256 matched;29corresponding sourcearchives are delivered. The listenablefuture placeholder contains0class files and its source404 is retained with original binary/POM. The releaseSPDX describes build dependencies, not an exhaustive minimized-binary composition/SBOM or bit-reproducible build claim. Original installed runtime notices and exact OpenJDK corresponding source are supplied.