fix(TRUEREF-0021): reduce event loop blocking, add busy_timeout, and add TRUEREF-0022 PRD

src/lib/server/db/client.ts

@@ -13,6 +13,7 @@ export function getClient(): Database.Database {
 		_client = new Database(env.DATABASE_URL);
 		_client.pragma('journal_mode = WAL');
 		_client.pragma('foreign_keys = ON');
+		_client.pragma('busy_timeout = 5000');
 	}
 	return _client;
 }

src/lib/server/db/index.ts

@@ -15,6 +15,10 @@ const client = new Database(env.DATABASE_URL);
 client.pragma('journal_mode = WAL');
 // Enforce foreign key constraints.
 client.pragma('foreign_keys = ON');
+// Wait up to 5 s when the DB is locked instead of failing immediately.
+// Prevents SQLITE_BUSY errors when the indexing pipeline holds the write lock
+// and an HTTP request arrives simultaneously.
+client.pragma('busy_timeout = 5000');
 
 export const db = drizzle(client, { schema });