max_count:int|None=Field(default=None,gt=0,description='Optional cap on the total number of matches returned across all files. Leave unset to use the configured default. When the cap is hit,
results are truncated and a note says so; narrow the pattern or path to see the rest.'