adachsoft / ai-evaluation-contracts

v0.1.0 2026-10-21 06:04 UTC

Requires

• php: ^8.3
• adachsoft/collection: ^3.0

Requires (Dev)

• adachsoft/php-code-style: ^0.7.1
• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: ^2.3
• phpunit/phpunit: ^13.4
• rector/rector: ^2.7
• symplify/phpstan-rules: ^14.19

MIT

• Arkadiusz Adach

• php
• rules
• ai
• Evaluation
• contracts
• verdicts

Published on Packagist.org on 2026-10-21 04:30 UTC

README

Provider-agnostic PHP contracts for evaluating text against structured AI rules.

Features

• A common EvaluatorInterface for consumer-provided evaluation adapters.
• Immutable request and result DTOs.
• Boolean, single-choice, and numeric-scale rule and verdict types.
• Typed immutable collections and evaluation-related exceptions.

Requirements

• PHP 8.3 or later.
• adachsoft/collection 2.1.0 or later.

Installation

composer require adachsoft/ai-evaluation-contracts

Usage

Create an EvaluationRequestDto with named rules and pass it to an implementation of EvaluatorInterface provided by your application or an integration package. The returned EvaluationResultDto contains verdicts indexed by rule name.

See Evaluating descriptions for a complete contract-usage example.

License

MIT