dangernoodle-io / TaipanMiner / 26543051943

90%

push

github

feat(mining): hot-loop cache-isolation guards (doc rule + runtime eff%) (#436)

Adds two protective mechanisms against future recurrences of the
hot-loop cache regression fixed in PR #435 (TA-392):

1. CLAUDE.md convention: any per-nonce data read by mine_nonce_range
   MUST be `static __attribute__((aligned(32)))`. Reviewers can enforce.
   Explains the mechanism (stack-base shifts with BSS growth cause
   D-cache aliasing on hot reads) and points at the historical example.

2. Runtime efficiency log: every Tier-2 yield now emits `eff: NN.N%`
   alongside the hashrate, computed as actual / sha_khs_ceiling.
   Per-board healthy range:
     - tdongle-s3 (S3 + AHB SHA):    99-101% of ceiling
     - esp32-wroom32 (DPORT):        65-70% of ceiling (early-reject mix)
   Sustained drops vs the board's historical steady state are the
   tripwire for cache/contention regressions. CI or operators can grep
   for the value; no false-positive-prone threshold gating.

verified on tdongle-s3 .78 (post-#435):
  hw: 307.8 kH/s | shares: 0 | eff: 101.2%

454 host tests pass. All 5 boards build.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

2549 of 3217 branches covered (79.24%)

Branch coverage included in aggregate %.

5158 of 5332 relevant lines covered (96.74%)

154876.86 hits per line