docs(brief-quality): correct help text — cap_truncation has no fallback estimate (#3393)

Greptile P3 follow-up on PR #3390 (already merged): the help comment
described cap_truncation_rate as "computed from production drop logs
if supplied via stdin, else estimated as max(0, in - 16)/in from
replay record counts" — but:

1. The "16" was stale (post PR #3389, cap default is 12).
2. The fallback estimate was never implemented. cap_truncation only
   appears when --drop-lines-stdin is passed.

Updated the comment to match what the code actually does: cap
metric is omitted entirely without stdin input. No fallback estimate
because replay records don't capture the post-cap output count, so
any derived value would be misleading.
This commit is contained in:
Elie Habib
2026-04-25 13:47:53 +04:00
committed by GitHub
parent 621ac8d300
commit 8f8213605f

View File

@@ -17,9 +17,11 @@
// - false_adjacency — % of "should-separate" labeled pairs that end
// up adjacent (false positive)
// - cap_truncation_rate — % of qualified stories truncated by the
// MAX_STORIES_PER_USER cap (computed from production drop logs if
// supplied via stdin, else estimated as max(0, in - 16)/in from
// replay record counts)
// MAX_STORIES_PER_USER cap. ONLY reported when production drop logs
// are piped in via --drop-lines-stdin. Without that input, this
// metric is omitted entirely (no fallback estimate — replay records
// don't capture the post-cap output count, so any estimate would be
// misleading).
// - multi_member_topic_share — % of topics with size > 1
// - quality_score — composite (recall × 0.6 + (1-false-adj) × 0.3 +
// multi-member × 0.1)