BFM-decomp/docs/family-hseq.md

# Phase 26 — h_seq family survey (T1)

> **Glossary — `zero-crack` in THIS file means `n_matched == 0`: the family has no matched member anywhere and needs its FIRST crack.** (Roadmap §3 T3 uses the phrase for the OPPOSITE case — an already-matched exemplar awaiting propagation.)
>

> Generated by `tools/family_hseq.py` from the 212 binary sigs + per-binary src stubs. Ranked by TEMPLATABLE byte-weight (PURE+IMM members × nins × 4). The byte-gate is the arbiter.
>
> **Scope (212 binaries): 141 location overlays + 70 md_* modules + the resident · MAIN IS EXCLUDED** · generated at HEAD `commit:3070` · stub set derived from `corpus.stubs` — the same oracle `progress.py` counts, so same-tree overlay totals agree by construction; compare digests only at the same HEAD.

**Fleet (overlays):** 99.3% fn / 98.7% instr / 97.4% distinct-code matched. Unmatched: 2,369 instances / 169,327 ins (1,921 distinct classes).

**Tail cross-check (Phase-25 close):** 1,663 tail fns / 129,070 ins → 58 h_seq families ≥2, **23 substantial (nins≥80) / 12,833 ins**.

**Full frontier (all unmatched by h_seq):** 666 target families (≥2 members or a matched sibling) + 1126 singletons (Step-D residue). Substantial: **104 families / 36,965 templatable ins**, 62 with a matched sibling (zero-crack). Substantial member classes: 219 PURE · 9 IMM · 2 STRUCT-excluded.


## Top substantial families (by templatable byte-weight)

