Skip to content
N0zoM1z0Public

About

Source reconstruction of 東方風神録 ~ Mountain of Faith 1.00a

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

東方風神録 ~ Mountain of Faith

Agent workflow: follow the highest-priority requirements in AGENTS.md. Use affected exact checks and searchable Markdown knowledge; ordinary notes do not require full CI or replay.

Original Japanese TH10 1.00a title screen

TH10 reconstruction progress

This project reconstructs the original Japanese TH10 version 1.00a executable. It tracks target identity, candidate boundaries, origin, source presence, codegen exactness, native-product closure, runtime semantics, and portability as separate facts.

Exact target

Supply your own legal copy at the ignored path resources/th10.exe.

Property Required value
Version original Japanese 1.00a
Size 487,936 bytes
SHA-256 2f14760b6fbbf57549541583283badb9a19a4222b90f0a146d5aa17f01dc9040
MD5 7dc488d82c81dd4aee4ba098b8804d83
Image base 0x00400000
Entry point 0x004537DC

The pinned thcrap version database classifies this exact SHA-256 as th10, v1.00a, (original); patched and Steam executables have different digests.

scripts/repo-python scripts/verify-target.py
scripts/repo-python scripts/validate-tracking.py --require-target
scripts/repo-python scripts/report-reconstruction-status.py

Original executables, game data, Ghidra projects, decompiler output, and downloaded tools are private and never committed.

Current status

Start with the current handoff, the selected owner's source and ledger rows. PROGRESS.md is generated from the ledgers and is the count authority. The inventory and origin classifications remain provisional; the Windows i386 product, runtime semantics and portability are open.

Current owner priorities and source-epoch-specific diagnostics are maintained in RE_HANDOFF.md and KNOWLEDGE_BASE.md; the generated PROGRESS.md remains the count authority.

For a new agent, read AGENTS.md, then RE_HANDOFF.md, followed by the selected owner's source/ledger rows, and the relevant comparison lane. Use RE_ARTIFACTS.md for private inputs, the few retained unresolved contexts and cleanup policy.

Use scripts/repo-python; it enforces the locked Capstone package. Verify the private target before target work. Check toolchain declarations and run the execution smoke on setup, toolchain changes or a compiler/Wine problem. The pinned VC7.1 SP1 candidate reports compiler/linker build6030. Original production partitions, flags, libraries, resources and link order remain open.

scripts/repo-python scripts/verify-target.py
scripts/repo-python scripts/verify-toolchain.py --check
scripts/repo-python scripts/ci.py

Default CI checks changed Python/JSON/TOML/CSV/Shell syntax and whitespace, including staged changes. It uses only Python 3.11+ and Git. Regenerate progress with scripts/repo-python scripts/progress.py when ledger inputs change. Historical host fixtures, failure/lifecycle simulations, sanitizer sweeps and mutation reports are not current gates. scripts/repo-python scripts/ci.py --full adds the comparator self-tests and the ledger validator (about 15 seconds); run it when shared tooling changes. Nonexact owners are tracked by the diagnostic ratchet scripts/check-frontier.py (data in config/frontiers.toml).

Exact work compares complete native owners, every relocation/resolved field, fixed local destinations, actual ABI and required callee bindings. Select only new/affected exact owners, for example:

scripts/repo-python scripts/replay-exact-units.py \
  --unit hint-frame-update --unit hint-update-callback --json

Selected units with the same complete recipe share one cold artifact. Source or header sharing alone does not require replaying every consumer. Omitting selectors rebuilds the historical cohort and is inappropriate for ordinary bounded work. Matching size or a structural candidate grants no exact credit.

Linked-PE acceptance binds the complete PDB contribution, PE/map/PDB identities and exhaustive field manifest to the original target. Its incomplete harness is not a runnable reconstructed product. See ORACLES.md, RE_WORKFLOW.md and TOOLS.md.

Keep required private inputs and current comparison contexts as described in RE_ARTIFACTS.md. Historical archives, duplicate snapshots and old reports can be deleted after recording useful findings.

Required phase order

  1. Reconcile authored boundaries and recover exact historical-toolchain units.
  2. Close and exercise the faithful Windows i386 product, including data owners, initializers, resources, libraries, and runtime scenarios.
  3. Perform semantic reconstruction using both the original target and the reconstructed native i386 product as runtime Oracles.
  4. Start portability only after the native semantic baseline is trustworthy.

Project map

License

Repository-authored code and documentation are provided under the MIT License. This does not grant rights to the original game or its assets.

About

Source reconstruction of 東方風神録 ~ Mountain of Faith 1.00a

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages