beqforge 0.3.3__tar.gz → 0.3.4__tar.gz

{beqforge-0.3.3 → beqforge-0.3.4}/.github/workflows/build-device-check.yml

@@ -61,7 +61,7 @@ jobs:
             executable: beqforge-device-check
     steps:
       - uses: actions/checkout@v7
-      - uses: astral-sh/setup-uv@v10.3.2
+      - uses: astral-sh/setup-uv@v10.3.3
         with:
           enable-cache: true
       - name: Install Linux audio and USB libraries

{beqforge-0.3.3 → beqforge-0.3.4}/.github/workflows/build-executable.yml

@@ -112,7 +112,7 @@ jobs:
       contents: read
     steps:
       - uses: actions/checkout@v7
-      - uses: astral-sh/setup-uv@v10.3.2
+      - uses: astral-sh/setup-uv@v10.3.3
         with:
           enable-cache: true
       - name: Build wheel and source distribution
@@ -201,7 +201,7 @@ jobs:
       - uses: actions/checkout@v7
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.3.2
+        uses: astral-sh/setup-uv@v10.3.3
         with:
           enable-cache: true
 

{beqforge-0.3.3 → beqforge-0.3.4}/.github/workflows/tests.yml

@@ -67,7 +67,7 @@ jobs:
         run: choco install ffmpeg -y
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.3.2
+        uses: astral-sh/setup-uv@v10.3.3
         with:
           enable-cache: true
 
@@ -100,7 +100,7 @@ jobs:
       - uses: actions/checkout@v7
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.3.2
+        uses: astral-sh/setup-uv@v10.3.3
         with:
           enable-cache: true
 
@@ -131,7 +131,7 @@ jobs:
         profile: [base, designer, optimiser, device-check, all]
     steps:
       - uses: actions/checkout@v7
-      - uses: astral-sh/setup-uv@v10.3.2
+      - uses: astral-sh/setup-uv@v10.3.3
         with:
           enable-cache: true
       - name: Build the single distribution

{beqforge-0.3.3 → beqforge-0.3.4}/CLAUDE.md

@@ -12,8 +12,8 @@
   protocol for anything that can change a decision, and the outcome written into
   `TODO.md` and the completed evidence under `plans/`. Don't substitute a full nine-title rerun, and don't skip it.
 * Don't run `uv run python tools/design_beq.py` casually against real material — a run is
