feat(warmup): order the Breeze preload list by importance

[parisek]

Breeze zpracovává preload frontu striktně od začátku, tempem zhruba sekunda na URL. Pozice v poli tedy přímo určuje, jak dlouho po vychladnutí cache dostane návštěvník stránku ze studena. Dosud o tom rozhodovalo pořadí, v jakém URL vyplivl generátor sitemapy.

Tenhle PR pořadí řídí podle důležitosti stránky — a tím mění strop z hrubého ořezu na vědomý výběr.

Jak to funguje

Skóre se počítá ve studené cestě (odložená cron obnova sitemapy) a do wp_options jde hotové seřazené pole. Horká cesta — filtr breeze_preload_urls, který běží synchronně v purge requestu, zatímco redaktor čeká na odpověď — jen přečte uložený seznam a pozičně ho sloučí se seznamem od Breeze. Její náklad neroste s velikostí sitemapy.

Skóre je součet, ne maximum, aby čerstvá stránka v menu předběhla stránku v menu, na kterou rok nikdo nesáhl:

Složka	Výchozí
homepage každého aktivního jazyka	1000
ruční seznam z administrace Breeze	800
položka libovolného menu	500
váha per post type	0 (mapa types)
čerstvost z <lastmod>	300 / 200 / 100 / 25 podle stáří

Remízu rozhoduje původní pořadí ze sitemapy, takže datové řazení AIOSEO zůstává jako poslední instance zdarma.

Tři věci, které je potřeba vědět předem

<lastmod> je datum úpravy, ne publikace. Deset let stará stránka s opravou překlepu se počítá jako čerstvá. Signál je zadarmo v XML, které stejně parsujeme; dotahovat skutečná data publikace by znamenalo párovat URL na příspěvky přes WPML a vlastní permalinky.

Strop není celá cena. timberkit_warmup_sitemap_max_urls (výchozí 200) platí jen na URL ze sitemapy. Položky od Breeze se nahřejí navrch a homepage i menu každého jazyka jsou garantované, i když strop překročí — je měkký záměrně.

Nahřát stránku, kterou nikdo nenavštíví během TTL cache, je čistý odpad. Praktické měřítko pro nastavení stropu: kolik URL dostalo včera aspoň jedno zobrazení.

Zapnutí

Vypnuté ve výchozím stavu, jako každá nová funkce v tomhle balíčku.

protected bool $breeze_warmup_sitemap  = true;
protected bool $breeze_warmup_priority = true;

protected array $breeze_warmup_priority_weights = array(
    'types' => array( 'realizace' => 150 ),
);

Invalidace

Uložené pořadí přestane být pravdivé ze tří důvodů, a každý má svou cestu:

1. Vypršelo CACHE_TTL (hodina) — dosavadní chování.
2. Změnily se váhy (deploy) — otisk vah se počítá jednou při registraci a při purge stojí jedno porovnání řetězců.
3. Změnilo se menu — wp_update_nav_menu na prioritě 5 přeskládá pořadí na místě z uložených signálů, bez síťového požadavku, ještě než Breeze a kit na prioritě 10 spustí purge.

Cron obnova a přeskládání při změně menu píší do stejného option řádku, takže přibyl optimistický zámek přes revizi: zapisovatel, jehož snímek mezitím zestárl, se zahodí místo aby přepsal čerstvá data. ADR-0006 popisuje, proti kterému prokládání to chrání a proti kterému ne.

Navíc

Site Health check preload_chain_healthy hlásí zaseknutý preload chain. Dnes se ten výpadek nijak neprojeví — web jen tiše zůstane studený.

Změna chování

fetchSitemapUrls() nově dedupuje podle kanonického tvaru URL, ne přesného řetězce. Dvě psaní téže stránky (lomítko na konci, velikost písmen ve schématu, výchozí port, fragment) se sloučí a vítězí první nalezené. Tatáž stránka se tak přestane počítat do stropu dvakrát.

Tvar uloženého payloadu se rozšířil o signály, otisk vah a revizi. Migrace není potřeba — starší řádek se čte jako zastaralý a naplánuje se obnova.

Ověření

• composer test — 1622 testů, 1 skipped, 0 selhání
• composer test:property — 18 testů, 15 703 asercí (invariant: řazení je permutace vstupu)
• composer phpstan — bez chyb
• composer adr — 6 ADR, všechny v indexu

Šest nových tříd v Parisek\TimberKit\BreezeWarmup, z toho čtyři čisté funkce bez jediného volání WordPressu — proto se dají testovat bez Brain\Monkey a property test splňuje izolační konvenci z AGENTS.md.

Známá omezení

• WPML v režimu doména-na-jazyk: cizí hostitel neprojde naší kontrolou ani preload_url() v Breeze. Každá doména se nahřívá sama ve svém purge requestu — korektní výsledek, ne chyba.
• Filtr vah musí být čistá funkce. Jeho výsledek se otiskuje a porovnává napříč requesty; callback, který čte měnící se stav, by plánoval obnovu při každém purge. Zdokumentováno u weights().
• Časové údaje o Breeze (sekunda na URL, 24h TTL) pocházejí z verze 2.5.11 mimo tenhle repozitář a odsud se ověřit nedají.