Files
Syplheed-Reborn/docs/re/_TEMPLATE.function.md
MechaCat02 b7028471e9
Some checks failed
CI / Native — ubuntu-latest (push) Failing after 7m53s
CI / WASM — Web (push) Failing after 6m32s
CI / Formatting (push) Failing after 35s
CI / Native — macos-latest (push) Has been cancelled
CI / Native — windows-latest (push) Has been cancelled
docs(re): add reverse-engineering knowledge base + conventions
Establish docs/re/ as the spec-side of the clean-room:
- README: confidence tiers (HYPOTHESIS/PROBABLE/CONFIRMED), promotion
  requires NEW independent evidence, append-only evidence logs,
  demote-on-contradiction, and a clean-room firewall (describe behaviour +
  cite addresses; never paste decompiled code). Documents the toolchain
  (sylpheed.db + zq.py, xenia-rs probes, Wine-Canary oracle) and the
  join-by-guest-PC method with the VA-equality caveat.
- Function/structure templates + a seeded INDEX (9 already-reversed formats).
- First entry: texture-color-k8888 — CONFIRMED plain k_8_8_8_8 is linear
  UNORM (no sRGB), channel order still to be measured.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-11 17:04:23 +02:00

1.0 KiB

<function name / sub_XXXXXXXX>

  • Address: 0x________ (in sylpheed.db; zq.py fn 0x________)
  • Confidence: HYPOTHESIS | PROBABLE | CONFIRMED
  • Reimplemented in: crates/…/…rs::fn — or not yet
  • Related: other RE entries, [[memory-slug]]

What it does

One-paragraph behavioural summary, in your own words. No pasted disassembly.

Signature / calling convention

Inputs (registers/args + meaning), outputs, side effects (memory it writes, globals, imports it calls).

Behaviour

Step-by-step of the observable behaviour — the spec to implement from. Formulas, branches, state transitions. Cite addresses for detail (the loop at 0x…), don't transcribe code.

Evidence log (append-only; newest last)

  • YYYY-MM-DDhow we know: static disasm read / --lr-trace from 0x… / canary output / N observations. What it established. → confidence set to .

Open questions / what would raise confidence

The specific check that would confirm or refute the current claim.