102 lines
5.4 KiB
Markdown
102 lines
5.4 KiB
Markdown
# SotS RE campaign — coverage dashboard
|
||
|
||
Generated 2026-09-08 02:18 UTC · `sots-re` @ 9e74691,2026-09-07 · `sots-engine` @ 8b231c0,2026-09-07 (39 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)
|
||
|
||
48 targets · mapped-or-better **40/48** `[████████░░] 83%` · verified **23/48** `[█████░░░░░] 48%`
|
||
|
||
| Status | Count | % |
|
||
|---|---:|---:|
|
||
| verified | 23 | 48% |
|
||
| mapped | 17 | 35% |
|
||
| in-progress | 2 | 4% |
|
||
| backlog | 5 | 10% |
|
||
| blocked | 1 | 2% |
|
||
|
||
| Type | verified | mapped | in-progress | backlog | blocked | total |
|
||
|---|---:|---:|---:|---:|---:|---:|
|
||
| objects | 5 | 2 | 0 | 0 | 0 | 7 |
|
||
| control-flow | 0 | 2 | 0 | 0 | 0 | 2 |
|
||
| subsystems | 2 | 6 | 1 | 3 | 1 | 13 |
|
||
| engine | 8 | 1 | 0 | 0 | 0 | 9 |
|
||
| verify | 4 | 2 | 0 | 0 | 0 | 6 |
|
||
| phase2 | 2 | 0 | 1 | 2 | 0 | 5 |
|
||
| meta | 2 | 4 | 0 | 0 | 0 | 6 |
|
||
|
||
## 2. Binary understanding
|
||
|
||
- RTTI type descriptors: **1,924** (`Game::` 1,404, `Mars::` 194; serializable types 179)
|
||
- Classes with recovered member layouts: **21** / 179 serializable types `[█░░░░░░░░░] 12%` — heuristic: distinct `Game::X`/`Mars::X` in `##`–`####` headings of `struct-recovery.md` + `schema-gaps-resolved.md`
|
||
- Functions: **41,411** (parsed from `01-fingerprint.md`); named/annotated in the **address contract** (`ghidra/addresses.json`, not Ghidra's full rename count): **137**, verified **123** `[█████████░] 90%`
|
||
|
||
## 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: **3/3** 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` | 315 | 3 | 89 | yes | M1.md |
|
||
| `game/data` | 2,053 | 12 | 462 | yes | game-data.md |
|
||
| `game/design` | 1,024 | 17 | 250 | yes | game-design.md |
|
||
| `game/sim` | 1,342 | 9 | 356 | yes | game-sim.md |
|
||
| `mars/parse` | 875 | 12 | 277 | yes | mars-parse.md |
|
||
| `mars/rng` | 166 | 0 | 0 | yes | mars-rng.md |
|
||
| `mars/stream` | 3,703 | 6 | 195 | yes | mars-stream.md |
|
||
| `mars/text` | 899 | 8 | 245 | yes | mars-text.md |
|
||
| `mars/vfs` | 788 | 9 | 140 | yes | mars-vfs.md |
|
||
| `shim` | 2,452 | 0 | 0 | direct (WIN32) | M0.md |
|
||
| `shim/hooks` | 368 | 0 | 0 | direct (WIN32) | M0.md |
|
||
| `shim/trace` | 1,824 | 8 | 248 | direct (WIN32) | shim-trace.md |
|
||
| **total** | **15,809** | **84** | **2262** | | |
|
||
|
||
Board `engine:` rows: verified **8**, mapped 1, in flight 0 (of 9) — verified & merged `[█████████░] 89%`
|
||
|
||
## 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 | 🔄 in-progress | 0% | no registry object: WeaponDictionary::Init 0x0059a4c0 / SectionDictionary ctor 0x00576f40 |
|
||
| 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: 3/3 (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 **24** · resolved/parked 9 · backlog items: Now 4, Next 3, Later 2, Breadth queue 7, Parked 1, From the RE how-to 4
|
||
|
||
Most recent open:
|
||
|
||
- Notes disagree on MSVC-2010 `std::string` layout — `struct-recovery.md` §0 vs `turn-spine.md` §1.1…
|
||
- 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…
|
||
- PARITY BUG (fix in mars/text + Python flat_kv): duplicate config keys are FIRST-occurrence-wins in t…
|
||
- Formula gaps surfaced by the game/sim port (feed back to Ghidra) — which bankruptcy limit carries …
|
||
|
||
## 8. Delta since previous dashboard
|
||
|
||
- verified targets: 22 → 23 (+1) · mapped-or-better: 39 → 40 (+1)
|
||
- engine LOC: 14,726 → 15,809 (+1,083) · test files: 81 → 84 (+3) · checks: 2,173 → 2,262 (+89)
|
||
- addresses verified: 123 → 123 (+0) · recovered layouts: 21 → 21 (+0) · open questions: 24 → 24 (+0)
|
||
|
||
---
|
||
warnings: 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": 23, "mapped_plus": 40, "targets": 48, "loc": 15809, "tests": 84, "checks": 2262, "addr_verified": 123, "addr_total": 137, "layouts": 21, "open_q": 24} -->
|