| name | finish |
| description | Turn a benchmark turn-log (or an already-analyzed run dir) into a report the GUI shows right away — runs analyze + plot so summary.json + report.csv AND charts/tokens_saved.svg + charts/tokens_saved.bg.svg all exist. The bare .bg.svg is the share-card PNG background; without it the downloaded/posted card has no chart lines. Also backfills old runs (--all) that predate the .bg.svg output. Use after a manual analyze, or to repair runs whose share PNG renders as a solid card. Pass --card to also bake the share-card PNG to disk (opt-in, best-effort). |
clawback finish-run (report generation for the GUI)
Run .skills/finish/scripts/finish_run.sh from the project root. It produces the exact files
the report server serves for a run, so the run appears complete in the GUI with
a share PNG that actually carries the chart.
A run is GUI-complete when its directory under the report root (config.reportDir,
default ./runs) holds:
summary.json + report.csv — analyzer output (the hero figures + CSV).charts/tokens_saved.svg — the labeled on-screen chart.charts/tokens_saved.bg.svg — the BARE share-card background. The report
GUI inlines this behind the scrim to make the downloadable / shareable PNG.
Missing it ⇒ the PNG is a solid card with no chart lines.
run_paired.sh and ab_block.sh already run analyze + plot at the end of a
complete (both-arm) run, so a normal benchmark is finished automatically. Reach
for this skill for a manual analyze, a single-step re-plot, or a backfill.
Usage
.skills/finish/scripts/finish_run.sh runs/my-run runs/A0.ndjson runs/A5.ndjson
.skills/finish/scripts/finish_run.sh runs/my-run
.skills/finish/scripts/finish_run.sh --all
.skills/finish/scripts/finish_run.sh --all --root runs
.skills/finish/scripts/finish_run.sh runs/my-run --card
.skills/finish/scripts/finish_run.sh --all --card
Backfill is safe and idempotent
Re-plot is a pure function of summary.json + report.csv: it never
re-spends tokens, never re-reads turn-logs, and --all skips any run that
already has charts/tokens_saved.bg.svg. So running --all repeatedly only
fills the gaps and is byte-identical for runs already complete.
Bake the social share card (--card, opt-in)
By default finish_run.sh stops at the SVGs. The share PNG is rendered on
demand, client-side, when someone hits Download/Share in the report GUI —
so the pipeline never hard-depends on a headless browser, and the browser is
the faithful renderer. Pass --card to also bake charts/share_card.{svg,png}
to disk right now, for posting a card without opening the GUI:
.skills/finish/scripts/finish_run.sh runs/my-run --card
.skills/finish/scripts/finish_run.sh --all --card
--card delegates to .skills/scripts/preview_card.sh, which walks a best-effort
raster ladder — headless Chrome (faithful 1200×630) → macOS sips (degraded:
drops the text blur, so the headline is bedded on a scrim) → SVG-only no-op when
neither is present. A missing rasterizer leaves share_card.svg and skips the
PNG; it never fails the run. The --all --card backfill skips runs that already
have share_card.png, staying as cheap and idempotent as the re-plot backfill.
The same --card flag is on run_paired.sh and ab_block.sh, baking the card
at the tail of a full both-arm run.
When a run can't be finished
--all skips (with a note, without aborting) any directory lacking
summary.json + report.csv — e.g. an aborted run, or one whose analyzer
output was never written. Analyze it first (supply its turn-logs as extra
arguments) and the plot step follows automatically.
