Simplify game files to automatic T5 and T6 uploads

src/lib/server/hosts/preparation.ts

@@ -5,6 +5,7 @@ import { getHostLibraryCache, latestPublishedLibraries, queueLibraryDownload } f
 import type { Host, HostOperationState, HostPreparation, HostPreparationItem } from '../../hosts.js';
 
 const activeStates = ['pending', 'accepted', 'running', 'unknown'];
+const supersededDownload = 'Superseded by newer game files before delivery to the host.';
 type PreparationOperation = { id: string; state: HostOperationState; updated_at: string; error: string | null };
 type Target = { item: HostPreparationItem; image?: string; versionId?: string; requiredBytes: number; operation?: PreparationOperation };
 
@@ -53,8 +54,8 @@ function targets(host: Host): Target[] {
         const ready = matches && ['ready', 'outdated'].includes(cache!.status) && cache!.bytesDownloaded === version.sizeBytes;
         result.push({ versionId: version.id, requiredBytes: version.sizeBytes - (matches ? cache!.bytesDownloaded : 0) + host.minimumFreeBytes,
             operation: latestOperation(host.id, 'library.download', 'libraryVersionId', version.id),
-            item: { kind: 'library', label: `${version.name} · ${version.version}`, state: ready ? 'ready' : 'waiting',
-                detail: ready ? 'Game files are downloaded and verified.' : 'Game files will be downloaded and verified automatically.',
+            item: { kind: 'library', label: version.name, state: ready ? 'ready' : 'waiting',
+                detail: ready ? 'The latest game files are downloaded and verified.' : 'The latest game files will be downloaded and verified automatically.',
                 bytesDownloaded: cache?.bytesDownloaded ?? 0, bytesTotal: version.sizeBytes } });
     }
     const blocker = hostBlocker(host);
@@ -82,7 +83,7 @@ function targets(host: Host): Target[] {
 export function hostPreparationStatus(host: Host): HostPreparation {
     const items = targets(host).map(target => target.item);
     if (!items.some(item => item.kind === 'library')) items.push({ kind: 'library', label: 'Game files', state: 'waiting',
-        detail: 'Upload and publish a game-file library once; hosts download it automatically.' });
+        detail: 'Upload T5 or T6 game files; hosts download the latest available files automatically.' });
     const state = items.some(item => item.state === 'blocked') ? 'blocked'
         : items.some(item => item.state === 'preparing') ? 'preparing'
         : items.some(item => item.state === 'waiting') ? 'waiting' : 'ready';
@@ -97,25 +98,44 @@ export function presentHostPreparation(host: Host): Host {
     return { ...host, preparation };
 }
 
+function supersedeUndeliveredDownloads(hostId: string): void {
+    const latest = new Set(latestPublishedLibraries().map(version => version.id));
+    const pending = db().prepare(`SELECT id,json_extract(payload,'$.libraryVersionId') AS versionId
+        FROM ec_host_operations WHERE host_id=? AND kind='library.download' AND state='pending'
+        AND last_delivered_at IS NULL AND json_extract(payload,'$.automatic')=1`).all(hostId) as { id: string; versionId: string }[];
+    const now = new Date().toISOString();
+    for (const operation of pending) {
+        if (latest.has(operation.versionId)) continue;
+        // Delivered operations may already be writing files. Only unsubmitted
+        // automatic work can be replaced without consulting the agent journal.
+        db().prepare("UPDATE ec_host_operations SET state='failed',error=?,updated_at=? WHERE id=?").run(supersededDownload, now, operation.id);
+        db().prepare("INSERT INTO ec_host_operation_events(operation_id,state,created_at,error) VALUES(?,'failed',?,?)").run(operation.id, now, supersededDownload);
+        db().prepare("UPDATE host_library_caches SET status='missing',error=NULL,updated_at=? WHERE host_id=? AND version_id=? AND operation_id=? AND status NOT IN ('ready','outdated')")
+            .run(now, hostId, operation.versionId, operation.id);
+    }
+}
+
 /** Agent heartbeats and polls drive durable preparation; no open UI or in-memory worker is needed. */
 export function reconcileHostPreparation(hostId: string): HostPreparation {
     return db().transaction(() => {
         const host = getHost(hostId);
         if (!host) throw new Error('Host was not found.');
         if (!hostBlocker(host)) {
+            supersedeUndeliveredDownloads(hostId);
             // Queue only one setup mutation at a time so each capacity check uses
             // fresh disk inventory. This also respects manually queued downloads.
             const active = db().prepare(`SELECT 1 FROM ec_host_operations WHERE host_id=?
                 AND kind IN ('runtime.pull','library.download','library.import') AND state IN ('pending','accepted','running','unknown') LIMIT 1`).get(hostId);
             const finished = db().prepare(`SELECT updated_at FROM ec_host_operations WHERE host_id=?
                 AND kind IN ('runtime.pull','library.download','library.import') AND state IN ('completed','failed')
-                ORDER BY updated_at DESC LIMIT 1`).get(hostId) as { updated_at: string } | undefined;
+                AND (error IS NULL OR error != ?)
+                ORDER BY updated_at DESC LIMIT 1`).get(hostId, supersededDownload) as { updated_at: string } | undefined;
             if (!active && (!finished || Date.parse(host.lastHeartbeat!) > Date.parse(finished.updated_at))) {
                 // A failed or oversized library must not prevent other libraries
                 // from preparing. The runtime still comes first when eligible.
                 const target = targets(host).find(target => target.item.state === 'waiting');
                 if (target?.image) queueHostOperation(host.id, 'runtime.pull', { image: target.image });
-                else if (target?.versionId) queueLibraryDownload(host.id, target.versionId);
+                else if (target?.versionId) queueLibraryDownload(host.id, target.versionId, { automatic: true });
             }
         }
         return hostPreparationStatus(host);