-  40-80 s a title. Wrap any timed run in `systemd-inhibit` (see AGENTS.md's "Waiting on a long
-  run") and use the background-task workflow rather than a foreground `sleep` loop.
+  40-80 s a title. Wrap any timed run in `systemd-inhibit` (see AGENTS.md's "Long-running jobs and
+  timing") and use the background-task workflow rather than a foreground `sleep` loop.
 * The stage cache (`beqforge/cache.py`) is on by default and keyed per stage; `--fresh` forces a
   recompute, `--no-cache` uses neither. Don't assume a change took effect without one of these if
   you're re-running against the same material.

{beqforge-0.3.3 → beqforge-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: beqforge
-Version: 0.3.3
+Version: 0.3.4
 Summary: Audio-derived BEQ design, published filter optimisation and DSP validation
 License-File: LICENCE.md
 Requires-Python: <3.15,>=3.13

{beqforge-0.3.3 → beqforge-0.3.4}/TODO.md

@@ -47,14 +47,14 @@ ID alone (AGENTS.md says where each lives), and the stale contract versions are
 | 20 | Protective corner (former TODO 9) | parked | The corner is already derived from boost cap and implied order, floored by `lowest_frequency_hz`. No case requires an independent override or different fallback alignment; reopen with one. |
 | 21 | Device configuration on the wire | parked | The current contract deliberately omits device preference; server flags already configure realisation. Reopen if one server must serve different device formats/rates per request; then agree an upstream extension. Hardware validity remains F2. |
 | 22 | Catalogue comparison (former TODO 8) | parked | A disagreement detector has no demonstrated accuracy benefit. Reopen with an independent discrepancy to investigate; authored filters remain comparisons, never calibration targets. |
-| 23 | Performance | fit kernel released in 0.3.0 (design version 8); 0.3.1 fixes the designer image run as another user | [The measurement and outcome](plans/fit-kernel.md#outcome). The fit's search now scores each DE generation at once in the linear domain (`beqforge/fit_kernel.py`; numba, numpy fallback, bit-identical). Real runs on the 11 titles: 703 to 283 s wall, 1905 to 373 CPU-s; the `fit` stage 10x, so a title is 28 s and 37 CPU-s. A re-roll: refit probe no worse on balance, no baseline title's winner or verdict changed in real runs, protocol and corpus unchanged where gated. **Left:** the fit re-rolls near the top of the band as freely as at 10 Hz (row 37: weighting the search works, held back behind row 36); measure a library sample for the impact basis and replace it in a later 0.3 release (0.3.0's is mostly injected variants); CI's Windows and macOS executables with numba. Still parked: reuse of repeated numerical identities, the ~9 s a title outside the pipeline (measure on the server path), an own DE loop. GPU offload rejected. Missed-fit search belongs to F3/F4. |
+| 23 | Performance | fit kernel released in 0.3.0 (design version 8); 0.3.1 fixes the designer image run as another user | [The measurement and outcome](plans/fit-kernel.md#outcome). The fit's search now scores each DE generation at once in the linear domain (`beqforge/fit_kernel.py`; numba, numpy fallback, bit-identical). Real runs on the 11 titles: 703 to 283 s wall, 1905 to 373 CPU-s; the `fit` stage 10x, so a title is 28 s and 37 CPU-s. A re-roll: refit probe no worse on balance, no baseline title's winner or verdict changed in real runs, protocol and corpus unchanged where gated. **Left:** the fit re-rolls near the top of the band as freely as at 10 Hz (row 37: weighting the search works, held back behind row 36); measure a library sample for the impact basis and replace it in a later 0.3 release (0.3.0's is mostly injected variants); CI's Windows and macOS executables with numba. **Repeated work removed** (not yet released; no design version bump, no answer changed): seven exact-preserving changes, one commit each, each with probe `--tol 0` unchanged and real-run records identical — the headroom peak in one-second blocks, the sub feed and its unfiltered spectra built once a run, one filtered waveform per measured candidate, a counterfactual cap's restoration reused when its boosts repeat, one flat deficit a channel, and the bootstrap's percentile read off draw counts (bit-identical; the review's prototype differed by 2e-15 dB only through the layout `std` read). Caught Stealing 54.7 to 27.5 s cold and 28.9 to 15.2 s warm in the pipeline, Black Bag 22.1 to 13.9 and 12.3 to 8.1; see [the outcome](plans/designer-latency.md). Follow-up (the mix's flat deficit measured twice a run not five times, the record's chart transfer built once a candidate: Caught Stealing warm 22.3 to 20.6 s wall, Black Bag 14.2 to 12.3, records identical). Still parked: the ~7 s a title outside the pipeline that remains (npz decompression 1.5 s, imports 0.8 s, record 0.6 s, chart curves 4 s; measure on the server path), an own DE loop. GPU offload rejected. Missed-fit search belongs to F3/F4. |
 | 24 | Chart peak bias | parked | Deliberate catalogue-compatible per-bin maximum; it affects presentation only. Reopen if a reader needs an alternative percentile view; keep it distinct from the 95th-percentile evidence envelope. |
 | 26 | Texture yardstick retune (library review) | blocked on E10 | The cubic (row 2) keeps the 200 Hz band only because the sub-band cap admitted one synthetic negative, `broadband/5`: chance unevenness in noise bursts, at a 2.6 dB boost. With 45 gated cases a single case moves the gate's upper bound from 0.079 to 0.118. Carrie is still declined (0.85x about a cubic, 1.33x with the cap). The reopening trigger (the library review) is met and the first measurement is done ([research item 4](plans/library-review-improvements.md#4-the-texture-retune-row-26)): the trend degree does nothing; ending the band at 80 Hz clears five of the seven review declines but lets five more gated negatives past this rule and costs three filtered cases their passband. Its full corpus run lets in exactly `broadband/5` (a false acceptance at a 2.5 dB boost; gate 0/45 to 1/45, upper bound 0.118, FAIL) and moves nothing else, `filtered` included ([the run](plans/library-review-improvements.md#4-the-texture-retune-row-26)). So the open question is the boost-weighted gate, and E10 (row 3) before adopting any retune. Retune against its declines: the band edge, the trend degree, and whether the gate weights a false acceptance by its boost. The library holds no known negative, so it can expose wrong declines but not measure false acceptances. Any retune still needs the corpus or a fresh E10 set for that, ideally with negatives built from real programme texture (row 5). See [the outcome](plans/texture-yardstick-sub-band.md#outcome-17-october-2026). |
 | 28 | Fit sensitivity to arithmetic | released in 0.2.10 (design version 6) | Identification now converges to 1e-12 and the fit gets its target and ceiling quantised to 0.01 dB. The refit probe gives the same filters natively and as an emulated older CPU (0 of 11 titles moved; 28 Years Later's parametric moved before). Protocol false acceptances unchanged; corpus gate pass, `filtered` 7/9 (was 6/9). The 11 titles' corrected curves stay within 1.3 dB, though three swap between near-tied winners ([outcome](plans/library-review-improvements.md#built-a-reproducible-fit-input-22-october-2026-design_version-6)). CI's verdict on the golden: `counterfactual` matches on Linux, Windows and macOS and is back in it; `parametric` matches on the x86 runners that disagreed in 0.2.6, but macOS arm64 publishes the same filters with figures 0.06 dB apart, so it stays out ([verdict](plans/library-review-improvements.md#built-a-reproducible-fit-input-22-october-2026-design_version-6)). Left: find where arm64's parametric fit parts from x86's (needs an arm64 machine: compare the identified target, the quantised fit input and the fitted cascade unrounded) and either close the gap or accept it and say so in the golden's docstring; until then an Apple-silicon caller can see parametric figures a few hundredths of a dB from an x86 one. From design version 8 (row 23's kernel) `counterfactual` on the golden's rolloff title also publishes one step away on arm64 (36.25 Hz against 36.24, figures within tolerance), so the golden skips that case on arm64 too. Ship before the version 5 redesign (row 31) so the library is redesigned once. |
 | 29 | Library review improvements | fixes released; research recorded | From beqdesigner's review of all 279 declines in its full-library run ([the proposal](plans/library-review-improvements.md), with evidence, ids and run records per item). Released in 0.2.9 as design version 5 ([outcomes](plans/library-review-improvements.md#outcomes)): fix 1 (the unmeasured floor wording), fix 2 (the fit scored on the published parameters; The Quiet Girl now designs, Bugonia now declines on coverage below 8.1 Hz), fix 3 (mains-hum notches filled), fix 4 (the fit bounded by the over-lift bar; Crazy Heart's flatten passes), O2 (an infrasonic plateau refused as the reference) and O1 (a stepping DC offset reported). Research, measured and not built ([research](plans/library-review-improvements.md#research-after-the-fixes)), now tracked elsewhere: 1b (textured passband) has no contained fix and is a plateau recalibration for E10 (row 3); 4 is row 26; 5 (per-title scene margin, which also covers item 7) is an experiment for the protocol, corpus and E10; 6 (a sub-band reference) rescues one plausible title and is not worth building on this evidence; item 8's machine dependence is row 28. Not followed up: item 3's tilt band. Fix 2 rescued The Quiet Girl, and The Smurfs and Despicable Me 3 already design here, but Blood Simple and Synecdoche, New York haven't been rerun; check them in row 31. |
 | 30 | Contract 1.5: design adjustments | released in 0.2.9; one gap parked | beqdesigner can ask for a different design per title: ignore a band, a floor, a boost cap, a tilted goal, a note. `beqforge/adjustments.py` answers each; default answers unchanged (golden; probe `--tol 0`, all 11 titles). See [the outcome](plans/contract-1.5-adjustments.md#outcome). Only gap: a note's text is not written into the run record (the record holds the adjusted params, so the design replays). Reopen if a review needs the note from the record. |
 | 31 | Review the version 5 library redesign | open: handoff received 23 October 2026; group 1 released in 0.2.10 (design version 6) | Outcome and evidence: [the v5 review](plans/library-v5-review.md). beqdesigner's v5 rerun (job `ef4265fa`, 1,083 titles, about 1,000 designed and 69 declined; 18 titles v4 designed now decline, about half wrongly) is triaged into four groups in `/media/beq/triage/handoff-v5.md` (queue ids, v5 records and earlier runs per title). 1 (built): O2 refused a plateau starting just under 10 Hz on the knee of a real rolloff (A Quiet Place: Day One, Elysium, Pan); it now keeps such a plateau when it reaches 20 Hz and the shortfall beneath exceeds the passband's ripple, and all three design. Probe, protocol and corpus unchanged. 2: a whole candidate rejected for missing one check by a fraction: cliff by under 3 dB/oct (Heartburn, Back to the Future, Guardians of the Galaxy, The Commitments), tilt (Guardians, The Exorcist, Alien Resurrection, Philadelphia), level (Ray), F9 residual just below the content edge (Drive, Amy). The library has no negatives, so a tolerance it suggests still goes through the protocol and E10, never the catalogue. 3: every candidate corrected only down to above the content edge (Return to Seoul, Spirited Away, The Jungle Book, Bugonia). 4: known, rows 5/6 (steep filter; `judge_from_content_edge` is a server flag, not on the wire), F5 (Eastern Promises, Fame, Home Alone) and row 26. Earlier scope of this row:  0.2.9 reports design version 5, so beqdesigner's out-of-date filter flags every title designed before it. Review the redesign's declines and changed designs from their run records, as the first review was (row 29): confirm the fixes' titles moved as measured, rerun the open cases (row 29's tilt titles, the near-texture watch cases Black Bag, Bugonia and Incredible Hulk), and collect real-title evidence for rows 26 and 29's research. It can show wrong declines but not false acceptances (the library has no known negatives), so a retune it suggests still goes through E10. Do row 28 first if both machines will design. Records are kept by default from 0.2.10 (row 27, done). |
-| 32 | Fit optimum selection | part built (design version 7, not released); strategy choice still unstable | Found by row 28: reproducible is not stable. Changing the fit's input by at most 0.005 dB changed 24 winners on 54 titles and variants; Black Bag LR4 35's recovery fell from a 13.1 dB to a 3.4 dB peak. **Built (25 October 2026):** the fitter returns every fit within its 0.5 dB residual bar of its answer, and the pipeline keeps the first the judge passes, fewest sections first; an alternative must lift by more than the goal tolerance to replace the answer. Perturbing the fit input by 0.004 dB now flips 14 winners where HEAD flipped 19, 33 verdicts against 36, and no title swaps between designed and declined (HEAD 1). Black Bag LR4 35 goes to a 0.4 dB shortfall and holds; 13 of row 35's 14 new declines design again and none of its 17 gains is lost. Protocol unchanged, corpus gate passes. **Left:** most remaining flips are which strategy wins (flatten against a counterfactual on the steep variants, up to 38 dB apart below the content edge). The choice among strategies is untouched, and that is the next research step. See [the outcome](plans/library-review-improvements.md#row-32-choosing-among-near-equal-fits-25-october-2026-design_version-7) and [the finding](plans/library-review-improvements.md#built-a-reproducible-fit-input-22-october-2026-design_version-6). |
+| 32 | Fit optimum selection | part built (design version 10, not released); ties now broken by strategy order; verdict flips left | Found by row 28: reproducible is not stable. Changing the fit's input by a few thousandths of a dB changes winners. **Built (25 October 2026, version 7):** the fitter returns every fit within its 0.5 dB residual bar of its answer, and the pipeline keeps the first the judge passes, fewest sections first; an alternative must lift by more than the goal tolerance to replace the answer ([outcome](plans/library-review-improvements.md#row-32-choosing-among-near-equal-fits-25-october-2026-design_version-7)). **Measured again (2 November 2026):** `refit_probe.py`'s perturbation stacked per worker and read cached proposals made under another offset, so every earlier flip count was indicative only; fixed, and `rejudge` now judges again from kept fits in seconds. On 32 titles (the 11 baseline titles and the 21 variants that had ever moved) at three offsets, version 9 flipped 14 of 93 winners (28 with `--content-edge`), and real titles flip too: 28 Years Later and Send Help move between parametric and flatten, under 0.1 dB apart, because the tie went to the fewest sections and a near-equal fit's section count re-rolls. Searching the outranked fit again from other seeds (A) and per-octave departure (C) changed little and are not adopted. **Built (version 10):** a flatness tie goes to the strategy listed first in `STRATEGIES`: 8 flips (18), every default-mode ranking flip gone. Probe: the two real titles go to flatten, the same answer within 0.6 dB; protocol seed 101 improves one recovery, 947 unchanged; corpus gate unchanged. On the v8 library 80 of 1,069 winners change (70 of 762 all passing, 10 of 271 with a failure). **Left:** verdict flips, a candidate on the edge of a shape check passing under one offset and failing under the next (8 of the 8 left, 11 of 18 with `--content-edge`). Next: a margin around those checks. See [the outcome](plans/library-review-improvements.md#a-stable-tie-break-2-november-2026-design_version-10) and [the finding](plans/library-review-improvements.md#built-a-reproducible-fit-input-22-october-2026-design_version-6). |
 | 33 | Noise lift beyond the evidence (found on a pumping floor) | open: the evidence bound was measured and not adopted; next, validate the floor detection | E10's first runs lifted `nonstationary_floor` 27-33 dB, but that recipe swung about 37 dB inside every event: event-locked content, matching real stopband leakage on contrast and coherence, so not a failure under the content principle ([v5](plans/E10-validation-protocol.md#the-pumping-floor-v5-28-october-2026) reports it as `event_locked_floor` and counts realistic 2-6 dB `tracking_floor` and `breathing_floor`). On seeds 1-12 under [v6](plans/E10-validation-protocol.md#the-skirt-and-the-cases-it-leaves-v6-28-october-2026) (noise lift counted beyond half an octave under the truth band), 4 of 72 realistic-floor rows lift noise. The two large ones are the judge passing the candidate that fits worst: on `breathing_floor/2` four three-section fits within 1.1-2.1 dB of target fail the cliff check, and a single shelf 6.4 dB off target and 5.5 dB over the evidence ceiling passes and is selected; on `breathing_floor/5` (gentle) a single section 9.0 dB over the ceiling at an unsupported bin is selected over a passing three-section fit 1.9 dB over. Nothing refuses a design for exceeding its evidence: the over-lift bar is measured from the goal, and `evidence_excess` is reported only. **Bounding lift by the evidence, not adopted (29 October 2026):** the fitter bound at the licence plus 1.5 dB (A), a judge check on any excess over 1.5 dB (B), and that check limited to excesses at least half an octave wide (C) were each built on branch `experiment-evidence-bound`, uncommitted. C cleared E10's counted noise lifts, but applied to the v8 library's stored `evidence_excess` it refuses the accepted design for 96 of 1,033 titles, and 14 of those would decline. Inspection showed that most of these are a smooth fit against a ragged licence on content that tracks the programme (Any Given Sunday, To Die For). The large lifts it catches below a diagnosed floor (Wait Until Dark, White Heat) sit inside a licence that allows 20-25 dB there, and C catches them only by an edge excess. **Lift below the diagnosed floor:** 247 of the 304 designed titles with measured bins under `noise_floor_hz` lift more than 3 dB there, and 151 more than 10 dB. Almost all are flatten, holding its lift flat, among them Moana (37 dB under 8.4 Hz) and White Heat (29 dB under 40 Hz). These are not counts of noise lift. `noise_floor_hz` is the mix tracking boundary, the first band whose envelope fails to track the passband, and failing that is not proof of noise. The contrast licence often disagrees with it (Wait Until Dark: 20 dB licensed below it). **On E10's truth** ([evidence](plans/E10-validation-protocol.md#is-the-tracking-boundary-a-noise-detector-29-october-2026)), the boundary sits 0.24-0.42 octave (median) below the true noise boundary on every floor family, up to 1.12 octave, and never above it: it calls the noise just above it content. It also misses half of `finite_stopband`'s exposed cases, and calls LFE-only content noise at 15-27 Hz on 3 of 12 `partial_channels`. **On the library**, an independent test calibrated on E10 (does the band's level scale with programme loudness, and is it steady) finds content under the boundary on 151 of 300 floored titles, among them Moana, Creed III and Juror #2, the largest lifts below it. Only 10 look like steady noise. The other 139, mostly older, neither scale nor stay steady, which these statistics cannot resolve. So the boundary is not fit to gate a rule, and its content-as-noise error also holds restorations flat that the content supports. Measured within 240 s stretches, only 27 of those 139 become steady noise; 85 stay bursty within minutes without scaling with the plateau, which is either content independent of the plateau or transient noise (splices, handling), and E10 has no transient noise to calibrate against. **Next:** listen to Wait Until Dark, Marnie and GoodFellas (bursty, not scaling) against Mary Poppins and The Exorcist (steady noise). If bursty and non-scaling proves to be noise, add a transient-noise family to E10. Then improve the floor detection itself, before deciding how a restoration should behave below a floor shown to be noise: hold flat, cap at the local target as the counterfactuals do, or return to 0 dB. [Evidence](plans/E10-validation-protocol.md#bounding-lift-by-the-evidence-three-experiments-none-adopted-29-october-2026). Related: rows 32, 36, E4/E9. |
 | 34 | Redesign scope | built and released in 0.2.12 (contract 1.6's `POST /impact`); beqdesigner's step 2 live check passed, step 4 verification next | The pipeline is a catalogue of 37 named features (`beqforge/impact.py`), each owning its code and reading from a run record how a design relied on it. Each answer-changing design version declares in `beqforge/impact.toml` which features it changed and how much that moved; `tools/impact.py check` refuses changed code no feature owns and undeclared answer-reaching changes (regression step 5). `POST /impact` scores up to 500 records (15 s over the share), and records from before 0.2.11 are identified by the release that wrote them, so the current library can be scored. Version 7's fit-choice degree was measured on the library on one machine: 18 of 34 post-fit declines moved, 7 of 15 designs with a failing candidate, 2 of 15 with all passing, 0 of 8 analysis declines. Against the library: 34 likely, 1,015 possible, 236 unaffected, 70 unknown (pre-design-version builds). It doesn't meet the plan's bar for this change (likely holds 18 of the sample's 27 movers): a change that re-rolls the fit can't be narrowed by outcome class. The ranking still holds: the top 30% hold about two thirds of the expected movers. Records now carry each verdict's margins and each fit `_choose_fit` had, so a threshold change is scored exactly (`will_move` or `unaffected`), and `unknown` (`no_figure`) only for older records or a losing candidate that would start passing; this changes no answer (rejudge probe 11 of 11 at `--tol 0`, refit probe 0 of 54 moved). Responses carry each change's `basis` and `unknown_reason` (agreed with beqdesigner). `impact.MOVED`'s cascade line is now 20/f dB, capped at 2 dB at 10 Hz and below, not a flat 1 dB. Version 7's designed classes were recounted on beqdesigner's 105-title sample: 16 of 35 with a failing candidate, 22 of 60 all passing. **Version 9's scores (1 November 2026):** the ceiling's basis came from a sample chosen for lifting above 60 Hz, and its two touches were combined as independent although they were one measurement, so every one of the v8 library's 1,033 designs scored `likely`. Each touch can now be confined above a frequency (`above_hz`, `basis_below`). A record is scored by whether its band, target or cascade reaches above 60 Hz, and the largest share among a change's touches stands for the change. That gives 365 `likely` and 684 `possible` (0.29, row 32's re-roll); expected movers fall from 999 to 532. No answer changes (probe 11 of 11 at `--tol 0`). See [the outcome](plans/redesign-scope.md#scoring-a-change-by-what-it-reaches-1-november-2026). **Left:** beqdesigner's step 2 live check and step 4 verification sample (105 titles), and the check's from-the-results direction. See [the outcome](plans/redesign-scope.md#outcome). |
 | 35 | Review the version 6 library redesign | open: handoff received 24 October 2026; the 500 and record overwriting fixed in 0.2.11; the 14 new declines traced to row 28, 13 of them designing again on row 32 (version 7, unreleased) | beqdesigner's v6 rerun (job `e6a70f7e`, 1,287 titles): 1,016 designed and 270 declined. A Quiet Place: Day One, Elysium and Pan now design (row 31's O2 fix). 17 titles declined on v5 now design, and 14 designed on v5 now decline. Handoff: `/media/beq/triage/handoff-v6.md`; ledger `/media/beq/triage/ledger.jsonl`, stage `E`. **Fixed:** A Quiet Place Part II got a 500 every time, because `TargetFit.within_tolerance` came back as 1.0000000000000002. Zero-weight bins that miss the tolerance change how numpy pairs up a sum, so the in-tolerance sum could round above the full one. It is now met / (met + missed), which can't exceed 1; this code predates row 28. The figure is reporting only, so no design version: the title's filters are unchanged (low shelf 18.25 Hz +24.6 dB, peak 28.38 Hz −3.5 dB), and its response is now valid. Probe 11 of 11 unchanged at `--tol 0`; suite passes. **The 14 new declines (analysed 24 October 2026):** all 14 were rerun on one machine, at v0.2.9, at `f6dca94` (row 28 alone) and at HEAD, from requests identical to the library's (same digest). All 14 design on 0.2.9 and decline at `f6dca94`; HEAD agrees with `f6dca94`. So row 28 alone is the cause, and processor variance accounts for none of them. In every case the target is identical (0.000 dB apart) and the fit lands on a different cascade: row 28's 0.01 dB quantisation of the fit's input re-rolls the fitter's choice among near-equal optima (row 32). Except for TINA, the new fits are within 1 dB of the old by the fitter's own measure, worst-case error (Kung Fu Panda 4 0.4-0.9 dB worse, You've Got Mail 0.9 dB better), yet a judge check that depends on the error's shape flips: cliff (Platoon, The Manchurian Candidate, You've Got Mail, How to Marry a Millionaire), tilt (On Golden Pond, Christine, Twilight's counterfactual), ripple (Arrival, Kung Fu Panda 4), turnover (Magnolia, Zoolander), extent (Twilight's flatten) or slot (Rocky, Souleymane's Story). In TINA's case the fit itself is worse: 0.2.9's three-section fits drifted 2.1-3.0 dB on publication rounding, against a 3.0 limit, with their lowest sections about 4 quantisation steps from the device's DC limit. The new fits most likely drifted just past it, and the exposure rule fell back to one shelf fitting 4-6 dB off. No threshold should move on this evidence: the declines are as arbitrary as the 0.2.9 acceptances were, and the fix is row 32's, choosing among near-equal fits by what the judge checks rather than by which optimum the arithmetic lands on. **Slot check:** Rocky's and Souleymane's Story's new fits carry sections under 1 dB that the pruner keeps, because dropping them costs 1.02 and 1.12 dB of worst-case error against its 1 dB allowance. Their 0.2.9 two-section fits reached the same error without them. `designer-interface.md` §4 allows a rejection only for a reason internal to the evidence, which a redundant section is not, so the stated reason is wrong whatever the outcome. The outcome itself is doubtful too: both designs are 0.2-2.6 dB sections at 71-353 Hz, mostly above an 80 Hz crossover, not low-end restoration. The library's flip lists are not ground truth for row 34 by themselves (see [the proposal](plans/redesign-scope.md#validation-before-relying-on-it)): its v5 records were overwritten by v6's, because a record was named by its request's audio digest. **Fixed (0.2.11):** a record is now named by digests of the audio and of the rest of the request (coverage, bass management, adjustments, settings) and by the design version, and holds `design_version` and `design_settings` itself. A response's `run_record` (1.6, agreed in principle with beqdesigner) names it relative to the shared root. No answer changes. |

{beqforge-0.3.3 → beqforge-0.3.4}/beq_common/__init__.py

@@ -1,6 +1,6 @@
 """Shared filter primitives; no workflow package dependencies."""
 
-__version__ = "0.3.3"
+__version__ = "0.3.4"
 
 from .types import BiquadSpec as BiquadSpec
 from .types import BiquadType as BiquadType

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/AGENTS.md

@@ -151,6 +151,14 @@ something that decides anything is committed. The synthetic protocol and corpus
 a decision-changing fitter change; run the two protocol seeds in parallel. `probe.py snapshot
 --content-edge --records DIR` likewise rejudges any scratch record set with the option on.
 
+A change to fit selection or the judge alone does not need refitting: take "before" with
+`snapshot --state <scratch>/state`, and `refit_probe.py rejudge ... --state <scratch>/state`
+judges and chooses again from the kept fits in seconds (`REFIT_REJUDGE_FRESH=1` when the judge
+itself changed, about seven minutes over the steep variants). In a worktree, run the tool with
+the main checkout's `.venv/bin/python`: `uv run` there builds an environment without the
+extras. Stability under another machine's arithmetic (TODO 32) is `REFIT_PERTURB_DB`; see the
+tool's docstring.
+
 **3. Act on what moved:**
 
 * **Nothing** → the change reaches no decision on this material. The test suite is still
@@ -532,7 +540,7 @@ least `min_judge_octaves` above the floor — no fixed top (historical review T6
 
 * A run is ~40-80 s a title (down from ~100-490 s, 7.18x, every accepted filter's verdict
   preserved); the test suite is ~2 minutes. Run both in the background regardless — see
-  "Waiting on a long run" above. Measured 2026-10-25 on 0.2.12 (warm cache, 10 designing
+  the root AGENTS.md's "Long-running jobs and timing". Measured 2026-10-25 on 0.2.12 (warm cache, 10 designing
   titles, 70 s and 190 CPU-s a title on average): `fit` is 41% of wall time and 70% of CPU,
   `parametric`'s own fit inside its target stage another ~10% and ~12%, the rest of target
   construction ~12%, judging 17% (verify, headroom, sub feed) and ~13 s a title falls outside

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/accept.py

@@ -24,11 +24,11 @@ import numpy as np
 from beqforge import DESIGN_GRID, BiquadSpec
 from beqforge.filters import (
     Realisation,
-    publication_filters,
-    unstable_sections,
     biquad_sos,
     drift_distribution,
     magnitude_db,
+    publication_filters,
+    unstable_sections,
 )
 from beqforge.verify import Correction
 
@@ -603,9 +603,11 @@ def assess(
         return Verdict(
             passed=False,
             failures=[
-                f"only {octaves:.2f} octaves left to judge "
-                f"({correction.band_hz[0]:.1f}-{correction.band_hz[1]:.1f} Hz); a slope read "
-                f"over less than {params.min_judge_octaves:g} is set by where the band stops"
+                (
+                    f"only {octaves:.2f} octaves left to judge "
+                    f"({correction.band_hz[0]:.1f}-{correction.band_hz[1]:.1f} Hz); a slope read "
+                    f"over less than {params.min_judge_octaves:g} is set by where the band stops"
+                )
             ],
             notes=[],
             worst_gradient_before=math.nan,

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/charts.py

@@ -34,13 +34,13 @@ import matplotlib
 
 matplotlib.use("Agg")  # written to file, never shown; plt.show() blocks a headless run
 
-import matplotlib.pyplot as plt  # noqa: E402
-import numpy as np  # noqa: E402
+import matplotlib.pyplot as plt
+import numpy as np
 
-from beqforge import BiquadSpec  # noqa: E402
-from beqforge.filters import Realisation, unstable_sections  # noqa: E402
-from beqforge.verify import device_waveform  # noqa: E402
-from beqforge.material import Material  # noqa: E402
+from beqforge import BiquadSpec
+from beqforge.filters import Realisation, unstable_sections
+from beqforge.material import Material
+from beqforge.verify import device_waveform
 
 logger = logging.getLogger(__name__)
 
@@ -146,7 +146,7 @@ def programme_levels_db(
 
     index = int(power.sum(axis=1).argmax()) if frame_index is None else frame_index
     anchor = int(coarse[index])
-    half = int(round(LOUDEST_SPAN_S * fs / 2.0))
+    half = round(LOUDEST_SPAN_S * fs / 2.0)
     fine = np.arange(
         max(0, anchor - half),
         min(len(samples) - NPERSEG, anchor + half) + 1,

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/design.py

@@ -15,7 +15,7 @@ Two routes, matching the contract's `method`:
 
 import logging
 from collections.abc import Callable
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import Literal
 
 import numpy as np
@@ -118,7 +118,7 @@ class DesignParams:
     least often selected. `PipelineParams.fit_seeds` sets this now, and the
     reasoning there applies here unchanged."""
 
-    realisation: Realisation | None = Realisation()
+    realisation: Realisation | None = field(default_factory=Realisation)
     """How the cascade will actually be realised, scored during the fit.
 
     On by default. Fitting in float64 alone accepts cascades built from large opposing
@@ -321,7 +321,7 @@ def _unpriced_fitted_target(
 
 
 def _nearest_even_order(order: float) -> int:
-    return max(2, 2 * int(round(order / 2.0)))
+    return max(2, 2 * round(order / 2.0))
 
 
 PROTECTIVE_ALIGNMENT = Alignment.BUTTERWORTH

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/designer.py

@@ -77,7 +77,7 @@ logger = logging.getLogger(__name__)
 CONTRACT_VERSION = "1.6"
 """The version this module implements. Responses echo the request's own version instead."""
 
-DESIGN_VERSION = 9
+DESIGN_VERSION = 10
 """Which answer this code gives (1.4): bumped by any change that can alter `candidates`,
 `rejected`, a decline or a 1.3 fit figure for an unchanged request and unchanged settings.
 
@@ -105,7 +105,9 @@ the first the judge passes, fewest sections first, instead of whichever the arit
 domain (TODO 23), which re-rolls the fit among near-equal optima as any change to its
 arithmetic does. 0.3.2 is 9: it stops bass EQ at a 60 Hz ceiling: no target asks for lift
 above it, the judged band's top is capped there, and a cascade may add no more than the level
-tolerance beyond it (TODO 39). `plans/design-version.md` has each one's build."""
+tolerance beyond it (TODO 39). 10 breaks a flatness tie between candidates by the strategy's
+place in `STRATEGIES`, not by section count (TODO 32). `plans/design-version.md` has each one's
+build."""
 
 Coverage = Literal["complete_programme", "excerpt"]
 ChannelScope = Literal["all_channels", "lfe_only", "mixed"]
@@ -966,14 +968,14 @@ def _validate_candidate(
     for i, spec in enumerate(candidate.filters):
         _validate_biquad_spec(spec, i, index, where)
     _validate_fit(candidate, f"{where}[{index}]")
-    if candidate.commentary is not None:
-        if not isinstance(candidate.commentary, dict) or not all(
+    if candidate.commentary is not None and (
+        not isinstance(candidate.commentary, dict)
+        or not all(
             isinstance(k, str) and isinstance(v, str)
             for k, v in candidate.commentary.items()
-        ):
-            raise ContractViolation(
-                f"{where}[{index}].commentary must be a dict[str, str]"
-            )
+        )
+    ):
+        raise ContractViolation(f"{where}[{index}].commentary must be a dict[str, str]")
 
 
 def _validate_fit(candidate: DesignCandidate, prefix: str) -> None:

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/explain.py

@@ -150,8 +150,10 @@ def correction(candidate: Candidate, report: Report | None = None) -> str:
         for f in candidate.filters
     )
     parts = [
-        f"{candidate.label}: {len(candidate.filters)} section(s) — {sections}; "
-        f"peak boost {candidate.mv_adjust_db:+.1f} dB"
+        (
+            f"{candidate.label}: {len(candidate.filters)} section(s) — {sections}; "
+            f"peak boost {candidate.mv_adjust_db:+.1f} dB"
+        )
     ]
     recovered = candidate.verdict.recovered_fraction
     if math.isfinite(recovered):

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/extraction.py

@@ -168,8 +168,15 @@ def _block_bootstrap_se(
     their own isolated instant (wide) — a flat constant cannot see that difference.
 
     Vectorised across every bin in `bins` at once: the resampled *frame indices* are the same
-    for every bin in a given replicate, so one `(n_boot, n_frames)` index matrix drives one
-    gather and one `percentile` call rather than one per bin.
+    for every bin in a given replicate, so one `(n_boot, n_frames)` index matrix serves every
+    bin.
+
+    A replicate is a multiset of the masked frames, so its percentile needs only how often
+    each frame was drawn and the frames in order of value (`_bootstrap_percentiles`), not the
+    resampled values gathered and partitioned per replicate. That was 90% of `extract`, and
+    the LFE of a two-hour title (12 s) set a cold run's wall time; this takes about a sixth of
+    it and returns the same bits, which `tests/test_design_extraction.py` pins against the
+    gather.
     """
     runs = _runs(mask)
     if len(runs) < 2 or n_boot < 2:
@@ -195,21 +202,90 @@ def _block_bootstrap_se(
                 if filled >= n_frames:
                     break
             batch *= 2
-    # Chunked over bins, because the gather below is the one large allocation here and it is
-    # proportional to bins x replicates x frames: every bin of a two-hour title at 200
-    # replicates is some 400 MB in one array. The arithmetic is identical either way — the
-    # replicate indices are shared across bins by construction — so this only bounds peak
-    # memory, and it is what lets the caller price every bin rather than a band of them.
+    percentiles = _bootstrap_percentiles(power, bins, mask, replicate_idx, percentile)
+    # C order, so `std` sums each bin's replicates in the order the gather's result did
+    percentiles_db = 10.0 * np.log10(np.ascontiguousarray(percentiles) + 1e-300)
+    return np.std(percentiles_db, axis=1)
+
+
+_TOP_SHARE = 4.0
+"""How far down the values a replicate's percentile is sought, in multiples of its rank.
+
+The 95th percentile of `n` frames is about the `0.05 n`-th largest, and a replicate draws each
+frame about once, so the frames ranked within four times that hold it in all but freak draws.
+A bin where some replicate needs more is sorted in full, so this sets only the speed."""
+
+
+def _bootstrap_percentiles(
+    power: np.ndarray,
+    bins: np.ndarray,
+    mask: np.ndarray,
+    replicate_idx: np.ndarray,
+    percentile: float,
+) -> np.ndarray:
+    """Each replicate's `percentile` of each bin's power, `(bins, replicates)`.
+
+    `np.percentile`'s linear method over each replicate, without forming the replicate: the
+    order statistics it interpolates are read off the masked frames in descending order of
+    value, by how many draws each one carries, and interpolated as `np.percentile` does it
+    (`numpy.lib._function_base_impl._lerp`). The same values, the same arithmetic, so the same
+    bits. Non-finite power, which `np.percentile` treats its own way, takes the gather.
+
+    Chunked over bins to bound memory (`_BOOTSTRAP_ELEMENTS`): the counts gathered in sorted
+    order are replicates x bins x the frames searched.
+    """
+    n_boot, n_frames = replicate_idx.shape
+    frames = np.flatnonzero(mask)
+    position = np.zeros(mask.shape[0], dtype=np.int64)
+    position[frames] = np.arange(n_frames)
+    counts = np.zeros((n_boot, n_frames), dtype=np.int64)
+    np.add.at(counts, (np.arange(n_boot)[:, None], position[replicate_idx]), 1)
+    virtual = (n_frames - 1) * (percentile / 100.0)
+    lower = math.floor(virtual)
+    upper = n_frames - 1 if virtual >= n_frames - 1 else lower + 1
+    lower = min(lower, upper)
+    gamma = virtual - lower
+    # descending, the ascending order statistic j is where the draws passed exceed n - 1 - j
+    need_lower, need_upper = n_frames - 1 - lower, n_frames - 1 - upper
+    searched = min(n_frames, math.ceil(_TOP_SHARE * (need_lower + 1)) + 16)
+    chunk = max(1, _BOOTSTRAP_ELEMENTS // max(n_boot * searched, 1))
+    out = np.empty((bins.shape[0], n_boot))
+    for start in range(0, bins.shape[0], chunk):
+        taken = bins[start : start + chunk]
+        values = power[taken][:, frames]
+        order = np.argsort(-values, axis=1, kind="stable")[:, :searched]
+        passed = np.cumsum(counts[:, order], axis=2)
+        if not np.isfinite(values).all() or not (passed[:, :, -1] > need_lower).all():
+            out[start : start + taken.size] = _gathered_percentiles(
+                power, taken, replicate_idx, percentile
+            )
+            continue
+        top = np.take_along_axis(values, order, axis=1)
+        low = np.take_along_axis(top, (passed > need_lower).argmax(axis=2).T, axis=1)
+        high = np.take_along_axis(top, (passed > need_upper).argmax(axis=2).T, axis=1)
+        diff = high - low
+        out[start : start + taken.size] = (
+            high - diff * (1 - gamma) if gamma >= 0.5 else low + diff * gamma
+        )
+    return out
+
+
+def _gathered_percentiles(
+    power: np.ndarray, bins: np.ndarray, replicate_idx: np.ndarray, percentile: float
+) -> np.ndarray:
+    """`_bootstrap_percentiles` the direct way: gather every replicate, `np.percentile` it.
+
+    Chunked over bins, because the gather is proportional to bins x replicates x frames:
+    every bin of a two-hour title at 200 replicates is some 400 MB in one array.
+    """
+    n_boot, n_frames = replicate_idx.shape
     flat_idx = replicate_idx.reshape(-1)
     chunk = max(1, _BOOTSTRAP_ELEMENTS // max(n_boot * n_frames, 1))
-    out = np.empty(bins.shape[0])
+    out = np.empty((bins.shape[0], n_boot))
     for start in range(0, bins.shape[0], chunk):
         taken = bins[start : start + chunk]
         resampled = power[taken][:, flat_idx].reshape(taken.size, n_boot, n_frames)
-        percentiles_db = 10.0 * np.log10(
-            np.percentile(resampled, percentile, axis=2) + 1e-300
-        )
-        out[start : start + chunk] = np.std(percentiles_db, axis=1)
+        out[start : start + taken.size] = np.percentile(resampled, percentile, axis=2)
     return out
 
 

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/filters.py

@@ -860,7 +860,7 @@ def _escalate(
         pending = [state for state in states if state.answer is None]
         if not pending:
             break
-        tasks: list["FitTask"] = []
+        tasks: list[FitTask] = []
         owners: list[tuple[_Escalation, int]] = []
         for sections in group:
             for state in pending:

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/harness.py

@@ -20,8 +20,8 @@ from dataclasses import dataclass
 import numpy as np
 from scipy import signal
 
-from beqforge.biquad import PeakingEQ
 from beqforge import Alignment, HighPass
+from beqforge.biquad import PeakingEQ
 from beqforge.filters import high_pass_sos
 
 logger = logging.getLogger(__name__)
@@ -97,13 +97,13 @@ def synthesise(profile: SyntheticProfile, fs: float, seed: int = 0) -> np.ndarra
     can be reproduced from its profile and seed alone.
     """
     rng = np.random.default_rng(seed)
-    n = int(round(profile.duration_s * fs))
+    n = round(profile.duration_s * fs)
     out = rng.standard_normal(n) * 10.0 ** (profile.floor_db / 20.0)
 
-    count = max(1, int(round(profile.duration_s * profile.event_rate_hz)))
+    count = max(1, round(profile.duration_s * profile.event_rate_hz))
     starts = rng.integers(0, n, size=count)
     levels = 10.0 ** (-rng.uniform(0.0, profile.event_level_spread_db, count) / 20.0)
-    decay_len = int(round(profile.event_decay_s * 6.0 * fs))
+    decay_len = round(profile.event_decay_s * 6.0 * fs)
     envelope = np.exp(-np.arange(decay_len) / (profile.event_decay_s * fs))
     nyquist = fs / 2.0
     for start, level in zip(starts, levels, strict=True):

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/impact.py

@@ -284,6 +284,8 @@ FEATURES: tuple[Feature, ...] = (
             "pipeline:counterfactual_targets",
             "pipeline:_Restoration*",
             "pipeline:_restoration_mix",
+            "pipeline:_restoration_boosts",
+            "pipeline:_restored_target",
             "pipeline:PipelineParams.restore_caps_db",
         ),
         _strategy("counterfactual"),
@@ -557,6 +559,7 @@ FEATURES: tuple[Feature, ...] = (
         (
             "pipeline:run",
             "pipeline:Report*",
+            "pipeline:_strategy_rank",
             "pipeline:Candidate*",
             "pipeline:TargetFit*",
             "pipeline:target_fit",

{beqforge-0.3.3 → beqforge-0.3.4}/beqforge/impact.toml

@@ -163,3 +163,71 @@ basis_below = { no_fit = [0, 10], declined_after_fit = [3, 12], designed_with_fa
 feature = "judge.assess"
 kind = "unchanged"
 note = "the over-lift failure names the bass ceiling when its worst bin lies above it; wording only"
+
+[[change]]
+id = "tie-by-strategy"
+design_version = 10
+summary = "a flatness tie between passing candidates goes to the strategy listed first in `STRATEGIES`, not to the fewest sections, whose count a near-equal fit re-rolls with the arithmetic (TODO 32)"
+evidence = "plans/library-review-improvements.md#a-stable-tie-break-2-november-2026-design_version-10"
+
+[[change.touches]]
+feature = "selection"
+kind = "behaviour"
+# Measured on the whole v8 library, not a sample, moved by `impact.MOVED` (another strategy
+# wins, or another counterfactual cap): each record's candidates re-selected under both rules
+# from their recorded verdicts and corrected curves. The old rule reproduces 1,068 of the 1,069
+# recorded winners; the other is an exact tie (flatten and parametric 0.9355 dB, two sections
+# each) that the new rule moves, counted here. A record with no passing candidate has no
+# winner to move.
+basis = { no_fit = [0, 20], declined_after_fit = [0, 16], designed_with_failures = [10, 271], designed_all_passed = [70, 762] }
+
+[[change]]
+id = "designer-latency"
+design_version = 10
+summary = "the designer computes what a run reuses once: the sub feed, the unfiltered spectra, each candidate's filtered waveform and device transfer, each channel's flat deficit and restored boosts, and the bootstrap percentiles off draw counts; no answer moves (TODO 23)"
+evidence = "plans/designer-latency.md#validation-per-commit"
+
+[[change.touches]]
+feature = "analysis.blockers"
+kind = "unchanged"
+note = "`analyse` measures the mix's flat deficit once and `channels_missing_low_end` each channel's once; probe unchanged at --tol 0"
+
+[[change.touches]]
+feature = "analysis.extraction"
+kind = "unchanged"
+note = "bootstrap percentiles read off draw counts are bit-identical to the gathered ones; probe recomputing every analysis unchanged at --tol 0"
+
+[[change.touches]]
+feature = "fit.input"
+kind = "unchanged"
+note = "the over-lift allowance takes the run's sub feed and unfiltered spectra instead of rebuilding them; probe unchanged at --tol 0"
+
+[[change.touches]]
+feature = "judge.headroom"
+kind = "unchanged"
+note = "the headroom peak is interpolated in one-second blocks from the waveform verify filtered; real-run records identical, headroom peaks included"
+
+[[change.touches]]
+feature = "judge.verification"
+kind = "unchanged"
+note = "verify takes the run's sub feed, unfiltered spectra and one device transfer a candidate; probe unchanged at --tol 0, real-run records identical"
+
+[[change.touches]]
+feature = "targets.counterfactual"
+kind = "unchanged"
+note = "each distinct set of channel boosts is restored once across the caps, each channel's flat deficit measured once; probe unchanged at --tol 0"
+
+[[change.touches]]
+feature = "targets.flatten"
+kind = "unchanged"
+note = "the mix's flat deficit is measured once for the strategies; probe unchanged at --tol 0"
+
+[[change.touches]]
+feature = "targets.parametric"
+kind = "unchanged"
+note = "the mix's flat deficit is measured once for the strategies; probe unchanged at --tol 0"
+
+[[change.touches]]
+feature = "targets.shared"
+kind = "unchanged"
+note = "`propose`, the judged band and the passband ripple take the flat deficit measured once; probe unchanged at --tol 0"