Add native host management and role-based operator authentication

Introduce an outbound Python host agent, Debian installer, durable remote
operations, immutable game-file libraries, host-aware deployments and ports,
and occupancy-safe campaigns and draining. Native hosts do not require Komodo.

Add administrator, operator and viewer accounts, protected management routes,
secure sessions, password recovery, audit history and separate telemetry tokens.
Document first-admin setup, reporter migration and live-host acceptance checks.

Validation: 1,343 TypeScript tests and 39 agent tests passed, along with type
checking, the production build, compiled SSR/API smoke tests and administrator
recovery. Real Debian/Docker T5/T6 acceptance remains unrun.

src/lib/server/backends/native.ts

@@ -0,0 +1,41 @@
+import { randomUUID } from 'node:crypto';
+import { db } from '../db/index.js';
+import { getHost, queueHostOperation, waitHostOperation } from '../hosts/index.js';
+
+export interface NativeInstance {
+    id: string; server: string; host_id: string; generation: number; library_id: string;
+    image: string; bind_address: string; port: number; public_address: string | null;
+    public_port: number | null; created_at: string; retired_at: string | null;
+}
+
+export function nativeInstance(server: string): NativeInstance | null {
+    return db().prepare('SELECT * FROM native_instances WHERE server = ? AND retired_at IS NULL').get(server) as NativeInstance | undefined ?? null;
+}
+
+export function nativeDeployment(id: string): boolean {
+    return !!db().prepare('SELECT 1 FROM native_provisioning WHERE deployment_id = ?').get(id);
+}
+
+/** Only the agent receives host paths, Docker access, or game credentials. */
+export async function nativeRequest<T = Record<string, unknown>>(instance: NativeInstance, kind: string, payload: Record<string, unknown> = {}, key?: string): Promise<T> {
+    const host = getHost(instance.host_id);
+    if (!host || host.connectionState !== 'online') throw new Error('Host agent is offline; instance state is unknown.');
+    const operation = queueHostOperation(instance.host_id, kind, payload, {
+        instanceId: instance.id, generation: instance.generation, idempotencyKey: key ?? randomUUID()
+    });
+    const result = await waitHostOperation(operation.id, 25_000);
+    if (result.state !== 'completed') throw new Error(result.error || `Agent operation ${result.id} is ${result.state}; its original ID is retained.`);
+    // Do not apply replies from a retired generation to a replacement server.
+    const current = nativeInstance(instance.server);
+    if (current?.id !== instance.id || current.generation !== instance.generation) throw new Error('Instance was replaced during the operation.');
+    return result.result as T;
+}
+
+export async function nativeHealth(server: string): Promise<{ ok: true; state: string } | { ok: false; reason: string; state?: string }> {
+    const instance = nativeInstance(server);
+    if (!instance) return { ok: false, reason: 'Native instance is not registered' };
+    try {
+        const result = await nativeRequest<{ state: string; healthy: boolean }>(instance, 'instance.inspect');
+        return result.healthy ? { ok: true, state: result.state } : { ok: false, state: result.state, reason: `Container ${result.state}` };
+    } catch (error) { return { ok: false, state: 'unknown', reason: (error as Error).message }; }
+}