Surfaces the GEPA (genetic-evolution prompt-adaptation) library exports
from @metaharness/darwin/gepa. Unlike the other skills in this plugin
there is no CLI binary behind this — the script dynamic-imports the library
(local resolution first, versioned cache install as fallback) and calls the
subprocess-safe subset.
--op render shows the actual systemprompt a genome compiles to — read THAT, not the raw JSON, before
wiring a genome into a harness.
--op genome loads + validates the shippedcand-6 genome (first holdout-confirmed cheap-tier promotion; provenance
ships in the package) or any genome file you point at.
--op validate --alert-on-invalid exits 1on structural errors.
--op analyze --transcript run.json classifiesfailure modes (GEPA's failure-class taxonomy) from a transcript array.
gepaOptimize — the optimization loop takes an in-processevaluate(candidate) callback ("bring your own evaluator") that cannot
cross a subprocess boundary. Two supported paths instead:
import { gepaOptimize, loadCand6Genome } from '@metaharness/darwin/gepa'harness-evolve (darwin CLI evolve),which pairs GEPA with its own sandbox evaluators.
Implementation: scripts/gepa.mjs.
import('@metaharness/darwin/gepa'); on MODULENOTFOUND fall back to aone-time npm install --prefix ~/.ruflo/darwin-cache-<pin> and import
the cached dist/gepa/index.js (versioned dir → pin bumps invalidate).
--op:genome → loadGenome(fs, path) or loadCand6Genome() + validateGenomevalidate → validateGenome(rawJson) (raw parse so broken files reachthe validator instead of throwing in the loader)
render → buildSystemFromGenome(genome, ext?, glob?)analyze → analyzeTranscript(entries)--alert-on-invalid, 2 on bad input).node scripts/gepa.mjs --op genome # cand-6 + validation
node scripts/gepa.mjs --op render | jq -r .system # what does cand-6 SAY?
node scripts/gepa.mjs --op validate --path my-genome.json --alert-on-invalid
node scripts/gepa.mjs --op analyze --transcript run.json
0 — op completed (or degraded — darwin not installable)1 — --alert-on-invalid and validation found errors2 — config error (unknown op, missing/broken input file)