zapgun-ai 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
# Analyze fresh turn-logs into a run dir, then plot both SVGs:
.skills/finish/scripts/finish_run.sh runs/my-run runs/A0.ndjson runs/A5.ndjson
# Re-plot a run that already has summary.json + report.csv (adds .bg.svg):
.skills/finish/scripts/finish_run.sh runs/my-run
# Backfill EVERY run under the root that's missing its bare background:
.skills/finish/scripts/finish_run.sh --all
.skills/finish/scripts/finish_run.sh --all --root runs
# Also bake the social share card to disk (opt-in; PNG is best-effort):
.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 # one run
.skills/finish/scripts/finish_run.sh --all --card # every run missing a PNG
--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.