105 lines
5.7 KiB
Markdown
105 lines
5.7 KiB
Markdown
# SotS RE campaign — coverage dashboard
|
|
|
|
Generated 2026-09-08 12:55 UTC · `sots-re` @ 66bed1d,2026-09-08 · `sots-engine` @ 2bf38bc,2026-09-08 (109 commits) · regenerate with `tools/dashboard.py`
|
|
|
|
> **North star:** A functional reimplementation of the engine — behavior-equivalent, NOT byte-for-byte
|
|
|
|
## 1. Map coverage (campaign/board.md)
|
|
|
|
155 targets · mapped-or-better **131/155** `[████████░░] 85%` · verified **105/155** `[███████░░░] 68%`
|
|
|
|
| Status | Count | % |
|
|
|---|---:|---:|
|
|
| verified | 105 | 68% |
|
|
| mapped | 26 | 17% |
|
|
| in-progress | 2 | 1% |
|
|
| backlog | 20 | 13% |
|
|
| blocked | 2 | 1% |
|
|
|
|
| Type | verified | mapped | in-progress | backlog | blocked | total |
|
|
|---|---:|---:|---:|---:|---:|---:|
|
|
| objects | 21 | 6 | 0 | 2 | 1 | 30 |
|
|
| control-flow | 6 | 2 | 0 | 1 | 0 | 9 |
|
|
| subsystems | 3 | 7 | 1 | 3 | 1 | 15 |
|
|
| engine | 16 | 0 | 0 | 0 | 0 | 16 |
|
|
| verify | 26 | 4 | 0 | 10 | 0 | 40 |
|
|
| phase2 | 10 | 3 | 1 | 2 | 0 | 16 |
|
|
| meta | 21 | 4 | 0 | 1 | 0 | 26 |
|
|
| other | 2 | 0 | 0 | 1 | 0 | 3 |
|
|
|
|
## 2. Binary understanding
|
|
|
|
- RTTI type descriptors: **1,924** (`Game::` 1,404, `Mars::` 194; serializable types 179)
|
|
- Classes with recovered member layouts: **384** / 1,598 named classes `[██░░░░░░░░] 24%` — `objects/layouts.json` (serializer recovery) plus classes recovered by hand in `struct-recovery.md` + `schema-gaps-resolved.md`. Note 179 types are *serializable*; the recovery also reaches non-serializable ones, so this is not a subset of that
|
|
- Functions: **41,411** (parsed from `01-fingerprint.md`); named/annotated in the **address contract** (`ghidra/addresses.json`, not Ghidra's full rename count): **750**, verified **729** `[██████████] 97%`
|
|
|
|
## 3. Data layer
|
|
|
|
- Catalogs: **1,595/1,595** files parsed (91 block kinds in `schema_stats.json`), dangling cross-refs **0** (`crosslink.json`)
|
|
- Oracle `mars-parse`: **1,531/1,531** files agree `[██████████] 100%`
|
|
- Oracle `mars-text`: **64/64** files agree `[██████████] 100%`
|
|
- Saves: **11/11** real saves strict-clean — strict exit 0, 0 errors, 0 warnings
|
|
- Design rules: **127/127** stock designs pass `[██████████] 100%`
|
|
|
|
## 4. Engine accrual (sots-engine)
|
|
|
|
| Module | LOC | Test files | Checks | Wired | Doc |
|
|
|---|---:|---:|---:|---|---|
|
|
| `game/config` | 558 | 4 | 131 | yes | M1.md |
|
|
| `game/data` | 2,053 | 12 | 462 | yes | game-data.md |
|
|
| `game/design` | 1,024 | 17 | 250 | yes | game-design.md |
|
|
| `game/effects` | 973 | 3 | 231 | yes | game-effects.md |
|
|
| `game/events` | 558 | 3 | 152 | yes | E-events.md |
|
|
| `game/sim` | 3,100 | 10 | 699 | yes | game-sim.md |
|
|
| `mars/parse` | 875 | 12 | 277 | yes | mars-parse.md |
|
|
| `mars/rng` | 206 | 0 | 0 | yes | mars-rng.md |
|
|
| `mars/stream` | 5,096 | 7 | 282 | yes | mars-stream.md |
|
|
| `mars/text` | 899 | 8 | 245 | yes | mars-text.md |
|
|
| `mars/vfs` | 788 | 9 | 140 | yes | mars-vfs.md |
|
|
| `shim` | 9,903 | 0 | 0 | direct (WIN32) | M0.md |
|
|
| `shim/hooks` | 6,957 | 0 | 0 | direct (WIN32) | M0.md |
|
|
| `shim/trace` | 2,258 | 9 | 273 | direct (WIN32) | shim-trace.md |
|
|
| **total** | **35,248** | **94** | **3142** | | |
|
|
|
|
Board `engine:` rows: verified **16**, mapped 0, in flight 0 (of 16) — verified & merged `[██████████] 100%`
|
|
|
|
## 5. Phase 2 milestones
|
|
|
|
| Milestone | Status | Coverage | Notes |
|
|
|---|---|---:|---|
|
|
| P2-M0 shim bootstrap | ✅ verified | 100% | sots-engine 5f5bc41: proxy binkw32.dll (66 exports identical), MinHook, asm-stub trace hoo |
|
|
| P2-M1 flat-KV config loader | ✅ verified | 100% | LIVE: GlobalConsts::LoadFile hooked; trace 19 calls/1088 regions (tracecmp 0); compare 19/ |
|
|
| P2-M2 manifest/id registry | ✅ verified | 80% | LIVE: trace 22 calls (tracecmp 0); weapons compare 1/1 0 divergences; REPLACE+oracle byte- |
|
|
| P2-M3 Mars brace-block parser | ⬜ backlog | 0% | Mars::Script pull tokenizer (Open 0x008cd7d0, ReadToken 0x008cd2f0, Next 0x008cd3e0, SkipB |
|
|
| P2-M4 gobio VFS read | ⬜ backlog | 0% | choke point: bool __cdecl gobio::ReadFile(const char*, IBuffer**) 0x008d5140; FileSystemSe |
|
|
|
|
## 6. Verification ledger
|
|
|
|
- ✅ Saves strict: 11/11 (strict exit 0, 0 errors, 0 warnings)
|
|
- ✅ Design rules: 127/127
|
|
- ✅ oracle mars-parse 1531/1531 · ✅ oracle mars-text 64/64
|
|
- ✅ Compare harness present (`verify/harness/compare/`)
|
|
- ✅ M0 evidence present (`verify/results/shim/m0.log`)
|
|
- ✅ Determinism oracle: verified
|
|
|
|
## 7. Open questions
|
|
|
|
Open **26** · resolved/parked 11 · backlog items: Now 4, Next 3, Later 2, Breadth queue 7, Parked 1, From the RE how-to 4, Behavioral slice 4
|
|
|
|
Most recent open:
|
|
|
|
- Some truths are unreachable by compare — B3's draw-divisor bug differed on 0.78% of draws yet flip…
|
|
- x87 precision-control mode at runtime — 53-bit MSVC default vs 24-bit if D3D9 grabbed the FPU; mov…
|
|
- Struct-modelling hazard (found by M2) — an MSVC-2010 `std::vector` member is three words, so a…
|
|
- SAVE_FORMAT tag corrections (fix Python reader + spec) — real on-disk tags: `otnF` (not `ontF`) in…
|
|
- Not traced end-to-end — `Species/_NPC/weapons/*.weapon` loading and the `.effect` dictionary entry…
|
|
|
|
## 8. Delta since previous dashboard
|
|
|
|
- verified targets: 93 → 105 (+12) · mapped-or-better: 118 → 131 (+13)
|
|
- engine LOC: 35,208 → 35,248 (+40) · test files: 94 → 94 (+0) · checks: 3,142 → 3,142 (+0)
|
|
- addresses verified: 703 → 729 (+26) · recovered layouts: 384 → 384 (+0) · open questions: 26 → 26 (+0)
|
|
|
|
---
|
|
warnings: board.md: unknown types subsystems; mars-rng.md: no oracle total row parsed; mars-stream.md: no oracle total row parsed; mars-vfs.md: no oracle total row parsed
|
|
<!-- dashboard-metrics {"verified": 105, "mapped_plus": 131, "targets": 155, "loc": 35248, "tests": 94, "checks": 3142, "addr_verified": 729, "addr_total": 750, "layouts": 384, "open_q": 26} -->
|