Files
reverse-engineering-anything/docs/specs/web/source-map-budget-recovery/spec.md
T
morluto cb4e5cfbff feat(analysis): make resource budgets recoverable across CLI and MCP (#9706)
* refactor(analysis): centralize resource budgets and recovery facts

* feat(analysis): expose ASAR and Ghidra runtime admission controls

* feat(artifacts): expose reader admission and preserve limited recognition

* feat(javascript): expose recoverable semantic precision budgets

* feat(web): add recoverable source-map budgets and compact retained views

* feat(web): make historical capture decoding budgets recoverable

* fix(desktop): enforce selected view policies across capture and export

* feat(runtime): make Frida and LLDB retention budgets selectable

* feat(native): expose diagnostic budgets and preserve exhaustion causes

* feat(managed): expose recoverable snapshot and representation budgets

* feat(metadata): make Go and Rust inspection budgets recoverable

* feat(wasm): expose representation and producer admissions

* feat(evm): expose per-call worker resource budgets

* feat(android): make resource and string-pool omissions recoverable

* feat(producers): expose command and recorded-capture budgets

* docs(analysis): record recovery contracts and integrated validation

* fix(docs): link calibration oracle from published verification pages

* fix(docs): restore desktop task anchors and receipt links

* test(analysis): align fixtures with selectable budget contracts

* fix(analysis): remove source-location projector dependency cycle

* test(analysis): refresh budget recovery and verifier regressions

* test(analysis): preserve format and publication recovery expectations

* test(windows): align conformance with owned runtime admission

* fix(desktop): preserve selected alias kinds in exported state

* test(analysis): align provider fixtures with recoverable budgets

* test(desktop): validate emitted alias metadata structurally

* fix(ghidra): classify bounded Windows endpoint refusals

* test(cli): assert selectable artifact admission recovery

* fix(cli): preserve capture provenance in environment builds
2026-11-10 05:11:20 -05:00

1.6 KiB

Per-call source-map budget recovery

Problem

Local tracing and bundle source-map collection discard or refuse useful facts at independent fixed byte, structural and codec-heap ceilings. A longer timeout cannot admit the same map. Related: #6176, #8434, #8978.

Requirements

  • Preserve defaults unless representative calibration justifies a change; preserve selected artifact identities, source declarations, unknown coverage and cleanup ownership.
  • Admit explicit bounded per-call budgets at the producing owners, and propagate the same policy through acquisition, structural preflight, codec child and complete request/reply checks.
  • Reject inapplicable fields; preserve omission in Evidence parameters.
  • Explain the exact exhausted control, effective value, range, application point and recovery. Retain real representation and client constraints.
  • Keep upstream decoding unchanged and preflight rows/segments before allocation.

Acceptance

A valid local map fails at an explicitly lowered admission, names map_bytes, and succeeds for the same point through the public CLI after increasing that budget. The calibrated 8 MiB default admits a complete map above 4 MiB while preserving an explicit smaller selection; see the calibration record. A finite fetched map similarly recovers after increasing decoded_records. Malformed maps, cancellation and failed cleanup retain their existing semantics.

Non-goals

No source fetching beyond existing origin authority, application execution, implicit retries, unbounded allocation or change to client deadlines.