pub fn knob_needs_a_whole_set(flags: &[String]) -> StringExpand description
GAP-SG-209: a knob that needs the whole set was aimed at a stream.
export emits one self-contained JSON record per line, and the surface is
defined over a COMPLETE envelope. Applying a whole-set knob there ran it once
per line: --count-only export --limit 10 answered with eleven separate
{"count":1} lines instead of one count. Naming the flags as data matters
here as much as elsewhere, so discarded_flags carries them.
GAP-SG-215 added --max-items to the callers of this message and made the
corrective action name --limit. “Narrow the query itself” was true and
unactionable: a caller who reached for an output ceiling needs to be told
which flag is the QUERY ceiling, not merely that one exists.