it-pack / derive-it-runit

1.1.1 2026-10-28 15:08 UTC

Requires

• php: ^8.4
• it-pack/derive-it: *@dev
• it-pack/run-it: *@dev

Requires (Dev)

• codeception/codeception: ^5.0
• codeception/module-asserts: ^3.3
• infection/codeception-adapter: ^0.4
• just-bases/php-obs-dev-base: ^0.1.0
• just-bases/php-qa-base: ^1.0
• just-bases/php-unit-test-base: ^1.0
• phparkitect/phparkitect: ^1.2

MIT

• tidal

• execution
• integration
• telemetry
• it-pack
• itpack
• derive-it
• run-it

Published on Packagist.org on 2026-11-03 23:52 UTC

README

RunIt execution-model integration for DeriveIt — the only place where the two packages meet.

DeriveIt emits derivation telemetry (activities, measurements, observations, occurrences) through its own dependency-free DeriveEventSinkInterface. RunIt models executions. This package bridges the two: a derivation run becomes a first-class execution, and every pipeline fact lands on that execution's recorders — without DeriveIt importing a single RunIt symbol, and vice versa.

Installation

composer require it-pack/derive-it-runit

(Pulls in it-pack/derive-it and it-pack/run-it.)

Usage

use ItPack\DeriveIt\DeriveIt;
use ItPack\DeriveIt\Generator\DeriveConfig;
use ItPack\DeriveItRunit\DeriveItExecutions;
use ItPack\RunIt\SDK\Builder\RunItBuilder;

$runtime = /* your RunItBuilder-built runtime */;

$source = DeriveItExecutions::run(
    $runtime,
    'derive.flat',
    fn ($sink) => DeriveIt::deriveWithResult($class, new DeriveConfig(), $sink)->source,
);

Every facade method that performs a derivation accepts an optional trailing ?DeriveEventSinkInterface $eventSink = null; hand it the sink your closure receives and the whole pipeline attaches to the ambient execution.

Fact mapping

DeriveIt fact	RunIt artifact
activityStarted/Finished	occurrence deriveit.activity.{started,finished}.v1
measured	measurement named deriveit.<name> (count→counter, By→size, ms→duration, %→ratio, else gauge)
observed	observation with mapped severity
occurred	occurrence deriveit.<type>.v1

Execution vocabulary: kind derivation.run, names like derive.flat, derive.family, derive.diff.

Commands

composer test:unit   # PHPUnit incl. end-to-end execution test
composer analyse     # PHPStan level 8
composer cs:check    # PHP-CS-Fixer dry-run