Final completeness by time window: ranges keep their posting span, release_final() over blocks of done ranges

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

app/services/search_service.ts

@@ -51,6 +51,8 @@ export interface ReleaseSummary {
   size: number
   readable: boolean
   complete: boolean | null
+  /** The complete verdict is definite: done ranges cover the release's posting times and 6 hours either side (release_final). */
+  final: boolean
   category: number
   settled: boolean
   /** The prober found encrypted archive entries or headers; null: not probed (yet). */
@@ -92,7 +94,8 @@ class SearchService {
     }
     if (params.readable) where.push('(r.readable OR r.inner_name IS NOT NULL)')
     if (params.complete) where.push('r.complete')
-    if (params.notIncomplete) where.push('r.complete IS NOT FALSE')
+    // Incomplete only when final: a release next to unread ranges may yet get its missing files (release_final).
+    if (params.notIncomplete) where.push('(r.complete IS NOT FALSE OR NOT release_final(r.group_id, r.first_article, r.last_article, r.posted_at, r.last_posted_at))')
     if (params.unlocked) where.push('r.passworded IS NOT TRUE')
     if (params.source) {
       where.push('r.source = ?')
@@ -133,7 +136,8 @@ class SearchService {
     const countLimit = offset + (params.countLimit ?? COUNT_LIMIT)
     const [{ rows }, { rows: counted }] = await Promise.all([
       db.rawQuery(
-        `SELECT r.id, r.name, r.source, r.poster, r.groups, r.posted_at, r.file_total, r.files, r.bytes, r.readable, r.complete, r.category, r.settled_at, r.passworded, r.inner_name
+        `SELECT r.id, r.name, r.source, r.poster, r.groups, r.posted_at, r.file_total, r.files, r.bytes, r.readable, r.complete, r.category, r.settled_at, r.passworded, r.inner_name,
+                release_final(r.group_id, r.first_article, r.last_article, r.posted_at, r.last_posted_at) AS final
          FROM releases r WHERE ${whereSql} ORDER BY ${order} LIMIT ? OFFSET ?`,
         [...bindings, perPage, offset]
       ),
@@ -158,6 +162,7 @@ class SearchService {
         size: Number(r.bytes),
         readable: r.readable,
         complete: r.complete,
+        final: r.final,
         category: r.category,
         settled: r.settled_at !== null,
         passworded: r.passworded,
@@ -170,9 +175,10 @@ class SearchService {
   async release(id: number) {
     const r = await db.from('releases').where('id', id).first()
     if (!r) return null
-    const [files, { rows: inspections }] = await Promise.all([
+    const [files, { rows: inspections }, { rows: finality }] = await Promise.all([
       NzbService.files(id),
       db.rawQuery(`SELECT kind, result, created_at FROM release_inspections WHERE release_id = ? ORDER BY candidate_id`, [id]),
+      db.rawQuery(`SELECT release_final(?, ?, ?, ?, ?) AS final`, [r.group_id, r.first_article, r.last_article, r.posted_at, r.last_posted_at]),
     ])
     return {
       id: Number(r.id),
@@ -187,6 +193,7 @@ class SearchService {
       segments: Number(r.segments),
       readable: r.readable,
       complete: r.complete,
+      final: finality[0].final,
       hasPar2: r.has_par2,
       category: r.category,
       firstSeenAt: r.first_seen_at,