recover method

  1. @override
Future<QueueRecoveryReport> recover()
override

Recovers persistent queue state by validating journal entries and reconciling stored jobs.

Implementation

@override
Future<QueueRecoveryReport> recover() => _locked(() async {
  var corruptedEntriesDiscarded = 0;
  var recoveredJobs = 0;

  // 1. Truncate incomplete journal line if present
  if (await _journalFile.exists()) {
    final bytes = await _journalFile.readAsBytes();
    if (bytes.isNotEmpty && bytes.last != 10) {
      final lastNewline = bytes.lastIndexOf(10);
      if (lastNewline >= 0) {
        await _journalFile.writeAsBytes(
          bytes.sublist(0, lastNewline + 1),
          flush: true,
        );
        corruptedEntriesDiscarded++;
      } else {
        await _journalFile.delete();
        corruptedEntriesDiscarded++;
      }
    }
  }

  // 2. Reload state
  _state = null;
  final state = await _syncState();

  // 3. Scan jobs directory for unindexed or uncommitted jobs
  final diskJobs = await _allJobs();
  for (final job in diskJobs) {
    if (job.status == RegenerationJobStatus.queued) {
      final composite = '${job.siteId}|${job.tenantId}|${job.idempotencyKey}';
      if (!state.idempotency.containsKey(composite) ||
          !state.pending.contains(job.id)) {
        state.idempotency[composite] = job.id;
        state.pending.add(job.id);
        recoveredJobs++;
      }
    } else if (job.status == RegenerationJobStatus.processing &&
        job.leaseUntil != null) {
      if (!state.processing.containsKey(job.id)) {
        state.processing[job.id] = job.leaseUntil!;
        recoveredJobs++;
      }
    }
  }

  await _checkpointInternal();

  return QueueRecoveryReport(
    journalEntriesReplayed: state.lastSeq,
    recoveredJobs: recoveredJobs,
    corruptedEntriesDiscarded: corruptedEntriesDiscarded,
    rebuiltFromDisk: true,
    activePendingCount: state.pending.length,
    activeProcessingCount: state.processing.length,
    idempotencyCount: state.idempotency.length,
  );
});