pilotphp/contracts

Stable public contracts for the PilotPHP Agent-First framework ecosystem.

Maintainers

Package info

gitlab.com/pilotphp/contracts

Issues

pkg:composer/pilotphp/contracts

Transparency log

Statistics

Installs: 13

Dependents: 3

Suggesters: 0

Stars: 0

Security

Advisories: 0

Aikido package health analysis

0.0.2 2026-07-27 01:31 UTC

Requires

  • php: ^8.5

Requires (Dev)

MIT 66be98766e0075154992cb1ac1b1c1a9e4ea232c

psrcontractsagent-firstpilotphp

Published on Packagist.org on 2026-07-26 22:41 UTC

This package is not auto-updated.

Last update: 2026-07-27 21:11:36 UTC

README

Stable public contracts for the PilotPHP Agent-First framework ecosystem.

This package defines interfaces, value objects, and enums only. It contains no runtime implementations, and depends on nothing beyond PHP itself.

Scope

pilotphp/contracts exists to give every other PilotPHP package (core, config, container, runtime, runtime-roadrunner, grpc, blueprint, and so on) a shared, transport-neutral vocabulary to program against, without forcing them to depend on each other or on any concrete implementation.

What belongs here:

  • Interfaces that multiple PilotPHP packages need to agree on.
  • Immutable value objects that describe build-time or lifecycle data.
  • Enums for closed sets of values (e.g. service scopes).

What does not belong here:

  • Runtime implementations of any kind.
  • Anything specific to a transport or technology (HTTP, gRPC, RoadRunner, FrankenPHP, a specific DI container, an ORM, Blueprint).
  • Speculative abstractions without an immediate, concrete consumer.

See AGENTS.md for the contribution rules that keep this package minimal and stable, and the docs/ directory for the full public API reference, compatibility policy, and lifecycle documentation.

Installation

composer require pilotphp/contracts

Requires PHP 8.5+.

Namespaces

NamespaceContents
PilotPHP\Contracts\PackagePackage description and registration
PilotPHP\Contracts\KernelApplication entry point lifecycle
PilotPHP\Contracts\ContainerRead-only service resolution
PilotPHP\Contracts\ConfigTyped configuration access
PilotPHP\Contracts\RuntimeTransport-neutral invocation handling

Development

make install   # composer install
make check     # validate + cs-check + analyse + test

Individual steps: make test, make analyse, make cs-check, make cs-fix, make validate.

Repository

This is a standalone Git repository, one of many single-purpose repositories that make up PilotPHP. There is no monorepo; each PilotPHP package is its own repository and its own Composer package.