Suppressing findings

// bonsai-lint-ignore: hand-tuned state machine, splitting it hurts more than it helps
function parse(string $input): Ast { /* ... */ }

Works above the declaration, inside the docblock, or trailing the signature line, in every supported language, and for a $handler = function () {} or const handler = () => {} too. A marker after a closing brace on its own line belongs to nobody. A marker without a reason is refused, reported on stderr, and the finding stands. Suppression hides a finding but never changes a score, and --all always shows the real number.

A <toplevel> finding is reported on line 1, so its marker goes in the comment block at the top of the file: trailing <?php, in the file’s docblock, or on the first line of a script, behind a shebang if there is one. One comment silences one unit, so a marker directly above the first function is that function’s; write it on the <?php line to address the file instead.