repo-scripts git:20261003.cf79a39A

Immutable. This exact content never changes and is served at /api/v1/blob/cbc32f1c6e4903c0.

---
name: repo-scripts
description: Use BEFORE writing an inline shell or bun one-off for any of these: running the build/test loop (typecheck, clean dist, bun test), finding the next free roadmap id or setting a roadmap row's status, checking coord status (pause, questions, stale, doing, checkpoints, Cronus leases), summarising or diffing two LethAL SessionReport JSON files, or querying a lethal.sqlite results store. A tested script already does it.
---

# Repo scripts

Each is a small tested script under `scripts/`. Use it instead of re-writing the flow by hand.
Run from the repo root. Every one exits non-zero on failure and never prints an empty result as success.

| Script | Signature | When |
|---|---|---|
| `verify.ts` | `bun scripts/verify.ts [pkg...]` | The CLAUDE.md build/test loop: typecheck, delete `packages/*/dist`, `bun test` (all, or `packages/<pkg>`). Prints counts and failing test names; full output goes to a log file it names. |
| `roadmap-next-id.ts` | `bun scripts/roadmap-next-id.ts` | Before filing a roadmap row. Max id over the working tree, every local and remote branch, and every worktree, plus one. Run it right before writing the file. |
| `roadmap-set.ts` | `bun scripts/roadmap-set.ts R<n> --status "<text>"` | Closing or updating a row. Rewrites only the `status:` line (escaped), refuses `pending`, regenerates `ROADMAP.md`. |
| `coord.sh` | `bash scripts/coord.sh <command> [args...]` | Any coord CLI call. In a kraken container (`KRAKEN_PROJECT` set) it runs `kraken coord` on the inherited `CG_COORD_ROOT` (`/coord`), and refuses (exit 2, naming both) a `LETHAL_COORD_ROOT` that differs from it; `coord-status.ts` refuses the same. On the host it uses `H:\lethal-coord`, IGNORING an inherited `CG_COORD_ROOT` (the machine-wide one can point at CentralGauge's root; override with `LETHAL_COORD_ROOT`), and exits 3 if that root has a `MOVED-TO-KRAKEN` marker. |
| `coord-status.ts` | `bun scripts/coord-status.ts` | One view: pause state, open questions, stale list, Doing tasks with their latest checkpoint, lease holders of the leased containers (Cronus28 and Cronus284 on the host, the project's `allocation.json` list in kraken). |
| `coord-manifest.ts` | `bun scripts/coord-manifest.ts <root>` | JSON `{ files: [{ path, size, sha256 }] }` for a coord root (sorted, relative `/` paths, no contents), to compare a copy against its source. |
| `report-summary.ts` | `bun scripts/report-summary.ts <report.json>` | Totals by verdict and by operator, plus `groupedCalls` / `warmKills`, for a `lethal run --out` report. |
| `report-diff.ts` | `bun scripts/report-diff.ts <a.json> <b.json>` | Per-mutant diff by the live gates' own compare (`diffMutants`, `packages/runner/itest/mutant-equality.ts`: `keyOf` key, multiset per key, so twins are fine). Exit 0 IDENTICAL, 1 DIFFERENT, 2 refused (zero mutants on both sides). |
| `store-query.ts` | `bun scripts/store-query.ts <lethal.sqlite> [--run latest\|<id>] verdicts\|runs\|tests` | Read-only look at a results store. "latest" is the highest FINISHED run id; a newer unfinished run is named on stderr. |