Function planIssueLabelChanges

scripts/issue-labels/index.js:584–631

* Compute label mutations for the current issue state. * * @param {{currentLabels: Set |string[], desiredType: string|null, desiredDomainLabels: string[], syncDomains: boolean, overrideType: boolean}} params * @returns {{toAdd: string[], toRemove: string[]}}

(params)

 * @returns {{toAdd: string[], toRemove: string[]}}
 */
function planIssueLabelChanges(params) {
  const {
    currentLabels,
    desiredType,
    desiredDomainLabels,
    syncDomains,
    overrideType,
  } = params;

  const current = currentLabels instanceof Set ? currentLabels : new Set(currentLabels || []);
  const toAdd = new Set();
  const toRemove = new Set();

  // Type: only apply when desiredType exists.
  // Safety: by default, do NOT override existing type labels to avoid reverting manual triage.
  if (desiredType) {
    const currentType = [...current].filter((l) => TYPE_LABEL_SET.has(l));
    const shouldApplyType = overrideType || currentType.length === 0;
    if (shouldApplyType) {
      if (!current.has(desiredType)) {
        toAdd.add(desiredType);
      }
      for (const t of currentType) {
        if (t !== desiredType) toRemove.add(t);
      }
    }
  }

  // Domain: add-only by default; strict sync via --sync-domains.
  const desiredDomains = new Set(desiredDomainLabels || []);
  for (const d of desiredDomains) {
    if (!current.has(d)) toAdd.add(d);
  }

  // Safety: only remove domains when we can positively match at least one domain.
  if (syncDomains && desiredDomains.size > 0) {
    for (const d of current) {
      if (DOMAIN_LABEL_SET.has(d) && !desiredDomains.has(d)) {
        toRemove.add(d);
      }
    }
  }

  return {
    toAdd: [...toAdd],
    toRemove: [...toRemove],
  };
}

/**
 * Parse CLI arguments into runtime options.