Releases: kernelstub/Retract
Releases · kernelstub/Retract
0.2.0
2026-06-04
Added
- Added a stronger x86/x64 disassembly path with REX and ModRM-aware decoding for common instructions, stack operands, conditional branches, indirect calls, and indirect jumps.
- Added a more capable C-like decompiler that recovers stack locals, labels, branch conditions, calls, arithmetic, bitwise operations, and richer function metadata.
- Added reverse-engineering workspace artifacts used by common RE tools:
deep/function_tags.jsonanddeep/function_tags.csvfor auto tags such as leaf functions, wrappers, parser/state-machine candidates, no-return candidates, and large stack frames.deep/annotations.jsonanddeep/annotations.csvfor auto comments and notebook-style analyst notes.deep/jump_tables.jsonanddeep/jump_tables.csvfor indirect branch and dense-branch jump-table candidates.
- Added additional RE-tool style datasets:
deep/api_call_sites.jsonanddeep/api_call_sites.csvfor resolved imported API call sites and likely calling-convention argument registers.deep/string_references.jsonanddeep/string_references.csvfor instruction-to-string/data reference candidates.deep/stack_frames.jsonanddeep/stack_frames.csvfor per-function stack frame summaries, locals, arguments, and saved registers.deep/basic_block_notes.jsonanddeep/basic_block_notes.csvfor CFG block annotations such as terminal blocks, branches, and loop backedges.deep/decompiler_hints.jsonanddeep/decompiler_hints.csvfor address-level hints such as zeroing idioms, condition sources, call-site review points, address calculations, and undecoded bytes.
- Added advanced RE triage artifacts:
deep/function_clusters.jsonanddeep/function_clusters.csvfor SimHash and function-shape clustering.deep/hot_paths.jsonanddeep/hot_paths.csvfor ranked manual-audit paths.deep/patch_points.jsonanddeep/patch_points.csvfor conditional branch, call-site, padding, and breakpoint patch candidates.deep/calling_conventions.jsonanddeep/calling_conventions.csvfor calling-convention and argument-storage guesses.deep/unpacking_hints.jsonanddeep/unpacking_hints.csvfor high-entropy, WX, overlay, loader, and self-modifying-code guidance.deep/type_hints.jsonanddeep/type_hints.csvfor propagated type hints from API calls and string references.
- Added advanced triage and indicator panes:
deep/timeline.jsonanddeep/timeline.csvfor ordered analysis events.deep/capability_matrix.jsonanddeep/capability_matrix.csvfor scored capability rollups.deep/anti_analysis.jsonanddeep/anti_analysis.csvfor anti-debug, VM, sandbox, and tool-detection signals.deep/crypto_indicators.jsonanddeep/crypto_indicators.csvfor crypto APIs and constants.deep/persistence_indicators.jsonanddeep/persistence_indicators.csvfor registry, service, scheduled-task, startup, and file persistence hints.deep/syscall_indicators.jsonanddeep/syscall_indicators.csvfor syscall, interrupt, segment-register, and low-level execution hints.
- Extended
project/retract_project.jsonwith function tags, annotations, jump-table candidates, API call sites, string references, stack frames, block notes, decompiler hints, function clusters, hot paths, patch points, calling conventions, unpacking hints, and type hints. - Added external RE-tool helper exports:
project/labels.mapfor address-to-name mappings.project/rizin_radare2.r2for radare2/Rizin labels and comments.project/ghidra_bookmarks.tsvfor bookmark/comment style imports.project/ida_names_comments.idcfor IDA-style names and comments.
- Added focused tests for ModRM stack/branch decoding, decompiler recovery of locals, labels, and conditions, and RE workspace artifact generation.
Changed
- Expanded
reports/reverse_engineering.mdto include function tags, jump-table candidates, auto annotations, call sites, string references, stack frames, decompiler hints, hot paths, function clusters, patch points, unpacking hints, calling-convention guesses, and propagated type hints. - Expanded
deep/analyst_workflow.mdto include RE workspace tags, jump-table candidates, call sites, string references, hot paths, unpacking hints, and function clusters. - Added the advanced RE Workspace view to the React web UI and surfaced hot paths, patch points, API call sites, calling conventions, clusters, unpacking hints, type hints, and decompiler hints.
- Expanded the React RE Workspace and Deep views with timeline, capability matrix, and indicator panes.
- Added an Advanced RE section to the fallback generated web index.
- Updated README and output documentation to list the new reverse-engineering artifacts.
Full Changelog: 1.0.1...0.2.0