kam-mobile/docs/FIRST_SERVER_RUN_DIAGNOSIS.md

First server run diagnosis (2026-09-08)

The first server report did not reach KaM portability errors. Two harness defects blocked it first.

1. tools/generate.py passed -Mdelphi as a global FPC command-line option. This changed compilation mode for Castle Game Engine units too. CastleLocalizationGetText relies on its normal CGE/FPC mode and failed with Variable identifier expected and overload errors. KaM units do not need a global mode flag because KaM_Remake.inc contains {$MODE Delphi} under FPC. Fix: remove global -Mdelphi.
2. tools/source_audit.py read UTF-8 files without BOM stripping. src/game/KM_Game.pas begins with a UTF-8 BOM, so the lexical ^unit matcher did not index it and the simulation/integration profiles were incorrectly marked Missing required original source units: KM_Game. Fix: read with utf-8-sig.

After these fixes, rerun the same Android profiles. New failures should be treated as the first meaningful evidence about KaM/FPC/Android dependencies.