Data, identity and persistence
Sources and authority
| Source | Provides | Does not prove |
|---|---|---|
| TradeSkillMaster.lua | Saved inventory, professions and history | Instantaneous server state |
| AppData.lua | Available cached prices and statistics | A future sale at that price |
| DonjonsEtPognons.lua | Saved Companion observations | Certain outcome of every auction |
| Local D&P state | Decisions, confirmations and accumulated observations | Writes to WoW |
The Lua reader interprets a literal subset: it never executes the file. It validates the filename and a 100 MiB size ceiling, then compares size and modification time before and after reading. SHA-256 identifies the content. An inconsistent save is rejected; a later read may succeed.
Preserve identity
i:1234 and an itemString with a suffix are not interchangeable. Names and icons may come from the base identifier; one variant's quote or sale is not evidence for every variant. Profiles separate realm, faction, region and selected characters.
Performance scope also includes the normalized TSM path. Moving the source may therefore create a new historical scope. Do not promise transparent migration simply by changing a path; back up state and inspect the resulting profile.
Persistence and deduplication
engine/state is private. Configuration, workspace, returns journal and performance files retain preferences and observations. Writes use a temporary file followed by replacement; mutations are serialized. Back up the complete directory to avoid inconsistent partial restores.
Historical transactions are grouped by identity and observed multiplicity. Reading the same export again does not add another sale. This depends on available fields, not a universal TSM transaction identifier. Financial events are bounded to 365 days and 20,000 entries per profile; costs to 366 observations per exact itemString and scope. A changed cost produces a new observation immediately; an unchanged cost is recorded again after at least an hour.
Missing, zero and age
A missing source is unknown, not zero. A disappeared auction may have sold, been cancelled, expired or be missing from an incomplete observation. The observer retains last-good state when data is empty or regresses. Stock age means first continuous positive observation, not purchase date. See accounting.
Paths, character names and history may contain personal information. Raw files and state must never become public fixtures.
