lychee.toml

# Externe-links-gate (openspec: add-docs-drift-gates).
#
# De beperking van 2026-07-07 is vervallen. Toen draaide de check achter de
# egress-proxy van con-ci-oci en waren alleen allowlisted hosts echt te
# controleren; sinds de pipeline op GitHub Actions draait (2026-08-03) is de
# egress open en is de externe dekking volledig.
#
# 403 blijft geaccepteerd, maar nu om één reden in plaats van twee: er is geen
# proxy-denial meer, alleen bot-blocking (sites die een CI-user-agent weren).
# Wil je de gate strenger, dan is 403 uit `accept` halen nu een reële optie —
# dat was het eerder niet, omdat de proxy zelf 403 gaf.

# 403 = bot-blocking; 429 = rate limit. Beide niet dood.
accept = [200, 201, 202, 203, 204, 206, 301, 302, 303, 307, 308, 403, 429]

timeout = 20
max_retries = 2
max_concurrency = 8

# De gegenereerde 404-pagina bevat root-relatieve links naar /handbook/… Die
# kloppen pas op het gepubliceerde basispad; in een lokale build wijzen ze naar
# site/handbook/… dat niet bestaat. 94 valse bevindingen, allemaal uit dit ene
# bestand.
exclude_path = ["site/404.html"]

exclude = [
  "^https?://localhost",
  "^https?://127\\.0\\.0\\.1",
  "^https?://.*\\.example\\.com",
  # Forgejo edit-links vragen een sessie; geen inhoudslink.
  "_edit/",
  # Placeholder-hosts uit voorbeeldconfiguraties in docs.
  "^https?://<",
]

# Mailadressen niet checken (privacy + zinloos zonder SMTP-probe).
# Heette `exclude_mail` tot lychee 0.24; dat veld bestaat niet meer en liet de
# hele config afketsen met "unknown field". Dat viel niet op omdat de
# workflow-stap zijn eigen exitcode opving.
include_mail = false