@kiwa-test/perf-harness 0.1.1

package/README.md

@@ -0,0 +1,55 @@
+# @kiwa-test/perf-harness
+
+Generic performance harness for kiwa packages and dogfood apps. It measures p50/p95/p99 latency, persists baselines, detects regressions, and feeds perf data into `@kiwa-test/quality-metrics`.
+
+## Single measure
+
+```ts
+import { measure } from '@kiwa-test/perf-harness';
+
+const result = await measure({
+  name: 'reply',
+  iterations: 100,
+  warmup: 5,
+  fn: async () => {
+    await adapter.reply({ userMessage: 'Say hi.' });
+  },
+});
+```
+
+## Baseline compare
+
+```ts
+import {
+  defaultBaselinePath,
+  detectRegression,
+  loadBaseline,
+  measure,
+  saveBaseline,
+} from '@kiwa-test/perf-harness';
+
+const path = defaultBaselinePath('dogfood-anthropic-chatbot');
+const current = await measure({ name: 'reply', iterations: 100, warmup: 5, fn });
+const baseline = await loadBaseline(path);
+
+if (baseline) {
+  const regression = detectRegression({ current, baseline, threshold: 0.2 });
+  console.log(regression.verdict);
+}
+
+await saveBaseline(path, current);
+```
+
+## Release-gate integration
+
+```ts
+import { evaluatePerfGate, measure } from '@kiwa-test/perf-harness';
+
+const result = await measure({ name: 'evaluateReleaseGate', iterations: 100, warmup: 5, fn });
+const gate = evaluatePerfGate({
+  result,
+  thresholds: { p95Ms: 100 },
+});
+
+console.log(gate.verdict.passed, gate.breaches);
+```

package/dist/index.cjs

