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.
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.
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.pyOriginal executables, game data, Ghidra projects, decompiler output, and downloaded tools are private and never committed.
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.pyDefault 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 --jsonSelected 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.
- Reconcile authored boundaries and recover exact historical-toolchain units.
- Close and exercise the faithful Windows i386 product, including data owners, initializers, resources, libraries, and runtime scenarios.
- Perform semantic reconstruction using both the original target and the reconstructed native i386 product as runtime Oracles.
- Start portability only after the native semantic baseline is trustworthy.
AGENTS.md— mandatory session and evidence rules.config/target.toml— target and observed PE facts.config/build.toml— explicit open whole-build graph.config/tools.lock.toml— compiler, linker, frontend, optimizer, resource-tool, linked-code decoder, and headless-Wine lock.docs/RE_WORKFLOW.md— reconstruction loop and gates.docs/ORACLES.md— claim-specific falsification rules.docs/RE_HANDOFF.md— current resume brief, unresolved owners, and source-epoch checks.docs/RE_ARTIFACTS.md— required private inputs, current unresolved contexts, and cleanup policy.docs/KNOWLEDGE_BASE.md— TH10-only knowledge.
Repository-authored code and documentation are provided under the MIT License. This does not grant rights to the original game or its assets.
