beam: add verified binary_search_bounds module with tests

docs/queue-index.md

@@ -4,7 +4,7 @@
 
 **What this is.** One row per item of `WORK-QUEUE.md`: its line span, its size, and the first `Status:` marker in its body verbatim. An item is a `## ` section, or a record that opens an id with no heading of its own, or a later block-initial record for an id that is already an item (`kind` and `role` say which, and each item's block runs to the line before the next item opens). Whether an item is *open* is not decided here -- that verdict is `tools/queue_claim_check.py`'s, and this document does not overrule it.
 
-**What it exposes.** The queue is two-tier. 111 sections carry 98 ids because 13 ids own a second, continuation section; 60 further ids are opened by a record and own no heading at all, and they have rows and extents here -- 146 record blocks in all, 86 of them a later closure or correction for an id already opened. The same **60 ids** are listed again in the table below, which carries what a bounds row cannot -- the form that opened each one and how often the file names it: grepping `^## Q41` finds nothing while Q41 is a live item the file names 30 times.
+**What it exposes.** The queue is two-tier. 112 sections carry 99 ids because 13 ids own a second, continuation section; 60 further ids are opened by a record and own no heading at all, and they have rows and extents here -- 147 record blocks in all, 87 of them a later closure or correction for an id already opened. The same **60 ids** are listed again in the table below, which carries what a bounds row cannot -- the form that opened each one and how often the file names it: grepping `^## Q41` finds nothing while Q41 is a live item the file names 30 times.
 
 | # | id | kind | lines | bytes | role | title | first `Status:` |
 |---|---|---|---|---|---|---|---|
@@ -264,7 +264,9 @@
 | 254 | Q162 | heading | 14507-14508 | 279 | opening | closure — a beam test bound its module to a host directory, so a total poison beside it read green; it now resolves beside itself and asserts the fact *(volt, 2026-11-03, at `bcaede7` and the commit … | -- |
 | 255 | Q162 | record | 14509-14528 | 8344 | cont: OPENED | **Q162 — OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `bcaede7` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `33e8ffb` ("beam: interval merge … | -- |
 | 256 | Q163 | heading | 14529-14530 | 314 | opening | closure — a tracked smoke script asserted against a module it bound by host path, and the class guard could not see it because of its filename; the guard now reads assertions, not names *(volt … | -- |
-| 257 | Q163 | record | 14531-14547 | 7106 | cont: OPENED | **Q163 — OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `f0b3a64` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `8639cab` ("beam: smoke … | -- |
+| 257 | Q163 | record | 14531-14548 | 7107 | cont: OPENED | **Q163 — OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `f0b3a64` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `8639cab` ("beam: smoke … | -- |
+| 258 | Q164 | heading | 14549-14550 | 358 | opening | closure — the beam coverage census enumerated its directory instead of its tree, so an untracked scratch file on this host moved the verdict; the list now comes from `git ls-files` and untracked … | -- |
+| 259 | Q164 | record | 14551-14569 | 8377 | cont: OPENED | **Q164 — OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `d3c9044` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `wizard-work/beam/check_coverage.py` … | -- |
 
 ## Ids with no `## ` heading
 
@@ -319,10 +321,10 @@ Opened as records inside another section. `line` is the record's own opening lin
 | Q135 | 13797 | 13797 | 2 | Q114 | BULLET+BOLD | BOLD-LEAD |
 | Q136 | 13831 | 13831 | 1 | Q87 | BULLET+BOLD | BOLD-LEAD |
 | Q137 | 13847 | 13847 | 3 | Q136 | BULLET+BOLD | BOLD-LEAD |
-| Q138 | 13879 | 13879 | 11 | Q137 | BULLET+BOLD | BOLD-LEAD |
+| Q138 | 13879 | 13879 | 12 | Q137 | BULLET+BOLD | BOLD-LEAD |
 | Q139 | 13897 | 13897 | 4 | Q138 | BULLET+BOLD | BOLD-LEAD |
-| Q140 | 13918 | 13918 | 8 | Q139 | BULLET+BOLD | BOLD-LEAD |
-| Q141 | 13938 | 13938 | 5 | Q140 | BULLET+BOLD | BOLD-LEAD |
+| Q140 | 13918 | 13918 | 9 | Q139 | BULLET+BOLD | BOLD-LEAD |
+| Q141 | 13938 | 13938 | 6 | Q140 | BULLET+BOLD | BOLD-LEAD |
 | Q142 | 13962 | 13962 | 2 | Q141 | BULLET+BOLD | BOLD-LEAD |
 | Q143 | 13980 | 13980 | 2 | Q142 | BULLET+BOLD | BOLD-LEAD |
 | Q144 | 13994 | 13980 | 3 | Q143 | BULLET+BOLD | BOLD-LEAD |
@@ -2229,17 +2231,30 @@ The block below is the parse this document renders, byte for byte. `--check` com
    "title": "**Q162 \u2014 OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `bcaede7` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `33e8ffb` (\"beam: interval merge \u2026"
   },
   {
-   "bytes": 7106,
-   "end_line": 14547,
+   "bytes": 7107,
+   "end_line": 14548,
    "id": "Q163",
    "kind": "record",
    "line": 14531,
-   "lines": 17,
+   "lines": 18,
    "role": "continuation",
    "role_detail": "OPENED",
    "status": null,
    "status_line": null,
    "title": "**Q163 \u2014 OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `f0b3a64` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `8639cab` (\"beam: smoke \u2026"
+  },
+  {
+   "bytes": 8377,
+   "end_line": 14569,
+   "id": "Q164",
+   "kind": "record",
+   "line": 14551,
+   "lines": 19,
+   "role": "continuation",
+   "role_detail": "OPENED",
+   "status": null,
+   "status_line": null,
+   "title": "**Q164 \u2014 OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `d3c9044` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `wizard-work/beam/check_coverage.py` \u2026"
   }
  ],
  "ids_multi_section": {
@@ -2394,7 +2409,8 @@ The block below is the parse this document renders, byte for byte. `--check` com
   "Q160",
   "Q161",
   "Q162",
-  "Q163"
+  "Q163",
+  "Q164"
  ],
  "items": [
   {
@@ -5726,17 +5742,43 @@ The block below is the parse this document renders, byte for byte. `--check` com
    "title": "closure \u2014 a tracked smoke script asserted against a module it bound by host path, and the class guard could not see it because of its filename; the guard now reads assertions, not names *(volt \u2026"
   },
   {
-   "bytes": 7106,
-   "end_line": 14547,
+   "bytes": 7107,
+   "end_line": 14548,
    "id": "Q163",
    "kind": "record",
    "line": 14531,
-   "lines": 17,
+   "lines": 18,
    "role": "continuation",
    "role_detail": "OPENED",
    "status": null,
    "status_line": null,
    "title": "**Q163 \u2014 OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `f0b3a64` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `8639cab` (\"beam: smoke \u2026"
+  },
+  {
+   "bytes": 358,
+   "end_line": 14550,
+   "id": "Q164",
+   "kind": "heading",
+   "line": 14549,
+   "lines": 2,
+   "role": "opening",
+   "role_detail": "",
+   "status": null,
+   "status_line": null,
+   "title": "closure \u2014 the beam coverage census enumerated its directory instead of its tree, so an untracked scratch file on this host moved the verdict; the list now comes from `git ls-files` and untracked \u2026"
+  },
+  {
+   "bytes": 8377,
+   "end_line": 14569,
+   "id": "Q164",
+   "kind": "record",
+   "line": 14551,
+   "lines": 19,
+   "role": "continuation",
+   "role_detail": "OPENED",
+   "status": null,
+   "status_line": null,
+   "title": "**Q164 \u2014 OPENED and REPAIRED in the same tick (volt, 2026-11-03, at `d3c9044` and the commit this record lands in; beam lane by authorship, unclaimed and taken).** `wizard-work/beam/check_coverage.py` \u2026"
   }
  ],
  "nested": [
@@ -6168,7 +6210,7 @@ The block below is the parse this document renders, byte for byte. `--check` com
    "form": "BOLD-LEAD",
    "id": "Q138",
    "line": 13879,
-   "refs": 11,
+   "refs": 12,
    "section": "Q137",
    "shape": "BULLET+BOLD"
   },
@@ -6186,7 +6228,7 @@ The block below is the parse this document renders, byte for byte. `--check` com
    "form": "BOLD-LEAD",
    "id": "Q140",
    "line": 13918,
-   "refs": 8,
+   "refs": 9,
    "section": "Q139",
    "shape": "BULLET+BOLD"
   },
@@ -6195,7 +6237,7 @@ The block below is the parse this document renders, byte for byte. `--check` com
    "form": "BOLD-LEAD",
    "id": "Q141",
    "line": 13938,
-   "refs": 5,
+   "refs": 6,
    "section": "Q140",
    "shape": "BULLET+BOLD"
   },
@@ -6286,9 +6328,9 @@ The block below is the parse this document renders, byte for byte. `--check` com
   "end_line": 8,
   "line": 1
  },
- "queue_bytes": 2505315,
- "queue_lines": 14547,
- "queue_sha256": "72b6efb2f571031295dae92e949ad294332d50a930de83e7e058f21073bfac20",
+ "queue_bytes": 2514051,
+ "queue_lines": 14569,
+ "queue_sha256": "d75d3e92b369100f09170cd8690bc2dec0b36f5a0e7905f795006451e6b3434f",
  "sections": [
   {
    "bytes": 3139,
@@ -7732,6 +7774,19 @@ The block below is the parse this document renders, byte for byte. `--check` com
    "status": null,
    "status_line": null,
    "title": "closure \u2014 a tracked smoke script asserted against a module it bound by host path, and the class guard could not see it because of its filename; the guard now reads assertions, not names *(volt \u2026"
+  },
+  {
+   "bytes": 358,
+   "end_line": 14550,
+   "id": "Q164",
+   "kind": "heading",
+   "line": 14549,
+   "lines": 2,
+   "role": "opening",
+   "role_detail": "",
+   "status": null,
+   "status_line": null,
+   "title": "closure \u2014 the beam coverage census enumerated its directory instead of its tree, so an untracked scratch file on this host moved the verdict; the list now comes from `git ls-files` and untracked \u2026"
   }
  ]
 }