@@ -0,0 +1,387 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildMeasureResult: () => buildMeasureResult,
+  defaultBaselinePath: () => defaultBaselinePath,
+  detectRegression: () => detectRegression,
+  emitPerfReport: () => emitPerfReport,
+  evaluatePerfGate: () => evaluatePerfGate,
+  loadBaseline: () => loadBaseline,
+  measure: () => measure,
+  saveBaseline: () => saveBaseline
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/measure.ts
+async function measure(input) {
+  const warmup = input.warmup ?? 0;
+  if (input.iterations < 1) {
+    throw new Error(`measure: iterations must be >= 1, got ${input.iterations}`);
+  }
+  if (warmup < 0) {
+    throw new Error(`measure: warmup must be >= 0, got ${warmup}`);
+  }
+  for (let index = 0; index < warmup; index += 1) {
+    await input.fn();
+  }
+  const samples = [];
+  for (let index = 0; index < input.iterations; index += 1) {
+    const start = process.hrtime.bigint();
+    await input.fn();
+    const end = process.hrtime.bigint();
+    samples.push(Number(end - start) / 1e6);
+  }
+  return buildMeasureResult(input.name, input.iterations, warmup, samples);
+}
+function buildMeasureResult(name, iterations, warmup, samples) {
+  const sorted = [...samples].sort((left, right) => left - right);
+  const totalMs = samples.reduce((sum, sample) => sum + sample, 0);
+  const mean = totalMs / samples.length;
+  const variance = samples.length > 1 ? samples.reduce((sum, sample) => {
+    const delta = sample - mean;
+    return sum + delta * delta;
+  }, 0) / (samples.length - 1) : 0;
+  return {
+    name,
+    iterations,
+    warmup,
+    samples,
+    p50: percentile(sorted, 0.5),
+    p95: percentile(sorted, 0.95),
+    p99: percentile(sorted, 0.99),
+    mean,
+    stdev: Math.sqrt(variance),
+    minMs: sorted[0] ?? 0,
+    maxMs: sorted[sorted.length - 1] ?? 0,
+    totalMs
+  };
+}
+function percentile(sorted, ratio) {
+  if (sorted.length === 0) return 0;
+  const rank = Math.max(0, Math.ceil(sorted.length * ratio) - 1);
+  return sorted[rank] ?? sorted[sorted.length - 1] ?? 0;
+}
+
+// src/regression.ts
+function detectRegression(input) {
+  const threshold = input.threshold ?? 0.2;
+  const current = normalize(input.current);
+  const baseline = normalize(input.baseline);
+  const deltaPct = baseline.p95 === 0 ? current.p95 === 0 ? 0 : Number.POSITIVE_INFINITY : (current.p95 - baseline.p95) / baseline.p95;
+  const welchT = welchTScore(current.samples, baseline.samples);
+  const significant = Math.abs(welchT) > 2;
+  let verdict = "stable";
+  if (significant && deltaPct >= threshold) {
+    verdict = "regressed";
+  } else if (significant && deltaPct <= -threshold) {
+    verdict = "improved";
+  }
+  return {
+    regressed: verdict === "regressed",
+    deltaPct,
+    welchT,
+    significant,
+    verdict
+  };
+}
+function normalize(result) {
+  if (result.samples.length === 0) {
+    return result;
+  }
+  return buildMeasureResult(result.name, result.iterations, result.warmup, result.samples);
+}
+function welchTScore(current, baseline) {
+  if (current.length < 2 || baseline.length < 2) {
+    return 0;
+  }
+  const currentStats = sampleStats(current);
+  const baselineStats = sampleStats(baseline);
+  const numerator = currentStats.mean - baselineStats.mean;
+  const denominator = Math.sqrt(
+    currentStats.variance / current.length + baselineStats.variance / baseline.length
+  );
+  if (!Number.isFinite(denominator) || denominator === 0) {
+    return 0;
+  }
+  return numerator / denominator;
+}
+function sampleStats(samples) {
+  const mean = samples.reduce((sum, sample) => sum + sample, 0) / samples.length;
+  const variance = samples.reduce((sum, sample) => {
+    const delta = sample - mean;
+    return sum + delta * delta;
+  }, 0) / (samples.length - 1);
+  return { mean, variance };
+}
+
+// src/baseline.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function loadBaseline(path) {
+  try {
+    const body = await (0, import_promises.readFile)(path, "utf8");
+    return JSON.parse(body);
+  } catch (error) {
+    if (isMissingFile(error)) {
+      return null;
+    }
+    throw error;
+  }
+}
+async function saveBaseline(path, result) {
+  await (0, import_promises.mkdir)((0, import_node_path.dirname)(path), { recursive: true });
+  await (0, import_promises.writeFile)(path, `${JSON.stringify(result, null, 2)}
+`, "utf8");
+}
+function defaultBaselinePath(moduleName) {
+  return `${process.cwd()}/.perf-baseline/${moduleName}.json`;
+}
+function isMissingFile(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+
+// src/gate.ts
+var import_quality_metrics = require("@kiwa-test/quality-metrics");
+function evaluatePerfGate(input) {
+  const thresholds = input.thresholds ?? {};
+  const enabledAxes = countThresholds(thresholds);
+  const report = buildReport(input, thresholds, enabledAxes === 0);
+  const relaxedVerdict = (0, import_quality_metrics.evaluateReleaseGate)(report, {
+    coverageLine: 0,
+    coverageBranch: 0,
+    coverageFunction: 0,
+    fidelityRatio: 0,
+    perfP95Ms: thresholds.p95Ms ?? Number.POSITIVE_INFINITY,
+    mutationKillRate: 0,
+    behaviorTests: 0
+  });
+  if (enabledAxes === 0) {
+    return {
+      report,
+      verdict: { passed: true, blockers: [], axesEvaluated: 0 },
+      breaches: []
+    };
+  }
+  const breaches = [];
+  if (thresholds.p95Ms !== void 0 && relaxedVerdict.blockers.some((blocker) => blocker.axis === "perf.p95Ms")) {
+    breaches.push({
+      axis: "perf.p95Ms",
+      threshold: thresholds.p95Ms,
+      actual: input.result.p95,
+      op: "<="
+    });
+  }
+  appendOptionalBreach(
+    breaches,
+    "cost.perRequestUsd",
+    "<=",
+    thresholds.costUsd,
+    input.metrics?.costUsd,
+    Number.POSITIVE_INFINITY
+  );
+  appendOptionalBreach(
+    breaches,
+    "token.totalTokens",
+    "<=",
+    thresholds.tokens,
+    input.metrics?.tokens,
+    Number.POSITIVE_INFINITY
+  );
+  appendOptionalBreach(
+    breaches,
+    "accuracy.score",
+    ">=",
+    thresholds.accuracy,
+    input.metrics?.accuracy,
+    Number.NEGATIVE_INFINITY
+  );
+  const verdict = {
+    passed: breaches.length === 0,
+    blockers: breaches,
+    axesEvaluated: enabledAxes
+  };
+  return { report, verdict, breaches };
+}
+function buildReport(input, thresholds, empty) {
+  const perf = empty || thresholds.p95Ms === void 0 ? { p50Ms: 0, p95Ms: 0, p99Ms: 0, samples: 0 } : {
+    p50Ms: input.result.p50,
+    p95Ms: input.result.p95,
+    p99Ms: input.result.p99,
+    samples: input.result.samples.length
+  };
+  const report = {
+    provider: `@kiwa-test/perf-harness/${input.result.name}`,
+    version: "0.1.0",
+    reportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    coverage: { line: 0, branch: 0, function: 0 },
+    testCount: { behavior: 0, integration: 0, e2e: 0, total: 0 },
+    fidelity: { mockCoveredMethods: 0, realTotalMethods: 0, ratio: 0 },
+    perf,
+    mutation: { mutations: 0, killed: 0, survived: 0, killRate: 0 }
+  };
+  if (!empty && thresholds.costUsd !== void 0) {
+    const actual = input.metrics?.costUsd ?? 0;
+    report.cost = { perRequestUsd: actual, totalUsd: actual, requests: 1 };
+  }
+  if (!empty && thresholds.tokens !== void 0) {
+    const actual = input.metrics?.tokens ?? 0;
+    report.token = {
+      promptTokens: actual,
+      completionTokens: 0,
+      totalTokens: actual,
+      requests: 1
+    };
+  }
+  if (!empty && thresholds.accuracy !== void 0) {
+    report.accuracy = {
+      score: input.metrics?.accuracy ?? 0,
+      samples: 1,
+      method: "provided"
+    };
+  }
+  return report;
+}
+function appendOptionalBreach(breaches, axis, op, threshold, actual, missingFallback) {
+  if (threshold === void 0) {
+    return;
+  }
+  const resolvedActual = actual ?? missingFallback;
+  const passed = op === "<=" ? resolvedActual <= threshold : resolvedActual >= threshold;
+  if (!passed) {
+    breaches.push({
+      axis,
+      threshold,
+      actual: resolvedActual,
+      op
+    });
+  }
+}
+function countThresholds(thresholds) {
+  return [
+    thresholds.p95Ms,
+    thresholds.costUsd,
+    thresholds.tokens,
+    thresholds.accuracy
+  ].filter((value) => value !== void 0).length;
+}
+
+// src/report.ts
+function emitPerfReport(result, opts = {}) {
+  const lines = [];
+  lines.push(`# Perf Report \u2014 ${result.name}`);
+  lines.push("");
+  lines.push("| metric | value |");
+  lines.push("|---|---|");
+  lines.push(`| iterations | ${result.iterations} |`);
+  lines.push(`| warmup | ${result.warmup} |`);
+  lines.push(`| p50 | ${formatMs(result.p50)} |`);
+  lines.push(`| p95 | ${formatMs(result.p95)} |`);
+  lines.push(`| p99 | ${formatMs(result.p99)} |`);
+  lines.push(`| mean | ${formatMs(result.mean)} |`);
+  lines.push(`| stdev | ${formatMs(result.stdev)} |`);
+  lines.push(`| min | ${formatMs(result.minMs)} |`);
+  lines.push(`| max | ${formatMs(result.maxMs)} |`);
+  lines.push(`| total | ${formatMs(result.totalMs)} |`);
+  lines.push("");
+  if (opts.baseline) {
+    const metrics = [
+      { label: "p50", current: result.p50, baseline: opts.baseline.p50 },
+      { label: "p95", current: result.p95, baseline: opts.baseline.p95 },
+      { label: "p99", current: result.p99, baseline: opts.baseline.p99 },
+      { label: "mean", current: result.mean, baseline: opts.baseline.mean },
+      { label: "min", current: result.minMs, baseline: opts.baseline.minMs },
+      { label: "max", current: result.maxMs, baseline: opts.baseline.maxMs },
+      { label: "total", current: result.totalMs, baseline: opts.baseline.totalMs }
+    ];
+    lines.push("## Baseline diff");
+    lines.push("");
+    lines.push("| metric | current | baseline | delta ms | delta % |");
+    lines.push("|---|---|---|---|---|");
+    for (const metric of metrics) {
+      const deltaMs = metric.current - metric.baseline;
+      const deltaPct = metric.baseline === 0 ? 0 : deltaMs / metric.baseline * 100;
+      lines.push(
+        `| ${metric.label} | ${formatMs(metric.current)} | ${formatMs(metric.baseline)} | ${formatSignedMs(deltaMs)} | ${formatSignedPct(deltaPct)} |`
+      );
+    }
+    lines.push("");
+  }
+  if (opts.includeSamples) {
+    lines.push("## Samples histogram");
+    lines.push("");
+    lines.push("| bin | range ms | count | bar |");
+    lines.push("|---|---|---|---|");
+    for (const row of histogramRows(result.samples, 10)) {
+      lines.push(`| ${row.index} | ${row.range} | ${row.count} | ${row.bar} |`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function histogramRows(samples, bins) {
+  if (samples.length === 0) {
+    return [];
+  }
+  const min = Math.min(...samples);
+  const max = Math.max(...samples);
+  const width = max === min ? 1 : (max - min) / bins;
+  const counts = new Array(bins).fill(0);
+  for (const sample of samples) {
+    const rawIndex = width === 0 ? 0 : Math.floor((sample - min) / width);
+    const index = Math.min(bins - 1, Math.max(0, rawIndex));
+    counts[index] = (counts[index] ?? 0) + 1;
+  }
+  const peak = Math.max(...counts, 1);
+  return counts.map((count, index) => {
+    const start = min + index * width;
+    const end = index === bins - 1 ? max : start + width;
+    return {
+      index: index + 1,
+      range: `${start.toFixed(2)}-${end.toFixed(2)}`,
+      count,
+      bar: "#".repeat(count === 0 ? 0 : Math.max(1, Math.round(count / peak * 10)))
+    };
+  });
+}
+function formatMs(value) {
+  return `${value.toFixed(2)}ms`;
+}
+function formatSignedMs(value) {
+  const sign = value > 0 ? "+" : "";
+  return `${sign}${value.toFixed(2)}ms`;
+}
+function formatSignedPct(value) {
+  const sign = value > 0 ? "+" : "";
+  return `${sign}${value.toFixed(2)}%`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildMeasureResult,
+  defaultBaselinePath,
+  detectRegression,
+  emitPerfReport,
+  evaluatePerfGate,
+  loadBaseline,
+  measure,
+  saveBaseline
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/measure.ts","../src/regression.ts","../src/baseline.ts","../src/gate.ts","../src/report.ts"],"sourcesContent":["export type {\n  MeasureInput,\n  MeasureResult,\n  PerfGateInput,\n  PerfGateResult,\n  RegressionInput,\n  RegressionResult,\n  Thresholds,\n} from './types.js';\n\nexport { buildMeasureResult, measure } from './measure.js';\nexport { detectRegression } from './regression.js';\nexport { defaultBaselinePath, loadBaseline, saveBaseline } from './baseline.js';\nexport { evaluatePerfGate } from './gate.js';\nexport { emitPerfReport } from './report.js';\n","import type { MeasureInput, MeasureResult } from './types.js';\n\nexport async function measure(input: MeasureInput): Promise<MeasureResult> {\n  const warmup = input.warmup ?? 0;\n  if (input.iterations < 1) {\n    throw new Error(`measure: iterations must be >= 1, got ${input.iterations}`);\n  }\n  if (warmup < 0) {\n    throw new Error(`measure: warmup must be >= 0, got ${warmup}`);\n  }\n\n  for (let index = 0; index < warmup; index += 1) {\n    await input.fn();\n  }\n\n  const samples: number[] = [];\n  for (let index = 0; index < input.iterations; index += 1) {\n    const start = process.hrtime.bigint();\n    await input.fn();\n    const end = process.hrtime.bigint();\n    samples.push(Number(end - start) / 1_000_000);\n  }\n\n  return buildMeasureResult(input.name, input.iterations, warmup, samples);\n}\n\nexport function buildMeasureResult(\n  name: string,\n  iterations: number,\n  warmup: number,\n  samples: number[],\n): MeasureResult {\n  const sorted = [...samples].sort((left, right) => left - right);\n  const totalMs = samples.reduce((sum, sample) => sum + sample, 0);\n  const mean = totalMs / samples.length;\n  const variance = samples.length > 1\n    ? samples.reduce((sum, sample) => {\n        const delta = sample - mean;\n        return sum + (delta * delta);\n      }, 0) / (samples.length - 1)\n    : 0;\n\n  return {\n    name,\n    iterations,\n    warmup,\n    samples,\n    p50: percentile(sorted, 0.5),\n    p95: percentile(sorted, 0.95),\n    p99: percentile(sorted, 0.99),\n    mean,\n    stdev: Math.sqrt(variance),\n    minMs: sorted[0] ?? 0,\n    maxMs: sorted[sorted.length - 1] ?? 0,\n    totalMs,\n  };\n}\n\nfunction percentile(sorted: number[], ratio: number): number {\n  if (sorted.length === 0) return 0;\n  const rank = Math.max(0, Math.ceil(sorted.length * ratio) - 1);\n  return sorted[rank] ?? sorted[sorted.length - 1] ?? 0;\n}\n","import { buildMeasureResult } from './measure.js';\nimport type {\n  MeasureResult,\n  RegressionInput,\n  RegressionResult,\n} from './types.js';\n\nexport function detectRegression(input: RegressionInput): RegressionResult {\n  const threshold = input.threshold ?? 0.2;\n  const current = normalize(input.current);\n  const baseline = normalize(input.baseline);\n\n  const deltaPct = baseline.p95 === 0\n    ? current.p95 === 0\n      ? 0\n      : Number.POSITIVE_INFINITY\n    : (current.p95 - baseline.p95) / baseline.p95;\n  const welchT = welchTScore(current.samples, baseline.samples);\n  const significant = Math.abs(welchT) > 2;\n\n  let verdict: RegressionResult['verdict'] = 'stable';\n  if (significant && deltaPct >= threshold) {\n    verdict = 'regressed';\n  } else if (significant && deltaPct <= -threshold) {\n    verdict = 'improved';\n  }\n\n  return {\n    regressed: verdict === 'regressed',\n    deltaPct,\n    welchT,\n    significant,\n    verdict,\n  };\n}\n\nfunction normalize(result: MeasureResult): MeasureResult {\n  if (result.samples.length === 0) {\n    return result;\n  }\n  return buildMeasureResult(result.name, result.iterations, result.warmup, result.samples);\n}\n\nfunction welchTScore(current: number[], baseline: number[]): number {\n  if (current.length < 2 || baseline.length < 2) {\n    return 0;\n  }\n\n  const currentStats = sampleStats(current);\n  const baselineStats = sampleStats(baseline);\n  const numerator = currentStats.mean - baselineStats.mean;\n  const denominator = Math.sqrt(\n    (currentStats.variance / current.length) +\n      (baselineStats.variance / baseline.length),\n  );\n\n  if (!Number.isFinite(denominator) || denominator === 0) {\n    return 0;\n  }\n  return numerator / denominator;\n}\n\nfunction sampleStats(samples: number[]): { mean: number; variance: number } {\n  const mean = samples.reduce((sum, sample) => sum + sample, 0) / samples.length;\n  const variance = samples.reduce((sum, sample) => {\n    const delta = sample - mean;\n    return sum + (delta * delta);\n  }, 0) / (samples.length - 1);\n  return { mean, variance };\n}\n","import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport type { MeasureResult } from './types.js';\n\nexport async function loadBaseline(path: string): Promise<MeasureResult | null> {\n  try {\n    const body = await readFile(path, 'utf8');\n    return JSON.parse(body) as MeasureResult;\n  } catch (error) {\n    if (isMissingFile(error)) {\n      return null;\n    }\n    throw error;\n  }\n}\n\nexport async function saveBaseline(path: string, result: MeasureResult): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, `${JSON.stringify(result, null, 2)}\\n`, 'utf8');\n}\n\nexport function defaultBaselinePath(moduleName: string): string {\n  return `${process.cwd()}/.perf-baseline/${moduleName}.json`;\n}\n\nfunction isMissingFile(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';\n}\n","import {\n  evaluateReleaseGate,\n  type QualityReport,\n  type ReleaseGateBlocker,\n  type ReleaseGateVerdict,\n} from '@kiwa-test/quality-metrics';\nimport type {\n  PerfGateInput,\n  PerfGateResult,\n  Thresholds,\n} from './types.js';\n\nexport function evaluatePerfGate(input: PerfGateInput): PerfGateResult {\n  const thresholds = input.thresholds ?? {};\n  const enabledAxes = countThresholds(thresholds);\n  const report = buildReport(input, thresholds, enabledAxes === 0);\n  const relaxedVerdict = evaluateReleaseGate(report, {\n    coverageLine: 0,\n    coverageBranch: 0,\n    coverageFunction: 0,\n    fidelityRatio: 0,\n    perfP95Ms: thresholds.p95Ms ?? Number.POSITIVE_INFINITY,\n    mutationKillRate: 0,\n    behaviorTests: 0,\n  });\n\n  if (enabledAxes === 0) {\n    return {\n      report,\n      verdict: { passed: true, blockers: [], axesEvaluated: 0 },\n      breaches: [],\n    };\n  }\n\n  const breaches: ReleaseGateBlocker[] = [];\n  if (thresholds.p95Ms !== undefined && relaxedVerdict.blockers.some((blocker) => blocker.axis === 'perf.p95Ms')) {\n    breaches.push({\n      axis: 'perf.p95Ms',\n      threshold: thresholds.p95Ms,\n      actual: input.result.p95,\n      op: '<=',\n    });\n  }\n\n  appendOptionalBreach(\n    breaches,\n    'cost.perRequestUsd',\n    '<=',\n    thresholds.costUsd,\n    input.metrics?.costUsd,\n    Number.POSITIVE_INFINITY,\n  );\n  appendOptionalBreach(\n    breaches,\n    'token.totalTokens',\n    '<=',\n    thresholds.tokens,\n    input.metrics?.tokens,\n    Number.POSITIVE_INFINITY,\n  );\n  appendOptionalBreach(\n    breaches,\n    'accuracy.score',\n    '>=',\n    thresholds.accuracy,\n    input.metrics?.accuracy,\n    Number.NEGATIVE_INFINITY,\n  );\n\n  const verdict: ReleaseGateVerdict = {\n    passed: breaches.length === 0,\n    blockers: breaches,\n    axesEvaluated: enabledAxes,\n  };\n\n  return { report, verdict, breaches };\n}\n\nfunction buildReport(\n  input: PerfGateInput,\n  thresholds: Thresholds,\n  empty: boolean,\n): QualityReport {\n  const perf = empty || thresholds.p95Ms === undefined\n    ? { p50Ms: 0, p95Ms: 0, p99Ms: 0, samples: 0 }\n    : {\n        p50Ms: input.result.p50,\n        p95Ms: input.result.p95,\n        p99Ms: input.result.p99,\n        samples: input.result.samples.length,\n      };\n  const report: QualityReport = {\n    provider: `@kiwa-test/perf-harness/${input.result.name}`,\n    version: '0.1.0',\n    reportedAt: new Date().toISOString(),\n    coverage: { line: 0, branch: 0, function: 0 },\n    testCount: { behavior: 0, integration: 0, e2e: 0, total: 0 },\n    fidelity: { mockCoveredMethods: 0, realTotalMethods: 0, ratio: 0 },\n    perf,\n    mutation: { mutations: 0, killed: 0, survived: 0, killRate: 0 },\n  };\n  if (!empty && thresholds.costUsd !== undefined) {\n    const actual = input.metrics?.costUsd ?? 0;\n    report.cost = { perRequestUsd: actual, totalUsd: actual, requests: 1 };\n  }\n  if (!empty && thresholds.tokens !== undefined) {\n    const actual = input.metrics?.tokens ?? 0;\n    report.token = {\n      promptTokens: actual,\n      completionTokens: 0,\n      totalTokens: actual,\n      requests: 1,\n    };\n  }\n  if (!empty && thresholds.accuracy !== undefined) {\n    report.accuracy = {\n      score: input.metrics?.accuracy ?? 0,\n      samples: 1,\n      method: 'provided',\n    };\n  }\n  return report;\n}\n\nfunction appendOptionalBreach(\n  breaches: ReleaseGateBlocker[],\n  axis: string,\n  op: '>=' | '<=',\n  threshold: number | undefined,\n  actual: number | undefined,\n  missingFallback: number,\n): void {\n  if (threshold === undefined) {\n    return;\n  }\n  const resolvedActual = actual ?? missingFallback;\n  const passed = op === '<=' ? resolvedActual <= threshold : resolvedActual >= threshold;\n  if (!passed) {\n    breaches.push({\n      axis,\n      threshold,\n      actual: resolvedActual,\n      op,\n    });\n  }\n}\n\nfunction countThresholds(thresholds: Thresholds): number {\n  return [\n    thresholds.p95Ms,\n    thresholds.costUsd,\n    thresholds.tokens,\n    thresholds.accuracy,\n  ].filter((value) => value !== undefined).length;\n}\n","import type { MeasureResult } from './types.js';\n\nexport function emitPerfReport(\n  result: MeasureResult,\n  opts: {\n    baseline?: MeasureResult;\n    includeSamples?: boolean;\n  } = {},\n): string {\n  const lines: string[] = [];\n  lines.push(`# Perf Report — ${result.name}`);\n  lines.push('');\n  lines.push('| metric | value |');\n  lines.push('|---|---|');\n  lines.push(`| iterations | ${result.iterations} |`);\n  lines.push(`| warmup | ${result.warmup} |`);\n  lines.push(`| p50 | ${formatMs(result.p50)} |`);\n  lines.push(`| p95 | ${formatMs(result.p95)} |`);\n  lines.push(`| p99 | ${formatMs(result.p99)} |`);\n  lines.push(`| mean | ${formatMs(result.mean)} |`);\n  lines.push(`| stdev | ${formatMs(result.stdev)} |`);\n  lines.push(`| min | ${formatMs(result.minMs)} |`);\n  lines.push(`| max | ${formatMs(result.maxMs)} |`);\n  lines.push(`| total | ${formatMs(result.totalMs)} |`);\n  lines.push('');\n\n  if (opts.baseline) {\n    const metrics = [\n      { label: 'p50', current: result.p50, baseline: opts.baseline.p50 },\n      { label: 'p95', current: result.p95, baseline: opts.baseline.p95 },\n      { label: 'p99', current: result.p99, baseline: opts.baseline.p99 },\n      { label: 'mean', current: result.mean, baseline: opts.baseline.mean },\n      { label: 'min', current: result.minMs, baseline: opts.baseline.minMs },\n      { label: 'max', current: result.maxMs, baseline: opts.baseline.maxMs },\n      { label: 'total', current: result.totalMs, baseline: opts.baseline.totalMs },\n    ];\n    lines.push('## Baseline diff');\n    lines.push('');\n    lines.push('| metric | current | baseline | delta ms | delta % |');\n    lines.push('|---|---|---|---|---|');\n    for (const metric of metrics) {\n      const deltaMs = metric.current - metric.baseline;\n      const deltaPct = metric.baseline === 0 ? 0 : (deltaMs / metric.baseline) * 100;\n      lines.push(\n        `| ${metric.label} | ${formatMs(metric.current)} | ${formatMs(metric.baseline)} | ${formatSignedMs(deltaMs)} | ${formatSignedPct(deltaPct)} |`,\n      );\n    }\n    lines.push('');\n  }\n\n  if (opts.includeSamples) {\n    lines.push('## Samples histogram');\n    lines.push('');\n    lines.push('| bin | range ms | count | bar |');\n    lines.push('|---|---|---|---|');\n    for (const row of histogramRows(result.samples, 10)) {\n      lines.push(`| ${row.index} | ${row.range} | ${row.count} | ${row.bar} |`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\nfunction histogramRows(samples: number[], bins: number): Array<{\n  index: number;\n  range: string;\n  count: number;\n  bar: string;\n}> {\n  if (samples.length === 0) {\n    return [];\n  }\n\n  const min = Math.min(...samples);\n  const max = Math.max(...samples);\n  const width = max === min ? 1 : (max - min) / bins;\n  const counts = new Array<number>(bins).fill(0);\n\n  for (const sample of samples) {\n    const rawIndex = width === 0 ? 0 : Math.floor((sample - min) / width);\n    const index = Math.min(bins - 1, Math.max(0, rawIndex));\n    counts[index] = (counts[index] ?? 0) + 1;\n  }\n\n  const peak = Math.max(...counts, 1);\n  return counts.map((count, index) => {\n    const start = min + (index * width);\n    const end = index === bins - 1 ? max : start + width;\n    return {\n      index: index + 1,\n      range: `${start.toFixed(2)}-${end.toFixed(2)}`,\n      count,\n      bar: '#'.repeat(count === 0 ? 0 : Math.max(1, Math.round((count / peak) * 10))),\n    };\n  });\n}\n\nfunction formatMs(value: number): string {\n  return `${value.toFixed(2)}ms`;\n}\n\nfunction formatSignedMs(value: number): string {\n  const sign = value > 0 ? '+' : '';\n  return `${sign}${value.toFixed(2)}ms`;\n}\n\nfunction formatSignedPct(value: number): string {\n  const sign = value > 0 ? '+' : '';\n  return `${sign}${value.toFixed(2)}%`;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,73 @@
+import { QualityReport, ReleaseGateVerdict, ReleaseGateBlocker } from '@kiwa-test/quality-metrics';
+
+interface MeasureInput {
+    name: string;
+    fn: () => void | Promise<void>;
+    iterations: number;
+    warmup?: number;
+}
+interface MeasureResult {
+    name: string;
+    iterations: number;
+    warmup: number;
+    samples: number[];
+    p50: number;
+    p95: number;
+    p99: number;
+    mean: number;
+    stdev: number;
+    minMs: number;
+    maxMs: number;
+    totalMs: number;
+}
+interface RegressionInput {
+    current: MeasureResult;
+    baseline: MeasureResult;
+    threshold?: number;
+}
+interface RegressionResult {
+    regressed: boolean;
+    deltaPct: number;
+    welchT: number;
+    significant: boolean;
+    verdict: 'improved' | 'stable' | 'regressed';
+}
+interface Thresholds {
+    p95Ms?: number;
+    costUsd?: number;
+    tokens?: number;
+    accuracy?: number;
+}
+interface PerfGateInput {
+    result: MeasureResult;
+    baseline?: MeasureResult | null;
+    thresholds?: Thresholds;
+    metrics?: {
+        costUsd?: number;
+        tokens?: number;
+        accuracy?: number;
+    };
+}
+interface PerfGateResult {
+    report: QualityReport;
+    verdict: ReleaseGateVerdict;
+    breaches: ReleaseGateBlocker[];
+}
+
+declare function measure(input: MeasureInput): Promise<MeasureResult>;
+declare function buildMeasureResult(name: string, iterations: number, warmup: number, samples: number[]): MeasureResult;
+
+declare function detectRegression(input: RegressionInput): RegressionResult;
+
+declare function loadBaseline(path: string): Promise<MeasureResult | null>;
+declare function saveBaseline(path: string, result: MeasureResult): Promise<void>;
+declare function defaultBaselinePath(moduleName: string): string;
+
+declare function evaluatePerfGate(input: PerfGateInput): PerfGateResult;
+
+declare function emitPerfReport(result: MeasureResult, opts?: {
+    baseline?: MeasureResult;
+    includeSamples?: boolean;
+}): string;
+
+export { type MeasureInput, type MeasureResult, type PerfGateInput, type PerfGateResult, type RegressionInput, type RegressionResult, type Thresholds, buildMeasureResult, defaultBaselinePath, detectRegression, emitPerfReport, evaluatePerfGate, loadBaseline, measure, saveBaseline };

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { QualityReport, ReleaseGateVerdict, ReleaseGateBlocker } from '@kiwa-test/quality-metrics';
+
+interface MeasureInput {
+    name: string;
+    fn: () => void | Promise<void>;
+    iterations: number;
+    warmup?: number;
+}
+interface MeasureResult {
+    name: string;
+    iterations: number;
+    warmup: number;
+    samples: number[];
+    p50: number;
+    p95: number;
+    p99: number;
+    mean: number;
+    stdev: number;
+    minMs: number;
+    maxMs: number;
+    totalMs: number;
+}
+interface RegressionInput {
+    current: MeasureResult;
+    baseline: MeasureResult;
+    threshold?: number;
+}
+interface RegressionResult {
+    regressed: boolean;
+    deltaPct: number;
+    welchT: number;
+    significant: boolean;
+    verdict: 'improved' | 'stable' | 'regressed';
+}
+interface Thresholds {
+    p95Ms?: number;
+    costUsd?: number;
+    tokens?: number;
+    accuracy?: number;
+}
+interface PerfGateInput {
+    result: MeasureResult;
+    baseline?: MeasureResult | null;
+    thresholds?: Thresholds;
+    metrics?: {
+        costUsd?: number;
+        tokens?: number;
+        accuracy?: number;
+    };
+}
+interface PerfGateResult {
+    report: QualityReport;
+    verdict: ReleaseGateVerdict;
+    breaches: ReleaseGateBlocker[];
+}
+
+declare function measure(input: MeasureInput): Promise<MeasureResult>;
+declare function buildMeasureResult(name: string, iterations: number, warmup: number, samples: number[]): MeasureResult;
+
+declare function detectRegression(input: RegressionInput): RegressionResult;
+
+declare function loadBaseline(path: string): Promise<MeasureResult | null>;
+declare function saveBaseline(path: string, result: MeasureResult): Promise<void>;
+declare function defaultBaselinePath(moduleName: string): string;
+
+declare function evaluatePerfGate(input: PerfGateInput): PerfGateResult;
+
+declare function emitPerfReport(result: MeasureResult, opts?: {
+    baseline?: MeasureResult;
+    includeSamples?: boolean;
+}): string;
+
+export { type MeasureInput, type MeasureResult, type PerfGateInput, type PerfGateResult, type RegressionInput, type RegressionResult, type Thresholds, buildMeasureResult, defaultBaselinePath, detectRegression, emitPerfReport, evaluatePerfGate, loadBaseline, measure, saveBaseline };

package/dist/index.js

@@ -0,0 +1,355 @@
+// src/measure.ts
+async function measure(input) {
+  const warmup = input.warmup ?? 0;
+  if (input.iterations < 1) {
+    throw new Error(`measure: iterations must be >= 1, got ${input.iterations}`);
+  }
+  if (warmup < 0) {
+    throw new Error(`measure: warmup must be >= 0, got ${warmup}`);
+  }
+  for (let index = 0; index < warmup; index += 1) {
+    await input.fn();
+  }
+  const samples = [];
+  for (let index = 0; index < input.iterations; index += 1) {
+    const start = process.hrtime.bigint();
+    await input.fn();
+    const end = process.hrtime.bigint();
+    samples.push(Number(end - start) / 1e6);
+  }
+  return buildMeasureResult(input.name, input.iterations, warmup, samples);
+}
+function buildMeasureResult(name, iterations, warmup, samples) {
+  const sorted = [...samples].sort((left, right) => left - right);
+  const totalMs = samples.reduce((sum, sample) => sum + sample, 0);
+  const mean = totalMs / samples.length;
+  const variance = samples.length > 1 ? samples.reduce((sum, sample) => {
+    const delta = sample - mean;
+    return sum + delta * delta;
+  }, 0) / (samples.length - 1) : 0;
+  return {
+    name,
+    iterations,
+    warmup,
+    samples,
+    p50: percentile(sorted, 0.5),
+    p95: percentile(sorted, 0.95),
+    p99: percentile(sorted, 0.99),
+    mean,
+    stdev: Math.sqrt(variance),
+    minMs: sorted[0] ?? 0,
+    maxMs: sorted[sorted.length - 1] ?? 0,
+    totalMs
+  };
+}
+function percentile(sorted, ratio) {
+  if (sorted.length === 0) return 0;
+  const rank = Math.max(0, Math.ceil(sorted.length * ratio) - 1);
+  return sorted[rank] ?? sorted[sorted.length - 1] ?? 0;
+}
+
+// src/regression.ts
+function detectRegression(input) {
+  const threshold = input.threshold ?? 0.2;
+  const current = normalize(input.current);
+  const baseline = normalize(input.baseline);
+  const deltaPct = baseline.p95 === 0 ? current.p95 === 0 ? 0 : Number.POSITIVE_INFINITY : (current.p95 - baseline.p95) / baseline.p95;
+  const welchT = welchTScore(current.samples, baseline.samples);
+  const significant = Math.abs(welchT) > 2;
+  let verdict = "stable";
+  if (significant && deltaPct >= threshold) {
+    verdict = "regressed";
+  } else if (significant && deltaPct <= -threshold) {
+    verdict = "improved";
+  }
+  return {
+    regressed: verdict === "regressed",
+    deltaPct,
+    welchT,
+    significant,
+    verdict
+  };
+}
+function normalize(result) {
+  if (result.samples.length === 0) {
+    return result;
+  }
+  return buildMeasureResult(result.name, result.iterations, result.warmup, result.samples);
+}
+function welchTScore(current, baseline) {
+  if (current.length < 2 || baseline.length < 2) {
+    return 0;
+  }
+  const currentStats = sampleStats(current);
+  const baselineStats = sampleStats(baseline);
+  const numerator = currentStats.mean - baselineStats.mean;
+  const denominator = Math.sqrt(
+    currentStats.variance / current.length + baselineStats.variance / baseline.length
+  );
+  if (!Number.isFinite(denominator) || denominator === 0) {
+    return 0;
+  }
+  return numerator / denominator;
+}
+function sampleStats(samples) {
+  const mean = samples.reduce((sum, sample) => sum + sample, 0) / samples.length;
+  const variance = samples.reduce((sum, sample) => {
+    const delta = sample - mean;
+    return sum + delta * delta;
+  }, 0) / (samples.length - 1);
+  return { mean, variance };
+}
+
+// src/baseline.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { dirname } from "path";
+async function loadBaseline(path) {
+  try {
+    const body = await readFile(path, "utf8");
+    return JSON.parse(body);
+  } catch (error) {
+    if (isMissingFile(error)) {
+      return null;
+    }
+    throw error;
+  }
+}
+async function saveBaseline(path, result) {
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, `${JSON.stringify(result, null, 2)}
+`, "utf8");
+}
+function defaultBaselinePath(moduleName) {
+  return `${process.cwd()}/.perf-baseline/${moduleName}.json`;
+}
+function isMissingFile(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+
+// src/gate.ts
+import {
+  evaluateReleaseGate
+} from "@kiwa-test/quality-metrics";
+function evaluatePerfGate(input) {
+  const thresholds = input.thresholds ?? {};
+  const enabledAxes = countThresholds(thresholds);
+  const report = buildReport(input, thresholds, enabledAxes === 0);
+  const relaxedVerdict = evaluateReleaseGate(report, {
+    coverageLine: 0,
+    coverageBranch: 0,
+    coverageFunction: 0,
+    fidelityRatio: 0,
+    perfP95Ms: thresholds.p95Ms ?? Number.POSITIVE_INFINITY,
+    mutationKillRate: 0,
+    behaviorTests: 0
+  });
+  if (enabledAxes === 0) {
+    return {
+      report,
+      verdict: { passed: true, blockers: [], axesEvaluated: 0 },
+      breaches: []
+    };
+  }
+  const breaches = [];
+  if (thresholds.p95Ms !== void 0 && relaxedVerdict.blockers.some((blocker) => blocker.axis === "perf.p95Ms")) {
+    breaches.push({
+      axis: "perf.p95Ms",
+      threshold: thresholds.p95Ms,
+      actual: input.result.p95,
+      op: "<="
+    });
+  }
+  appendOptionalBreach(
+    breaches,
+    "cost.perRequestUsd",
+    "<=",
+    thresholds.costUsd,
+    input.metrics?.costUsd,
+    Number.POSITIVE_INFINITY
+  );
+  appendOptionalBreach(
+    breaches,
+    "token.totalTokens",
+    "<=",
+    thresholds.tokens,
+    input.metrics?.tokens,
+    Number.POSITIVE_INFINITY
+  );
+  appendOptionalBreach(
+    breaches,
+    "accuracy.score",
+    ">=",
+    thresholds.accuracy,
+    input.metrics?.accuracy,
+    Number.NEGATIVE_INFINITY
+  );
+  const verdict = {
+    passed: breaches.length === 0,
+    blockers: breaches,
+    axesEvaluated: enabledAxes
+  };
+  return { report, verdict, breaches };
+}
+function buildReport(input, thresholds, empty) {
+  const perf = empty || thresholds.p95Ms === void 0 ? { p50Ms: 0, p95Ms: 0, p99Ms: 0, samples: 0 } : {
+    p50Ms: input.result.p50,
+    p95Ms: input.result.p95,
+    p99Ms: input.result.p99,
+    samples: input.result.samples.length
+  };
+  const report = {
+    provider: `@kiwa-test/perf-harness/${input.result.name}`,
+    version: "0.1.0",
+    reportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    coverage: { line: 0, branch: 0, function: 0 },
+    testCount: { behavior: 0, integration: 0, e2e: 0, total: 0 },
+    fidelity: { mockCoveredMethods: 0, realTotalMethods: 0, ratio: 0 },
+    perf,
+    mutation: { mutations: 0, killed: 0, survived: 0, killRate: 0 }
+  };
+  if (!empty && thresholds.costUsd !== void 0) {
+    const actual = input.metrics?.costUsd ?? 0;
+    report.cost = { perRequestUsd: actual, totalUsd: actual, requests: 1 };
+  }
+  if (!empty && thresholds.tokens !== void 0) {
+    const actual = input.metrics?.tokens ?? 0;
+    report.token = {
+      promptTokens: actual,
+      completionTokens: 0,
+      totalTokens: actual,
+      requests: 1
+    };
+  }
+  if (!empty && thresholds.accuracy !== void 0) {
+    report.accuracy = {
+      score: input.metrics?.accuracy ?? 0,
+      samples: 1,
+      method: "provided"
+    };
+  }
+  return report;
+}
+function appendOptionalBreach(breaches, axis, op, threshold, actual, missingFallback) {
+  if (threshold === void 0) {
+    return;
+  }
+  const resolvedActual = actual ?? missingFallback;
+  const passed = op === "<=" ? resolvedActual <= threshold : resolvedActual >= threshold;
+  if (!passed) {
+    breaches.push({
+      axis,
+      threshold,
+      actual: resolvedActual,
+      op
+    });
+  }
+}
+function countThresholds(thresholds) {
+  return [
+    thresholds.p95Ms,
+    thresholds.costUsd,
+    thresholds.tokens,
+    thresholds.accuracy
+  ].filter((value) => value !== void 0).length;
+}
+
+// src/report.ts
+function emitPerfReport(result, opts = {}) {
+  const lines = [];
+  lines.push(`# Perf Report \u2014 ${result.name}`);
+  lines.push("");
+  lines.push("| metric | value |");
+  lines.push("|---|---|");
+  lines.push(`| iterations | ${result.iterations} |`);
+  lines.push(`| warmup | ${result.warmup} |`);
+  lines.push(`| p50 | ${formatMs(result.p50)} |`);
+  lines.push(`| p95 | ${formatMs(result.p95)} |`);
+  lines.push(`| p99 | ${formatMs(result.p99)} |`);
+  lines.push(`| mean | ${formatMs(result.mean)} |`);
+  lines.push(`| stdev | ${formatMs(result.stdev)} |`);
+  lines.push(`| min | ${formatMs(result.minMs)} |`);
+  lines.push(`| max | ${formatMs(result.maxMs)} |`);
+  lines.push(`| total | ${formatMs(result.totalMs)} |`);
+  lines.push("");
+  if (opts.baseline) {
+    const metrics = [
+      { label: "p50", current: result.p50, baseline: opts.baseline.p50 },
+      { label: "p95", current: result.p95, baseline: opts.baseline.p95 },
+      { label: "p99", current: result.p99, baseline: opts.baseline.p99 },
+      { label: "mean", current: result.mean, baseline: opts.baseline.mean },
+      { label: "min", current: result.minMs, baseline: opts.baseline.minMs },
+      { label: "max", current: result.maxMs, baseline: opts.baseline.maxMs },
+      { label: "total", current: result.totalMs, baseline: opts.baseline.totalMs }
+    ];
+    lines.push("## Baseline diff");
+    lines.push("");
+    lines.push("| metric | current | baseline | delta ms | delta % |");
+    lines.push("|---|---|---|---|---|");
+    for (const metric of metrics) {
+      const deltaMs = metric.current - metric.baseline;
+      const deltaPct = metric.baseline === 0 ? 0 : deltaMs / metric.baseline * 100;
+      lines.push(
+        `| ${metric.label} | ${formatMs(metric.current)} | ${formatMs(metric.baseline)} | ${formatSignedMs(deltaMs)} | ${formatSignedPct(deltaPct)} |`
+      );
+    }
+    lines.push("");
+  }
+  if (opts.includeSamples) {
+    lines.push("## Samples histogram");
+    lines.push("");
+    lines.push("| bin | range ms | count | bar |");
+    lines.push("|---|---|---|---|");
+    for (const row of histogramRows(result.samples, 10)) {
+      lines.push(`| ${row.index} | ${row.range} | ${row.count} | ${row.bar} |`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function histogramRows(samples, bins) {
+  if (samples.length === 0) {
+    return [];
+  }
+  const min = Math.min(...samples);
+  const max = Math.max(...samples);
+  const width = max === min ? 1 : (max - min) / bins;
+  const counts = new Array(bins).fill(0);
+  for (const sample of samples) {
+    const rawIndex = width === 0 ? 0 : Math.floor((sample - min) / width);
+    const index = Math.min(bins - 1, Math.max(0, rawIndex));
+    counts[index] = (counts[index] ?? 0) + 1;
+  }
+  const peak = Math.max(...counts, 1);
+  return counts.map((count, index) => {
+    const start = min + index * width;
+    const end = index === bins - 1 ? max : start + width;
+    return {
+      index: index + 1,
+      range: `${start.toFixed(2)}-${end.toFixed(2)}`,
+      count,
+      bar: "#".repeat(count === 0 ? 0 : Math.max(1, Math.round(count / peak * 10)))
+    };
+  });
+}
+function formatMs(value) {
+  return `${value.toFixed(2)}ms`;
+}
+function formatSignedMs(value) {
+  const sign = value > 0 ? "+" : "";
+  return `${sign}${value.toFixed(2)}ms`;
+}
+function formatSignedPct(value) {
+  const sign = value > 0 ? "+" : "";
+  return `${sign}${value.toFixed(2)}%`;
+}
+export {
+  buildMeasureResult,
+  defaultBaselinePath,
+  detectRegression,
+  emitPerfReport,
+  evaluatePerfGate,
+  loadBaseline,
+  measure,
+  saveBaseline
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/measure.ts","../src/regression.ts","../src/baseline.ts","../src/gate.ts","../src/report.ts"],"sourcesContent":["import type { MeasureInput, MeasureResult } from './types.js';\n\nexport async function measure(input: MeasureInput): Promise<MeasureResult> {\n  const warmup = input.warmup ?? 0;\n  if (input.iterations < 1) {\n    throw new Error(`measure: iterations must be >= 1, got ${input.iterations}`);\n  }\n  if (warmup < 0) {\n    throw new Error(`measure: warmup must be >= 0, got ${warmup}`);\n  }\n\n  for (let index = 0; index < warmup; index += 1) {\n    await input.fn();\n  }\n\n  const samples: number[] = [];\n  for (let index = 0; index < input.iterations; index += 1) {\n    const start = process.hrtime.bigint();\n    await input.fn();\n    const end = process.hrtime.bigint();\n    samples.push(Number(end - start) / 1_000_000);\n  }\n\n  return buildMeasureResult(input.name, input.iterations, warmup, samples);\n}\n\nexport function buildMeasureResult(\n  name: string,\n  iterations: number,\n  warmup: number,\n  samples: number[],\n): MeasureResult {\n  const sorted = [...samples].sort((left, right) => left - right);\n  const totalMs = samples.reduce((sum, sample) => sum + sample, 0);\n  const mean = totalMs / samples.length;\n  const variance = samples.length > 1\n    ? samples.reduce((sum, sample) => {\n        const delta = sample - mean;\n        return sum + (delta * delta);\n      }, 0) / (samples.length - 1)\n    : 0;\n\n  return {\n    name,\n    iterations,\n    warmup,\n    samples,\n    p50: percentile(sorted, 0.5),\n    p95: percentile(sorted, 0.95),\n    p99: percentile(sorted, 0.99),\n    mean,\n    stdev: Math.sqrt(variance),\n    minMs: sorted[0] ?? 0,\n    maxMs: sorted[sorted.length - 1] ?? 0,\n    totalMs,\n  };\n}\n\nfunction percentile(sorted: number[], ratio: number): number {\n  if (sorted.length === 0) return 0;\n  const rank = Math.max(0, Math.ceil(sorted.length * ratio) - 1);\n  return sorted[rank] ?? sorted[sorted.length - 1] ?? 0;\n}\n","import { buildMeasureResult } from './measure.js';\nimport type {\n  MeasureResult,\n  RegressionInput,\n  RegressionResult,\n} from './types.js';\n\nexport function detectRegression(input: RegressionInput): RegressionResult {\n  const threshold = input.threshold ?? 0.2;\n  const current = normalize(input.current);\n  const baseline = normalize(input.baseline);\n\n  const deltaPct = baseline.p95 === 0\n    ? current.p95 === 0\n      ? 0\n      : Number.POSITIVE_INFINITY\n    : (current.p95 - baseline.p95) / baseline.p95;\n  const welchT = welchTScore(current.samples, baseline.samples);\n  const significant = Math.abs(welchT) > 2;\n\n  let verdict: RegressionResult['verdict'] = 'stable';\n  if (significant && deltaPct >= threshold) {\n    verdict = 'regressed';\n  } else if (significant && deltaPct <= -threshold) {\n    verdict = 'improved';\n  }\n\n  return {\n    regressed: verdict === 'regressed',\n    deltaPct,\n    welchT,\n    significant,\n    verdict,\n  };\n}\n\nfunction normalize(result: MeasureResult): MeasureResult {\n  if (result.samples.length === 0) {\n    return result;\n  }\n  return buildMeasureResult(result.name, result.iterations, result.warmup, result.samples);\n}\n\nfunction welchTScore(current: number[], baseline: number[]): number {\n  if (current.length < 2 || baseline.length < 2) {\n    return 0;\n  }\n\n  const currentStats = sampleStats(current);\n  const baselineStats = sampleStats(baseline);\n  const numerator = currentStats.mean - baselineStats.mean;\n  const denominator = Math.sqrt(\n    (currentStats.variance / current.length) +\n      (baselineStats.variance / baseline.length),\n  );\n\n  if (!Number.isFinite(denominator) || denominator === 0) {\n    return 0;\n  }\n  return numerator / denominator;\n}\n\nfunction sampleStats(samples: number[]): { mean: number; variance: number } {\n  const mean = samples.reduce((sum, sample) => sum + sample, 0) / samples.length;\n  const variance = samples.reduce((sum, sample) => {\n    const delta = sample - mean;\n    return sum + (delta * delta);\n  }, 0) / (samples.length - 1);\n  return { mean, variance };\n}\n","import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport type { MeasureResult } from './types.js';\n\nexport async function loadBaseline(path: string): Promise<MeasureResult | null> {\n  try {\n    const body = await readFile(path, 'utf8');\n    return JSON.parse(body) as MeasureResult;\n  } catch (error) {\n    if (isMissingFile(error)) {\n      return null;\n    }\n    throw error;\n  }\n}\n\nexport async function saveBaseline(path: string, result: MeasureResult): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, `${JSON.stringify(result, null, 2)}\\n`, 'utf8');\n}\n\nexport function defaultBaselinePath(moduleName: string): string {\n  return `${process.cwd()}/.perf-baseline/${moduleName}.json`;\n}\n\nfunction isMissingFile(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';\n}\n","import {\n  evaluateReleaseGate,\n  type QualityReport,\n  type ReleaseGateBlocker,\n  type ReleaseGateVerdict,\n} from '@kiwa-test/quality-metrics';\nimport type {\n  PerfGateInput,\n  PerfGateResult,\n  Thresholds,\n} from './types.js';\n\nexport function evaluatePerfGate(input: PerfGateInput): PerfGateResult {\n  const thresholds = input.thresholds ?? {};\n  const enabledAxes = countThresholds(thresholds);\n  const report = buildReport(input, thresholds, enabledAxes === 0);\n  const relaxedVerdict = evaluateReleaseGate(report, {\n    coverageLine: 0,\n    coverageBranch: 0,\n    coverageFunction: 0,\n    fidelityRatio: 0,\n    perfP95Ms: thresholds.p95Ms ?? Number.POSITIVE_INFINITY,\n    mutationKillRate: 0,\n    behaviorTests: 0,\n  });\n\n  if (enabledAxes === 0) {\n    return {\n      report,\n      verdict: { passed: true, blockers: [], axesEvaluated: 0 },\n      breaches: [],\n    };\n  }\n\n  const breaches: ReleaseGateBlocker[] = [];\n  if (thresholds.p95Ms !== undefined && relaxedVerdict.blockers.some((blocker) => blocker.axis === 'perf.p95Ms')) {\n    breaches.push({\n      axis: 'perf.p95Ms',\n      threshold: thresholds.p95Ms,\n      actual: input.result.p95,\n      op: '<=',\n    });\n  }\n\n  appendOptionalBreach(\n    breaches,\n    'cost.perRequestUsd',\n    '<=',\n    thresholds.costUsd,\n    input.metrics?.costUsd,\n    Number.POSITIVE_INFINITY,\n  );\n  appendOptionalBreach(\n    breaches,\n    'token.totalTokens',\n    '<=',\n    thresholds.tokens,\n    input.metrics?.tokens,\n    Number.POSITIVE_INFINITY,\n  );\n  appendOptionalBreach(\n    breaches,\n    'accuracy.score',\n    '>=',\n    thresholds.accuracy,\n    input.metrics?.accuracy,\n    Number.NEGATIVE_INFINITY,\n  );\n\n  const verdict: ReleaseGateVerdict = {\n    passed: breaches.length === 0,\n    blockers: breaches,\n    axesEvaluated: enabledAxes,\n  };\n\n  return { report, verdict, breaches };\n}\n\nfunction buildReport(\n  input: PerfGateInput,\n  thresholds: Thresholds,\n  empty: boolean,\n): QualityReport {\n  const perf = empty || thresholds.p95Ms === undefined\n    ? { p50Ms: 0, p95Ms: 0, p99Ms: 0, samples: 0 }\n    : {\n        p50Ms: input.result.p50,\n        p95Ms: input.result.p95,\n        p99Ms: input.result.p99,\n        samples: input.result.samples.length,\n      };\n  const report: QualityReport = {\n    provider: `@kiwa-test/perf-harness/${input.result.name}`,\n    version: '0.1.0',\n    reportedAt: new Date().toISOString(),\n    coverage: { line: 0, branch: 0, function: 0 },\n    testCount: { behavior: 0, integration: 0, e2e: 0, total: 0 },\n    fidelity: { mockCoveredMethods: 0, realTotalMethods: 0, ratio: 0 },\n    perf,\n    mutation: { mutations: 0, killed: 0, survived: 0, killRate: 0 },\n  };\n  if (!empty && thresholds.costUsd !== undefined) {\n    const actual = input.metrics?.costUsd ?? 0;\n    report.cost = { perRequestUsd: actual, totalUsd: actual, requests: 1 };\n  }\n  if (!empty && thresholds.tokens !== undefined) {\n    const actual = input.metrics?.tokens ?? 0;\n    report.token = {\n      promptTokens: actual,\n      completionTokens: 0,\n      totalTokens: actual,\n      requests: 1,\n    };\n  }\n  if (!empty && thresholds.accuracy !== undefined) {\n    report.accuracy = {\n      score: input.metrics?.accuracy ?? 0,\n      samples: 1,\n      method: 'provided',\n    };\n  }\n  return report;\n}\n\nfunction appendOptionalBreach(\n  breaches: ReleaseGateBlocker[],\n  axis: string,\n  op: '>=' | '<=',\n  threshold: number | undefined,\n  actual: number | undefined,\n  missingFallback: number,\n): void {\n  if (threshold === undefined) {\n    return;\n  }\n  const resolvedActual = actual ?? missingFallback;\n  const passed = op === '<=' ? resolvedActual <= threshold : resolvedActual >= threshold;\n  if (!passed) {\n    breaches.push({\n      axis,\n      threshold,\n      actual: resolvedActual,\n      op,\n    });\n  }\n}\n\nfunction countThresholds(thresholds: Thresholds): number {\n  return [\n    thresholds.p95Ms,\n    thresholds.costUsd,\n    thresholds.tokens,\n    thresholds.accuracy,\n  ].filter((value) => value !== undefined).length;\n}\n","import type { MeasureResult } from './types.js';\n\nexport function emitPerfReport(\n  result: MeasureResult,\n  opts: {\n    baseline?: MeasureResult;\n    includeSamples?: boolean;\n  } = {},\n): string {\n  const lines: string[] = [];\n  lines.push(`# Perf Report — ${result.name}`);\n  lines.push('');\n  lines.push('| metric | value |');\n  lines.push('|---|---|');\n  lines.push(`| iterations | ${result.iterations} |`);\n  lines.push(`| warmup | ${result.warmup} |`);\n  lines.push(`| p50 | ${formatMs(result.p50)} |`);\n  lines.push(`| p95 | ${formatMs(result.p95)} |`);\n  lines.push(`| p99 | ${formatMs(result.p99)} |`);\n  lines.push(`| mean | ${formatMs(result.mean)} |`);\n  lines.push(`| stdev | ${formatMs(result.stdev)} |`);\n  lines.push(`| min | ${formatMs(result.minMs)} |`);\n  lines.push(`| max | ${formatMs(result.maxMs)} |`);\n  lines.push(`| total | ${formatMs(result.totalMs)} |`);\n  lines.push('');\n\n  if (opts.baseline) {\n    const metrics = [\n      { label: 'p50', current: result.p50, baseline: opts.baseline.p50 },\n      { label: 'p95', current: result.p95, baseline: opts.baseline.p95 },\n      { label: 'p99', current: result.p99, baseline: opts.baseline.p99 },\n      { label: 'mean', current: result.mean, baseline: opts.baseline.mean },\n      { label: 'min', current: result.minMs, baseline: opts.baseline.minMs },\n      { label: 'max', current: result.maxMs, baseline: opts.baseline.maxMs },\n      { label: 'total', current: result.totalMs, baseline: opts.baseline.totalMs },\n    ];\n    lines.push('## Baseline diff');\n    lines.push('');\n    lines.push('| metric | current | baseline | delta ms | delta % |');\n    lines.push('|---|---|---|---|---|');\n    for (const metric of metrics) {\n      const deltaMs = metric.current - metric.baseline;\n      const deltaPct = metric.baseline === 0 ? 0 : (deltaMs / metric.baseline) * 100;\n      lines.push(\n        `| ${metric.label} | ${formatMs(metric.current)} | ${formatMs(metric.baseline)} | ${formatSignedMs(deltaMs)} | ${formatSignedPct(deltaPct)} |`,\n      );\n    }\n    lines.push('');\n  }\n\n  if (opts.includeSamples) {\n    lines.push('## Samples histogram');\n    lines.push('');\n    lines.push('| bin | range ms | count | bar |');\n    lines.push('|---|---|---|---|');\n    for (const row of histogramRows(result.samples, 10)) {\n      lines.push(`| ${row.index} | ${row.range} | ${row.count} | ${row.bar} |`);\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\nfunction histogramRows(samples: number[], bins: number): Array<{\n  index: number;\n  range: string;\n  count: number;\n  bar: string;\n}> {\n  if (samples.length === 0) {\n    return [];\n  }\n\n  const min = Math.min(...samples);\n  const max = Math.max(...samples);\n  const width = max === min ? 1 : (max - min) / bins;\n  const counts = new Array<number>(bins).fill(0);\n\n  for (const sample of samples) {\n    const rawIndex = width === 0 ? 0 : Math.floor((sample - min) / width);\n    const index = Math.min(bins - 1, Math.max(0, rawIndex));\n    counts[index] = (counts[index] ?? 0) + 1;\n  }\n\n  const peak = Math.max(...counts, 1);\n  return counts.map((count, index) => {\n    const start = min + (index * width);\n    const end = index === bins - 1 ? max : start + width;\n    return {\n      index: index + 1,\n      range: `${start.toFixed(2)}-${end.toFixed(2)}`,\n      count,\n      bar: '#'.repeat(count === 0 ? 0 : Math.max(1, Math.round((count / peak) * 10))),\n    };\n  });\n}\n\nfunction formatMs(value: number): string {\n  return `${value.toFixed(2)}ms`;\n}\n\nfunction formatSignedMs(value: number): string {\n  const sign = value > 0 ? '+' : '';\n  return `${sign}${value.toFixed(2)}ms`;\n}\n\nfunction formatSignedPct(value: number): string {\n  const sign = value > 0 ? '+' : '';\n  return `${sign}${value.toFixed(2)}%`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@kiwa-test/perf-harness",
+  "version": "0.1.1",
+  "description": "Generic performance harness — p50/p95/p99 measurement + regression detection + baseline persistence + 11-axis release gate integration",
+  "license": "MIT",
+  "author": {
+    "name": "cardene",
+    "url": "https://github.com/cardene777"
+  },
+  "keywords": [
+    "kiwa",
+    "perf",
+    "harness",
+    "benchmark",
+    "regression",
+    "release-gate"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cardene777/kiwa.git",
+    "directory": "packages/perf-harness"
+  },
+  "homepage": "https://github.com/cardene777/kiwa#readme",
+  "bugs": {
+    "url": "https://github.com/cardene777/kiwa/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "prebuild": "pnpm -F @kiwa-test/core -F @kiwa-test/quality-metrics build",
+    "build": "tsup",
+    "pretest": "pnpm -F @kiwa-test/core -F @kiwa-test/quality-metrics build",
+    "test": "node -e \"require('node:fs').rmSync('.vitest-dist',{recursive:true,force:true})\" && tsc -p tsconfig.vitest.json && vitest run .vitest-dist/tests --environment node",
+    "pretest:cov": "pnpm -F @kiwa-test/core -F @kiwa-test/quality-metrics build",
+    "test:cov": "node -e \"require('node:fs').rmSync('.vitest-dist',{recursive:true,force:true})\" && tsc -p tsconfig.vitest.json && vitest run .vitest-dist/tests --environment node --coverage --coverage.provider=v8 --coverage.reporter=json --coverage.reporter=json-summary --coverage.reporter=text --coverage.reportsDirectory=coverage --coverage.include='.vitest-dist/src/**/*.js' --coverage.exclude='.vitest-dist/tests/**'",
+    "pretypecheck": "pnpm -F @kiwa-test/core -F @kiwa-test/quality-metrics build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@kiwa-test/core": "workspace:*",
+    "@kiwa-test/quality-metrics": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}