mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-07-26 09:52:11 +03:00
* feat(eval): add router-eval harness (AIQ scoring, regression gate, Pareto search)
Extracts a standalone router-eval evaluation tool that replays routing
decisions (from NDJSON corpora or the usage_history/call_logs SQLite
tables) into an AIQ (success/latency/cost) score, compares baseline vs.
candidate router configs with a retained-run regression gate, and ranks
Pareto-optimal candidates across a search space — a sibling to the
existing eval:compression harness.
New scripts: scripts/router-eval/{index,compare,patch-compare,search,
trends}.ts, scripts/check/check-router-eval-regression.ts, and
src/lib/routerEval/index.ts, wired via 6 new package.json entries
(eval:router, eval:router:compare, eval:router:patch-compare,
eval:router:search, eval:router:trends, check:router-eval).
Reconstructed onto current release/v3.8.49 from the original ~142-commit
stale PR branch: only the genuinely new router-eval payload (17 files)
was extracted — the other ~560 changed files in the original diff were
base-drift already present on release in newer form. The new package.json
scripts now invoke `node --import tsx` instead of `bun`, matching the
`eval:compression` precedent (Bun is reserved for a closed 5-script
allowlist). The runtime-detection shim (`"Bun" in globalThis`) already
present in the harness gracefully falls back to better-sqlite3 under
Node, so no logic changes were needed there; the retained-run manifest's
previously-hardcoded `runtime: "bun"` field and matching CLI help text
were corrected to reflect the actual invocation.
All 27 existing router-eval unit tests pass unchanged.
Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>
* refactor(router-eval): decompose toRouterObservation below complexity gate
toRouterObservation had cyclomatic complexity 18 (gate max is 15). Extract
the per-field parsing/normalization into pure helpers (sampleId, model
fields, latency, cost derivation, success) so the entry point is a plain
sequential assembly of a RouterObservation. Behavior is unchanged — same
tests pass, same fallbacks, same precedence between input aliases.
Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>
---------
Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>
129 lines
3.6 KiB
TypeScript
129 lines
3.6 KiB
TypeScript
import test from "node:test";
|
|
import assert from "node:assert/strict";
|
|
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
|
|
import { tmpdir } from "node:os";
|
|
import { join } from "node:path";
|
|
import { spawnSync } from "node:child_process";
|
|
|
|
const trendsScript = "scripts/router-eval/trends.ts";
|
|
|
|
function artifact(generatedAt: string, configId: string, aiq: number) {
|
|
return {
|
|
schemaVersion: 1,
|
|
kind: "router-eval-report",
|
|
generatedAt,
|
|
report: {
|
|
evaluatedAt: generatedAt,
|
|
summary: {
|
|
totalSamples: 1,
|
|
validSamples: 1,
|
|
droppedSamples: 0,
|
|
uniqueConfigs: 1,
|
|
},
|
|
configurations: [],
|
|
frontier: [],
|
|
top: [
|
|
{
|
|
configId,
|
|
samples: 1,
|
|
successRate: 1,
|
|
avgLatencyMs: 100,
|
|
p50LatencyMs: 100,
|
|
p95LatencyMs: 100,
|
|
avgCostUsd: 0.004,
|
|
aiq,
|
|
},
|
|
],
|
|
},
|
|
};
|
|
}
|
|
|
|
test("router eval trends reads retained and flat artifacts with limit", () => {
|
|
const dir = mkdtempSync(join(tmpdir(), "router-eval-trends-"));
|
|
const runA = join(dir, "run-a");
|
|
const runB = join(dir, "run-b");
|
|
mkdirSync(runA);
|
|
mkdirSync(runB);
|
|
writeFileSync(
|
|
join(runA, "router-eval.json"),
|
|
JSON.stringify(artifact("2026-01-01T00:00:00.000Z", "old", 80))
|
|
);
|
|
writeFileSync(
|
|
join(runB, "router-eval.json"),
|
|
JSON.stringify(artifact("2026-01-02T00:00:00.000Z", "new", 90))
|
|
);
|
|
writeFileSync(
|
|
join(dir, "flat.json"),
|
|
JSON.stringify(artifact("2026-01-03T00:00:00.000Z", "flat", 95))
|
|
);
|
|
writeFileSync(join(dir, "bad.json"), "{not json");
|
|
|
|
const result = spawnSync(
|
|
process.execPath,
|
|
["--import", "tsx", trendsScript, "--artifact-dir", dir, "--limit", "2"],
|
|
{
|
|
encoding: "utf8",
|
|
}
|
|
);
|
|
|
|
try {
|
|
assert.equal(result.status, 0);
|
|
assert.ok((result.stdout ?? "").includes("Router Eval Trends"));
|
|
assert.ok(!(result.stdout ?? "").includes("run-a"));
|
|
assert.ok((result.stdout ?? "").includes("run-b"));
|
|
assert.ok((result.stdout ?? "").includes("flat"));
|
|
} finally {
|
|
rmSync(dir, { recursive: true, force: true });
|
|
}
|
|
});
|
|
|
|
test("router eval trends can print dashboard summaries", () => {
|
|
const dir = mkdtempSync(join(tmpdir(), "router-eval-dashboard-"));
|
|
const runA = join(dir, "run-a");
|
|
const runB = join(dir, "run-b");
|
|
mkdirSync(runA);
|
|
mkdirSync(runB);
|
|
writeFileSync(
|
|
join(runA, "router-eval.json"),
|
|
JSON.stringify(artifact("2026-01-01T00:00:00.000Z", "old", 80))
|
|
);
|
|
writeFileSync(
|
|
join(runB, "router-eval.json"),
|
|
JSON.stringify(artifact("2026-01-02T00:00:00.000Z", "new", 90))
|
|
);
|
|
|
|
const result = spawnSync(
|
|
process.execPath,
|
|
["--import", "tsx", trendsScript, "--artifact-dir", dir, "--dashboard"],
|
|
{
|
|
encoding: "utf8",
|
|
}
|
|
);
|
|
|
|
try {
|
|
assert.equal(result.status, 0);
|
|
assert.ok((result.stdout ?? "").includes("Router Eval Dashboard"));
|
|
assert.ok((result.stdout ?? "").includes("Latest: run-b"));
|
|
assert.ok((result.stdout ?? "").includes("AIQ: 90.000 (+10.000)"));
|
|
assert.ok((result.stdout ?? "").includes("Rolling Averages"));
|
|
} finally {
|
|
rmSync(dir, { recursive: true, force: true });
|
|
}
|
|
});
|
|
|
|
test("router eval trends exits clearly for empty artifact dirs", () => {
|
|
const dir = mkdtempSync(join(tmpdir(), "router-eval-trends-empty-"));
|
|
const result = spawnSync(
|
|
process.execPath,
|
|
["--import", "tsx", trendsScript, "--artifact-dir", dir],
|
|
{ encoding: "utf8" }
|
|
);
|
|
|
|
try {
|
|
assert.equal(result.status, 2);
|
|
assert.ok((result.stderr ?? "").includes("No router-eval artifacts found"));
|
|
} finally {
|
|
rmSync(dir, { recursive: true, force: true });
|
|
}
|
|
});
|