browser/plugins/examples/scum-server-plugin/schemas/bridge/queries/SCUM_DB_CONTRACT.md

SCUM.db Query Contract

These query template keys are browser-safe declarations. They intentionally do not carry SQL text, host paths, DSNs, sockets, or credentials. The bound run/agent beside the current SCUM service owns the actual SQLite read implementation and must return rows matching the referenced result schemas.

Template key	SCUM.db source tables	Plugin-owned output
scum.player.profile	user_profile, prisoner, prisoner_entity, entity, bank_account_registry, bank_account_registry_currencies, optional squad_member / squad joins	Player identity, economy, squad summary, and current position
scum.squads	squad, optional squad_member, optional user_profile leader joins	Squad records and leader/member counts
scum.squad-members	squad_member, user_profile, optional squad joins	Squad roster and member identity mapping
scum.vehicles	vehicle_spawner, entity, optional owner/squad joins when present	Vehicle inventory and coordinates; unknown class labels remain unknown
scum.flags	base_element, entity, user_profile, squad_member, squad where available	Flag ownership, ownership confidence, and coordinates
scum.positions	prisoner_entity, vehicle_spawner, base_element, entity	Current player, vehicle, and flag coordinates

last_save_time is freshness evidence only. It must not be treated as proof that a player is online; online state comes from login/logoff evidence or an explicit typed online field.