| # | nins | members (P/I/S) | #addr/#ov | tag | class | matched | jr | exemplar | templ. ins |
|--:|--:|--|--|--|--|--:|:-:|--|--:|
| 1 | 246 | 16 (16/0/0) | 6/16 | cross-address | PURE | 0 | · | 0x8017c294 draft-ov077 | 3,936 |
| 2 | 770 | 3 (3/0/0) | 1/3 | per-location | PURE | 138 | · | 0x80144b9c matched-ov077 | 2,310 |
| 3 | 407 | 4 (4/0/0) | 4/4 | cross-address | PURE | 1 | Y | 0x8017c3bc matched | 1,628 |
| 4 | 279 | 5 (5/0/0) | 4/5 | cross-address | PURE | 0 | Y | 0x8017f2d4 modal | 1,395 |
| 5 | 326 | 4 (4/0/0) | 4/4 | cross-address | PURE | 1 | Y | 0x8017d730 matched | 1,304 |
| 6 | 291 | 4 (4/0/0) | 4/4 | cross-address | PURE | 1 | Y | 0x8017d2a4 matched | 1,164 |
| 7 | 187 | 6 (6/0/0) | 1/6 | per-location | PURE | 135 | · | 0x8013dd68 matched-ov077 | 1,122 |
| 8 | 363 | 3 (3/0/0) | 1/3 | per-location | PURE | 138 | Y | 0x8015444c matched-ov077 | 1,089 |
| 9 | 188 | 5 (5/0/0) | 1/5 | per-location | PURE | 136 | Y | 0x8016ab6c matched-ov077 | 940 |
| 10 | 218 | 4 (4/0/0) | 4/4 | cross-address | PURE | 1 | Y | 0x8017cf3c matched | 872 |
| 11 | 127 | 6 (6/0/0) | 1/6 | per-location | PURE | 135 | · | 0x80145cec matched-ov077 | 762 |
| 12 | 551 | 1 (1/0/0) | 1/1 | per-location | PURE | 4 | Y | 0x8018c000 matched | 551 |
| 13 | 91 | 6 (6/0/0) | 6/6 | cross-address | PURE | 0 | · | 0x80189e60 modal | 546 |
| 14 | 266 | 2 (2/0/0) | 1/2 | per-location | PURE | 139 | · | 0x80130d48 matched-ov077 | 532 |
| 15 | 94 | 5 (5/0/0) | 5/5 | cross-address | PURE | 1 | · | 0x80185f6c matched | 470 |
| 16 | 111 | 4 (4/0/0) | 4/4 | cross-address | PURE | 0 | · | 0x801832f8 modal | 444 |
| 17 | 108 | 4 (4/0/0) | 4/4 | cross-address | PURE | 1 | Y | 0x8017ca18 matched | 432 |
| 18 | 209 | 2 (2/0/0) | 2/2 | cross-address | PURE | 0 | Y | 0x801810c8 modal | 418 |
| 19 | 101 | 4 (4/0/0) | 4/4 | cross-address | PURE | 2 | · | 0x8017f278 matched | 404 |
| 20 | 201 | 2 (2/0/0) | 1/2 | per-location | PURE | 1 | Y | 0x80181be4 matched-ov077 | 402 |
| 21 | 397 | 1 (1/0/0) | 1/1 | per-location | PURE | 2 | · | 0x8018f060 matched | 397 |
| 22 | 197 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | · | 0x80184a08 modal | 394 |
| 23 | 196 | 2 (2/0/0) | 2/2 | cross-address | PURE | 2 | Y | 0x8017ffd0 matched | 392 |
| 24 | 96 | 4 (4/0/0) | 4/4 | cross-address | PURE | 0 | · | 0x8017fd64 modal | 384 |
| 25 | 187 | 2 (1/1/0) | 2/1 | cross-address | IMM | 0 | · | 0x80183da4 modal | 374 |
| 26 | 177 | 2 (2/0/0) | 2/2 | cross-address | PURE | 0 | · | 0x80185ba4 draft-ov077 | 354 |
| 27 | 87 | 4 (4/0/0) | 4/4 | cross-address | PURE | 0 | · | 0x8017f068 modal | 348 |
| 28 | 116 | 3 (3/0/0) | 1/3 | per-location | PURE | 0 | · | 0x8017c234 modal | 348 |
| 29 | 87 | 4 (4/0/0) | 4/4 | cross-address | PURE | 0 | · | 0x80183a88 modal | 348 |
| 30 | 109 | 3 (3/0/0) | 3/3 | cross-address | PURE | 0 | · | 0x8017de58 modal | 327 |
| 31 | 106 | 3 (2/1/0) | 3/3 | cross-address | IMM | 0 | · | 0x8017e4e4 modal | 318 |
| 32 | 158 | 2 (2/0/0) | 1/2 | per-location | PURE | 1 | · | 0x80182a24 matched-ov077 | 316 |
| 33 | 158 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | Y | 0x80187b40 modal | 316 |
| 34 | 154 | 2 (2/0/0) | 2/2 | cross-address | PURE | 0 | · | 0x8017ec34 modal | 308 |
| 35 | 153 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | · | 0x80184f18 modal | 306 |
| 36 | 99 | 3 (3/0/0) | 3/3 | cross-address | PURE | 0 | · | 0x80184560 modal | 297 |
| 37 | 148 | 2 (2/0/0) | 1/2 | per-location | PURE | 139 | · | 0x8016d1d8 matched-ov077 | 296 |
| 38 | 135 | 2 (2/0/0) | 2/2 | cross-address | PURE | 0 | · | 0x801808e8 modal | 270 |
| 39 | 265 | 1 (0/1/0) | 1/1 | per-location | IMM | 6 | · | 0x80183e04 matched | 265 |
| 40 | 132 | 2 (2/0/0) | 2/2 | cross-address | PURE | 0 | · | 0x80185e68 draft-ov077 | 264 |
| 41 | 132 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | · | 0x80187a98 modal | 264 |
| 42 | 128 | 2 (1/1/0) | 2/1 | cross-address | IMM | 0 | · | 0x800cdba8 modal | 256 |
| 43 | 124 | 2 (2/0/0) | 2/2 | cross-address | PURE | 0 | · | 0x8017f4dc modal | 248 |
| 44 | 122 | 2 (2/0/0) | 1/2 | per-location | PURE | 139 | Y | 0x801588cc matched-ov077 | 244 |
| 45 | 119 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | · | 0x80183310 modal | 238 |
| 46 | 117 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | · | 0x8017f9f8 modal | 234 |
| 47 | 117 | 2 (2/0/0) | 1/2 | per-location | PURE | 1 | Y | 0x80181f08 matched-ov077 | 234 |
| 48 | 117 | 2 (1/1/0) | 2/2 | cross-address | IMM | 0 | · | 0x800caf90 modal | 234 |
| 49 | 110 | 2 (2/0/0) | 1/2 | per-location | PURE | 0 | · | 0x80187988 modal | 220 |
| 50 | 108 | 2 (2/0/0) | 2/2 | cross-address | PURE | 4 | Y | 0x8017e30c matched | 216 |