Aller au contenu

list_a11y_gaps

List the actionable a11y gaps (the items[] of a11y_report, task 991), optionally filtered client-side. Each gap = {key_uuid, key_name, namespace_slug, surface, locale, gap, severity, detail}. To find keys/surfaces with NO a11y variant in the source, pass require_surface= and filter gap='a11y_variant_absent'. Feed key_uuid + surface (+ locale) into set_a11y_variant to fix one, or generate_a11y_variant / translate_a11y_variants to fill them in bulk.

NomTypeDescription
project_uuidstringoptionnelProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
gapstringoptionnelClient-side filter: keep only gaps of this type. (a11y_untranslated, alt_missing, reading_level_high, a11y_variant_absent)
surfacestringoptionnelClient-side filter: keep only gaps on this a11y surface. (aria_label, alt_text, screen_reader, plain_language)
localestringoptionnelClient-side filter: keep only gaps for this target locale code (e.g. 'fr'). Source-level gaps have locale=null.
require_surfacearrayoptionnela11y surfaces to flag as ABSENT in the source (produces a11y_variant_absent gaps). Pair with gap='a11y_variant_absent' to list keys missing a surface.
version_idstringoptionnelOptional version UUID; defaults to the production version.
reading_level_max_wordsintegeroptionnelReadability heuristic threshold for reading_level_high gaps. Default 15 server-side.
{
"tool": "list_a11y_gaps",
"arguments": {}
}