# 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.