Release 0.1.2: Claude install & user-level roots

Bump package to v0.1.2 and add Claude installation support and docs. Introduces a persistent user-level application root for workspaces, database, cache, and audit paths (defaults under ~/.windows-exe-decompiler-mcp-server) and loads config from that path by default. Update Codex and Copilot install scripts to write WORKSPACE_ROOT, DB_PATH, CACHE_ROOT and AUDIT_LOG_PATH; add a new install-to-claude.ps1 and CLAUDE_INSTALLATION.md. Improve DecompilerWorker and config handling: better sample resolution, Ghidra project fallback/mapping, new analysis options (processor/language/cspec/scriptPaths), and plumbing for PE function recovery and runtime helpers. Add multiple PE/Rust recovery tools and workflows plus corresponding unit tests; update README/CHANGELOG to document these changes.

Author: Last-emo-boy

.gitignore

@@ -28,6 +28,7 @@ audit.log
 
 # Runtime state
 cache/
+.cache/
 data/
 tmp/
 temp/
@@ -44,6 +45,7 @@ live-cache-runtime-export/
 .idea/
 .kiro/
 codex-mcp-config.toml
+.mcp.json
 *~
 *.swp
 *.swo

CHANGELOG.md

@@ -9,6 +9,15 @@ Versioning where practical.
 
 - Ongoing reverse-engineering coverage, MCP workflow orchestration, and packaging polish
 
+## [0.1.2] - 2026-03-12
+
+- Upgraded `workflow.reconstruct` with universal preflight orchestration, including binary role profiling, Rust-specific profiling, and optional automatic function-index recovery before export
+- Aligned `workflow.semantic_name_review` and `workflow.function_explanation_review` with reconstruct refresh preflight, provenance, and selection diff semantics
+- Added `.pdata`-driven PE recovery tooling: `pe.pdata.extract`, `code.functions.smart_recover`, `pe.symbols.recover`, and `code.functions.define`
+- Added `workflow.function_index_recover` and `rust_binary.analyze` to make Rust and hard-to-index native samples recoverable even when Ghidra function extraction fails
+- Hardened sample/original and Ghidra project fallback handling so analysis can continue when older workspaces are incomplete
+- Stabilized runtime state defaults by moving workspace, database, cache, and audit paths to persistent user-level configuration roots
+
 ## [0.1.1] - 2026-03-11
 
 - Added `binary.role.profile` for universal EXE/DLL/.NET/driver role profiling, export surface triage, and COM/service/plugin indicators

CLAUDE_INSTALLATION.md

@@ -0,0 +1,113 @@
+# Claude Installation
+
+This repository can be installed into Claude Code as an MCP server in three
+scopes:
+
+- `local`: machine-local config for the current project, stored in
+  `~/.claude.json`
+- `user`: machine-wide config for your user, stored in `~/.claude.json`
+- `project`: project-scoped config written to `.mcp.json` in the repo root
+
+On this Windows setup, writing the config file directly is more reliable than
+shelling out to `claude mcp add`, so the install script uses the config-file
+path directly and then verifies the result with `claude mcp get`.
+
+## Prerequisites
+
+- Claude Code CLI installed and available as `claude`
+- Node.js available as `node`
+- Project already built with `npm run build`
+
+## Recommended Install
+
+From the repository root:
+
+```powershell
+.\install-to-claude.ps1
+```
+
+The default scope is `user`, so this installs the server once for your account
+and makes it available in all Claude Code projects on this machine.
+
+The script also writes a stable `WORKSPACE_ROOT` by default:
+
+- `%USERPROFILE%/.windows-exe-decompiler-mcp-server/workspaces`
+
+It also pins:
+
+- `DB_PATH`
+- `CACHE_ROOT`
+- `AUDIT_LOG_PATH`
+
+## Pass Ghidra Explicitly
+
+```powershell
+.\install-to-claude.ps1 -GhidraPath "C:\path\to\ghidra"
+```
+
+The script writes both `GHIDRA_PATH` and `GHIDRA_INSTALL_DIR`.
+
+If you want a different persistent workspace root:
+
+```powershell
+.\install-to-claude.ps1 -WorkspaceRoot "D:\reverse-data\workspaces"
+```
+
+## Change Scope
+
+Examples:
+
+```powershell
+.\install-to-claude.ps1 -Scope local
+.\install-to-claude.ps1 -Scope user
+.\install-to-claude.ps1 -Scope project
+```
+
+If you choose `project`, the script writes `.mcp.json` into the repository
+root. If you choose `local` or `user`, the script updates `~/.claude.json`.
+Use `local` only when you want this repo to override the global `user`
+registration.
+
+## Manual Config Format
+
+Claude Code recognizes the standard MCP config shape:
+
+```json
+{
+  "mcpServers": {
+    "windows-exe-decompiler": {
+      "command": "node",
+      "args": ["E:/Playground/Reverse/dist/index.js"],
+      "cwd": "E:/Playground/Reverse",
+      "env": {
+        "WORKSPACE_ROOT": "C:/Users/<you>/.windows-exe-decompiler-mcp-server/workspaces",
+        "GHIDRA_PATH": "C:/path/to/ghidra",
+        "GHIDRA_INSTALL_DIR": "C:/path/to/ghidra"
+      }
+    }
+  }
+}
+```
+
+That same server object works in:
+
+- repo-local `.mcp.json` for `project` scope
+- top-level `mcpServers` in `~/.claude.json` for `user` scope
+- `projects["E:/path/to/repo"].mcpServers` in `~/.claude.json` for `local`
+  scope
+
+## Verify
+
+```powershell
+claude mcp list
+claude mcp get windows-exe-decompiler
+```
+
+If you used `project` scope, `claude mcp get` should report `Scope: Project
+config (shared via .mcp.json)`. If you used `local` or `user`, it should report
+the corresponding Claude config scope from `~/.claude.json`.
+
+## References
+
+- Claude Code MCP overview: https://docs.anthropic.com/en/docs/claude-code/mcp
+- Claude Code MCP CLI reference: https://docs.anthropic.com/en/docs/claude-code/mcp#manage-mcp-servers

