sots-re/campaign/DASHBOARD.md

4.9 KiB
Raw Blame History

SotS RE campaign — coverage dashboard

Generated 2026-09-07 21:45 UTC · sots-re @ f1c7f55,2026-09-07 · sots-engine @ 352577a,2026-09-07 (16 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)

43 targets · mapped-or-better 30/43 [███████░░░] 70% · verified 14/43 [███░░░░░░░] 33%

Status Count %
verified 14 33%
mapped 16 37%
in-progress 5 12%
backlog 7 16%
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 1 5 1 3 1 11
engine 3 1 3 0 0 7
verify 2 2 1 0 0 5
phase2 1 0 0 4 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): 102, verified 90 [█████████░] 88%

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/sim 1,342 9 356 yes game-sim.md
mars/parse 750 12 188 yes mars-parse.md
mars/text 855 8 205 yes mars-text.md
mars/vfs 788 9 140 yes mars-vfs.md
shim 184 0 0 direct (WIN32) M0.md
total 3,919 38 889

Board engine: rows: verified 3, mapped 1, in flight 3 (of 7) — verified & merged [████░░░░░░] 43%

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 ⬜ backlog 0% HOOK: GlobalConsts::LoadFile(const char* file, map*) 0x008b73c0 cdecl (driven by LoadAll 0
P2-M2 manifest/id registry ⬜ backlog 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: in-progress

7. Open questions

Open 22 · resolved/parked 5 · backlog items: Now 4, Next 3, Later 2, Breadth queue 7, Parked 1

Most recent open:

  • 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 …
  • Mars::Application::Initialize signature (P2-M0 finding) — a C++ __thiscall detour that called …
  • Corrections from turn internals — ServerPlayer+0xf9 is the AI flag (not bTurnDone); `FUN_007d7f7…

8. Delta since previous dashboard

  • verified targets: 13 → 14 (+1) · mapped-or-better: 29 → 30 (+1)
  • engine LOC: 3,919 → 3,919 (+0) · test files: 38 → 38 (+0) · checks: 889 → 889 (+0)
  • addresses verified: 10 → 90 (+80) · recovered layouts: 21 → 21 (+0) · open questions: 20 → 22 (+2)

warnings: mars-vfs.md: no oracle total row parsed