ship

1# Ship
2 
3Turn a finished evo run into a change a maintainer would merge.
4 
5The optimize loop leaves a tree of committed experiments. The winning worktree
6diff is not mergeable as-is: it carries debug prints, search-process churn,
7over-broad edits, and sometimes a test that was relaxed to clear a gate. Shipping
8is the step that re-derives the *minimal clean change* reproducing the winning
9behaviour, lands it the way the repo expects (PR or merge), and reports how
10mergeable it is.
11 
12Correctness is the floor, not the goal. The score says the behaviour works; this
13skill decides whether the *diff* is fit to merge.
14 
15## Invocation
16 
17```bash
18/evo:ship            # ship the auto-selected winner
19/evo:ship exp_0042   # ship a specific experiment instead
20```
21 
22## Stage 1 -- Select the winner
23 
24Pick the experiment to ship, then confirm it with the user before touching their
25tree.
26 
27```bash
28evo status    # current best valid score + counts
29evo report    # top valid experiments table + score chart
30```
31 
32- The default winner is the highest-scoring valid result in the graph history,
33  not the frontier. `evo frontier` is for choosing where to branch next; it can
34  exclude an exhausted branch whose score is still the right thing to ship. An
35  explicit `exp_id` argument overrides auto-selection.
36- A shippable winner must be valid: `committed`, or `pruned` with
37  `prune_kind=exhausted`, with a commit and score, no `gate_result === false`,
38…