[PR #7001] docs(android): guide large APK heap budgeting and focused direct loads #7565

New issue

Open

opened 2026-11-03 13:38:45 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-11-03 13:38:45 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/7001
Author: @Tsury
Created: 10/24/2026
Status: 🔄 Open

Base: main ← Head: docs/android-large-apk-guide

📝 Commits (1)

6dd125b docs(android): guide large APK heap budgeting and focused direct loads

📊 Changes

1 file changed (+40 additions, -0 deletions)

View changed files

📝 .agents/skills/reverse-engineer-anything/references/android-applications.md (+40 -0)

📄 Description

Summary

The Android skill names the heap setting but gives no budgeted large-APK example. It also leaves agents using direct headless JADX without guidance on limiting preprocessing. Add one conditional section with a scoped CLI heap example and the direct 0.7.1 load_apk prefix recipe.

Evidence and validation

Reviewed retained diagnostics from a 105,453-class APK: an observed 2 GiB heap exhausted; loading completed with a 6144 MiB heap cap. The later exact-class lookup still required a valid selector. No private sample, paths, or logs are attached.
Checked the JSON example against the saved 0.7.1 tools/list schema and a successful prefix-scoped direct load. include_packages is a comma-separated string and is not a REA Android tool argument.
Compared the heap example with docs/android-analysis.md; reviewed the diff and ran git diff --check successfully.
No APK was rerun and no runtime or package tests were run for this prose-only change. No performance measurements or universal heap sizing claim.

Related: #3517 already addresses typed heap diagnostics. This change improves the skill's practical recovery guidance rather than changing that implementation.

Contract and boundary impact

Documentation only; no target interaction, CLI/MCP schema change, provider upgrade, new capability, configuration write, or generated output. Existing ordinary APK instructions and evidence limitations remain. Heap sizing requires available host/container memory plus native-memory headroom. Prefix filtering limits coverage and is documented as such. Maintainer capability scope decision: not applicable.

Author readiness

Human owner: @Tsury

I reviewed the final diff and relevant existing code, understand the change and its edge cases, and take responsibility for the complete PR, including AI-assisted work.
I checked the evidence above, confirmed it supports the current change, and recorded meaningful validation gaps.
I declare this PR ready for initial maintainer review.

Prepared with AI assistance. This PR remains a draft; human readiness declarations are left for the owner.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/7001 **Author:** [@Tsury](https://github.com/Tsury) **Created:** 10/24/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/android-large-apk-guide` --- ### 📝 Commits (1) - [`6dd125b`](https://github.com/morluto/rea/commit/6dd125bdff6b8c5a50300a6e8e654ef0144713e3) docs(android): guide large APK heap budgeting and focused direct loads ### 📊 Changes **1 file changed** (+40 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `.agents/skills/reverse-engineer-anything/references/android-applications.md` (+40 -0) </details> ### 📄 Description ## Summary The Android skill names the heap setting but gives no budgeted large-APK example. It also leaves agents using direct headless JADX without guidance on limiting preprocessing. Add one conditional section with a scoped CLI heap example and the direct 0.7.1 `load_apk` prefix recipe. ## Evidence and validation - Reviewed retained diagnostics from a 105,453-class APK: an observed 2 GiB heap exhausted; loading completed with a 6144 MiB heap cap. The later exact-class lookup still required a valid selector. No private sample, paths, or logs are attached. - Checked the JSON example against the saved 0.7.1 `tools/list` schema and a successful prefix-scoped direct load. `include_packages` is a comma-separated string and is not a REA Android tool argument. - Compared the heap example with `docs/android-analysis.md`; reviewed the diff and ran `git diff --check` successfully. - No APK was rerun and no runtime or package tests were run for this prose-only change. No performance measurements or universal heap sizing claim. Related: #3517 already addresses typed heap diagnostics. This change improves the skill's practical recovery guidance rather than changing that implementation. ## Contract and boundary impact Documentation only; no target interaction, CLI/MCP schema change, provider upgrade, new capability, configuration write, or generated output. Existing ordinary APK instructions and evidence limitations remain. Heap sizing requires available host/container memory plus native-memory headroom. Prefix filtering limits coverage and is documented as such. Maintainer capability scope decision: not applicable. ## Author readiness Human owner: @Tsury - [ ] I reviewed the final diff and relevant existing code, understand the change and its edge cases, and take responsibility for the complete PR, including AI-assisted work. - [ ] I checked the evidence above, confirmed it supports the current change, and recorded meaningful validation gaps. - [ ] I declare this PR ready for initial maintainer review. Prepared with AI assistance. This PR remains a draft; human readiness declarations are left for the owner. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

2026-11-03 13:38:45 +00:00

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

morluto/rea#7565

No description provided.

Rows
Columns