CODEX_INSTALLATION.md

@@ -14,18 +14,35 @@ Then run the helper script from the repository root:
 .\install-to-codex.ps1
 ```
 
+By default, the script writes a stable `WORKSPACE_ROOT` under your user profile:
+
+- `%USERPROFILE%/.windows-exe-decompiler-mcp-server/workspaces`
+
+It also pins:
+
+- `DB_PATH`
+- `CACHE_ROOT`
+- `AUDIT_LOG_PATH`
+
 If Ghidra is not already configured through `GHIDRA_PATH` or
 `GHIDRA_INSTALL_DIR`, pass it explicitly:
 
 ```powershell
 .\install-to-codex.ps1 -GhidraPath "C:\tools\ghidra"
 ```
 
+If you want a different persistent workspace root:
+
+```powershell
+.\install-to-codex.ps1 -WorkspaceRoot "D:\reverse-data\workspaces"
+```
+
 ## What the script does
 
 - validates that `dist/index.js` exists
 - registers the MCP server with Codex
 - updates `~/.codex/config.toml`
+- writes `WORKSPACE_ROOT` so workspaces do not depend on the current repo path
 - writes `GHIDRA_PATH` and `GHIDRA_INSTALL_DIR` when a Ghidra path is provided
 
 ## Manual configuration example
@@ -41,7 +58,7 @@ cwd = "E:/path/to/repo"
 startup_timeout_sec = 30
 tool_timeout_sec = 300
 enabled = true
-env = { GHIDRA_PATH = "C:/tools/ghidra", GHIDRA_INSTALL_DIR = "C:/tools/ghidra" }
+env = { WORKSPACE_ROOT = "C:/Users/<you>/.windows-exe-decompiler-mcp-server/workspaces", GHIDRA_PATH = "C:/tools/ghidra", GHIDRA_INSTALL_DIR = "C:/tools/ghidra" }
 ```
 
 ## Verify

COPILOT_INSTALLATION.md

@@ -6,6 +6,16 @@ This repository includes a helper script for local GitHub Copilot clients:
 .\install-to-copilot.ps1
 ```
 
+By default, the script writes a stable `WORKSPACE_ROOT` under your user profile:
+
+- `%USERPROFILE%/.windows-exe-decompiler-mcp-server/workspaces`
+
+It also pins:
+
+- `DB_PATH`
+- `CACHE_ROOT`
+- `AUDIT_LOG_PATH`
+
 Build the project first:
 
 ```powershell
@@ -18,6 +28,12 @@ If Ghidra is not already configured in the environment, pass it explicitly:
 .\install-to-copilot.ps1 -GhidraPath "C:\tools\ghidra"
 ```
 
+If you want a different persistent workspace root:
+
+```powershell
+.\install-to-copilot.ps1 -WorkspaceRoot "D:\reverse-data\workspaces"
+```
+
 ## What the script updates
 
 - workspace config: `.vscode/mcp.json`

README.md

@@ -171,12 +171,29 @@ Most MCP clients can start this server with:
 This repository already includes local install scripts:
 
 - Codex: [`install-to-codex.ps1`](./install-to-codex.ps1)
+- Claude Code: [`install-to-claude.ps1`](./install-to-claude.ps1)
 - GitHub Copilot: [`install-to-copilot.ps1`](./install-to-copilot.ps1)
 
 Related docs:
 
 - [`CODEX_INSTALLATION.md`](./CODEX_INSTALLATION.md)
 - [`COPILOT_INSTALLATION.md`](./COPILOT_INSTALLATION.md)
+- [`CLAUDE_INSTALLATION.md`](./CLAUDE_INSTALLATION.md)
+
+By default, the server now stores persistent sample workspaces under the user
+profile instead of `./workspaces`:
+
+- Windows: `%USERPROFILE%/.windows-exe-decompiler-mcp-server/workspaces`
+
+The same user-level app root is also used for:
+
+- SQLite database: `%USERPROFILE%/.windows-exe-decompiler-mcp-server/data/database.db`
+- File cache: `%USERPROFILE%/.windows-exe-decompiler-mcp-server/cache`
+- Audit log: `%USERPROFILE%/.windows-exe-decompiler-mcp-server/audit.log`
+
+You can still override these with environment variables or a user config file at:
+
+- `%USERPROFILE%/.windows-exe-decompiler-mcp-server/config.json`
 
 ## Sample ingest note
 

README_zh.md

@@ -168,12 +168,14 @@ npm start
 仓库已经提供了本地安装脚本：
 
 - Codex: [`install-to-codex.ps1`](./install-to-codex.ps1)
+- Claude Code: [`install-to-claude.ps1`](./install-to-claude.ps1)
 - GitHub Copilot: [`install-to-copilot.ps1`](./install-to-copilot.ps1)
 
 配套文档：
 
 - [`CODEX_INSTALLATION.md`](./CODEX_INSTALLATION.md)
 - [`COPILOT_INSTALLATION.md`](./COPILOT_INSTALLATION.md)
+- [`CLAUDE_INSTALLATION.md`](./CLAUDE_INSTALLATION.md)
 
 ## 样本导入说明