東方妖々夢 ～ Perfect Cherry Blossom

This project aims to reconstruct the source code of the original Japanese 東方妖々夢 ～ Perfect Cherry Blossom version 1.00b executable, with reproducible binary comparison as the acceptance criterion.

The project is in active reverse engineering. The initial IDA inventory is tracked in a machine-readable function ledger; a routine is counted as reconstructed only after a 100% function-byte comparison. The workflow combines the adjacent-engine knowledge in GensokyoClub/th06 and GensokyoClub/th08 with strict target, evidence, claim, and comparison gates derived from the TH10.5 reconstruction.

Target executable

Supply your own original executable as resources/th07.exe:

Property	Required value
Version	Original Japanese 1.00b
Size	650,752 bytes
SHA-256	35467eaf8dc7fc85f024f16fb2037255f151cefda33cf4867bc9122aaa2e80ca
PE image base	0x00400000

Localized or patched executables are different binaries and are intentionally rejected. The executable and game data are copyrighted assets and are not included. The target identity also agrees with the thpatch version manifest.

python3 scripts/verify-target.py

Reverse-engineering environment

IDA Pro MCP is the preferred semantic-analysis backend. Every session fails closed unless the IDA window is attached to the exact target above. The helper uses the project-independent ida-pro-mcp registration and never hard-codes a local IDA installation path.

python3 scripts/check-ida-mcp.py
python3 scripts/export-ida-inventory.py
python3 scripts/validate-tracking.py
python3 scripts/progress.py --check

The local _references/th06 and _references/th08 clones are intentionally ignored. Their source is supporting evidence, never a substitute for TH07 instructions, data layout, or exact comparison.

Project map

• Architecture and current binary facts
• Reverse-engineering workflow
• IDA-first analysis
• Build and matching plan
• Complete executable build
• Prebuilt D3DX8 and VC7 runtime recovery
• Vendored open-source codec baselines
• Workflow evolution and parallel gates
• Generated progress
• Agent operating rules

Build status

The PE linker metadata and Rich header identify Visual C++ .NET 2002 (VC7, build 9466), matching the toolchain family used by the TH06 and TH08 reference projects. The checked-in executable manifest and fail-closed build driver now compile the accepted source graph and reproduce the local icon resource, while the final link remains gated on complete function/global/TU ownership. A matching full executable is not yet advertised; reconstruction starts with address-bounded translation units and function-level comparison. Focused VC7 probes cover TextHelper, MIDI, DirectSound, Controller, ScreenEffect, BulletManager, Player, spell, and Chain code. SHA-pinned D3DX8 archive replay separately recovers original third-party objects without inflating authored-game progress. Current exact counts and byte totals are generated in docs/PROGRESS.md; probe units are not claims about the original game translation-unit boundaries.

License

Repository-authored code and documentation are provided under the MIT License. This does not grant rights to the original game or its assets. Adjacent-version reference code retains the license of its source repository.