[self::APPLYING, self::REJECTED, self::EXPIRED], self::APPLYING => [self::APPLIED, self::PARTIALLY_APPLIED, self::FAILED], self::APPLIED => [self::REVERTING], self::PARTIALLY_APPLIED => [self::REVERTING], self::REVERTING => [self::REVERTED], ]; /** States a revert may start from. */ public const REVERTIBLE = [self::APPLIED, self::PARTIALLY_APPLIED]; /** States with work in progress. */ public const RUNNING = [self::APPLYING, self::REVERTING]; public static function canTransition(string $from, string $to): bool { return in_array($to, self::TRANSITIONS[$from] ?? [], true); } public static function isFinal(string $status): bool { return in_array($status, [self::REJECTED, self::EXPIRED, self::REVERTED, self::FAILED], true); } /** * Final status of an apply run from the item counts: nothing applied → failed; some conflict/failed → * partially_applied; else applied. `excluded` items are NOT a problem. * * @param array $counts */ public static function finalApplyStatus(array $counts): string { $problems = (int) ($counts[self::ITEM_CONFLICT] ?? 0) + (int) ($counts[self::ITEM_FAILED] ?? 0); if ((int) ($counts[self::ITEM_APPLIED] ?? 0) === 0) { return self::FAILED; } return $problems > 0 ? self::PARTIALLY_APPLIED : self::APPLIED; } /** * Item counts per status (+ `items` total) of a list of items. * * @param array> $items * @return array */ public static function count(array $items): array { $counts = array_fill_keys(self::ITEM_STATUSES, 0); foreach ($items as $item) { $status = (string) ($item['status'] ?? ''); if (isset($counts[$status])) { ++$counts[$status]; } } $counts['items'] = count($items); return $counts; } }