Files
BFM-decomp/tools/wave/README.md
T
Drew T dcba5d0f4f feat(phase-30 S49): the micro-adapt lane — adapt cards + adapt_wave.js (wave 7a)
- family_cousins.py --adapt-cards: per seeded-unit member, drift classified vs the seed
  (LI-ONLY 27 / SMALL-EDIT 491 / MIXED 310 excluded); cards carry the seed C location + the
  aligned diff blocks with the member's raw words + disasm (the new constant is readable in
  the card). 518 cards / 1,101 instances / 23,820 ins; 514 haiku-band.
- tools/wave/adapt_wave.js: the EDIT-contract wave (crack_wave contracts preserved: per-agent
  dirs, sha1-last, UNVERIFIED != refuted); symbol surface from the TARGET .s; haiku<=60/sonnet.
- regen chain absorbed the 48 lane-A banks (A-prop open ins -6,475 == the report's instr
  delta exactly — two independent derivations agree); pilot slate .run/wave7a_pilot.json (30).
- R37: pilot before scaling to the 518-card pool.
2026-08-12 22:03:04 -06:00

36 lines
2.5 KiB
Markdown

# tools/wave — the crack-wave harness (P30 S48)
`crack_wave.js` is the CURRENT wave script, kept in the repo because it encodes contracts that were
paid for in real failures. Invoke with `Workflow({scriptPath: "tools/wave/crack_wave.js", args:[…]})`
where each arg is `{name, binary, sub, nins, reach, jr, model, prior}`.
**Contracts it encodes — do not drop these when editing:**
* **Per-agent output dir** `.run/waveN/<fn>/`, and "never delete or modify anything outside your own
directory, do not clean up". Wave 2 shared one directory and later agents deleted earlier agents'
drafts: 21 adversarially-VERIFIED cracks vanished. (They were all recovered from the run
transcripts by `tools/recover_drafts.py` — but only because the transcript is the backup.)
* **The verifier re-runs `sha1sum` LAST**, after the gate, and reports it separately, so a draft that
vanishes mid-run is DETECTED rather than trusted.
* **Prior-notes seeding.** A target that previously failed is re-run WITH ITS PREDECESSOR'S MEASURED
RESIDUAL (`.run/jr48/prior_notes.json`). Measured 7/9 (wave 3) and 10/12 (wave 4). NEAR is a cheap
RESUMABLE state, not a write-off.
* **The cookbook citation list must name every banked block** (§160-§164 today). Idioms are harvested
after every wave precisely so the NEXT wave's agents start with them; a stale citation list silently
wastes that.
* **Size-routing** haiku ≤30 ins / sonnet ≤120 / opus above. Wave 2 (20 of 28 Sonnet) beat the
all-Opus wave 1 on bank rate.
**Bank rate to date:** 67% → 79% → 69% → 68% of cracks survive the whole-binary gate.
## adapt_wave.js — the micro-adapt lane (P30 S49)
Cheap-tier companion to `crack_wave.js` for the COUSIN tier (cookbook §168): members that differ
from an already-matched body by ≤3 blocks / ≤6 tokens (`family_cousins.py --adapt-cards` →
`.run/adapt_cards.json`). The prompt is an EDIT contract, not a crack: copy the seed body, take the
symbol surface from the TARGET .s, apply the minimal semantic edit the measured diff implies
(usually a constant whose value is readable in the card's member words), iterate under match_one.
Same paid-for contracts as crack_wave: per-agent dirs, sha1-last verify, UNVERIFIED ≠ refuted,
never touch outside your own dir. Routing: haiku ≤60 ins / sonnet above (the edit is small even
when the body is not). Invoke: `Workflow({scriptPath:"tools/wave/adapt_wave.js",
args:[{wave:"wave7a"}, ...cards]})`. Pilot-first (R37): ~30 cards, measure the bank rate, then batch.