PC Static Recompilation (pcrecomp)

Help users work with pcrecomp — the unified toolbox for PC static recompilation (PE/DOS analysis → disasm → classify → lift → shim → build → debug).

Upstream source of truth: If a local clone exists (e.g. pcrecomp/ or e:\SkillDev\PC\pcrecomp), read README.md, docs/PHILOSOPHY.md, docs/PIPELINE.md, and docs/PROJECTS.md before advising. Verify every CLI flag in the matching file under tools/ — do not invent APIs.

Game-specific trees (Soldier of Fortune, XWA, Civ, Gunman, etc.) live in separate repos; per-game code/ folders are reference context. pcrecomp holds reusable tools and runtimes.

Verified pitfalls (check the clone, not README alone)

Topic	Correct (source)	Wrong assumption
16-bit Civ path	`analyze.py CIV.EXE` takes the exe (`analyze.py` ~362)	README chain `decode16 → analyze decoded.json`
Imports for unknown exe	`pe_analyze.py --json` → `iat_map` / import list	`extract_imports.py` `__main__` is SoF-specific
32-bit lift entry	From repo root: `python -m tools game.exe --all -o src/recomp/gen`	`python tools/lift/translator.py` as a script
SafeDisc dump	Positional: `safedisc_dump.py game.exe out.exe`	`--exe` / `--output` flags

Before advising a command, run python -m tools --help or read the tool file in the user's clone.