| # Reference coverage ledger |
|
|
| Initial source coverage, 2026-10-21. Owner for this ledger and the external dependencies listed in [DEPENDENCIES.md](DEPENDENCIES.md): **Nanobrush reference research**. E01 establishes source coverage; E02 adds converter-only runtime observations. Rust DAT parity is scoped to the F29 fixtures below; no editor parity is claimed. |
|
|
| Every one of the 560 regular-member occurrences has its own path/hash/category/coverage/owner/follow-up entry in [source-map.json](../assets/analysis/source-map.json). Direct include candidates, qualified calls, interrupt wrappers, tool registrations and literal-resource candidates remain attached to their source file. The human documents summarize behavior without copying the raw reference tree into ordinary Git. |
|
|
| | Latest-build category | Files | Initial disposition | Next contract/validation task | |
| | --- | ---: | --- | --- | |
| | Core host includes | 5 | Source-indexed; native contract/adapter planned | P4.03, P3.14 host behavior | |
| | Task clients | 9 | Source-indexed; service/protocol contracts planned | P4.05 | |
| | Top-level plugins | 17 | Source-indexed; native functionality planned | P4.08, P7 | |
| | Experimental plugins | 5 | Source-indexed; equivalent functionality or explicit scope decision required | P4.09 | |
| | IXPL utilities/misc | 10 | Source-indexed; needed functionality requires independent port | P4.07 | |
| | Model generator | 1 | Source-indexed; native generation target | P9.06 | |
| | Grammars | 7 | Grammar rules indexed; initial format map written | P6.01–P6.10 | |
| | CFG resources | 15 | Literal typed declarations indexed; full consumer semantics pending | P8.09 | |
| | Shader containers | 3 | Sections/uniforms indexed; selected output expressions reviewed | P9.01–P9.04 | |
| | BAT files | 17 | Text inventory and build/conversion boundary reviewed | P4.12 | |
| | Images | 4 | Byte inventory only in this pass; provenance/atlas meaning pending | P9.05 | |
| | Executables | 3 | Converter: both binaries decompiled and probed (E02); editor/compiler still header-only | P3.06/P3.17 | |
| | Other reference text | 28 | Encoding/line inventory; selected readmes/help reviewed | P3.02; original licenses P0.04 | |
| | Total | 124 | All regular members accounted for | No category has complete runtime parity | |
|
|
| “Lexically indexed” means identifiers/edges can be located, not that a complete language parser or host implementation is understood. “Text inventoried” means text identity/encoding/lines are known; it does not mean every paragraph has been semantically reviewed. CP1252 fallback is a decoding choice for indexing, not a proven application encoding contract. |
|
|
| ## Remaining mapping gaps |
|
|
| - Complete consumer-derived config keys, dotted scope handling, localized string tables and dynamic key generation. |
| - Dynamic file/resource names, implicit loader conventions, and actual compiler include precedence. |
| - Static and dynamic plugin load/unload order, callback concurrency, task priority ordering and errors. |
| - IXModel primitive semantics, native-editor DAT conformance, compiled plugin representation and editor/compiler runtime dependencies. Converter DAT widths/encoding/layout are specified in E02. |
| - Full tool state machines, geometry algorithms/tolerances, shader bindings and file-conversion preservation. |
| - Editor/plugin source discrepancies versus executed behavior. E01 ran no executables; E02 ran original converter copies only. |
|
|
| Keep the broad parent TODO tasks open until their promised behavioral evidence exists. The completed source-mapping subtasks record this pass without marking an entire subsystem reverse engineered. |
|
|
| ## Converter coverage extension (E02) |
|
|
| [static.json](../assets/analysis/converter/static.json) covers the 183/193 managed methods in both distinct converter binaries with RVAs and hashes; the four 2015 members are byte-identical. [probes.json](../assets/analysis/converter/probes.json) indexes 101 controlled cases and every captured payload. DAT hierarchy is experimentally specified on this corpus; format edge cases and editor cross-validation remain P6.19/P6.20, and external consumers remain P6.16. Broad parent tasks stay open. |
|
|
| ## Rust DAT implementation (F29) |
|
|
| `mb3-dat` implements both converter DAT layouts. The five Rust integration tests cover all 58 captured DAT outputs with exact bytes, selected semantic fields, captured malformed-input rejections and version migration. Twenty-four unit tests and one doctest add boundary/resource/I/O checks and 5,000 deterministic mutations. See [the compatibility matrix](RUST_DAT.md) for deliberate strictness and the old signed-16 writer repair. Native-editor conformance, real-document coverage, independent consumer testing and remaining codecs stay open. |
|
|
| ## TXT and CLI implementation (E04) |
|
|
| The native TXT codec and CLI cover all 58 E02 DAT outputs through exact DAT→TXT→DAT reconstruction, seven text outputs through canonical semantic round trips, 16 direct TXT-input/DAT-output pairs and nine rejected malformed/lossy text inputs. Original formatting, guessed encodings, ignored arrays and property optimization are explicit differences in F30. CLI no-clobber/force publication, alias/symlink guards, validation before I/O and exit streams are tested separately in F31. Legacy external formats, editor behavior and other-platform execution remain open. |
|
|
