From 2101208c51a337e5ac0818a59d2b2df738210b96 Mon Sep 17 00:00:00 2001 From: Matt McKay Date: Wed, 19 Aug 2026 09:04:09 +1000 Subject: [PATCH 1/3] bbh_michigan_monthly: state the measured ~825 KB transfer in the docstring The #96 validation instrumented the builder's HTTP traffic: 1 API GET (4,181 B) plus 6 range requests totalling 820,763 B = 824,944 bytes, ~2.6x the docstring's "~310 KiB". The builder is genuinely range-based (no full-archive fallback ran); the gap is the 256 KiB read buffer each member is streamed through. Documentation-only. Co-Authored-By: Claude Fable 5 --- builders/bbh_michigan_monthly.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/builders/bbh_michigan_monthly.py b/builders/bbh_michigan_monthly.py index 4203bcc..e22054b 100644 --- a/builders/bbh_michigan_monthly.py +++ b/builders/bbh_michigan_monthly.py @@ -31,7 +31,9 @@ Network cost: the deposit is a single 189 MiB zip. This builder HTTP-range-reads the zip's central directory and then only the three compressed members it needs -(~310 KiB), falling back to a full download if the host stops honouring Range. +(~825 KB transferred in total, measured -- each member is read through a 256 KiB +buffer, so reads overshoot the ~310 KiB of compressed member bytes), falling +back to a full download if the host stops honouring Range. Stages: fetch -> pre-process -> validate -> write. From 8fddc05ac0829ca985fb1728c7c724ef3fe7aa98 Mon Sep 17 00:00:00 2001 From: Matt McKay Date: Wed, 19 Aug 2026 13:26:27 +1000 Subject: [PATCH 2/3] State the exact measured bytes to keep the paragraph's units consistent Copilot review: the paragraph states the deposit in IEC units (189 MiB, 256 KiB, ~310 KiB) but the measured transfer was added as decimal "~825 KB". Exact bytes (824,944) sidestep the unit mix and match the instrumented figure in the #96 validation record verbatim. Co-Authored-By: Claude Fable 5 --- builders/bbh_michigan_monthly.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/builders/bbh_michigan_monthly.py b/builders/bbh_michigan_monthly.py index e22054b..d4bd0f8 100644 --- a/builders/bbh_michigan_monthly.py +++ b/builders/bbh_michigan_monthly.py @@ -31,8 +31,9 @@ Network cost: the deposit is a single 189 MiB zip. This builder HTTP-range-reads the zip's central directory and then only the three compressed members it needs -(~825 KB transferred in total, measured -- each member is read through a 256 KiB -buffer, so reads overshoot the ~310 KiB of compressed member bytes), falling +(824,944 bytes transferred in total, measured -- each member is read through a +256 KiB buffer, so reads overshoot the ~310 KiB of compressed member bytes), +falling back to a full download if the host stops honouring Range. Stages: fetch -> pre-process -> validate -> write. From 2df923a6f3b468643d62e810d55df2c17f4ce671 Mon Sep 17 00:00:00 2001 From: Matt McKay Date: Wed, 19 Aug 2026 13:26:44 +1000 Subject: [PATCH 3/3] Rejoin the wrapped line Co-Authored-By: Claude Fable 5 --- builders/bbh_michigan_monthly.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/builders/bbh_michigan_monthly.py b/builders/bbh_michigan_monthly.py index d4bd0f8..ace1046 100644 --- a/builders/bbh_michigan_monthly.py +++ b/builders/bbh_michigan_monthly.py @@ -33,8 +33,7 @@ the zip's central directory and then only the three compressed members it needs (824,944 bytes transferred in total, measured -- each member is read through a 256 KiB buffer, so reads overshoot the ~310 KiB of compressed member bytes), -falling -back to a full download if the host stops honouring Range. +falling back to a full download if the host stops honouring Range. Stages: fetch -> pre-process -> validate -> write.