The SEO contract.

What `probierz evaluate seo` and `probierz remote seo` read from an application's SEO policy and approved brief before a page is fetched, and each shape they refuse.

What is read before a page is fetched#

An SEO evaluation reads the application manifest's seo section, the SEO policy and the approved brief. Each rule below is checked before any page is fetched or any model is asked; a document that breaks one is refused naming the field, and nothing is written.

  • Modes: --mode and the profile names under a manifest's seo.profiles are the same four modes: pull-request, release, nightly and production. production additionally requires Search Console and CrUX evidence. Any other name is refused, and the refusal lists the modes.
  • Schema version: the SEO policy and the approved brief each declare "schemaVersion": 1, the one version the evaluator reads. A document at any other version is refused before a page is fetched.
  • Profiles: each profile under seo.profiles is an object stating requireSignature and requireProductionEvidence as booleans; a profile that states either as anything else is refused, naming the profile.
  • Crawl limits: crawl.maxRedirects, crawl.maxPages, crawl.maxDepth and crawl.maxSitemaps, when stated, are whole numbers of at least 0, and crawl.allowedOrigins a list of http or https addresses; anything else is refused naming the field. The site around the routes is crawled only when maxPages or maxSitemaps is stated.
  • Hard gates: hardGates, when stated, is an object whose keys are gates Probierz holds by its checks (http, crawl, index, parity, links, structuredData, evidence, performance) and whose values word them; another key, a gate with no wording, or hardGates of another shape is refused, naming the gates it may name.
  • Dimension checks: a dimension of source deterministic or hybrid states checks, a non-empty list of those same keys naming what measures it; one stating none, an unknown key, or checks on a model dimension is refused.

Where the evaluation is described#

The command itself, its inputs, what it writes and every refusal it answers with, is the CLI reference's probierz evaluate seo page; probierz remote seo runs the same evaluation on Stado.