東方永夜抄 ～ Imperishable Night

This project aims to reconstruct the source code of the original Japanese
東方永夜抄 ～ Imperishable Night version 1.00d executable, with reproducible
binary comparison as the acceptance criterion.

The repository continues the work of
GensokyoClub/th08. Its complete Git
history was imported rather than squashed, preserving the authorship and
contribution record of the original project. New infrastructure and
reconstruction work build on that baseline.

The project remains active reverse-engineering work. Existing source, symbol
mappings, or generated progress artwork must not be interpreted as a new exact
matching percentage without a reproducible report against the target binary.
Current source-presence inventory is generated in
docs/PROGRESS.md and is deliberately labeled separately
from strict exact-match coverage.

Target executable

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

Localized or patched executables are different binaries and are intentionally
out of scope. The executable and game data are copyrighted assets and are not
included.

python3 scripts/verify-target.py

Build

Initialize the third-party submodules, then create the upstream Visual Studio
.NET 2002/DirectX 8 environment. On Linux or macOS:

git submodule update --init --recursive
./scripts/create_th08_prefix
python3 ./scripts/build.py

The prefix helper uses Wine by default; set WINE before invoking it when a
different compatible runner is required. On Windows, use the upstream setup
script directly:

python scripts/create_devenv.py scripts/dls scripts/prefix
python scripts/build.py

See Build and exact matching for dependency,
build-mode, reccmp, and objdiff details.

Analysis status

IDA MCP follows whichever database is active in the GUI; it has no reliable
program selector. Use it for TH08 only after the active database passes the
attestation in IDA and analysis safety. Otherwise use
target-side objdump/llvm-objdump, the verified disposable Ghidra import, and
the target-pinned repository tools.

To see the live authored and library inventory instead of relying on prose:

python3 scripts/analysis/report-reconstruction-status.py --summary

Project map

• Architecture and binary inventory
• Reverse-engineering workflow
• IDA and analysis safety
• Build and exact matching
• Tool selection and command recipes
• Reusable knowledge map and contribution policy
• Current handoff and next milestones
• Generated reconstruction progress
• Agent operating rules

Credits and provenance

This continuation exists because of the reconstruction and tooling work by
the contributors to GensokyoClub/th08.
Their commits retain their original author/committer metadata in this
repository. The upstream project also credits @EstexNT for porting its
var_order pragma to MSVC7.

The N0zoM1z0/th07 reconstruction supplies
this repository's workflow, structure, target gates, matching, and
documentation model. GensokyoClub/th06
is adjacent-engine corroboration only; neither reference overrides TH08 target
evidence.

License

Repository code and documentation are provided under the included MIT License.
This does not grant rights to the original game, executable, or game data.