mentaltheme.dbss
Binary layout, byte coverage, field semantics, and validation evidence for the intrinsic BSD mentaltheme decoder.
Investigation status
| Status | Value |
|---|---|
| Coverage | 100% |
| Iteration | BSD migration |
| Review state | BSD migration reconciled |
| Last reviewed | 2026-08-03 |
| Captures examined | Steam capture ads_version 856; PAZ 5152; file hash 3600475061; 104,207 extracted bytes; 903 rows; normalized SHA-256 15ab02a067c384c39f6f5705caac4f984e1cd366092f00bd787270880c4335dc |
| Decoder | packages/scraper/src/tables/mentaltheme.dbss.ts |
| Remaining blockers | None |
See Decoder methodology for the confidence scale and evidence rules.
Field ledger
| Field/path | Offset and width | Representation | Claimed meaning | Physical confidence | Representation confidence | Semantic confidence | Evidence | Status |
|---|---|---|---|---|---|---|---|---|
| repeated identity/name | variable prefix | repeated key validated, name retained | theme identity and Korean name | Certain | Certain | Certain | Intrinsic controls and offset-key equality | Closed |
| hierarchy fields | parent u16, counted child u16[] |
retained | exact parent/child graph | Certain | Certain | Certain | Bidirectional edge equality in both builds | Closed |
| knowledge/energy controls | fixed fields | retained | grade and energy thresholds | Certain | Certain | High | Legacy/client semantics and ordered-boundary invariant | Closed |
bookshelfItemId |
u32 |
retained, zero sentinel | installable bookshelf item | Certain | Certain | Certain | 33 distinct total item joins in both builds; item 2530 public corroboration | Closed |
cardIds |
counted u32[] |
retained | theme membership | Certain | Certain | Certain | Exact inverse of every card’s themeKey in both builds |
Closed |
| child-list terminator | 4 bytes | consumed with .pad(4) and omitted |
neutral child-list framing | Certain | Certain | Neutral | Exact intrinsic boundary after childThemeKeys |
Closed neutral |
| Reserved ranges | schema-local fixed widths | consumed with .pad() and omitted |
framing or semantically neutral capacity | Certain | Certain | Neutral | Adjacent fields, strict EOF, and exact snapshot parity establish each width | Closed neutral |
Active assumptions
Findings
| ID | Finding | Evidence | Schema/documentation impact | Status |
|---|---|---|---|---|
| F-01 | The intrinsic decoder reproduces the transformed reference output exactly. | Full snapshot comparison; 903 rows; normalized SHA-256 15ab02a067c384c39f6f5705caac4f984e1cd366092f00bd787270880c4335dc |
The BSD schema is the production source of truth. | Closed |
| F-02 | Row and section boundaries are intrinsic. | Strict decoding reaches exact EOF on the installed capture. | No companion offset table is loaded by this decoder. | Closed |
| F-03 | Reserved byte ranges are representation details. | Their widths are fixed by adjacent fields and full-snapshot parity. | .pad() keeps the schema readable and omits redundant output properties. |
Closed |
Reconciled source findings
| ID | Finding | Evidence | Schema/documentation impact | Status |
|---|---|---|---|---|
| F-02 | Membership and hierarchy are exact bidirectional graphs. | Complete equality in two builds. | Aggregate tests added; production remains join-free. | Closed |
| F-03 | Every nonzero bookshelf ID belongs to the item namespace. | 33 distinct values, zero misses in committed and installed builds; item 2530 is the matching named bookshelf. | Added aggregate test and precise field TSDoc link. | Closed |