Method tryStartBackfill

server/modules/videosModule.js:755–765

* Atomically check the lock and kick off a backfill. Returns synchronously * with `started: true` (caller should respond 202) or `started: false` * (caller should respond 409). The actual backfill runs as a fire-and-forget * task; errors are logged inside `backfillVideoMetadata` itself.

({ trigger = 'manual' } = {})

   * task; errors are logged inside `backfillVideoMetadata` itself.
   */
  tryStartBackfill({ trigger = 'manual' } = {}) {
    if (this._backfillRunning) {
      return { started: false, reason: 'already-running' };
    }
    // backfillVideoMetadata sets the flag synchronously before its first await,
    // so launching it here is race-free for in-process callers.
    this.backfillVideoMetadata({ trigger }).catch((err) => {
      logger.error({ err }, 'Manual backfill run failed');
    });
    return { started: true };
  }

  isBackfillRunning() {
    return this._backfillRunning;