Core Functions

import { parseContract } from "@geval-labs/core";

const contract = parseContract({
  version: 1,
  name: "my-contract",
  required_evals: [...],
  // ...
});

import { parseContractFromYaml } from "@geval-labs/core";

const contractYaml = `
version: 1
name: my-contract
required_evals:
  - name: my-eval
    rules: [...]
`;

const contract = parseContractFromYaml(contractYaml);

import { validateContract } from "@geval-labs/core";

const errors = validateContract(contract);
if (errors.length > 0) {
  errors.forEach(error => console.error(error.message));
}

import { parseEvalFile } from "@geval-labs/core";

const csvContent = readFileSync("results.csv", "utf-8");
const evalResult = parseEvalFile(csvContent, "results.csv", contract);

import { parseEvalResult } from "@geval-labs/core";

const evalData = {
  evalName: "my-eval",
  runId: "run-123",
  metrics: {
    accuracy: 0.95,
    latency: 200
  }
};

const evalResult = parseEvalResult(evalData);

import { evaluate } from "@geval-labs/core";

const decision = evaluate({
  contract,
  evalResults: [evalResult1, evalResult2],
  baselines: {
    "my-eval": {
      type: "previous",
      metrics: baselineMetrics,
      source: { runId: "baseline-run" }
    }
  }
});

import { formatDecision } from "@geval-labs/core";

const output = formatDecision(decision, {
  colors: true,
  verbose: true
});

console.log(output);

import { diffEvalResults } from "@geval-labs/core";

const diff = diffEvalResults(previousResults, currentResults);

console.log(diff.stats);
// {
//   improved: 2,
//   regressed: 1,
//   unchanged: 5
// }

diff.diffs.forEach(evalDiff => {
  console.log(`${evalDiff.evalName}:`);
  evalDiff.metrics.forEach(metric => {
    console.log(`  ${metric.metric}: ${metric.previous} → ${metric.current}`);
  });
});

import { diffContracts } from "@geval-labs/core";

const diff = diffContracts(previousContract, currentContract);

diff.changes.forEach(change => {
  console.log(`Change: ${change.type} in ${change.path}`);
});

import {
  parseContractFromYaml,
  parseEvalFile,
  evaluate,
  formatDecision,
  validateContract,
} from "@geval-labs/core";
import { readFileSync } from "fs";

// 1. Load and parse contract
const contractYaml = readFileSync("contract.yaml", "utf-8");
const contract = parseContractFromYaml(contractYaml);

// 2. Validate contract
const errors = validateContract(contract);
if (errors.length > 0) {
  throw new Error(`Contract validation failed: ${errors.map(e => e.message).join(", ")}`);
}

// 3. Parse eval results
const csvContent = readFileSync("results.csv", "utf-8");
const evalResult = parseEvalFile(csvContent, "results.csv", contract);

// 4. Evaluate
const decision = evaluate({
  contract,
  evalResults: [evalResult],
  baselines: {},
});

// 5. Format and display
console.log(formatDecision(decision, { colors: true, verbose: true }));

// 6. Use in CI
if (decision.status === "PASS") {
  console.log("✅ Safe to deploy!");
  process.exit(0);
} else {
  console.log("❌ Deployment blocked");
  process.exit(1);
}