技能 人工智能 GEPA基因组审计

GEPA基因组审计

v20260927
harness-gepa
通过@metaharness/darwin/gepa库检查和审计GEPA基因组。支持加载、验证基因组,渲染系统提示,以及分析运行记录中的失败模式。适用于采用进化策略、CI门禁和调试进化运行。
获取技能
252 次下载
概览

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.

When to use

  • Adopting an evolved policy: --op render shows the actual system

prompt a genome compiles to — read THAT, not the raw JSON, before
wiring a genome into a harness.

  • Auditing a promotion: --op genome loads + validates the shipped

cand-6 genome (first holdout-confirmed cheap-tier promotion; provenance
ships in the package) or any genome file you point at.

  • CI gate on genome edits: --op validate --alert-on-invalid exits 1

on structural errors.

  • Debugging a bad run: --op analyze --transcript run.json classifies

failure modes (GEPA's failure-class taxonomy) from a transcript array.

What is deliberately NOT here

gepaOptimize — the optimization loop takes an in-process
evaluate(candidate) callback ("bring your own evaluator") that cannot
cross a subprocess boundary. Two supported paths instead:

  1. Library consumers: import { gepaOptimize, loadCand6Genome } from '@metaharness/darwin/gepa'
  2. Sandbox-scored evolution: harness-evolve (darwin CLI evolve),

which pairs GEPA with its own sandbox evaluators.

Algorithm

Implementation: scripts/gepa.mjs.

  1. import('@metaharness/darwin/gepa'); on MODULENOTFOUND fall back to a

one-time npm install --prefix ~/.ruflo/darwin-cache-<pin> and import
the cached dist/gepa/index.js (versioned dir → pin bumps invalidate).

  1. Dispatch --op:
  • genome → loadGenome(fs, path) or loadCand6Genome() + validateGenome
  • validate → validateGenome(rawJson) (raw parse so broken files reach

the validator instead of throwing in the loader)

  • render → buildSystemFromGenome(genome, ext?, glob?)
  • analyze → analyzeTranscript(entries)
  1. Emit one JSON object; exit 0 (or 1 under --alert-on-invalid, 2 on bad input).

Examples

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

Exit codes

  • 0 — op completed (or degraded — darwin not installable)
  • 1 — --alert-on-invalid and validation found errors
  • 2 — config error (unknown op, missing/broken input file)
信息
分类 人工智能
名称 harness-gepa
版本 v20260927
大小 3.25KB
更新时间 2026-09-28
语言