@intentsolutions/core

Part of the Intent Eval Platform — the umbrella grouping the platform's six repos: five converge via a shared Evidence Bundle schema (intent-eval-core, intent-eval-lab, audit-harness, j-rig-skill-binary-eval, intent-rollout-gate), plus intent-eval-dashboard as a satellite consumer (not part of the convergence taxonomy).

Canonical contracts kernel for the Intent Eval Platform — TypeScript types, JSON Schemas, Zod validators, and state machines for the 16 canonical platform entities (the 13 from Blueprint B § 2 + SkillVersion, the 14th per DR-028 T1, + UsageEvent and HumanReview, the 15th and 16th per DR-103 D1).

Status — v0.9.0: current published release (first public release was v0.1.0, 2026-05-17). Contracts follow SemVer. Published with Sigstore provenance — verify via npm audit signatures.

Install

# Types-only (zero runtime deps)
pnpm add @intentsolutions/core

# Types + Zod runtime validators
pnpm add @intentsolutions/core zod

Quick import surface

// Types
import type { EvalSpec, EvalRun, GateResultV1, Uuidv7 } from '@intentsolutions/core';

// JSON Schema (draft 2020-12) — language-agnostic
import gateResultSchema from '@intentsolutions/core/schemas/v1/gate-result.schema.json' with { type: 'json' };

// Zod validators (opt-in; tree-shakable)
import { GateResultV1Schema } from '@intentsolutions/core/validators/v1/gate-result-v1';
const parsed = GateResultV1Schema.parse(payload);

// State machine helpers
import { evalRunTransitions, canTransition } from '@intentsolutions/core';
canTransition(evalRunTransitions, 'queued', 'running'); // true

What this is

intent-eval-core is the kernel of the Intent Eval Platform. It is bicameral — it ships two schema tiers:

• Runtime tier (schemas/v1/) — contracts for the 16 canonical platform entities (the 13 from Blueprint B § 2 + SkillVersion, the 14th per DR-028 T1, + UsageEvent and HumanReview, the 15th and 16th per DR-103 D1):
  • TypeScript interfaces for every entity
  • JSON Schemas as the language-neutral wire format
  • Zod validators for runtime validation at every trust boundary
  • State machines governing entity transitions
• Authoring tier (schemas/authoring/v1/) — the Spec Authority Kernel (SAK): the single internal source of truth for authoring-artifact validity (skills, plugins, agents, MCP configs, hooks, marketplace catalogs). Each contract composes an upstream-base (the open standard) + the three universal folds + an IS overlay. skill-frontmatter is the published walking skeleton (DR-044 D7).

It is not:

• A runtime — execution lives in dedicated runtime packages
• A judge — behavioral evaluation lives in @j-rig/*
• A harness — deterministic gates live in audit-harness

Every validator in the platform — audit-harness deterministic gates, j-rig behavioral evaluators, intent-rollout-gate decision shell — depends on this package for canonical contract definitions. One source of truth, many consumers.

Architecture

This package is bound by the Intent Eval Platform's Phase A foundation, all on main of intent-eval-lab:

| Document | Role | | --- | --- | | DR-010 — ISEDC Session 4 widened-scope lock | Governance, TS-primary signing surfaces, unification thesis (every validator emits Evidence Bundle) | | Blueprint A — Ecosystem Master Blueprint | 12 binding principles, 5-repo taxonomy, anti-goals | | Blueprint B — Platform Runtime Blueprint | 13-entity canonical domain model, gate-result/v1 predicate contract | | Blueprint C — Repo Blueprint Template | The template this repo's blueprint applies | | Canonical Glossary | Platform terminology — every doc cites here |

The per-repo blueprint for intent-eval-core itself ships under epic iec-E10 (Blueprint C application).

License

Apache License 2.0 — see LICENSE.

The kernel is permissively licensed so every downstream consumer (commercial, OSS, internal) can depend on it without friction. The platform's enforcement scripts (audit-harness) ship under Apache-2.0 for the same reason — the whole Intent Eval Platform is Apache-2.0.

Status

Phase A foundation complete (2026-05-15). First public release v0.1.0 shipped (2026-05-17) — closes epics iec-E01 (scaffold), iec-E02 (13 entities + gate-result/v1), iec-E03 (JSON Schemas), iec-E04 (Zod validators), iec-E09 (NPM publishing). Track progress at:

• Bead workspace: ~/000-projects/.beads/ (prefix iec-)
• Plane sub-module: Intent Eval Core — Kernel in LAB project
• Master plan: ~/.claude/plans/se-the-council-bubbly-frog.md