Function validateMergeOrder

core/fleet/session.js:191–220

(task, tasks, options = {})

    .filter((entry) => entry.blockers.length > 0);
}

function validateMergeOrder(task, tasks, options = {}) {
  const taskMap = buildTaskMap(tasks);
  const candidate = typeof task === 'object' ? task : taskMap.get(String(task));
  if (!candidate) {
    return { ok: false, blockers: [{ dep: String(task), status: 'missing', reason: 'candidate is not in the work queue' }] };
  }

  const blockers = [];
  for (const dep of candidate.deps || []) {
    const target = taskMap.get(String(dep));
    if (!target) {
      blockers.push({ dep: String(dep), status: 'missing', reason: 'dependency is not in the work queue' });
      continue;
    }

    const status = normalizeStatus(target.status);
    const accepted = options.allowCompletedDependencies
      ? SUCCESS_STATUSES.has(status)
      : MERGED_STATUSES.has(status);
    if (!accepted) {
      blockers.push({
        dep: String(dep),
        status,
        reason: options.allowCompletedDependencies ? 'dependency is not complete' : 'dependency has not been merged',
      });
    }
  }

  return { ok: blockers.length === 0, blockers };
}

function normalizeGovernanceId(value, fallback) {